On-premises Linux

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.

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. Navigate to the extracted folder from Step 2 and execute ./setupJMS.sh as a root user.
    Note

    • The following are the optional parameters along with the description:
      • --diagnostic: determines if prerequisite conditions are met on the host machine to allow for successful agent installation and plug-in deployment
      • --force: uninstalls the plug-ins, deletes the configuration files or restores the originals from backups, and continues with installation
      • --override-jdk-symlink: replaces the existing JDK symlink that is created by the user with a new symlink pointing to the JDK installed in the agent's directory
      • --install-mgmt-agent: force Management Agent installation on an OCI Linux instance.

      Alternatively, the JMS_configuration.rsp file contains the setup parameters that you can use to customize your installation process. See Configuration Parameters for the complete list.

    • See Running Agent Installation Diagnostics for the complete list of question with solutions or recommendations.
  4. 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.