This section describes the rtvservers.dat configuration file which is used to manage your RTView EM deployment and RTView EM processes. This section includes:
The rtvservers.dat text file, located in your project directory/servers directory, contains one or more RTView EM configurations. An RTView EM configuration might include any of the following: Data Server, Historian, HSQLDB database, and either a Display Server (for a Web Deployment) or a Display Viewer (for a Desktop Deployment). The rtvservers.dat file is used when the following scripts are executed:
start_rtv Starts RTView EM processes specified in the rtvservers.dat file.
stop_rtv Stops the RTView EM processes specified in the rtvservers.dat file.
status_rtv Returns status information for RTView EM processes specified in the rtvservers.dat file.
The following rtvservers.dat file contains a single RTView EM configuration, named default, for a Web deployment.
default . dataserver rundata
default . historian runhist -ds
default . displayserver rundisp -ds
default . database rundb
NOTE: The last line in the rtvservers.dat file must end with a new line, or be followed by a blank line.
In this example, to start the default configuration type: start_rtv default or start_rtv all. To start a single server in the configuration, type start_rtv <Configuration Name> <Server Name>. For example: start_rtv default displayserver.
Each line has the following format consisting of four fields:
<Configuration Name> <Project Settings Directory Location> <Property Filter Identifying the Server> <Command>
|
<Configuration Name> |
The name of the RTView EM configuration (default in this example). |
|
<Project Settings Directory Location> |
The RTView EM project settings directory location, relative to the location of the rtvservers.dat file (., the current directory, in this example). |
|
<Property Filter Identifying the Server> |
The property filter that identifies the server, which is the property filter under which the server’s JMX port is defined. By default, this is the server name, such as dataserver, displayserver and historian. |
|
<Command> |
The script used to start the process. Valid values are:
|
When multiple configurations are specified in the rtvservers.dat file and they have different project settings directory locations, the all argument processes all the configurations. However, if the configurations have the same project settings directory locations, the all argument processes only the first configuration as the others are considered alternative configurations. Alternative configurations allow you to alternate between two configurations for a single RTView EM deployment.
For example, the following rtvservers.dat file contains two configurations, bwmon and emsmon. Note that the project settings directory locations differ (./bwmon and ./emsmon, respectively).
bwmon ./bwmon dataserver rundata
bwmon ./bwmon historian runhist -ds
bwmon ./bwmon displayserver rundisp -ds
emsmon ./emsmon dataserver rundata
emsmon ./emsmon historian runhist -ds
emsmon ./emsmon displayserver rundisp –ds
Because the project settings directory locations differ, you can use type start_rtv all to start both configurations. To start only the bwmon configuration, type: start_rtv bwmon. To start a single server in the bwmon configuration, type start_rtv <Configuration Name> <Server Name>. For example: start_rtv bwmon displayserver.
The following illustrates an rtvservers.dat file with an alternate configuration: desktop is for a Desktop Deployment and browser is for a Browser Deployment. Note that the project settings directory locations are the same (./bwmon for both). This rtvservers.dat file allows you to switch between a Web Browser and a Desktop Deployment.
desktop ./bwmon dataserver rundata
desktop ./bwmon historian runhist -ds
desktop ./bwmon viewer runv -ds
browser ./bwmon dataserver rundata
browser ./bwmon historian runhist -ds
browser ./bwmon displayserver rundisp -ds
When the rtvservers.dat file contains an alternate configuration as this example does, the all argument processes only the first configuration, in this case, the desktop configuration. To process the second configuration type: start_rtv browser.