Enterprise RTView® 
User Guide

Data Server - Data Servlet

This section is intended for users with a web server and a standard working knowledge of servlet deployment.

The Data Server includes a Data Servlet that will run on your web server. The servlet communicates with the Data Server via socket. If you are using multiple Data Servers, you must configure and install a Data Servlet for each Data Server. If you want to install multiple Data Servlets on the same application server, each must have a unique name.

Install Data Servlet
The servlets\rtvdata directory contains files necessary to run the Data Servlet. For your convenience, an installation script is provided to install these files on your web server.

In an initialized command window, go to the servlets\rtvdata directory and run the following scripts. NOTE: These scripts require that you set the environment variable CATALINA_HOME to the location of your Tomcat installation directory, see the Setup section for details.
 
make_war  This script creates a web archive (.war) named rtvdata.war.
install_to_tomcat rtvdata This script installs the web archive rtvdata.war to your Tomcat server. NOTE: This script will shutdown and restart Tomcat and requires administrative permissions.

NOTE: If you are using a JSP servlet container other than Tomcat, install the files contained in servlets\rtvdata and classes from lib\gmsjcs_client.jar on your web server according to instructions given with that product.


Data Servlet Options
The Data Servlet reads the file servlet.properties. NOTE: If you have already installed the servlet on your web server, you can edit this properties file on your web server. If you edit this file in servlets\rtvdata you must reinstall the servlet. In either case, you may need to restart your web server after making changes to this file.

You can set the following options in servlet.properties:
 
Option Description
ServiceHost The name of the host on which the Data Server is running. Default is localhost. NOTE: Default localhost assumes the servlet and Data Server are running on the same machine.
ServicePort Port the Data Server will use when communicating with the servlet.  Default is 3278. 
ServiceTimeout Amount of time (in seconds) the servlet will wait for replies from the Data Server. Default is 15 seconds.

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

ServiceHost=localhost
ServicePort=3278
ServiceTimeout=15
 
 
 
 
 
 
 
 
 
 
   

 
Enterprise RTView contains components licensed under the Apache License Version 2.0.

 

Treemap Algorithms v1.0  is used without modifications and licensed by MPL Version 1.1. Copyright © 2001 University of Maryland, College Park, MD

 

Datejs is licensed under MIT. Copyright © Coolite Inc.

 

JCalendar 1.3.2 is licensed under LGPL. Copyright © Kai Toedter.

 

jQuery is licensed under MIT. Copyright © John Resig,

 
JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only. 

 
SL, SL-GMS, GMS, Enterprise RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2009 Sherrill-Lubinski Corporation. All Rights Reserved.