Documente Academic
Documente Profesional
Documente Cultură
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
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.
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
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.
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.
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.
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.
10
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.
15
16
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.
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
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
19
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
Where: outpost is the FS Web Server username, password and port (defaults to 80) are optional.
20
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