in touch internet

Wonderware FactorySuite

Internet Connectivity

User’s Guide Revision A

July 1999

Wonderware Corporation

All rights reserved. No part of this documentation shall be reproduced, stored in aretrieval system, or transmitted by any means, electronic, mechanical,photocopying, recording, or otherwise, without the prior written permission of theWonderware Corporation. No copyright or patent liability is assumed with respectto the use of the information contained herein. Although every precaution has beentaken in the preparation of this documentation, the publisher and author assume noresponsibility for errors or omissions. Neither is any liability assumed for damagesresulting from the use of the information contained herein.

The information in this documentation is subject to change without notice and doesnot represent a commitment on the part of Wonderware Corporation. The softwaredescribed in this documentation is furnished under a license or nondisclosureagreement. This software may be used or copied only in accordance with the termsof 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 markshave been appropriately capitalized. Wonderware Corporation cannot attest to theaccuracy of this information. Use of a term in this book should not be regarded asaffecting the validity of any trademark or service mark.

Wonderware, InTouch and FactorySuite Web Server are registered trademarks ofWonderware Corporation.

FactorySuite, Wonderware FactorySuite, WindowMaker, WindowViewer, SQLAccess Manager, Recipe Manager, SPCPro, DBDump, DBLoad, HDMerge,HistData, Wonderware Logger, Alarm Logger, InControl, InTrack, InBatch,IndustrialSQL, FactoryOffice, FactoryFocus, License Viewer, Scout, SuiteLink andNetDDE are trademarks of Wonderware Corporation.

i

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

1

Introduction

The Wonderware® FactorySuite Web Server® provides you with the capability ofrunning your InTouch applications via a standard internet connection. You can runexisting InTouch applications or you can design internet-specific applications.

In either case, HTTP is used to transfer data. You can view these applications inMicrosoft® Internet Explorer™, or in WindowViewer just as if it was on a localnode.

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 InformationServer (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 thismanual.

2 FactorySuite Internet Connectivity Guide

Overview Applications must be published to the FactorySuite Web Server. An easy way to dothis is by using the Application Publisher (installed with WindowMaker V7.1 orlater).

For more information, see the "Using the InTouch Application Publisher" sectionlater in thismanual.

Once the application is published to the FactorySuite Web Server, clients candownload it via the internet to the local node. Alternately, the published applicationmay be installed on the client node from floppy disk, zip disk, or copied across acompany network by standard UNC addressing.

After the application is installed on the client machine, it must connect with theFactorySuite Web Server to begin data transfer.

For more information on running published applications, see the "Downloading andRunning Internet Applications " section later in this manual.

Once connected, your InTouch application will display data just as if it wererunning on a local node.

The two diagrams below illustrate both the development and runtime environmentswhen you are using the Application Publisher and the FactorySuite Web Server.

Development

Runtime

FactorySuite Internet Connectivity Guide 3

Installing FactorySuite Web Server The Wonderware FactorySuite installation program is used to install FactorySuiteWeb Server. The FactorySuite Web Server must be installed on an InternetInformation 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 bookletor your online FactorySuite System Administrator’s Guide.

Security and Licenses To view InTouch applications in your browser or to run a published application inWindowViewer, you must have a runtime licensed copy of InTouch. If youdownload an application with "write" capability, you must have a developmentlicense to edit the application in WindowMaker.

Note A client can only interact with data from the FactorySuite Web Server andcan not post applications back to the FactorySuite Web Server. For example, theclient 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 browsersecurity to "Low."

Note Currently it is necessary to view InTouch applications using MicrosoftInternet Explorer 4.0 SP1.


½ To adjust browser security settings:

1. In Internet Explorer, On the View menu, click Internet Options. The InternetOptions dialog box appears.

2. Click the Security tab.

3. In the Internet Zone group, and then select Low.

4. Click OK. A message box appears informing you that you have lowered yoursecurity settings.


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. Wonderwaredoes not provide these licenses.

Firewalls The FactorySuite Web Server is designed to be "firewall friendly." Meaning, itsupports connections between itself and one or more clients in such a manner as tobe compatible with Proxy Server intermediaries. Data can be exchanged betweenthe client and the server over Internet port 80 using the HTTP protocol. The servermust provide the client with a method of overriding the default Internet Port ID.

Note For more information about your organization’s firewall, contact your InternetAdministrator.


Designing Internet-SpecificApplications in InTouch

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

Internet Tagname Addressing The application name portion of the I/O address must be prefixed with 2backslashes, followed by the IP address to the FactorySuite Web Server, followedby an @ symbol, followed by the remote node’s 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 Serverinternet address) that identifies the path to theFactorySuite Web Server.

