E-Terracontrol 3.9 Reference Manual - Introduction and Configuration
E-Terracontrol 3.9 Reference Manual - Introduction and Configuration
This document describes the system overview, modeling, and configuration activities for
e-terracontrol.
NOTE: CONTAINS PROPRIETARY INFORMATION OWNED BY ALSTOM GRID INC. AND/OR ITS
AFFILIATES. DO NOT COPY, STORE IN A RETRIEVAL SYSTEM, REPRODUCE, DISTRIBUTE,
TRANSMIT OR DISCLOSE TO ANY THIRD PARTY WITHOUT PRIOR WRITTEN PERMISSION FROM
ALSTOM GRID INC.
__________________________________________________________________
Trademarks
“ESCA” and “HABITAT” are registered trademarks of ALSTOM Grid Inc. “eterra” is a registered
trademark and/or service mark of E-Terra, LLC, licensed for use by ALSTOM Grid Inc. in connection with
its e-terra family of products and services.
Other product and company names in these materials may be trademarks or registered trademarks of
other companies, and are the property of their respective owners. They are used only for explanation and
to the respective owners’ benefit, without intent to infringe.
Contents
About This Document ................................................................................................ v
Purpose of This Document ............................................................................................ v
Who Should Use This Document .................................................................................. v
Structure of This Document .......................................................................................... v
For More Information..................................................................................................... v
Conventions ................................................................................................................. vii
Change Summary ....................................................................................................... viii
1. Overview ................................................................................................................. 1
1.1 e-terracontrol Software Product Footprints ............................................................. 1
1.1.1 Plant Data Interface ........................................................................................... 2
1.1.2 Substation Data Server ...................................................................................... 3
1.1.3 Substation Gateway ........................................................................................... 4
1.1.4 Small SCADA Master ......................................................................................... 5
1.1.5 e-terraplatform SCADA Front End Processor .................................................... 6
1.1.6 Typical EMS System Overview .......................................................................... 7
1.2 e-terracontrol Architecture ...................................................................................... 8
1.2.1 e-terracontrol User Interface.............................................................................. 8
1.2.2 Localization ........................................................................................................ 9
1.2.3 e-terracontrol Applications ................................................................................. 9
1.2.4 e-terracontrol Object Data Model .................................................................... 10
1.2.5 e-terracontrol Interfaces .................................................................................. 10
Figures
Figure 1. e-terracontrol’s Versatility for Multiple Applications .......................................... 1
Figure 2. e-terracontrol as a Plant Data Interface ........................................................... 2
Figure 3. e-terracontrol for a Substation Data Server ...................................................... 3
Figure 4. e-terracontrol as a Substation Gateway ........................................................... 4
Figure 5. e-terracontrol as a Small SCADA Master ......................................................... 5
Figure 6. e-terracontrol as an e-terraplatform SCADA Front End Processor................... 6
Figure 7. Typical EMS System Overview ........................................................................ 7
Figure 8. Overview of e-terracontrol’s Internal System.................................................. 11
Figure 9. Remote Client Logon Dialog Box ................................................................... 31
Figure 10. e-terracontrol Redundancy and Failover ...................................................... 32
Figure 11. e-terracontrol Crash Dialog Box ................................................................... 34
Figure 12. Doctor Watson User Interface ...................................................................... 35
Conventions
The following conventions are used throughout this document. Commands that are
particular to an operating system are shown with the corresponding prompt symbol.
Command Prompts
Operating Prompt Description
System
Linux % All commands preceded by a percent sign prompt
(%) are issued from a Linux terminal window. Note
that all Linux commands are case sensitive.
Windows > All commands preceded by a greater than sign
prompt (>) are issued from a Windows command
line window.
All Operating The absence of any prompt character before a
Systems command indicates that the command is valid on
all operating systems.
Command Strings
Operating Delimiter Description
System
Linux Italics Text in italics indicates information you must
supply. (*)
Linux [] Text enclosed in square brackets "[ ]" indicates
optional qualifiers, arguments, or data. (*)
All Operating Select When used in command strings, the term “Select”
Systems means placing the pointer over the specified item
and pressing the left (default) mouse button.
(*) Note: All Linux commands are case sensitive and must be typed exactly as
shown.
The next few topics examine each of these functions, one by one.
Note: The Digi/port expander needs to have network isolation (that is, be separate
from the EMS network) to ensure timely communications.
1
Specifically, the Electric Power Research Institute’s (EPRI) Research Project RP3599 (“Substation
Integration Protection, Control, and Data Acquisition”).
Note that the user interface application is not packaged within the e-terracontrol
installation kit. It is not required that you install e-terrabrowser on the e-terracontrol
servers, but most systems are configured this way.
Other notes:
• Restart the computer whenever requested by the setup programs.
• Sometimes, the installation program(s) encounter a read-only file and ask what you
want to do. In these cases, be sure to overwrite existing files.
• Prior to upgrading an existing installation of the e-terracontrol product, make and
save copies of software license files, configuration files, and databases.
• Before you install e-terracontrol, you must un-install any previous version.
• Run e-terracontrol.exe and follow the instructions on the screen.
Note: Although this “tour” guides you through the basic functionality of e-terracontrol
and e-terrabrowser, it does not go into the complete depth that is necessary for full
mastery. To gain further knowledge of these programs, refer to the detailed content in
the e-terracontrol Reference Manual set.
3.2.2 Alarms
Alarms can provide a visual and auditory warning when a measurement goes above or
below a certain level, when a breaker changes status, or in any of several other
situations.
In this section, we set up an alarm to make a sound when the status of a breaker
changes.
3.2.2.1 Setup
Make sure that the SCADA server, the e-terrabrowser client, and the Kirkland Simulator
are all still running.
3.2.3.1 Setup
Make sure that the SCADA server, the e-terrabrowser client, and the Kirkland Simulator
are all still running.
3.2.3.2 Access the Analog Trends from the Measurements Tabular Display
To access the analog trends from the Measurements tabular display:
1. In an e-terrabrowser client display, click the Measurements List toolbar button, then
select Kirkland from the Stations drop-down menu.
2. Scroll down to the Kirkland Ln_540 Mw measurement. Then scroll to the right, and
click the Trend Analog button on the far right.
A graph should pop up in the bottom portion of the window, showing the activity of
the measurement.
As you change values in the Kirkland Simulator, you should see those changes
reflected in Modbus/SMP.
– Open and close breakers in the Kirkland Simulator and watch the Modbus
Reader.
After a slight delay, you should see the values in the Status Scan group change.
– Verify that the Modbus Reader is communicating with e-terracontrol.
∗ In the e-terrabrowser Viewer, go to the Martdale Station display. Use the
same method you used for the Kirkland Station display.
∗ Open and close breakers in the Kirkland Simulator and watch the Martdale
Station display. After a slight delay, you should see the breakers in the
Martdale Station display change.
You have now completed the main portion of this guided tour.
Note: The success of this particular demonstration may depend on how long the
SCADA server and the Kirkland Simulator have been running, because these two
programs are the co-creators of sample historical data.
1. From the e_terracontrol > Samples start menu, start the 60 Bus Measurement
History application.
– The database name and the directory should say “esca60” and
“…\e_terracontrol\samples”, respectively. If they do not, use the Browse button to
find the esca60 history file.
– The Ending field should read the current time and date. If it does not, enter the
current time and date.
– Change the “for” time to 30 minutes.
2. Select the Status radio button, and click Get Names. This should bring up the status
measurements from every station.
By clicking in the message window and pressing the K key, the list automatically
scrolls to the first status beginning with the letter “K”.
From there, you can use the scroll bar, use the arrow keys, or continue typing the
desired status name.
3. From the list, find and select Kirkland 540c Bkr (nothing actually happens when you
select this item, it simply becomes highlighted).
4. To view the history for this status measurement, click Get History.
5. Select the Analog radio button and click Get Names.
6. Select Kirkland 540 Mw, and click Get History. This should represent the megawatt
fluctuations associated with the tripping of the breaker.
According to the arguments used to configure the exception handler, the following files
may be present in the directory shown by the pop-up dialog box of the exception
handler:
• ApplicationName_MM-dd-YY_hh-mm-ss.managed.log:2 This file contains
information regarding a managed exception, and also information regarding the state
of the process when the exception has been caught. This file should always be
present.
• ApplicationName_MM-dd-YY_hh-mm-ss.unmanaged.log:2 This file contains
information regarding a potential unmanaged exception. If the exception occurs in
the managed part of the application, this file may not exist or may contain no
information at all.
• ApplicationName_MM-dd-YY_hh-mm-ss.managed.dmp:2 This file is a dump file;
it does not contain any readable information unless you use a specific tool such as
WinDbg. This file is only generated if the dump file option is enabled and if the
exception handler has enough information to generate it. Information captured in this
file is relative to the managed part of the application.
• ApplicationName_MM-dd-YY_hh-mm-ss.unmanaged.dmp:2 This file is a dump
file; it does not contain any readable information unless you use a specific tool such
as WinDbg. This file is only generated if the dump file option is enabled and if the
exception handler has enough information to generate it. Information captured in this
file is relative to the unmanaged part of the application. In particular, this file may
contain useful information regarding an unmanaged exception (such as an exception
occurring in an ActiveX control, for example).
By default, the directory of these files should be a subdirectory of the
eterra\e_terraControl\log directory.
2
“ApplicationName” is the name of the application; for example, with CFEReader.exe, “ApplicationName”
is “CFEReader”. MM represents the current month (01 is January and 12 is December). dd represents the
day (from 01 to 31). YY represents the year (04, 05, and so on). hh-mm-ss represents the time of the
crash, with hh as the hour (from 0 to 23), mm as the minute, and ss as the second.
Caution: A modal dialog box can prevent your process from being restarted by the
Process Starter. If you want to avoid this situation, first configure your system to use
Doctor Watson as your default debugger, and then configure your system not to show
a modal dialog box after a crash.
To enable Doctor Watson, you can simply enter the following line as a run command:
drwtsn32 –i
Remember to clear the Visual Notification check box.
Note: The modal dialog box issued by Doctor Watson may not be visible if the
process that crashed was started from the Process Starter as “not visible” (the option
was unchecked).
5.1 Logging
Our systems have grown more distributed and more complex over the years. Along with
complex installations that include multiple sets of front-end processors, new features
and the widespread adoption of multi-datacenter EMS environments have increased the
management burden required to ensure the health of these environments.
As part of the effort to standardize logging across e-terra products, e-terracontrol
produces log messages and writes them to the Windows Event Log. e-terracontrol
writes the messages under the e-terra\Operational channel (summarized as logging
channel). The Instrumentation manifest file is an XML file that contains the elements
that identify the logging provider. e-terracontrol delivers manifest files for the
applications that log in the logging channel. The manifest files have the extension
“.man”.
Each message written to the Windows Event Log can be identified by a unique event
ID. The logging functionality is enabled by default and applications that support the
Windows Event Log will automatically write log messages to the logging channel.
The Monitoring Service Listen Port is the server port opened by the monitor
application.
• For all other applications, enable the monitoring functionality through the command
line argument plus the listening port number.
– Scada: “/ENABLEMONITORING /MONITORING_PORT 9091”
– Isd: “/ENABLEMONITORING /MONITORING_PORT 9091”
– Cfereader: “ENABLEMONITORING MONITORING_PORT=9091”
– AlarmPager: “/ENABLEMONITORING /MONITORING_PORT 9091”
– OpcClient: “/ENABLEMONITORING /MONITORING_PORT 9091”
– xx2smp: “-h –j 9091”
– OpcServer: “/ENABLEMONITORING /MONITORING_PORT 9091”