Oracle Coherence Monitor User Guide

Configuring Servlets
A servlet container such as Tomcat is required for an OC Monitor Web deployment. An OC Monitor Web deployment makes use of two servlets that enable the servlet container to obtain data from OC Monitor server processes:

• Display Servlet
  A Display Servlet allows the servlet container to communicate with an OC Monitor Display Servlet to satisfy the servlet requests for data used in a Web page. A Display Servlet requires the IP or host name of the system where the OC Monitor Display Server is running, and the port on which the Display Server is listening. The default Display Servlet, ocmon.war, uses localhost and Port 3361.
  
• Data Servlet
  The data servlet allows a desktop client to connect to an OC Monitor Data Server via the servlet container. This technique allows a remote desktop client to obtain data from an OC Monitor Data Server when firewalls or network routing prevent a direct connection. A Data Servlet requires the IP or host name of the system where the OC Monitor Data Server is running, and the port on which the Data Server is listening. The default Data Servlet, ocmon_rtdata.war, uses localhost and Port 3381.

OC Monitor Display and Data Servlets are configured using property files and built using batch files and shells scripts provided for that purpose which are found in the projects/mysample subdirectory of the OC Monitor installation.

NOTE: An initial or test deployment can use the WAR files in the ocmon/webapps directory, which are based on the default ports, as long as the default ports are available.

The display servlet is configured by the rtvdisplay.properties file and uses the ocmon.war file.
The data servlet is configured by the servlet.properties file and uses the ocmon_rtvdata.war file.

To reconfigure a servlet you edit the appropriate .properties file for the servlet, set the ServiceHost and ServicePort properties as appropriate for your deployment, update the .war files by running the update_wars script appropriate for your platform, rename the updated .war files as appropriate for your deployment and deploy the (renamed) .war files to your web server.

Example: The OC Monitor for Coherence cluster DevClusterA is deployed with Tomcat running on WebHost1. The OC Monitor Data Server and Display Server are running on DevHost1.

The following instructions describe how to reconfigure a servlet. Rather than using the default ports, the instruction use the following settings as an example:

• The Display Server is uses port 3367 instead of the default port 3361.
• The Data Server is using port 3387 instead of the default port 3381.

Windows

1.   Open the rtvdisplay.properties file, located the ocmon\project\mysample directory, in a text editor and edit as follows to configure the display servlet:

Change From:	Change To:
DisplayServerHost=localhost	DisplayServerHost=DevHost1
DisplayServerPort=3361	DisplayServerPort=3367

2.    Save the file.

3.  Open the servlet.properties file, located the ocmon\project\mysample directory, in a text editor and edit as follows to configure the data servlet:

Change From:	Change To:
ServiceHost=localhost	ServiceHost=DevHost1
ServicePort=3381	ServicePort=3387

4.    Save the file.

5. In an initialized command window, navigate to the ocmon\project\mysample directory and execute the following script to create the new .war files:

        Example: update_wars.bat

6. Rename the .war files if required.

7. Deploy the servlets by transferring them to Tomcat’s webapps directory on WebHost1 (or by using the Tomcat Web Application Manager screen to deploy the .war files, if appropriate).

UNIX/Linux

1.    In an initialized command window, navigate to the project directory.

        Example: cd ocmon/project/mysample

2.    Edit rtvdisplay.properties with the following changes to configure the display servelet:

Change From:	Change To:
DisplayServerHost=localhost	DisplayServerHost=DevHost1
DisplayServerPort=3361	DisplayServerPort=3367

3.    Save the file.

4.    Open the servlet.properties file, located the ocmon/project/mysample directory, in a text editor and edit as follows to configure the data servlet:

Change From:	Change To:
ServiceHost=localhost	ServiceHost=DevHost1
ServicePort=3381	ServicePort=3387

5.    Save the file.

6.    Execute the following script to create the new .war files.
       Example: ./update_wars.sh

7. Rename the .war files if required.

8.    Deploy the servlets by transferring the .war files to Tomcat’s webapps directory on WebHost1 (or by using the Tomcat Web Application Manager screen to deploy the .war files, if appropriate).

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.

jQuery is licensed under MIT. Copyright © John Resig,

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

jQuery is licensed under MIT. Copyright (c) 2009 John Resig, http://jquery.com/ JCalendar 1.3.2 is licensed under LGPL. Copyright © Kai Toedter.

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, 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-2013 Sherrill-Lubinski Corporation. All Rights Reserved.