Wonderware FactorySuite Internet Connectivity

Users Guide
Revision A July 1999

Wonderware Corporation

All rights reserved. No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of the Wonderware Corporation. No copyright or patent liability is assumed with respect to the use of the information contained herein. Although every precaution has been taken in the preparation of this documentation, the publisher and author assume no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein. The information in this documentation is subject to change without notice and does not represent a commitment on the part of Wonderware Corporation. The software described in this documentation is furnished under a license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of these agreements. 1999 Wonderware Corporation. All Rights Reserved. 100 Technology Drive Irvine, CA 92618 U.S.A. (949) 727-3200 http://www.wonderware.com Trademarks All terms mentioned in this book that are known to be trademarks or service marks have been appropriately capitalized. Wonderware Corporation cannot attest to the accuracy of this information. Use of a term in this book should not be regarded as affecting the validity of any trademark or service mark. Wonderware, InTouch and FactorySuite Web Server are registered trademarks of Wonderware Corporation. FactorySuite, Wonderware FactorySuite, WindowMaker, WindowViewer, SQL Access Manager, Recipe Manager, SPCPro, DBDump, DBLoad, HDMerge, HistData, Wonderware Logger, Alarm Logger, InControl, InTrack, InBatch, IndustrialSQL, FactoryOffice, FactoryFocus, License Viewer, Scout, SuiteLink and NetDDE are trademarks of Wonderware Corporation.

Contents
Introduction ........................................................................................................ 1 Overview............................................................................................................. 2 Installing FactorySuite Web Server............................................................... 3 Security and Licenses ................................................................................... 3 3rd Party and ActiveX Controls ..................................................................... 5 Firewalls ...................................................................................................... 5 Designing Internet-Specific Applications in InTouch .......................................... 6 Internet Tagname Addressing....................................................................... 6 "Forcing" a Local Tagname Address ............................................................ 8 Screen Display Size and Resolution.............................................................. 9 Using the InTouch Application Publisher .......................................................... 10 Publishing Applications with Multiple Resolutions..................................... 15 Downloading and Running Internet Applications .............................................. 16 Downloading Published Applications ......................................................... 16 The IVIEW.HTM HTML Page ................................................................... 18 Command Line Arguments for Running WindowViewer............................ 19 IndustrialSQL Server Internet Enabled Client Tools ................................... 20

Index ....................................................................... I-1

ii

Contents

Introduction
The Wonderware FactorySuite Web Server provides you with the capability of running your InTouch applications via a standard internet connection. You can run existing InTouch applications or you can design internet-specific applications. In either case, HTTP is used to transfer data. You can view these applications in Microsoft Internet Explorer, or in WindowViewer just as if it was on a local node. FactorySuite's internet capability allows the client to receive five data sources: Remote InTouch Tagnames Distributed Alarms InTouch Tagname History I/O Server InSQL

In order for you to run your InTouch applications via the internet, you will need: The Wonderware FactorySuite Web Server installed on an Internet Information Server (IIS) or a Personal Web Server (PWS). Microsoft Internet Explorer 4.0 SP1. WindowViewer (V 7.1 or later) installed on the client node. A valid WindowViewer runtime license installed on the client node. For more information, see the "Security and License" section later in this manual.

FactorySuite Internet Connectivity Guide

Overview
Applications must be published to the FactorySuite Web Server. An easy way to do this is by using the Application Publisher (installed with WindowMaker V7.1 or later). For more information, see the "Using the InTouch Application Publisher" section later in thismanual. Once the application is published to the FactorySuite Web Server, clients can download it via the internet to the local node. Alternately, the published application may be installed on the client node from floppy disk, zip disk, or copied across a company network by standard UNC addressing. After the application is installed on the client machine, it must connect with the FactorySuite Web Server to begin data transfer. For more information on running published applications, see the "Downloading and Running Internet Applications " section later in this manual. Once connected, your InTouch application will display data just as if it were running on a local node. The two diagrams below illustrate both the development and runtime environments when you are using the Application Publisher and the FactorySuite Web Server.

Development

Runtime

FactorySuite Internet Connectivity Guide

Installing FactorySuite Web Server

The Wonderware FactorySuite installation program is used to install FactorySuite Web Server. The FactorySuite Web Server must be installed on an Internet Information Server or a Personal Web Server. Note For more information on web servers, contact your Internet Administrator. For complete installation instructions, refer to your FactorySuite installation booklet or your online FactorySuite System Administrators Guide.

Security and Licenses

To view InTouch applications in your browser or to run a published application in WindowViewer, you must have a runtime licensed copy of InTouch. If you download an application with "write" capability, you must have a development license to edit the application in WindowMaker. Note A client can only interact with data from the FactorySuite Web Server and can not post applications back to the FactorySuite Web Server. For example, the client can not modify an application and re-post it to the server via the internet.

