macOS
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
- Copy the compressed file and the configuration file to a new folder.
- 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 namedjms_setup_v9.0.57_macos-x86_64
within the new folder. - (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.
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.
- Add
- Navigate to the extracted folder from Step 2 and execute
./installJMSAgent.sh
as a root user. - 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.