Set up the Agent and JMS Plug-in on OCI

If your environment is on Oracle Cloud Infrastructure (OCI), then review this section to setup the agent and plug-in. You'll enable the Java Management Service (JMS) plug-in on your Oracle Linux compute instance with Java applications and then add the instance to the fleet that you created earlier.

Enable the JMS Plug-in on the Instance

Enable the JMS plug-in on your Oracle Linux compute instance.

Before enabling the plug-in, you must have an Oracle Linux compute instance with Java applications running on the instance.

1. Navigate to your Oracle Linux compute instance.
2. Select the correct compartment where your instance is located, then click on your instance to load the compute instance detail page.
3. Copy the OCID of the instance to your clipboard.
   Go to the next step once the instance detail page has loaded.
4. Click the Oracle Cloud Agent tab, then toggle on the Oracle Java Management Service plugin.
   When you first toggle on the plugin, the status will show as Stopped. Wait for a few minutes, the status should change to Running.

A message displays that the plugin is not registered to any fleet, which is expected. Go to the next task to register the instance to the fleet.

Register the Instance to the Fleet

After verifying the OCID of the compute instance, you'll register the instance to your fleet.

1. Navigate to the fleet that you created earlier.
2. Click the Managed instances under Resources on the left hand side.
3. Click Add managed instance(s).
   A side panel of all the unregistered managed instances displays.
4. Select the compartment for the OCI instance on which the JMS plugin was enabled.
5. Verify the OCID of the compute instance against the clipboard data that you copied when you enabled the JMS plugin on the instance. Select the box next to your instance, then click Add to register this instance to your fleet.

Verify the Managed Instance

Verify that the instance is setup for monitoring by JMS and that the managed instance is successfully associated to your fleet.

1. Verify the instance is setup for monitoring by JMS.
   1. Navigate to the instance detail page.
   2. Click the Oracle Cloud Agent tab.
      The status for the JMS plugin displays that the plugin is successfully registered to JMS fleet.
2. Verify the successful association of the managed instance to your fleet.
   1. Navigate to the fleet that you created earlier, then click the inventory log object.
   2. In the Fleet Inventory log page, under the Explore Log section, is a new log entry jms.agent.plugin.start.log.
      The new log entry has been emitted from your newly associated managed instance to your Fleet Inventory log.