OCI Linux

This section describes the steps to set up the Oracle Cloud Agent and deploy the JMS plug-in on an Oracle Linux Compute Instance. For Oracle Linux instances in different region and/or tenancy and other supported Linux platforms, follow the On-premises Linux instructions to set up Oracle Management Agent.

Before you begin, review the prerequisites.

Prerequisites:

Set up the policies as described in Setting Up Oracle Cloud Infrastructure for Fleets.

Steps

  1. Enable the Java Management Service plug-in on your compute instance's Oracle Cloud Agent tab.
    Note

    Plug-in deployment might fail if the plug-in is enabled shortly after the instance is created. If you encounter this issue, retry enabling the plug-in after some time.
  2. Register the agent to the JMS fleet by
    1. In OCI console, using the fleet's Add Managed Instance(s) action in the Managed Instances view. If the host shows up in the Unregistered Managed Instances list, you can select it and add it to the fleet. It may take some time for the host to show up in the Unregistered Managed Instances list after the plugins are enabled. Alternatively, add the host using the OCID of the agent in the Manual registration section.
      OR
    2. Using the OCI CLI command line:
      oci jms jms-plugin create --fleet-id <fleet_ocid> --agent-id <agent_ocid> --compartment-id <agent_compartment_ocid>
      OR
    3. Creating a registration.json file in the JMS plugin's configuration directory using the following:
      { 
      "version": 1, 
      "fleetId": "<fleetId>"  
      }

      Replace "<fleetID>" with the OCID of the fleet to which you want to register the instance.

      Place the registration file under /etc/oracle/jms/auto-registration/registration.json

      Note

      The registration.json file is deleted when the registration succeeds.
The log files are located in the /var/log/oracle-cloud-agent/plugins/oci-jms/ directory.