Add Oracle Coherence Clusters

You can add Oracle Coherence Cluster entities using the Add Entity UI or using the cloud agent command line interface (omcli) with the appropriate JSON files.

Step 1: Prepare Oracle Coherence Cluster for monitoring.

Prerequisites

Supports both credential and non-credential monitoring. When using a secured JMX connection, a credential input file needs to be passed. For information on configuring a Coherence cluster, see Configure a Coherence Cluster.

Step 2: Decide how you want to add the Oracle Coherence Cluster.

You can add Oracle Coherence Cluster entities using one of two ways:

  • Add them from UI
  • Use the agent's omcli add_entity command with the appropriate JSON files

Adding Entities from the UI

  1. From the Management Cloud main menu, select Administration, Discovery, and then Add Entity. The Add Entity page displays.
  2. Select the Oracle Coherence Cluster Entity Type.
  3. Enter the following UI properties.
    Oracle Coherence UI Fields
    • Entity Name: Name of this entity displayed in the Oracle Management Cloud console.
    • JMX Remote Port: Coherence JMX port
    • JMX Management Server Machine Name: Coherence management node host.
    • Do not discover caches: If set to True, new Coherence cache targets will not be discovered. This is recommended for clusters with a very large number of caches (over 1000).
    • Cloud Agent: Cloud agent monitoring the host where Oracle Coherence is installed.

    Monitoring Credentials (Coherence Credentials)

    • Username: JMX connection username.
    • Password: JMX connection password.

See Add Entities from the Console for detailed instructions on using the Add Entity UI.

Using omcli and the Appropriate JSON Files

  1. Download and extract the required JSON file(s) from the master JSON zip file. See the table below for the specific JSON files you'll need.
  2. Edit the file(s) and specify the requisite properties shown below.
    Oracle Coherence JSON Files and Properties

    Definition File: omc_oracle_coherence.json

    • omc_jmx_port - Coherence JMX port
    • omc_machine_name - Coherence management node host.
    • omc_skip_cache_discovery - Specify that Coherence

    Credential Files

    omc_oracle_coherence_cred.json

    coherence_credentials.json

    If Coherence is configured using a secured JMX connection, then a credentials file has to be passed as an input argument.

    • omc_username - JMX connection username.
    • omc_password - JMX connection password.
  3. Add the entity using omcli.
    omcli add_entity agent DEFINITION_FILE [-credential_file CREDENTIAL_FILE [-encryption_method_gpg]] 
  4. Verify the status of the newly added entity.
    omcli status_entity agent DEFINITION_FILE

See step 4. Adding Entities to Your Service of Add Entities Using JSON Files for more information.

Step 3: (Optional but recommended) Set up alerts.

To enable lights-out monitoring, you can set up alert rules to generate alerts and send notifications if your entities have performance issues.

See Set Up Alert Rules and Set Up Alert Thresholds and Notifications.

Troubleshooting

If you run into any issues regarding discovery or monitoring of Oracle Coherence Cluster, see the following: