Remote Automation Solutions Guide: OpenEnterprise Maintenance Reference Guide Manuals & Guides
Reference Guide
D301512X412
April 2012
OpenEnterprise Maintenance
Reference Guide (V2.83)
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D301512X412
April 2012
OEMaintenance
Contents
1 OpenEnterprise Maintenance Manual ...................................................................................1
1.1 Documenting all work done on the system: ........................................................................1
1.2 Caring for the Historical:......................................................................................................1
1.3 Caring for Bristol licenses: ..................................................................................................1
1.4 Security: ..............................................................................................................................1
1.5 Growing the OE system:.....................................................................................................1
1.6 Troubleshooting: .................................................................................................................2
1.7 Maintaining a System Changes Log ...................................................................................2
1.7.1 Who Should Perform This Procedure?.........................................................................2
1.7.2 Creating the System Changes Log (1st time only) .......................................................2
1.7.3 Maintaining the System Changes Log..........................................................................2
1.8 Using OEHook ....................................................................................................................2
1.8.1 OE Hook Setup Procedure:..........................................................................................3
1.9 Archive File Tool Symbols ..................................................................................................3
1.10 Moving Files Online/Offline..............................................................................................3
1.10.1 Who Should Perform This Procedure?.....................................................................3
1.10.2 Before You Begin......................................................................................................3
1.10.3 Bringing an Offline Archive File Online .....................................................................3
1.10.4 Taking Files Offline ...................................................................................................4
1.11 Removing Archive Files...................................................................................................4
1.11.1 Who Should Perform This Procedure?.....................................................................4
1.11.2 Before You Begin......................................................................................................4
1.11.3 Removing unwanted Archive files from the server....................................................4
1.11.4 Removing unwanted Event files from the server ......................................................5
1.12 Restoring Archive Files....................................................................................................5
1.12.1 Who Should Perform This Procedure?.....................................................................5
1.12.2 Before You Begin......................................................................................................5
1.12.3 Restoring Offline Archive Files from Backup Media or a different Server.................6
1.13 Maintaining a Workstation License..................................................................................6
1.13.1 OEGraphics (ICONICS GraphworX32) Licensing – things you sho uld NOT do…...7
1.13.2 OEGraphics (ICONICS GraphworX32) Licensing – things you CAN do…............... 7
1.14 How to Kill a Workstation License...................................................................................9
1.14.1 Who Should Perform This Procedure?.....................................................................9
1.14.2 Before You Begin......................................................................................................9
1.14.3 Removing an OE Graphics License..........................................................................9
1.15 OpenEnterprise Workstation License Replacement Request.........................................9
1.16 How to use the Bristol License Manager.......................................................................10
1.16.1 Who Should Perform This Procedure?...................................................................10
1.16.2 Before You Begin....................................................................................................10
1.16.3 Where is the Bristol License Manager? ..................................................................10
1.16.4 Create a LRF file.....................................................................................................10
1.16.5 Get Key ...................................................................................................................11
1.16.6 Include Key..............................................................................................................11
1.17 Adding a New User to the System.................................................................................11
1.17.1 Who Should Perform This Procedure?...................................................................11
1.17.2 Before You Begin....................................................................................................11
1.17.3 Adding a New User to an existing Group................................................................11
- i -
Reference Guide
D301512X412
April 2012
Disabling a User's Account............................................................................................12
1.18
1.18.1 Who Should Perform This Procedure?...................................................................12
1.18.2 Before You Begin....................................................................................................12
1.18.3 Disabling a User's Account .....................................................................................12
1.19 Removing a User...........................................................................................................12
1.19.1 Who Should Perform This Procedure?...................................................................12
1.19.2 Before You Begin....................................................................................................12
1.19.3 Removing a User ....................................................................................................12
1.19.4 Sometimes you can't delete a user… .....................................................................13
1.20 Adding an RTU..............................................................................................................13
1.20.1 Who Should Perform This Procedure?...................................................................13
1.20.2 Before You Begin:...................................................................................................13
1.20.3 Adding an RTU:.......................................................................................................13
1.21 Deleting an RTU............................................................................................................14
1.22 Adding one or more signals to the OE Database..........................................................14
1.23 Deleting one or more signals from the OE Database....................................................15
1.24 Version Mismatches - What are they?...........................................................................15
OEMaintenance
2 Index .......................................................................................................................................16
- ii -
Reference Guide
D301512X412
April 2012
OEMaintenance
1 OpenEnterprise Maintenance Manual
This user documentation is provided as a task-driven guide for OpenEnterprise SCADA system
engineers who are responsible for maintaining a configured OpenEnterprise project.
1.1 Documenting all work done on the system:
1) How to create and maintain a system log file.
2) What is OEHook and how to configure it?
1.2 Caring for the Historical:
1) What do the symbols in archive file manager indicate?
2) How to move archive files online/offline
3) Removing archive files from the online folder manually.
4) Restoring Archive files from Back up media
1.3 Caring for Bristol licenses:
1) Dos and Don’ts for maintaining a workstation license.
2) How to kill a workstation license.
3) How to request a workstation license that has been broken - USA.
4) Using the Bristol License Manager.
1.4 Security:
1) Adding a New User to the System
2) Disabling a User
3) Removing a User
1.5 Growing the OE system:
1) Adding /Removing an RTU
a) Adding an RTU
b) Deleting an RTU
Adding/Removing Signals to the database
2)
a) Adding signals to the Database
b) Deleting signals from the Database
- 1 -
Reference Guide
D301512X412
April 2012
OEMaintenance
1.6 Troubleshooting:
1) Version Mismatches
1.7 Maintaining a System Changes Log
Maintaining a system changes log is a recommended practice. Any time you make a significant
change to the system (adding new hardware, installing new software, adding/deleting RTUs or
signals, etc.) you should make note of the change in the system changes log.
1.7.1 Who Should Perform This Procedure?
A System Engineer should perform this procedure.
1.7.2 Creating the System Changes Log (1st time only)
Follow these steps to create a System Changes Log:-
1. On the OpenEnterprise Server, open an empty text file in Notepad, and enter the text: .LOG
in UPPERCASE on the first line of the file, and press the [Enter] key to add a carriage return.
2. Save the System Changes Log file with the name server_name.TXT where server name is
the name of your OpenEnterprise Server. Exit Notepad.
3. Re-start Notepad, and open the file you just created. Verify that the current date and time
have been added to the file. This will happen each time you edit the log, thus maintaining a
record of when you make system changes.
4. In Windows™ Explorer, create a shortcut for it by right-clicking on its icon, and choosing
"Create Shortcut" from the pop-up menu; drag the shortcut onto the Windows™ desktop.
5. Rename the shortcut to 'System Log'.
6. Drag the shortcut to the Windows™ Start button (this will add it to your Start menu.)
1.7.3 Maintaining the System Changes Log
Follow these steps to maintain the System Changes Log:-
1. Each time you make significant changes to the system; call up the System Changes log file
you created above, either through the shortcut, or from the Windows™ Start menu.
2. Make notes describing your changes, and save the file.
1.8 Using OEHook
The oehook.dll is a simple utility for Windows, which will log all program starts within Windows to the
file C:\oehook.txt, with timestamps. Once installed, it will monitor all attempts to open files within
Windows.
It can also (optionally) be configured to prevent any program being run for more than a specific
number of instances.
To do this the file oehook.ini should be placed in the Windows directory (typically C:\Windows or
C:\Winnt). It should contain an entry for each program you wish to control, as per the following
example:
[D:\Program Files\Bristol\OpenEnterprise\bin\rtrdb.exe]
- 2 -
Reference Guide
D301512X412
April 2012
OpenCount=1
(Where OpenCount indicates the maximum number of instances that may exist)
If the utility prevents the starting of a program, it will indicate the system is out of memory, rather than
indicating the actual reason.
Note: Setting an OpenCount=0 will prevent the program from running!
OEMaintenance
1.8.1 OE Hook Setup Procedure:
1. Unzip the files to the BBIUtil folder.
2. Simply double click on the setup.bat file to install
1.9 Archive File Tool Symbols
1. Archive files marked with a blue check with an “A” have been brought online automatically.
2. Files marked with just a blue check have been brought online manually.
3. Files marked with a red X are currently offline and will need to be brought online to view the
data.
4. Files marked by a paper with a red X indicates that the file is currently unavailable.
1.10 Moving Files Online/Offline
Data in archive files is only accessible when the archive file is online, however, only a certain number
of archive files can be kept online at the same time. Therefore, if you need access to an archive file
that is offline, you may need to bring it online, and then subsequently take it offline.
1.10.1 Who Should Perform This Procedure?
A System Engineer should perform this procedure.
1.10.2 Before You Begin
1. You must have privileges to work with Archive Files.
2. The OE Database must be running.
3. The Archive File Tool (accessible from the "Archive Files" item in the OE Toolbox) must be
running.
4. A program which supports the Archive File Tool (called OEArchiveFileManager.EXE) must be
running. Normally it is started automatically as part of the OpenEnterprise Session, but if you
haven't configured the Session Manager yet, you'll need to start it manually from the
/Bristol/OpenEnterprise/bin folder.
1.10.3 Bringing an Offline Archive File Online
1. In the Archive File Tool, offline archive file names are preceded with a red X.
2. In the Archive File Tool, highlight the file or group of files to be brought online, and then click
on the [Bring Online] button.
3. A message box will appear, asking you to confirm that you want to bring this Archive File
online. Click [Yes].
- 3 -
Reference Guide
D301512X412
April 2012
4. The Online Properties dialog box will appear. First, choose the Archive File you want to bring
online.
5. You need to choose how long you want this Archive File to remain online.
a. "Indefinitely" the file will remain online until you manually take it offline.
b. "For" you can specify a time for which the archive file will remain online
c. "Until", you can specify a date and time for which the Archive File will be taken
offline by the system.
6. Click on [OK] and the Archive File will be brought online.
7. You will notice that the file will now be preceded with a blue check.
OEMaintenance
1.10.4 Taking Files Offline
1. In the Archive File Tool files that were brought on line manually are preceded with a blue
check.
2. To take any of these files offline highlight the file or group of files and then click on the [Take
Offline] button.
3. You will notice the file will now be preceded with a red X.
1.11 Removing Archive Files
As archive files are produced, there may come a time when some of the older files need to be
removed from the server to make room for more archives. The following procedure will need to be
performed if this is the case.
1.11.1 Who Should Perform This Procedure?
A System Engineer should perform this procedure.
1.11.2 Before You Begin
1. You must have privileges to work with Archive Files.
2. The OE Database must be running.
3. The Archive File Tool (accessible from the "Archive Files" item in the OE Toolbox) must be
running.
4. A program which supports the Archive File Tool (called OEArchiveFileManager.EXE) must be
running. Normally it is started automatically as part of the OpenEnterprise Session, but if you
haven't configured the Session Manager yet, you'll need to start it manually from the
/Bristol/OpenEnterprise/bin folder.
1.11.3 Removing unwanted Archive files from the server
1. Remove old realanalog archive files from the online folder
Create a list or lists of archive files that are no longer available. These are files in the
2.
archive file tool that appear to have a paper with a red X in the middle.
The following sql statement will create a list of the archive filenames that are
3.
unavailable from realanalog group 1 with a rate of 0s:-
- 4 -
Loading...