This section describes the steps to set up the Oracle Management Agent and deploy the JMS plug-ins on an on-premises Linux host using the OMA installer.

See Manually installing management agent on On-premises Linux.

Prerequisites:

• If you are installing on OEL/SUSE/CENTOS/Red Hat Enterprise environments, ensure that you have downloaded the package with Agent package type as RPM, for example, jms_setup_v9.0.56_linux_rhel-aarch64.tar.gz.
• If you are installing on Ubuntu environment (non RHEL), ensure that you have downloaded the package with Agent package type as ZIP, for example, jms_setup_v9.0.56_linux-aarch64.tar.gz.

Steps

1. Copy the compressed file and the configuration file to a new folder.
2. Extract the compressed file into the new folder. For example, extracting jms_setup_v9.0.56_linux_rhel-aarch64.tar.gz will create a folder named jms_setup_v9.0.56_linux_rhel-aarch64 within the new folder.
3. (Optional diagnostic check):
   • Add jms.diagnostic = true to the JMS_agent_configuration.rsp file.
   • Navigate to the extracted folder from Step 2 and execute ./installJMSAgent.sh as a root user.
   Depending on the operating system and agent type, the results will be similar to:

   Diagnostic failed:

   ======================================================================================================
   Diagnostic Summary
   ======================================================================================================
   Shell is supported? : Yes
   User has sudo/root privileges? : Yes
   Certified OS? : Yes
   Meets minimum disk requirements? : Yes
   Meets minimum memory requirements? : Yes
   Able to reach OCI https://oracle.com endpoint? : Yes
   Meets Java requirement? : Yes
   Valid Management Agent installer? : No    
      Found 2 files with 'oracle.mgmt_agent*.rpm' pattern in /home/opc folder.    
      Please, run script test_linux.sh again with --use-agent-installer-path parameter.
   Management Agent has been detected? : No
   ======================================================================================================
   Diagnostics have failed. Please resolve all issues and run script test_linux.sh again.

   Diagnostic completed successfully:

   ======================================================================================================
   Diagnostic Summary
   ======================================================================================================
   Shell is supported? : Yes
   User has sudo/root privileges? : Yes
   Certified OS? : Yes
   Meets minimum disk requirements? : Yes
   Meets minimum memory requirements? : Yes
   Able to reach OCI https://oracle.com endpoint? : Yes
   Meets Java requirement? : Yes
   Valid Management Agent installer? : Yes
   Existing Management Agent has been detected? : Yes
   Existing Management Agent has JMS plugins? : Yes
   Existing Management Agent can be upgraded? : Yes
   ======================================================================================================
   Diagnostics have finished running and no error occurred.

   See Running Agent Installation Diagnostics for the complete list of question with solutions or recommendations.

4. Navigate to the extracted folder from Step 2 and execute ./installJMSAgent.sh as a root user.
5. Once the installation is complete, the following message will appear:

   Verifying status of JMS installation...
   Management Agent installation has been completed with 'Java Management service plugin (Service.plugin.jm)'    
   JMS advanced features can be enabled on this instance.
   Agent was successfully registered using key <JMS_YourFleetName>(ocid1.managementagentinstallkey.oc1.iad.<ocid hash>).
   Instance has been assigned to <JMS_YourFleetName>(ocid1.managementagentinstallkey.oc1.iad.<ocid hash>).
   A copy of this installation log can be found at /var/log/oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log
   Removing the temporary files.
   The JMS installer and configuration file can be removed from the machine.
   /var/log/oracle/JMSInstallScript/JMSInstallerLogs-<date>.log contains the install log.
   Agent is successfully installed and is running. 

The log files are located in the /var/log/oracle/JMSInstallScript/ directory.