Internet Explorer Security Settings

To view an application in your Internet Explorer, you must set your browser security to "Low." Note Currently it is necessary to view InTouch applications using Microsoft Internet Explorer 4.0 SP1.

FactorySuite Internet Connectivity Guide

To adjust browser security settings: 1. In Internet Explorer, On the View menu, click Internet Options. The Internet Options dialog box appears.

2. 3. 4.

Click the Security tab. In the Internet Zone group, and then select Low. Click OK. A message box appears informing you that you have lowered your security settings.

FactorySuite Internet Connectivity Guide

3rd Party and ActiveX Controls

If an application was developed and published with embedded 3rd party controls, wizards, or ActiveX controls, they may require additional licenses. Wonderware does not provide these licenses.

Firewalls
The FactorySuite Web Server is designed to be "firewall friendly." Meaning, it supports connections between itself and one or more clients in such a manner as to be compatible with Proxy Server intermediaries. Data can be exchanged between the client and the server over Internet port 80 using the HTTP protocol. The server must provide the client with a method of overriding the default Internet Port ID. Note For more information about your organizations firewall, contact your Internet Administrator.

FactorySuite Internet Connectivity Guide

Designing Internet-Specific Applications in InTouch

If you are publishing an existing application, the Web Server portion of the address will be dynamically added to the tagname at runtime. However, in some cases you may want to create an application which collects data from multiple FactorySuite Web Servers. For example, you may want to monitor the daily oil production of three different refineries in three distant locations. In such cases, each Web Server must be addressed specifically by name or IP Address. In the example below, each refinery is using its own FactorySuite Web Server.

Internet Tagname Addressing

The application name portion of the I/O address must be prefixed with 2 backslashes, followed by the IP address to the FactorySuite Web Server, followed by an @ symbol, followed by the remote nodes name, preceded by two backslashes, followed by one backslash. For example:
\\000.000.000.000@\\NodeName\VIEW|TAGNAME!ActualTagname

Where: \\000.000.000.000@ Represents the IP Address (FactorySuite Web Server internet address) that identifies the path to the FactorySuite Web Server. Represents the NodeName (remote nodes name) that identifies the remote node on which the data resides. Represents the ApplicationName (View) for the InTouch runtime program that contains the data element. Represents the TopicName. For InTouch, TAGNAME is the word always used when reading/writing to a tagname in the InTouch Tagname Data Dictionary. Represents the ItemName. For InTouch, this is the actual tagname defined in the Tagname Data Dictionary that specifies the data values address in the remote device.

\\NodeName \VIEW|

TAGNAME!

ActualTagname

FactorySuite Internet Connectivity Guide To create a new internet-specific tagname address: 1. In WindowMaker, on the Special menu, select Access Names. The Access Names dialog box appears.

2.

Click Add. The Add Access Name dialog box appears. For more information on creating Access Names in InTouch, see your online InTouch Users Guide.

3.

In the Node Name box, prefix the Node Name with the FactorySuite Web Server IP Address followed by an @ symbol.

Note If there is no Node Name (remote node) associated with the tagname, prefix the Application Name with type the IP Address and the @ symbol. 4. Click OK and then, click Close.

FactorySuite Internet Connectivity Guide

"Forcing" a Local Tagname Address

When you run an application via the FactorySuite Web Server, by default, the tagnames will automatically be assigned the IP Address of that particular FactorySuite Web Server. However, you can force a tagname to access data on the local node. For example, you may want the time for an alarm that is coming from the other side of the world to reflect the time on your local node. To force a local address: 1. 2. 3. In WindowMaker, on the Special menu, select Access Names. The Access Names dialog box appears. Select the Access Name you want to modify in the list and then, click Modify. The Modify Access Name dialog box appears. In the Node Name box, type an "@" symbol before the Node Name.

Note If there is no Node Name (remote node) associated with the tagname, prefix the Application Name with the IP Address and the @ symbol. 4. Click OK and then, click Close.

FactorySuite Internet Connectivity Guide

Screen Display Size and Resolution

The Application Publisher will only publish an application in one resolution at a time. For example, if you develop a runtime only application in 1024x768. The client must also be running in the same resolution to properly view the application in their browser. However, if the application is published with write capability after the client downloads the application and opens it in WindowMaker, the resolution will be adjusted to the clients resolution. The Application Publisher automatically notes the screen resolution that the application was developed at and includes that information when it is posted to the FactorySuite Web Server. For example, a published application may appear posted as: Description Publisher File Name Dairy Processing Application Navin Johnson Dairy.exe / Video Resolution(1024x768)

10

FactorySuite Internet Connectivity Guide

Using the InTouch Application Publisher

