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

See Manually installing management agent on On-premises macOS.

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.57_macos-x86_64.tar.gz will create a folder named jms_setup_v9.0.57_macos-x86_64 within the new folder.
3. (Optional diagnostic check):
   • Add jms.diagnostic = true in 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
   ======================================================================================================
   User has sudo/root privileges? : Yes
   Certified OS? : Yes
   Meets minimum disk requirements? : Yes
   Meets minimum memory requirements? : Yes
   Able to reach OCI endpoint? : Yes
   Certificate verification has been passed? : Yes
   Is clock sync with OCI platform? : Yes
   Available Java for agent installation ? : Yes
   Management Agent installer available? : No
   	Script JMS_YourFleetName_macos.sh can't find the Management Agent installer /kkk.
   	Check if the path /kkk exists and check the '--use-agent-installer-path' parameter.
   Existing Management Agent has been detected? : No
   ================================================================================
   Diagnostics have failed. Please resolve all issues and run script JMS_YourFleetName_macos.sh again.
   Please refer troubleshooting guide https://docs.oracle.com/en-us/iaas/jms/doc/troubleshooting.html for more details.
   
   A copy of this installation log can be found at /Library/Oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log
   

   Diagnostic completed successfully:

   ======================================================================================================
   Diagnostic Summary
   ======================================================================================================
   User has sudo/root privileges? : Yes
   Meets minimum disk requirements? : Yes
   Meets minimum memory requirements? : Yes
   Able to reach OCI endpoint? : Yes
   Certificate verification has been passed? : Yes
   Is clock sync with OCI platform? : Yes
   Existing Management Agent has been detected? : No
   Available Java for agent installation ? : Yes
   Management Agent installer available? : Yes
   ======================================================================================================
   Diagnostics have finished running and no error occurred.

   See Running Agent Installation Diagnostics for the complete list of criteria checked during diagnostics, along 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, a similar 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 will be enabled on this instance.
   Management Agent was successfully registered using key <JMS_YourFleetName>(ocid1.managementagentinstallkey.oc1.iad.<ocid hash>).
   Instance has been assigned to JMS fleet <JMS_YourFleetName>(ocid1.managementagentinstallkey.oc1.iad.<ocid hash>)
   A copy of this installation log can be found at /Library/Oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log
   Removing the temporary files.
   The JMS installer and configuration file can be removed from the machine.
   /Library/Oracle/JMSInstallScript/JMSInstallerLogs-<date>.log contains the install log.
   Agent is successfully installed and is running.

The log files are located in the /Library/Oracle/JMSInstallScript/ directory.