Setup
Following
installation, you will need to setup your environment to run Enterprise
RTView. If necessary, contact your system administrator for assistance.
Depending
on which
data sources
are licensed in your Enterprise RTView application, additional setup may be
required. For information on setup
for your data source, refer to the
Data Sources section of this
documentation. If you will be using the Oracle Coherence Monitor, refer to the System
Requirements and Setup for the Oracle Coherence Monitor.
Once setup is complete, please refer to the Registration
section for instructions on how to obtain a license key.
Setup Environment
Append the following to the PATH environment variable:
| Name |
Description |
Example |
| <java installation directory>\bin |
The bin subdirectory of the Java installation
subdirectory. |
c:\Program Files\Java\jdk1.5.0_01\bin |
Set RTV_HOME Locally or Globally
Use the following initialization scripts to set the RTV_HOME environment
variable and append RTV_HOME\bin to the PATH environment variable.
-
On Windows,
open a Command Prompt window, go to your installation directory, and type
rtv_init.
-
On UNIX,
open a terminal window, go to your installation directory and type source
rtv_init.
NOTE:
You must type rtv_init or source rtv_init in each command
window you open.
Alternatively,
you may set RTV_HOME and append RTV_HOME\bin globally. NOTE: In order to use shortcuts
(available in the Shortcuts directory) the environment variable
RTV_HOME must be set globally on your system and RTV_HOME\bin must be included
in your PATH environment variable. Shortcuts are available for use on Windows
platforms only.
| Name |
Description |
Example |
| RTV_HOME |
Enterprise
RTView
installation directory. Set locally with rtv_init (or source
rtv_init) script. If you installed Enterprise RTView using the Windows
installer, this may already be set globally on your system. |
c:\gms |
| Append
the following to the PATH environment variable: |
| RTV_HOME\bin |
Enterprise
RTView
subdirectory containing scripts and executables. Set locally with rtv_init
(or
source
rtv_init) script. |
c:\gms\bin |
Include lanscan in PATH Environment
Variable (HP users only)
If the
hostid script is not available on your system, HP users must
include the location of lanscan in their PATH environment variable. The standard location is
/usr/bin.
RTV_USERPATH
Java
options specified in
RTV_USERPATH will be added to the classpath by all of the Enterprise
RTView run scripts. These options are also used when Enterprise RTView
applications are run from the Windows Start menu:
| Name |
Description |
Example |
| RTV_USERPATH |
Java options. These will be passed
into the java process from the Enterprise RTView run scripts. These are also
used when Enterprise RTView applications are run from the Windows
Start menu. This environment variable is optional. |
c:\mycustomjars\myjar.jar |
RTV_JAVAOPTS
Java
options specified in
RTV_JAVAOPTS will be used by all of the Enterprise
RTView run scripts. These options will not be used when Enterprise RTView
applications are run from the Windows Start menu:
| Name |
Description |
Example |
| RTV_JAVAOPTS |
Java options. These will be passed
into the java process from the Enterprise RTView run scripts. These will
not be used when Enterprise RTView applications are run from the Windows
Start menu. This environment variable is optional. |
-verbose |
Specify the name of a directory, including path, for initialization (.ini)
files to be saved to and read by the Display Builder, Display Viewer, Display
Server, Data Server and Historian.
-Dcom.sl.rtview.optionsFileDir=(directory)
If no directory is specified and initialization files are not found in the
directory where you started the current
application, then Enterprise RTView will
search under lib in your
installation directory. NOTE: When
you start an Enterprise RTView application from the Windows Start menu, it runs
from the demos directory. |
-Dcom.sl.rtview.optionsFileDir=MyOptionsFilesDir
|
Demo Server, Data
Server, Display Server and JSP Example
To use the Demo Server, Data Server,
Display Server or Java Server
Pages Example you must also set the following variables:
| Name |
Description |
Example |
| CATALINA_HOME |
Web server installation
directory. |
C:\Tomcat |
| JAVA_HOME |
JDK1.5.0_01+ installation
directory. Only required if you will be using the
Demo Server. |
C:\Program
Files\Java\jdk1.5.0_06 |
| RTV_DEMOSERVER |
The location of the Demo Server in
your Enterprise RTView installation. This variable may be setup in the Windows
installer. It is also set to the correct location when you run the rtv_init
script to initialize a command window. Only
required if you will be using the
Demo Server. |
C:\Program
Files\ERTV\servers\apache_tomcat-5.5.17_sl |
TIBCO
EMS Manager
In
addition to the environment variables listed above, if you will be using
the TIBCO EMS Manager you must set TIBJMS_ROOT. If you will
be using SSL, you must set both TIBJMS_ROOT
and RTV_USERPATH:
| Name |
Description |
Example |
| TIBJMS_ROOT |
TIBCO EMS installation directory.
If you installed Enterprise RTView using the Windows installer, this variable
may already be set globally on your system. |
C:\TIBCO\ems |
| RTV_USERPATH |
TIBCO EMS SSL support jars.
NOTE: If this variable already exists
append the TIBCO EMS jars to it. |
If
you are using SSL for communication include:
C:\TIBCO\ems\clients\java\tibcrypt.jar;C:\TIBCO\ems\clients\java\jnet.jar;
C:\TIBCO\ems\clients\java\jcert.jar;C:\TIBCO\ems\clients\java\jsse.jar |
|
