P-Cim Web
P-Cim Web
P-Cim Web
Application
Table of Contents
P-CIM FOR THE WEB .................................................................................................................... 3
Introduction ...............................................................................................................................................3
System Requirements ................................................................................................................................4
Overview ...................................................................................................................................................5
Setting up the Server .................................................................................................................................... 6
Installing P-CIM ........................................................................................................................................7
Configuring IIS Servers.............................................................................................................................7
Microsoft Message Queuing Service.........................................................................................................9
Configuring the History Collection Module ............................................................................................10
Configuring a P-CIM Web server............................................................................................................12
Pack Application for Web Distribution ...................................................................................................14
Setting up the P-CIM Web Client ............................................................................................................. 19
Using the P-CIM Web Client..................................................................................................................... 22
Alarm Web Interface ...............................................................................................................................22
History Data Web Interface .....................................................................................................................25
Technical Support....................................................................................................................................... 28
Revision 2
Catalog No.
Operator Workstation
P-CIM for the Web Operator Workstation: a typical P-CIM runtime application can be deployed
remotely to any enabled computer. The operator can monitor plant activity and activate button
commands exactly as an on-site P-CIM workstation.
Alarm Collection and History Collection modules: The operator can access alarm data/historical
data generated from any number of P-CIM workstations using an internet/intranet connection
and a web browser.
The Operator Workstation, Alarm Collection Module, and History Collection Module are
the only modules that can be executed from the P-CIM Web client. The P-CIM Web
client cannot access the Advanced Alarm Handler or any creation modules (Animation,
Database, Recipe, Report Editors, etc.) An on-site operator has the same access to all
P-CIM modules (subject to authorization) as an operator using a standard P-CIM.
Catalog No 1
Revision
System Requirements
In the complete P-CIM Web setting, there are tasks that are performed from the factory floor to
the Web client. The following table describes the requirements for deploying a P-CIM Web
application:
Task
Description
System Requirements
P-CIM
Data Server
(Optional)
Fixed IP address
The Data Server is the computer that houses the database system (SQL or MS Access)
that is required for the Alarm and Historian modules. If you do not enable these features,
the Data Server is not needed. Alarm data is stored in the main database. In this case, all
alarms and historical data from all P-CIM Web server(s) are stored in one central
database.
The actual number of computers required is variable. In the most limited scenario, all
Agent and Server applications can reside on one computer (which can also be a node
station). Conversely, independent computers can be designated for every application.
Likewise, there can be multiple nodes that are configured as Agents. The only limitation
is that the web client applications cannot reside on the same computer as the Server
applications.
Revision 2
Catalog No.
Overview
In an on-site P-CIM network, one computer must be designated as the P-CIM Web server. This
station must have P-CIM Web installed on it. On this computer you must use the Pack Project
utility to package the applications that you wish to make available for web access into
designated folders. These folders are then imported into the HTTP server (it can be the same
computer). The Web client must access the HTTP server through an Internet or Intranet
connection. The Web client then downloads and installs the application onto the client computer
(off-site). Once successfully installed, the client computer can access displays and data by
connecting to the on-site servers.
The packed project consists of two executable files; the first executable file contains the P-CIM
Web client files and is downloaded only once. The second executable file contains the project
files. This file should be downloaded by every client each time a change has been made to the
project. To facilitate the procedure and to make sure that only the relevant files are downloaded,
it is possible to perform an incremental download only. By doing so, only the updated files are
downloaded to the each client. This is done by using an FTP server which resides on the same
computer as the Web server (IIS). The FTP server contains all the project's files and is updated
whenever a new project pack is made.
Operator Workstation - the Operator Workstation module works differently than the Alarm
collection and Open Historian modules. Once the Operator Workstation is accessed
through the HTML environment, the clients computer emulates a typical P-CIM
workstation and communicates directly to the P-CIM Web server where the data is
generated.
Alarm History Collection Modules: the Alarms and History Collection modules collect
data from one or more P-CIM Web server(s) that collect alarms and historical data. The
data is distributed to and stored in the data server. Generally, the data server resides on
the same computer as the HTTP server although you can designate an independent
computer or even one of the P-CIM Web servers for this purpose. The client accesses
the alarm and historical data from this server. One server can manage the data from as
many P-CIM Web servers as are involved in the enterprise. The following diagram
illustrates the basic structure described above including which application features need
to be loaded on each one.
Catalog No 1
Revision
Configure the Microsoft Message Queuing Service (MSMQ). (applicable only when
using OLEDB to collect historical records)
Download and install the application software onto the Web client computer(s).
Revision 2
Catalog No.
Installing P-CIM
This refers to the basic installation and setup of P-CIM for your factory. For additional
information please refer to the P-CIM help files.
Create a subfolder in this directory. Give the new sub-folder an easily identifiable name
(for example: the project name).
2.
3.
Right-click the Default Web Site menu and select New\Virtual Directory from the menu.
4.
Create a Virtual Directory, use the Browse option to navigate to the sub-folder created in
step 2 and complete the wizard.
5.
Once the new directory is created, right-click to enter the Properties menu.
6.
Select the Documents Tab, remove the default documents in the list and type in the
following documents: pcimwebc.asp, pcimwebh.asp, and pcimwebf.htm.
7.
8.
Click the Edit button in the Anonymous action and authentication control section.
This step is required only when using SQL or Access database.
Catalog No 1
Revision
9.
An Administrator's account is a user account with the highest level of access rights.
10.
Click OK twice
11.
Create another Virtual Directory for the FTP: Repeat steps 1-6, where Default FTP Site
Menu must be selected.
The project application files must be transferred into this directory after the Pack
Project procedure is completed, as explained on page 16. When using the Incremental
Download mechanism, the un-packed project's files are moved to the FTP Virtual
Directory folder during the Pack Project process.
To use the incremental download option (recommended), create a new sub-folder in
Inetpub/ftproot
Revision 2
Catalog No.
Open the Window's Control Panel and Locate the Add or Remove Programs utility.
2.
From the Add or Remove Programs window, select the Add\Remove Windows
Components button.
3.
4.
Catalog No 1
Revision
P-CIM Node
HTTP Server/
IIS Server
Data Server
P-CIM Web
Client
Make sure that the Microsoft Message Queuing Service (MSMQ) is installed prior to
performing the following procedure.
1. From the P-CIM Development icons group, open the Database Editor application.
2. From the Database menu, select P-CIM History OLEDB Collector-Configuration.
3. Select the General Tab.
4. Check the Collect History to OLEDB check box.
10
Revision 2
Catalog No.
Catalog No 1
Revision
11
9. Select from the pull-down menu, the SQL database used as your data source; or if using
MS Access, navigate to the MDB file and type in the User name and Password.
10. Select either Use a Windows NT integrated security or Use a specific user name
and password as the authentication methods. If you select Use a specific user name
and password, use a user account with administrative rights to the database.
11. Click OK.
From the P-CIM Runtime menu, locate the Open Historian For SQL Server 2000
appears on the taskbar.
Click the icon. A status box with an identical icon is displayed at the left corner of the title
bar.
3.
Click the icon in the title bar and select Options. The Options dialog box appears.
4.
Enter the server and database names. Select either NT authentication or type in a
username and password.
5.
Optional Select either History Collection module will start collecting data on P-CIM
start-up or data will be collected in a single table.
6.
Click OK.
P-CIM Node
1.
12
Data Server
P-CIM Web
Client
Revision 2
Catalog No.
2.
Create or associate an application using P-CIM tools. P-CIM Web supports data from all
CALLBACK servers (DBSR, TXTSRV, BASICSRV, PFWDRVR etc.).
3.
Create your authorization scheme: create user names and passwords and assign
authorization level to application components.
4.
These steps are identical to creating a typical P-CIM for Windows application. Refer to the
basic P-CIM documentation (help files or training manual) for detailed instructions.
5.
Make sure that the network is enabled and that a node number and a fixed IP address are
assigned to the Server station. This step is necessary even if P-CIM is not networked.
As P-CIM 7.50, the P-CIM Web server is part of the P-CIM application.
Open the Database Editor application for the P-CIM Development icons group
Select the database type from the Provider tab. move to the Connection tab.
Navigate to the P-CIM database and either add a username and password with
access rights to the database, or check Use NT Integrated Security in order to
use a user account from the domain.
Catalog No 1
Revision
13
P-CIM Node
Data Server
P-CIM Web
Client
Once your application is effectively running on the P-CIM Web server, the next step is to pack
your project for Web distribution.
1.
2.
Select Pack Project for Web. P-CIM Setup displays the Pack Project for Web dialog box.
3.
Locate the Project you wish to pack, or click on the Default Project button to select the
default project.
4.
Using the Target Folder browse to locate the location where the packed project will be
placed. Alternatively, use the default path.
5.
Check Activate Basic Server on the P-CIM Web server to allow the remote Web client
access to the Basic Server that is located on the on-site P-CIM Web server.
6.
Check Activate Text File Serve on the P-CIM Web server to allow the remote Web
client access to the Text File Server that is located on the on-site P-CIM Web server.
7.
Click the Pack button; packing starts, wait until the packing has completed.
8.
Select from the Custom Pack Tab the project you want to pack. By default, all of the
components in the project are included in the Pack. You can custom configure which
components are to be included. The following list appears:
14
Revision 2
Catalog No.
9.
Select or deselect the components that you wish to include or exclude. In order to exclude
specific files from the pack, write the file's name in the text box. In order to exclude several
files, separate the names using comma.
Warning Do not pack the application into your HTTP root folder i.e., the folder that
contains the web pages that you publish. Packing the application into HTTP root folder may
cause irreparable damage to the project files.
10.
Type in the password needed to download the P-CIM Web client in the General Tab.
Passwords must contain at least 6 characters.
11.
Type in the IP address of the P-CIM Web Server computer in the P-CIM Web Server IP
Address box.
12.
Click the Local IP button to enter the IP Address of the computer where the P-CIM Web is
installed.
13.
Type in the URL of the HTTP server, from which to download the Operator Workstation,
including the source directory for the application files (e.g., http://user1/pcim/) into the
Operator Workstation URL field.
14.
To enter the URL of the computer where the P-CIM Web is installed, click the Local URL
button and type in the source directory.
15.
To include alarms in this application select the Alarm Tab and check the Include Alarm
Window Web Page check box.
Catalog No 1
Revision
15
16.
17.
If both the web server and the P-CIM Server are installed on the same computer, click
Local URL.
2.
3.
Type in the URL of the HTTP server, from which to download the History window.
4.
To enter the URL of this computer, click the Local URL button and type in the source
directory.
Warning To use Support Node Names Database option, you must create a SQL
Server database named PCIMNODES, including one table named PCIMNODES in both Alarms
and History SQL Server. Enabling this option without creating this database may cause pages to
display improperly.
5.
You may designate a separate URL for each module, if desired. In this case, the
Pack procedure automatically creates a separate target folder for each module
based on (i.e., with the same name as) the URL path.
16
Revision 2
Catalog No.
1. Open Windows Explorer. Navigate to the Pack Project folder of the project files. This
folder contains a subfolder Computername (i.e., the folder is given the name of the host
computer example: user1). This folder contains a subfolder for every project that is
packed for client download (example: pcim).
2. Navigate to the folder that represents the current project (in this example C:\PCIM32.PAK\PcimPath\user1\pcim). Copy the folder.
3. Navigate to the appropriate directory on the HTTP server
(Inetpub\wwwroot\targetfolder). Paste the contents of the folder to this directory (i.e.,
Inetpub\wwwroot\pcim).
Previous method of alarms collection in a DBF format is supported by P-CIM 7.50.
Catalog No 1
Revision
17
8. Type in the Target FTP Files Folder or browse to locate the destination directory. This
directory holds the project's files and is used for incremental download options.
18
Revision 2
Catalog No.
P-CIM Node
P-CIM Web
Server
Data Server
P-CIM Web
Client
Add the P-CIM Web site to the Internet Explorer's trusted sites list.
1.
From the main screen of Internet Explorer Tools, select Internet Options.
2.
From Internet Options Security, select the Trusted Sites icon and click on the Sites
button to add the URL of the site.
Ensure that Port 4000 is enabled in the router or firewall.
3.
Start Internet Explorer and go to the P-CIM main page (the URL that you specified in the
pack procedure). If the following message appears, click on the Yes button.
4.
Select Run this program from its current location and click OK. Confirm all security
dialog boxes.
5.
The P-CIM Site Installation starts automatically. Follow the Client setup procedure.
6.
After the Client setup procedure is finished, the following message appears instructing you
to close Internet Explorer. Click OK, to confirm. The Internet Explorer window closes.
Catalog No 1
Revision
19
7.
Reopen Internet Explorer. Go to the P-CIM page (as in step 2 above). The Application
setup process starts automatically. This procedure is similar to the P-CIM Client setup, but
this time it will install a project to the P-CIM Site software.
8.
During this installation, a dialog box appears prompting you to choose either a
Replacement installation or an Upgrade installation.
This prompt is only relevant if there has been a previous application downloaded onto this
computer.
Replace existing project indicates that all of the contents of the application folder at the
client location are replaced with the files contained in the current application download.
All existing files are deleted or replaced.
Upgrade existing project indicates that the files contained in the current application
download are added to the folder. Only files with the same names are replaced (by
updated ones). Existing files that are not included in the current download are left
untouched. The system administrator must inform the prospective Web client as to the
proper option.
9.
Choose the desired option and click Next. If this is the first Installation of a client the
Download Password dialog box appears:
10.
Type in the correct password and click OK. This completes the installation.
11.
After finishing the installation of the Application, a new web page opens indicating that the
application is ready for use:
20
Revision 2
Catalog No.
2.
Open the P-CIM for Web home page (URL) of your HTTP Server and proceed to page
pcimwebc.asp.
2.
Click the Operator Workstation button. (If Alarm and Historian collection modules are
not installed, this step is automatic.) The Operator Workstation opens and the Login
dialog box is displayed.
3.
Enter your P-CIM or Windows user name and password. The Operator Workstation
displays the home display. The client can now use the application in the same manner as
an on-site user.
Operator Workstation closes if you go to another page.
Catalog No 1
Revision
21
The right side of the page is the Alarm Log that displays the results of the query.
The criteria for creating a query are divided into five groups:
22
Revision 2
Catalog No.
Alarms Started at the following Period [Select a time period for the Alarms]
Show [Alarm Types]. This field defines the type of data that is to be included in the
display. The options are All Alarms (Default) or one of the following:
Open Alarms,
System Events..
Sorted by Options. These elements define the order in which the data is displayed.
There are two elements:
Sorted By on which attribute is the order based. The options are: Start Time, Node,
Block Name, Clear Time, and Description.
Alarms Started at the following Period. This option defines the time frames of the data
to be displayed. The options are one of the following:
From System Startup all the alarms that are stored in the database until the present.
From (Date/Time)/ To (Date/Time) the data that was generated within the specified
range. Default From time is current date/time minus two hours. Default To time is current
date/time.
Before n Hours the data generated from current date/time minus the specified number
of hours until the current date/time. This field accepts whole numbers (decimal values are
recognized as whole numbers truncated at the decimal point) and can represent
extended time periods (i.e., one week = 168 hours; 30 Days = 720 Hours, etc.).
Today After the Hour n the data that was generated on the current date beginning at
the specified hour until the current time. This field only recognizes whole numbers
between 0-23.
Generated by Block. This group defines which alarm generating blocks are included in
the query. The options are:
All Blocks
Block Named Like X the data generated by the group of blocks whose names contain
the specified string.
From [Node] This group defines whether the display includes data generated from all PCIM nodes that are generating data or from a single node only. The options are:
All Nodes
After all the query criteria are entered into the form, click on View Alarms to display the
Catalog No 1
Revision
23
specified data.
First page
Previous page
Next page
Last page
You can also jump to a specific page. To do this, type inr the desired page number into the Page
# field and click Enter.
24
Revision 2
Catalog No.
The criteria for creating a query are divided into four fields:
Data recorded in the following Period: Defines the time frames of the data to be
displayed.
Value. This field determines whether or not the results of your query are limited to
records of specific values.
Data Layout: This group does not deal with the parameters of the query but rather with
how the contents are displayed.
Data for Block X. This field identifies the history-collecting block that is to be featured in
the display. Select your choice from the dropdown list.
Data recorded in the following Period. This field defines the time frames of the data to
be displayed. The options are one of the following:
From System Startup all the historical data that is stored in the database until the
present.
From (Date/Time)/ To (Date/Time) the data that was generated within the specified
Catalog No 1
Revision
25
range. Default From time is current date/time minus two hours. Default To time is
current date/time.
Before n Hours the data generated from current date/time minus the specified number
of hours until the current date/time. This field accepts whole numbers (decimal values are
recognized as whole numbers truncated at the decimal point) and can represent
extended time periods (i.e., one week = 168 hours; 30 Days = 720 Hours, etc.).
Today After the Hour n the data that was generated on the current date beginning at
the specified hour until the current time. This field only recognizes whole numbers
between 0-23.
Value. This field determines whether or not the results of your query are limited to
records of specific values:
All Records means that the query results will include all historical data relating to the
specified block and time frame regardless of the recorded value.
Only Records with Value in this Range means that the query results will include only
historical data relating to the specified block and time frame that contain specific values.
The specifications can be some or all of the following:
Below Values less than or equal to the specified values are to be included.
Above Values greater than or equal to the specified values are to be included.
Between x and y Values equal to or within range of the specified values are to be
included.
Data Layout. This group does not deal with the parameters of the query but rather with
how the contents are displayed:
Show Status (Table layout only) By default, the results are displayed in a table
comprised of two columns: Date/Time and Value. If this option is checked, the display
includes a third column that refers to Status information that is part of each history
record. If this option is cleared, the third column is omitted.
View as Graph If this option is enabled, the query results are displayed as a twodimensional graph where the x-axis represents Date/Time and the y-axis represents
Value. Status data is not available in Graph layout.
Fixed Sample Time By default, the results are displayed on event intervals and not time
intervals. This means that the records are arranged in what seems like random time
intervals but are actually based on changes in value, status, or system startup.
This option allows you to set fixed time intervals for the query results. If enabled, the
system checks for the first recorded value for the specified block at the time frame
indicated earlier. It then displays that record and subsequent records in intervals of the
specified sample time. This is helpful if you wish to monitor trends at regular time
intervals, i.e. every 30 seconds, 60 minutes, 24 hours, etc.
The Sample Time specification has a quantity field and units field. The quantity field
accepts whole numbers. The units field allows a choice of Seconds, Minutes, or Hours.
From Record This option enables you to view the display beginning at a specified
record. This is helpful for queries that return results in a large quantity of records. For
example, suppose the results contain 10,000 records and you wish to view the display
beginning at record number 5,000. To do this:
1. Check the From Record option.
2. Type in the desired record number in the adjacent field.
26
Revision 2
Catalog No.
Catalog No 1
Revision
27
Technical Support
If you experience any problem with the software contact your distributor.
28
If you encounter problems contacting your distributor, fill in and send the online form on
the website. www.afcon-inc.com
Revision 2
Catalog No.