Configure High Availability
This section describes how to configure High Availability
(HA) for RTView EM. HA prevents the loss of data and alerts during failover.
HA requires two host machines, a Primary Host and a
Backup
Host. You configure HA by editing configuration files and defining two
environment variables on each host (PRIMARYHOST and
BACKUPHOST) with their IP addresses. It is required that identical versions of Enterprise Monitor be installed on the hosts.
The following figure illustrates the RTView EM components
that are the subject of this section.
To configure HA you setup the Primary and Backup
Hosts, verify your setup, test the failover process to the Backup Host and
verify the Primary Host is restored to the primary server for the pair.
At this
point you have:
To setup HA on the Primary and Backup Hosts:
1. Configure Alert
Notification Persistence on the Primary and Backup Host.
2. On each of the hosts in the HA pair, define
two environment variables: PRIMARYHOST and BACKUPHOST, which are loaded by the
property files on both Windows and UNIX.
3. On the Primary Host, rename the following
files as described:
| |
Rename the rtvservers.dat file,
located in
your
project directory/servers
directory, to rtvservers.dat.keep.
|
| |
|
|
| |
Rename the rtvservers-ha.dat
file,
located in
your
project directory/servers
directory, to rtvservers.dat.
|
4. Open the emcommon.properties file,
located in
your
project directory/conf
directory, in a text editor
and make the following edits under ALERT CONFIGURATION:
| a. |
Uncomment the following lines: |
| |
|
ConfigClient.sl.rtview.sql.sqldb=ALERTDEFS - - - __none - - -
ConfigClient.sl.rtview.sub=$rtvConfigDataServer:CONFIG_SERVER
ConfigClient.sl.rtview.alert.ssadataserver=CONFIG_SERVER
ConfigClient.sl.rtview.alert.actionauditdataserver=CONFIG_SERVER
ConfigClient.sl.rtview.alert.persistDataServer=CONFIG_SERVER |
| |
|
|
| b. |
Change alert persistence from false to true: |
| |
|
collector.sl.rtview.alert.persistAlerts=true |
| |
|
|
| c. |
Save and exit the file. |
5. From the Primary Host, copy the following files
to the Backup Host as described:
6.
On the Backup Host, in an
initialized command window
change directory (cd) to
your
project directory/servers
directory.
7.
Create a script file (for example, start_backup_servers.bat) to execute the following scripts to start
all RTView EM
processes:
| |
|
Windows |
| |
|
start_rtv central-backup |
| |
|
start_rtv rtvrules-backup |
| |
|
start_rtv rtvmgr-backup |
| |
|
start_rtv <packagename>-backup dataserver, where
packagename is the name of the Solution Package to execute under HA. Add one
line for each of the Solution Packages that the Backup Host must execute.
|
| |
|
| |
|
UNIX |
| |
|
start_rtv.sh central-backup |
| |
|
start_rtv.sh rtvrules-backup |
| |
|
start_rtv.sh rtvmgr-backup |
| |
|
start_rtv.sh <packagename>-backup dataserver, where
packagename is the name of the Solution Package to execute under HA. Add one
line for each of the Solution Packages that the Backup Host must execute.
|
8. Test
your HA
setup:
| a. |
On the
Primary Host, in an
initialized command window change directory (cd) to
your
project directory/servers
directory and start all RTView EM processes by typing:
|
| |
|
Windows |
| |
|
start_rtv all
|
| |
|
|
| |
|
UNIX |
| |
|
start_rtv.sh all
|
| |
|
| b. |
On the Backup Host, in an
initialized command window
change directory (cd) to
your
project directory/servers
directory and execute the script you created in the previous step. For example, if
you created the file start_backup_servers.bat previously, type: |
| |
|
start_backup_servers.bat |
| |
|
|
| c. |
On
the
Primary Host, start the Viewer by typing: |
| |
|
Windows |
| |
|
start_rtv viewer |
| |
|
|
| |
|
UNIX |
| |
|
start_rtv.sh viewer |
| |
|
|
| |
NOTE: You can also start
RTView EM in the Thin
Client. |
9. In the Monitor, open the JVM Process Views
/ All JVMs Heatmap display and verify that all JVMs on both hosts are
running. If all JVMs on both hosts are running, continue to next step. If not,
review previous configuration steps.
10. Verify that all RTView EM processes are
running on the Primary Host. Depending on the type of process, there are
different ways to verify:
| a. |
Back-End Servers |
| |
Open the RTView EM Architecure/System Overview display
and mouse-over the rectangle associated with the servers to view the IP address
of the host. |
| |
|
|
| |
NOTE: To view all data for all available Data Servers, open the RTView Servers/Data Servers display
and choose Connection (in the upper
combo box). The
Connection String column in the Connection Status table shows host names. |
| |
|
| b. |
Central Servers (Configuration Server and Alert Server and Directory) |
| |
|
Open the RTView EM Architecture / System Overview display, then
double-click in the Configuration Server or Alert Server and Directory
object to open the RTView DataServer - Summary display. See the Connection Status table Connection
String column to view the host name. |
| |
|
| c. |
Historian Servers |
| |
|
Open the RTView EM RTView Servers / Historian Servers display,
select the Source and Connection of your Historian from the
drop-down menus and verify the Primary Server light is green. |
11. Test failover to the Backup Host:
| a. |
Stop the Primary Host by either executing the
stop_rtv all script (or the
stop_rtv.sh all script for UNIX) on the Primary Host or shutting it down (briefly).
|
| |
|
|
| b. |
In the JVM Process Views / All JVMs
Heatmap display, verify that all JVMs on the Primary Host are shown as
inactive. |
| |
|
| c. |
Verify the Backup Host is currently acting as the
Primary Host by repeating Steps 9 and 10. |
12. Verify the Primary Host takes over as the
Primary Host:
| a. |
Stop the Backup Host by either executing the
stop_rtv all script (or the
stop_rtv.sh all script for UNIX) on the Backup Host or shutting it down (briefly).
|
| |
|
| b. |
On the
Primary Host, in an
initialized command window change directory (cd) to
your
project directory/servers
directory and start all RTView EM processes by typing:
|
| |
|
Windows |
| |
|
start_rtv all
|
| |
|
|
| |
|
UNIX |
| |
|
start_rtv.sh all
|
| |
|
|
| c. |
On the
Primary Host, start the Viewer by typing: |
| |
|
Windows |
| |
|
start_rtv viewer |
| |
|
|
| |
|
UNIX |
| |
|
start_rtv.sh viewer |
| |
|
|
| d. |
|
Repeat Steps 9 and 10 to verify that
all RTView EM processes are
running on the Primary Host. |
You have finished configuring High Availability.
|