\\NodeName Represents the NodeName (remote node’s name) thatidentifies the remote node on which the data resides.

\VIEW| Represents the ApplicationName (View) for theInTouch runtime program that contains the dataelement.

TAGNAME! Represents the TopicName. For InTouch, TAGNAMEis the word always used when reading/writing to atagname in the InTouch Tagname Data Dictionary.

’ActualTagname’ Represents the ItemName. For InTouch, this is theactual tagname defined in the Tagname Data Dictionarythat specifies the data value’s address in the remotedevice.


½ To create a new internet-specific tagname address:

1. In WindowMaker, on the Special menu, select Access Names. The AccessNames dialog box appears.

2. Click Add. The Add Access Name dialog box appears.

For more information on creating Access Names in InTouch, see your onlineInTouch User’s Guide.

3. In the Node Name box, prefix the Node Name with the FactorySuite WebServer 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.


"Forcing" a Local Tagname Address When you run an application via the FactorySuite Web Server, by default, thetagnames will automatically be assigned the IP Address of that particularFactorySuite Web Server. However, you can force a tagname to access data on thelocal node. For example, you may want the time for an alarm that is coming fromthe other side of the world to reflect the time on your local node.

½ To force a local address:

1. In WindowMaker, on the Special menu, select Access Names. The AccessNames dialog box appears.

2. Select the Access Name you want to modify in the list and then, click Modify.The Modify Access Name dialog box appears.

3. 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.


Screen Display Size and Resolution The Application Publisher will only publish an application in one resolution at atime. For example, if you develop a runtime only application in 1024x768. Theclient must also be running in the same resolution to properly view the applicationin their browser. However, if the application is published with write capability afterthe client downloads the application and opens it in WindowMaker, the resolutionwill be adjusted to the client’s resolution.

The Application Publisher automatically notes the screen resolution that theapplication was developed at and includes that information when it is posted to theFactorySuite Web Server. For example, a published application may appear postedas:

Description Dairy Processing Application

Publisher Navin Johnson

File Name Dairy.exe / Video Resolution…(1024x768)


Using the InTouch ApplicationPublisher

The Application Publisher creates a self-extracting file that contains all relevantfiles and setup procedures that you need to install the application onto anotherInTouch node. The Application Publisher compresses the Application to minimizedownload time over the Internet.

Note You can copy these compressed applications to floppy disks, zip disks, and soon, for installation on other nodes.

The Application Publisher’s compression rate is approximately 19 to 1. This rateallows a 20 MB, full development application to fit on a standard floppy disk. If thefile 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 oneor more other InTouch 7.1 (or later) node(s).

You can use several methods to load the published application file onto anotherInTouch 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 extractingfile as a program on the target node.


½ To publish an InTouch application:

1. In WindowMaker, from the Application Explorer, open Applications.

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


3. Click Next. The InTouch Application Publisher – Step 2 of 4 dialog boxappears.

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 256characters). (This is an optional entry.) For example:

Real Time Production Status

Plant Number 5-Area 3 that requires access to zone 3 FactorySuite FileServer for data point access.

6. In the Package Name box type a name for the package (up to 32 standardWindows file naming characters.). You must type a Package Name.

Note The Package Name is a unique name that identifies a publishedapplication. It is used by the FactorySuite Web Server to maintain simultaneousdownloadable versions of the same published application.



8. In the entry box, type the path to the InTouch application source. The default isthe WindowMaker application directory.

9. Select the Runtime only option to prevent the inclusion of developmentWindowMaker files in the published file.



11. Verify that the executable name in the first box is correct. (By default, this willbe the same as the Package Name you specified.)

12. In the second box, type the path to the directory where you want to save thepublished 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 WebServer on the company intranet.