The Application Publisher creates a self-extracting file that contains all relevant files and setup procedures that you need to install the application onto another InTouch node. The Application Publisher compresses the Application to minimize download time over the Internet. Note You can copy these compressed applications to floppy disks, zip disks, and so on, for installation on other nodes. The Application Publishers compression rate is approximately 19 to 1. This rate allows a 20 MB, full development application to fit on a standard floppy disk. If the file is runtime only, a 30 to 40 MB application may fit on a single floppy disk. Once you publish an application, you re-constitute as an InTouch application on one or more other InTouch 7.1 (or later) node(s). You can use several methods to load the published application file onto another InTouch node: Copy to floppy disk Copy the file over your company Intranet Copy the file over the Internet A re-constituted InTouch application can be used by running the self extracting file as a program on the target node.

FactorySuite Internet Connectivity Guide

11

To publish an InTouch application: 1. In WindowMaker, from the Application Explorer, open Applications.

2.

Select Application Publisher. The InTouch Application Publisher Step 1 of 4 dialog box appears.

12

FactorySuite Internet Connectivity Guide 3. Click Next. The InTouch Application Publisher Step 2 of 4 dialog box appears.

4.

In the Author Name box, type the name of the person(s) (up to 256 characters) to contact regarding the application. (This is an optional entry.) For example: Ernie Tankhammer Ernie Tankhammer Senior Engineer Phone 1-800-555-1234

5.

In the Description box, type a description for the application (up to 256 characters). (This is an optional entry.) For example: Real Time Production Status Plant Number 5-Area 3 that requires access to zone 3 FactorySuite File Server for data point access.

6.

In the Package Name box type a name for the package (up to 32 standard Windows file naming characters.). You must type a Package Name. Note The Package Name is a unique name that identifies a published application. It is used by the FactorySuite Web Server to maintain simultaneous downloadable versions of the same published application.

FactorySuite Internet Connectivity Guide 7. Click Next. The InTouch Application Publisher Step 3 of 4 dialog box appears.

13

8. 9.

In the entry box, type the path to the InTouch application source. The default is the WindowMaker application directory. Select the Runtime only option to prevent the inclusion of development WindowMaker files in the published file.

14

FactorySuite Internet Connectivity Guide 10. Click Next. The InTouch Application Publisher Step 4 of 4 dialog box appears.

11. Verify that the executable name in the first box is correct. (By default, this will be the same as the Package Name you specified.) 12. In the second box, type the path to the directory where you want to save the published file. (By default, this will be saved in your current Temp directory.) Or, click Browse to locate a different directory. Note In the example above, the file will be posted to the FactorySuite Web Server on the company intranet. 13. Click Finish.

FactorySuite Internet Connectivity Guide

15

Publishing Applications with Multiple Resolutions

You can publish your applications in multiple resolutions. This will eliminate a clients inability to view your application at the proper resolution. To publish an application in a different resolution: 1. 2. 3. 4. While running WindowMaker, change the screen resolution on your PC. WindowMaker will notify you that your resolution has changed and prompt you to accept the change, click OK. From the Application Explorer, open Applications and then, run the Application Publisher. Change the Package Name for the application. For example, change Dairy to Dairy_2. Note If you want to keep the same Package Name and just change the file name (by default, these are the same), change the file name in the InTouch Application Publisher Step 4 of 4 dialog box. The file name must be changed to post multiple resolutions of the same application. If the file name is the same, it will only overwrite the initial application. When posted to the web server it appears as: Description Publisher File Name. Dairy Processing Application Navin Johnson Dairy.exe / Video Resolution(1024x768)

Description Publisher File Name.

Dairy Processing Application Navin Johnson Dairy_2.exe / Video Resolution(800x600)

16

FactorySuite Internet Connectivity Guide

Downloading and Running Internet Applications

There are two files that you will use with the FactorySuite Web Server, APPDIR.EXE and IVIEW.HTM. You will use APPDIR.EXE to download a published application and, you will use IVIEW.HTM to view the application in your web browser. Note You can also run the application in WindowViewer. For more information, see the "Using the View -I Command" section later in this manual.

Downloading Published Applications

APPDIR.EXE is a program that dynamically lists your published application in an HTML page. This is done by the FactorySuite Web Server when you publish your application. This web page resides on the FactorySuite Web Server and can be accessed directly by the client by directing their browser to the URL. For example:

000.000.000.000/scripts/fswebsvr/appdir.exe Note If you do not know the URL of the FactorySuite Web Server, contact the publisher of the application.

FactorySuite Internet Connectivity Guide

17

To download a published application: 1. In Microsoft Internet Explorer, enter the URL of APPDIR.EXE on the FactorySuite Web Server. For example: Http://000.000.000.000/scripts/fswebsvr/appdir.exe

