Oracle Cloud Infrastructure Documentation

Removing Agent Software

Note

Disabling the agent or removing the plug-in will not remove Java Usage Tracker, and it will continue to log usage events. This action is optional, depending on your business needs.
  1. Review the usagetracker.properties file. See Enabling and Configuring Java Usage Tracker. The usagetracker.properties file points to the Java Usage Tracker log.
  2. Remove the usagetracker.properties file and the Java Usage Tracker log.

Oracle Management Agent

Once deployed, the JMS plug-in can't be disabled on instances monitored using Oracle Management Agent. Use the Delete Managed Instance action if you no longer want to monitor such instances using JMS Fleets. However, this will not remove the JMS plug-in or agent software from the instance. To remove the JMS plug-in, the Oracle Management Agent has to be uninstalled from the instance. This action will affect all deployed service plug-ins, including JMS.

Uninstall Using Oracle Management Agent Software Installer

If you installed Oracle Management Agent Using Oracle Management Agent Software Installer from the Download Oracle Management Agent Software Installer with Requisite Software section, the compressed folder also contains an uninstallation script. Navigate to the folder to which the compressed folder was extracted and do the following:

Note

Review the JMS-configuration.rsp file before running the uninstaller, and ensure that the diagnostic flag is set to false. If it's set to true, the diagnostics will run without uninstalling the Oracle Management Agent software. See Configuration Parameters for details.
  • On Linux: execute ./uninstaller.sh as a root user.
  • On Windows: execute .\uninstaller.ps1 in Powershell as administrator.
    Note

    PowerShell version 5.1 or any version below 7 is required to run the uninstaller.
  • On macOS: execute ./uninstaller.sh as a root user.
Other Uninstallation options

If you no longer want to use OMA, or if you have encountered the error message Please uninstall the agent and remove the service file before installing the new agent!, remove the agent by following the procedure described in Remove Management Agents.

Oracle Cloud Agent

The JMS plug-in can be disabled on Oracle Linux instances monitored using Oracle Cloud Agent by following the steps in Disable a plug-in.

Oracle Container Management Agent

To uninstall the Oracle Container Management agent, use the helm uninstall command and specify the release name you used when installing the chart.