13. Click Finish.


Publishing Applications with MultipleResolutions

You can publish your applications in multiple resolutions. This will eliminate aclient’s inability to view your application at the proper resolution.

½ To publish an application in a different resolution:

1. While running WindowMaker, change the screen resolution on your PC.

2. WindowMaker will notify you that your resolution has changed and prompt youto accept the change, click OK.

3. From the Application Explorer, open Applications and then, run theApplication Publisher.

4. Change the Package Name for the application. For example, change Dairy toDairy_2.

Note If you want to keep the same Package Name and just change the filename (by default, these are the same), change the file name in the InTouchApplication Publisher – Step 4 of 4 dialog box.

The file name must be changed to post multiple resolutions of the sameapplication. If the file name is the same, it will only overwrite the initialapplication.

When posted to the web server it appears as:



File Name…………. Dairy.exe / Video Resolution…(1024x768)



File Name…………. Dairy_2.exe / Video Resolution…(800x600)


Downloading and Running InternetApplications

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 thismanual.

Downloading Published Applications APPDIR.EXE is a program that dynamically lists your published application in anHTML page. This is done by the FactorySuite Web Server when you publish yourapplication. This web page resides on the FactorySuite Web Server and can beaccessed 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 thepublisher of the application.


½ To download a published application:

1. In Microsoft Internet Explorer, enter the URL of APPDIR.EXE on theFactorySuite 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 theapplication to and then, click Save.


The IVIEW.HTM HTML Page IVIEW.HTM is an HTML page that acts as a frame to view "live" data in yourbrowser. Like APPDIR.EXE, IVIEW.HTM resides on the FactorySuite Web Server andis 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. You must have the published application installed.

2. In Internet Explorer, enter the URL to IVIEW.HTM on the FactorySuite WebServer.

Note If you do not know the URL to the IVIEW.HTM page, contact the publisherof the application.

3. Click the ellipse button (…) and then, select the published application you wantto view.

Note Only downloaded applications appear in the list.

4. Click Go.

Depending upon the resolution and screen size of the application, you may needto use the scroll bars to view the entire application in the frame.

TIP To maximize application visibility, click the Fullscreen tool on theInternet Explorer toolbar.


Command Line Arguments for RunningWindowViewer

You do not have to run your internet applications in your web browser. You canrun applications on a client machine with a licensed InTouch system. You can runyour downloaded or internet-specifically developed application in WindowViewerusing the "View -i" command from the command prompt.

You can run WindowViewer (VIEW.EXE) from the MS-DOS command prompt orthe 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.


IndustrialSQL Server Internet Enabled ClientTools

The following IndustrialSQL Server 7.1 client tools can also access data from anIndustrialSQL 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 FactorySuiteWeb Server must be installed on the Internet Server computer.

For more information on using these client tools, refer to your online IndustrialSQLServer Client Tools Guide.

I-1

Index

33rd Party Controls, 5

AAccess Name, 7

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

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

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

FFirewalls, 5Forcing a Local Tagname Address, 8

HHttp Address, 18

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

Internet Port ID, 5Internet Tagname Addressing, 6InTouch Access Name, 7

Modifying, 8IP Address, 6IVIEW.HTM

HTML Page, 18

LLicenses, 3

MMaximizing Application Visibility, 18Multiple Resolutions, 15

NNode Name, 6

PPackage Name, 12, 14

Changing, 15Proxy Server, 5Publishing an Application, 2, 10, 11

Author Name, 12Description, 12Excluding development files, 13Multiple Resolutions, 15Package Name, 12, 14

RResolution, 7, 9, 15Running Internet Applications, 16Running WindowViewer from the Command

Line, 19Runtime only option, 13

SScreen Display

Resolution, 9, 15Size, 9, 15

Security, 3Browser, 4Internet Explorer Security Settings, 3

I-2 Index

TTagname Addressing

Application Name, 6Forcing a Local Tagname Address, 8IP Address, 6Item Name, 6Node Name, 6Topic Name, 6

Transferring Published Applications, 10

VViewing a Published Application, 18

WWindowViewer

Command Line Arguments, 19

in touch internet

Documents