2.

Select the application you want to download and select a folder to save the application to and then, click Save.

18

FactorySuite Internet Connectivity Guide

The IVIEW.HTM HTML Page

IVIEW.HTM is

an HTML page that acts as a frame to view "live" data in your browser. Like APPDIR.EXE, IVIEW.HTM resides on the FactorySuite Web Server and is accessed by the client entering the URL in the browser. For example: Http://000.000.000.000/scripts/fswebsvr/iview.htm

To view applications with iview.htm: 1. 2. You must have the published application installed. In Internet Explorer, enter the URL to IVIEW.HTM on the FactorySuite Web Server. Note If you do not know the URL to the IVIEW.HTM page, contact the publisher of the application. 3. Click the ellipse button () and then, select the published application you want to view. Note Only downloaded applications appear in the list. 4. Click Go. Depending upon the resolution and screen size of the application, you may need to use the scroll bars to view the entire application in the frame. TIP To maximize application visibility, click the Fullscreen Internet Explorer toolbar. tool on the

FactorySuite Internet Connectivity Guide

19

Command Line Arguments for Running WindowViewer

You do not have to run your internet applications in your web browser. You can run applications on a client machine with a licensed InTouch system. You can run your downloaded or internet-specifically developed application in WindowViewer using the "View -i" command from the command prompt. You can run WindowViewer (VIEW.EXE) from the MS-DOS command prompt or the Windows Run dialog box by using the following arguments:
view -i [http[s]://][uid:passwd:]outpost[:port]

Where: outpost is the FS Web Server. username and password are optional. Examples: http:
view -i http://ahab:xdick:fswebN.wonderware.com:80 view -i ahab:xdick:fswebN.wonderware.com view -i fswebN.wonderware.com:80 view -i fswebN.wonderware.com

SSL:
view -i https://paranoid:gonecase:fsweb.wonderware.com view -i https://paranoid:gonecase:fsweb.wonderware.com:443 view -i https://fsweb.wonderware.com:443 view -i https://fsweb.wonderware.com

For normal http connections the format is:

[http://username:password:outpost:port]@targetRDBNode

For http connections over SSL the format is:

[https://username:password:outpost:port]@targetRDBNode

Where: outpost is the FS Web Server username, password and port (defaults to 80) are optional.

20

FactorySuite Internet Connectivity Guide

IndustrialSQL Server Internet Enabled Client Tools

The following IndustrialSQL Server 7.1 client tools can also access data from an IndustrialSQL Server either through a LAN or via the internet: InSQL Report ActiveTagBrowser ActiveGraph ActiveTimeSelector ActiveDataGrid.

In order for these clients to access data via the Internet, however, the FactorySuite Web Server must be installed on the Internet Server computer. For more information on using these client tools, refer to your online IndustrialSQL Server Client Tools Guide.

I-1 Internet Port ID, 5 Internet Tagname Addressing, 6 InTouch Access Name, 7 Modifying, 8 IP Address, 6 IVIEW.HTM HTML Page, 18

Index
3
3rd Party Controls, 5

L
Licenses, 3

A
Access Name, 7 Modifying, 8 ActiveX Controls, 5 Adjusting the Browser Security Settings, 4 APPDIR.EXE, 16 Application Name, 6 Application Publisher, 10 Author Name, 12

M
Maximizing Application Visibility, 18 Multiple Resolutions, 15

N
Node Name, 6

C
Changing a file name, 15 Changing a Package Name, 15 Command Line Arguments, 19 Compressed Files, 10 Creating Internet specific tagname address, 7

P
Package Name, 12, 14 Changing, 15 Proxy Server, 5 Publishing an Application, 2, 10, 11 Author Name, 12 Description, 12 Excluding development files, 13 Multiple Resolutions, 15 Package Name, 12, 14

D
Data Sources, 1 Designing Internet Appliations, 6 Downloading a Published Application, 2, 16, 17

R
Resolution, 7, 9, 15 Running Internet Applications, 16 Running WindowViewer from the Command Line, 19 Runtime only option, 13

F
Firewalls, 5 Forcing a Local Tagname Address, 8

H
Http Address, 18

S
Screen Display Resolution, 9, 15 Size, 9, 15 Security, 3 Browser, 4 Internet Explorer Security Settings, 3

I
I/O Address, 6 IndustrialSQL Internet Client Tools, 20 Installation, 3 Internet Explorer Security Settings, 3

I-2

Index

T
Tagname Addressing Application Name, 6 Forcing a Local Tagname Address, 8 IP Address, 6 Item Name, 6 Node Name, 6 Topic Name, 6 Transferring Published Applications, 10

V
Viewing a Published Application, 18

W
WindowViewer Command Line Arguments, 19