Quick Start

This section describes how to install, configure and start the Monitor using default settings. These instructions are intended for deployments in which you connect to a single Coherence cluster, use the Direct Connection data connection method (in which the Monitor joins the Coherence cluster as a node) and the default HSQLDB database.

NOTE: The HSQLDB database is sufficient for evaluation and testing, it is not recommended for use in production deployments.

To deploy the Monitor on:

Windows

  1. Download and unzip the contents to your local server:

    2. Unzip the RTViewOCMonitor_<version>.zip file into a directory of your choosing:

    unzip –a RTViewOCMonitor_<version>.zip

  2. Setup your project directory as follows:

    3. Change directory (cd) to the projects\rtview-server directory.

  3. Open the rtview.properties file and edit as follows:

    4. Specify that the Monitor connect as a node:

    sl.rtvapm.ocmon.node=true

    Define values for the tangosol properties that your cluster nodes use to join the cluster:

    tangosol.coherence.cluster=MyClusterName
    tangosol.coherence.wka=
    tangosol.coherence.override=
    tangosol.coherence.cacheconfig=

    Set the value of the sl.rtvapm.ocmon.jmxconn property to the name of the cluster:

    sl.rtvapm.ocmon.jmxconn=MyClusterName

       Add the path to the Coherence jar to the java class path:
    sl.rtview.cp=c:/coherence/lib/coherence.jar

    NOTE: You must also add any Coherence patch jars, and all jar files that facilitate deserialization of MBeans, including jar files for custom and third party MBeans.

  4. To start the Monitor, navigate to the RTViewOCMonitor directory and type:

    5.       start_server     

  5. Review log files for errors, located in the projects\rtview-server\logs directory.

  6. Deploy the war files under projects\rtview-server to your application server. For example, in the case of Apache Tomcat this could be done by copying the war files to the Tomcat webapps directory.

  7. Open the Monitor: Open a browser and go to the URL of the deployed ocmon-classic servlet. For example, http://localhost:8080/ocmon-classic. If authentication is required:

   Login. The default user name and password are:

   User Name: demo

Password: demo

The Monitor Cluster Overview display opens.

See Using the Monitor for details about using the Monitor.

UNIX/Linux

  1. Download and unzip the contents to your local server:

    2.    Unzip the RTViewOCMonitor_<version>.zip file into a directory of your choosing:

          unzip –a RTViewOCMonitor_<version>.zip

  2. Navigate to your installation directory, make the file fixperms.sh executable, then execute it in the current shell (first chmod 755 fixperms.sh, and then ./fixperms.sh).

  3. Setup your project directory as follows:

    4. Change directory (cd) to the projects/rtview-server directory.

  4. Open the rtview.properties file and edit as follows:

    5. Specify that the Monitor connect as a node:

    sl.rtvapm.ocmon.node=true

    Define values for the tangosol properties that your cluster nodes use to join the cluster:

    tangosol.coherence.cluster=MyClusterName
    tangosol.coherence.wka=
    tangosol.coherence.override=
    tangosol.coherence.cacheconfig=

    Set the value of the sl.rtvapm.ocmon.jmxconn property to the name of the cluster:

    sl.rtvapm.ocmon.jmxconn=MyClusterName

    Add the path to the Coherence jar to the java class path:

    sl.rtview.cp=coherence/lib/coherence.jar

    NOTE: You must also add any Coherence patch jars, and all jar files that facilitate deserialization of MBeans, including jar files for custom and third party MBeans.

    Save your changes.

  5. To start the Monitor, navigate to the RTViewOCMonitor directory and type:

    6.       start_server.sh

  6. Review log files for errors, located in the projects/rtview-server/logs directory.

  7. Deploy the war files under projects/rtview-server to your application server. For example, in the case of Apache Tomcat this could be done by copying the war files to the Tomcat webapps directory.

  8. Open the Monitor: Open a browser and go to the URL of the deployed ocmon-classic servlet. For example, http://localhost:8080/ocmon-classic. If authentication is required:

Login. The default user name and password are:

   User Name: demo

Password: demo

The the Monitor Cluster Overview display opens.

See Using the Monitor for details about how to use the Monitor.