This section provides step-by-step instructions on how to manually deploy Enterprise RTView. Refer to Application with Served Data - Manual Deployment Process for a summary of these instructions. Alternatively, you can use the Deployment Wizard to guide you through this process.

Step 1: Install and Configure Data Server
Install Enterprise RTView on the system where you will run the Data Server. If you are using multiple or high availability Data Servers, you will need to repeat the following steps on each system where you will run Data Server(s).

A: Verify System Requirements
 

Basic system requirements In addition to basic system requirements, refer to the Data Sources section of this documentation for system requirements and setup specific to your data source. Data Server must be accessible via network to all clients. NOTE: All clients must have permission to access the Data Server on the port specified for the socket in the DATASERVER.ini file (see Step D).

B: Install and Setup Enterprise RTView
At this point you have verified your system requirements.

1. Install Enterprise RTView

2. Setup Enterprise RTView

C: Register
At this point you have installed and setup Enterprise RTView.

Register for a license for the Data Server.

D: Configure Data Server
At this point you have installed, setup and registered your Enterprise RTView installation.

1. Create a project directory to store Data Server configuration files.

2. Copy the following files into the directory you just created from the project directory where you developed your Enterprise RTView application:
 

OPTIONS.ini Refer to Deployment in the Data Sources section of this documentation for information on configuration (.ini) files specific to your data sources. All display (.rtv) files you want to preload (optional)

NOTE: If you are using multiple or high availability Data Servers, each Data Server needs to run on a different host and/or port. Be sure that the DATASERVER.ini file, the OPTIONS.ini file, and any related data source initialization files are all correct for this instance of the Data Server.

3. If you already created a DATASERVER.ini that is configured to run the Data Server in socket mode on the correct port, copy the DATASERVER.ini to the project directory you just created. Then go to Step 2: Setup File Server.

If you have not created a DATASERVER.ini, go to next step.

4.  In an initialized command window, go to the project directory you created and type:

run_dataserver -socket

NOTE: The Data Server must be configured to run on a socket. The port specified for the socket must match the port specified for the Data Server in Step 2B-5.

6. Click the Save Configuration button to save DATASERVER.ini and exit the Data Server.

E: Set up RTVAgent Servlet on Application Server (Optional*)

*This step is only required if you are setting up the Data Server to accept RTVAgent data via HTTP or HTTPS.

At this point you have installed and setup Enterprise RTView and configured the Data Server.

1: Verify System Requirements

• Application server with a JSP servlet container, such as Apache Tomcat.

2: Install and Setup RTVAgent Servlet
The Data Server uses the RTVAgent Servlet that runs on your application server to access data sent from an RTVAgent application that is sending data via HTTP. The servlets\rtvagent directory contains all of the files necessary to configure and install the RTVAgent Servlet.

If you are using multiple Data Servers that are gathering RTVAgent data, you must configure and install a RTVAgent Servlet for each Data Server.

a. Configure RTVAgent Servlet Options
The RTVAgent Servlet reads the servlet.properties properties file to get configuration information. If you have not installed the RTVAgent Servlet, modify servlet.properties (in the servlets\rtvagent directory) and install. (Step 1E-2b - Install the RTVAgent Servlet). If you have already installed the RTVAgent Servlet on your application server, you can edit your properties file in the application server. NOTE: You may need to restart your application server after making changes to your properties file.

You can set the following options in servlet.properties:

The following is an example of the servlet.properties file:

ServiceHost=localhost
ServicePort=5665
ServiceTimeout=15

b. Install the RTVAgent Servlet:

• In an initialized command window, go to the servlets\rtvagent directory and type:

make_war

This script creates a web archive (.war) named rtvagent.war that includes all of the files necessary to run the RTVAgent Servlet.

• Install the files in the rtvagent.war file to your application server according to the documentation for that product.

Step 1 is completed. Go to Step 2: Setup File Server.

Step 2: Setup File Server
At this point you have installed, setup and registered Enterprise RTView, configured the Data Server and set up the RTVAgent Servlet.

NOTE: Instead of using a file server, you may install your project files onto each client machine. Using a file server allows you to update project files in a single location but is not required.

A: Verify System Requirements
 

1. Create a shared project directory to store files for the application.

2. Copy the following files into this directory from the project directory where you developed your Enterprise RTView application:
 

Display (.rtv) files  COLORS.ini (only required if Custom Colors have been defined) Panel configuration file  (optional) jar file containing custom classes (optional) Security configuration files (optional)

3. If you already created an OPTIONS.ini in which the Display Viewer is configured to connect to the Data Server via socket, copy the OPTIONS.ini to the project directory created in Step 1. Then go to Step 3: Install and Setup Client.

If you have not created an OPTIONS.ini, go to next step.

4. On the system where you developed your Enterprise RTView application, open an initialized command window and go to the project directory for the application you will be installing and type;

run_builder -xmlonly -dataserver

NOTE: The -xmlonly option prevents several data sources from loading. This allows us to save only OPTIONS.ini and not the other data source configuration files, which are not needed for this step.

You have finished Step 2. Go to Step 3: Install and Setup Client.

Step 3: Install and Setup Client
At this point you have installed, setup and registered Enterprise RTView, configured the Data Server, set up the RTVAgent Servlet and the file server.

A: Verify System Requirements
 

See System Requirements Checklist to verify: Hardware requirements Enterprise RTView application requirements  NOTE: You do not need to verify data source requirements. Must have permission to access the Data Server on the port specified for the socket in the DATASERVER.inifile (see Step 1D)

B: Install and Setup Enterprise RTView

NOTE: Instead of installing Enterprise RTView on each client system, you can install it only on the file server and have all clients share the installation by running it over a mapped drive. Using a single installation allows you to upgrade your Enterprise RTView version on a single system. Each client must still register.

1. Install Enterprise RTView

2. Setup Enterprise RTView

C: Register
At this point you have installed and setup Enterprise RTView.

Register for a license for the Display Viewer.

D: Map Drive to File Server

You have finished Step 3. Go to Step 4: Start / Run Data Server.

Step 4: Start / Run Data Server
At this point you have installed and setup Enterprise RTView, configured the Data Server, set up the RTVAgent Servlet, the file server and a client. If you are using multiple Data Servers, you will need to repeat the following steps on each system where you will run Data Server(s).

1. In an initialized command window, go to the directory you created in Step 1 and type:

run_dataserver

NOTE: You may also run the Data Server as a daemon process. See Running the Data Server for more information and additional options.

NOTE: The Data Server is instrumented with JMX to allow you to manage and monitor the clients and application settings. See Managing the Data Server Using JMX for more information.

You have finished Step 4. Go to Step 5: Test Client.

Step 5: Test Client
At this point you have setup Enterprise RTView, configured the Data Server, set up the RTVAgent Servlet, the file server, the client, and are running the Data Server.

A: Testing

1. In an initialized command window  go to the project directory on the file server and:
 

type run_viewer

NOTE: If no file is specified on the command line (on Windows or UNIX), the Display Viewer Application opens init.rtv. If the file init.rtv is not found, a blank display opens. Once the Display Viewer Application is open, you can access display files by selecting File>Open.

NOTE: Java options specified in RTV_JAVAOPTS are used by the run_viewer scripts. These options are not used when the Display Viewer is started from the Windows Start menu.

NOTE: Application options set on the command line will override values in initialization files. See Appendix C for more information on using command line parameters.

2. Login. By default, the Display Viewer requires a login to support role based security. If your system administrator has configured a user name and password for you, use those. You may also need to select a role. Otherwise, the default user name and password are:
 

User Name: admin Password: admin