Wonderware Finland InBalance Module 4
Installation
Hardware requirements
The InBalance has the same hardware requirements as Wonderware Application Server.
It is strongly recommended to have computer with 2 gigahertz (GHz) or faster processor,
32/64-bit. A multi-core processor is also strongly recommended. The Intel Itanium 2 processor is not supported.
Software requirements
The following software should be installed prior to InBalance installation:
- Wonderware Application Server 3.1 SP1 or later
- Wonderware InTouch 10.1 or later
- Wonderware Historian (InSQL) 9.0 or later
- Wonderware ActiveFactory 9.2 or later
- MS Office 2003 or later
Licensing requirements
The InBalance requires either a
software key
or a
demo license
. As well it can be licensed under
License Server
in case InBalance is delivered as a part of Wonderware
Finland
Automation Intelligence Suite
package.
The
demo license
is for free and provides an unlimited functionality, but is valid only for a limited time period. After demo license expiration the mass balance calculation request will be rejected (it still will be possible to use the Model Editor). The demo license can be obtained by sending inquiry to [email protected]
.
The
software key
should be purchased and it is available for 4 product levels (xxx is the current version of InBalance release, e.g. 103):
- Product ID: PR00161 xxx (maximum 10 streams);
- Product ID: PR00162 xxx (maximum 50 streams);
- Product ID: PR00163 xxx (maximum 100 streams);
- Product ID: PR00164 xxx (unlimited number of streams).
Models with maximum 3 streams do not require licensing.
See
Configuring Calculator
section for details how to get and enable software key or demo license or how to enable the licensing under License Server.
InBalance Ver 1.x User Manual Rev 1.4 PR0016xm14
Wonderware Finland InBalance Module
Files
The InBalance is delivered as an archive file (.zip) and contains the following files:
- PR0016xm14.pdf
– User Guide (this document);
- PR0016xSG10.pdf
– Security Guide;
- IBObjects.aaPKG
– contains InBalance objects;
- IBManual.xml
– demo model, using manually entered data;
- IBHist.xml
– demo model, using simulated data from Historian database;
- IBDensity.xml
– demo model for gas pipeline leak location detection;
- IBReport.xls
– simple mass balance demo report;
- IBHistorianData.zip
– contains simulated Historian data for IBHist.xml demo model.
5
Installation steps
1. Unpack the archive file to e.g. C:/InBalance folder.
2. Start the ArchestrA IDE and import the IBObjects.aaPKG file to a new/existing galaxy.
In the following explanation we will assume that a new galaxy IBDemo is used.
3. Configure WinPlatform_001 object
– set Network address field to your PC hostname or
IP Address:
InBalance Ver 1.x User Manual Rev 1.4 PR0016xm14
Wonderware Finland InBalance Module
4. Configure Historian field for WinPlatform_001 and AppEngine_001 if you will use second model (IBHist.xml) that uses Historian data:
6
Save the configuration by clicking on the icon , located at the top right corner of the configuration editor.
Save the configuration by clicking on the icon , located at the top right corner of the configuration editor.
InBalance Ver 1.x User Manual Rev 1.4 PR0016xm14
Wonderware Finland InBalance Module
5. Deploy all InBalance objects
– right-click and deploy WinPlatform_001:
7
The following steps are required only if you intend to work with the demo model
IBHist.xml. Proceed with step 10, if this demo model will not be used.
6. Backup your InSQL data (default location is C:/InSQL/Data/Circular folder), if required.
InBalance Ver 1.x User Manual Rev 1.4 PR0016xm14
Wonderware Finland InBalance Module 8
7. Delete the contents of the C:/InSQL/Data/Circular folder.
8. Extract InBalance simulated InSQL data from IBHistorianData.zip archive (included in
InBalance installation package) to your InSQL data folder (default location is
C:/InSQL/Data/Circular).
9. Start the Historian server if it is not started already.
10. In order to work with the demo report by clicking the
“Report” button in the InTouch application, copy the IBReport.xls file to the following folder:
C:\Documents and Settings\
[logged user name]
\Application
Data\Microsoft\Excel\XLSTART\
For example:
C:\Documents and Settings\
gr
\Application Data\Microsoft\Excel\XLSTART\
Adjusting demo project for your own model
After importing the IBObjects.aaPKG file, the galaxy contains objects adapted for work with the demo models. These model-specific features should be disabled or adapted for working with
your own model
. Below is a description of these features:
1) After importing the IBObjects.aaPKG file, the galaxy contains template $IBArea, derived from the base template $Area and supplemented with scripts for demo models.
The instance IBArea_001 is derived from this $IBArea template and should be used when performing the calculation for demo models. Delete or modify the scripts in the $IBArea template (or, alternatively, derive a new template from base template $Area, which will not contain any scripts) before performing calculation for your own model.
2) After importing the IBObjects.aaPKG file, the galaxy contains template
$DataGenerator, derived from the base template $UserDefined and supplemented with data generation scripts. The instance “dg” is derived from this $DataGenerator template and generates data for demo model IBHist.xml. Delete or modify the template
$DataGenerator and instance “dg”, before performing calculation for your own model.
3) After importing the IBObjects.aaPKG file, the galaxy contains InTouch application template $InBalance, derived from the base template $InTouchViewApp. $InBalance uses
ArchestrA symbols TotalMassAllTimePeriod1 and RecDataAllTimePeriod . These symbols are used to display the calculation results for demo models IBManual.xml and
IBHist.xml, and should be edited before using them for your own model.
4) IBReport.xls file is used to display the report for demo models IBManual.xml and
IBHist.xml, and should be edited before using it for your own model.
5) After importing the IBObjects.aaPKG file, the galaxy contains template
$GasManualHistory, supplemented with
UDAs. The instance “mg” is derived from this
$GasManualHistory template and generates data for demo model IBDensity.xml.
InBalance Ver 1.x User Manual Rev 1.4 PR0016xm14