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

See Manually installing management agent on OCI and On-premises Windows.

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_windows-x86_64.zip will create a folder named jms_setup_v9.0.57_windows-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 use either of the following options:
     • Option 1: Right click installJMSAgent.ps1 and select Run with PowerShell
     • Option 2: Open PowerShell as Administrator and execute .\installJMSAgent.ps1
   Depending on the operating system and agent type, the results will be similar to:

   Diagnostic failed:

   ======================================================================================================
   Diagnostic Summary
   ======================================================================================================
   User has administrator privileges? : Yes
   Powershell version meets requirements? : Yes
   Certified OS? : Yes
   Able to reach OCI endpoint? : No 
   Check your internet connection and proxy setting.
   Is clock sync with OCI platform? : Unknown 
   The clock sync check was skipped. Can't read headers from provided OCI endpoint.
   Certificate verification has been passed? : Unknown 
   The certificate check was skipped. Can't read certificate from provided OCI endpoint.
   Meets minimum disk requirements? : Yes
   Meets minimum memory requirements? : Yes
   Available Java for agent installation ? : Yes
   Management Agent installer available? : Yes
   ======================================================================================================
   Diagnostics have failed. Please resolve all issues and run the deployMgmtAgent.ps1 script again.

   Diagnostic completed successfully:

   ======================================================================================================
   Diagnostic Summary
   ======================================================================================================
   User has administrator privileges? : Yes
   Powershell version meets requirements? : Yes
   Certified OS? : Yes
   Able to reach OCI endpoint? : Yes
   Meets minimum disk requirements? : Yes
   Meets minimum memory requirements? : Yes
   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 question with solutions or recommendations.

4. Navigate to the extracted folder from Step 2 and use either of the following options:
   • Option 1: Right click installJMSAgent.ps1 and select Run with PowerShell
   • Option 2: Open PowerShell as Administrator and execute .\installJMSAgent.ps1
5. Once the installation is complete, the following message will appear:

   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>)
   Management Agent with plugins installation has been completed.
   Transcript stopped, output file is C:\ProgramData\Oracle\JMSInstallScript\JMSInstallScriptLogs-<date>.txt
   Removing the temporary files.
   The JMS installer and configuration file can be removed from the machine.
   C:\ProgramData\Oracle\JMSInstallScript\JMSInstallerLogs-<date>.txt contains the install log.
   Agent is successfully installed and is running.

The log files are located in the C:\ProgramData\Oracle\JMSInstallScript directory.