Oracle Coherence Monitor User Guide

Oracle Coherence Monitor

User Guide

UNIX/Linux - Installation & Setup

Perform the following steps to download the OC Monitor package, install and setup the OC Monitor application. For Windows steps, see Windows - Installation & Setup.

NOTE: If you are connecting to a single Coherence cluster, using the Direct Connection data connection method, and are using the default settings, you can use the Quick Start instructions.

At This Point You Have:

Viewed and completed the Before Installing OCM section of this document.

To install and setup the OC Monitor

1. Open the OC Monitor Download email sent to you by SL Software Distribution and do the following:

Make a note of the TSN (a unique serial number). You need this number if you want to obtain a permanent installation license key from SL Corporation. (You can obtain a license only after installing the OC Monitor application.) Download installations come with a temporary license key.
Select the link to the SL Corporation Software Download Site.

2. At the SL Corporation Software Download Site:

Click Continue.
Read and click Accept or Don't Accept the License Agreement.

3. Using unzip -a, extract the OC Monitor package, OCMonitor_XXXX.zip, into the directory of your choice. For example:

unzip –a OCMonitor_XXXX.zip

IMPORTANT: UNIX/Linux systems must use unzip –a to properly extract the files from the .zip archives.

Optionally, you can download Apache Tomcat and unzip the apache-tomcat-6.0.18-sl.zip file to a directory of your choice.
Optionally, you can download OC Monitor documentation and unzip the OCMonitor_docs_XXXX.zip file to a directory of your choice.

4. Open a command prompt window and type the following to verify the current command shell. A Bourne compatible shell is required:

echo $SHELL

Sample output:
/bin/sh for the Bourne shell
/bin/bash for the Bash shell

5. Type the following to verify that Java is available:

java –version

Sample output:
java version "1.6.0_17"
Java(TM) SE Runtime Environment (build 1.6.0_17-b04)
Java HotSpot(TM) Server VM (build 14.3-b01, mixed mode)

NOTE: If the version of Java available is not 1.5+, or is not found, make a suitable version of Java available before continuing to the next step.

6. Navigate to the OC Monitor installation directory.
Example: cd /opt/rtvoc_55c1

7.    Execute the file fixperms.sh in the current shell.
       Bourne shell:
       . ./fixperms.sh (Note that there are two periods with a space between them.)

       Bash shell:
       source fixperms.sh

8. Run the script rtvoc_setup.sh (./rtvoc_setup.sh).

9.    Run the script rtvoc_init.sh in the current shell.
       Bourne shell:
       . ./rtvoc_init.sh (Note that there are two periods with a space between them.)

       Bash shell:
       source rtvoc_init.sh

10. Verify the environment for RTView environment variables (env | grep ^RTV). RTVOC_HOME and RTV_HOME should be listed in the command output.

11. Check the PATH for two additional bin directories (echo $PATH) that correspond to $RTVOC_HOME/bin and $RTV_HOME/bin.

12. Create a Cluster Property File (which is required for the data connection). You reference the Cluster Property File in subsequent configuration steps.

To create your Cluster Property File:

Create a copy of the SampleCluster.properties file, located in the conf subdirectory of your OC Monitor installation. The name of the file should reflect the name of your existing cluster (it does not have to match the name of your cluster, but rather indicate which cluster it applies to). The filename must be alphanumeric and must not contain spaces or white-space characters.

Example: copy SampleCluster.properties to DevClusterA.properties.

Proceed to Configuring a Data Connection.

RTView contains components licensed under the Apache License Version 2.0.

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