Using Oracle Management Agent Software Installer
The Oracle Management Agent (OMA) software installer helps you perform seamless installation and deployment of the Java Management Service plug-in on your host machine. The installer contains all the prerequisite software components, making the installation process easier and more efficient.
Prerequisites
- Download the OMA installer and the configuration file as described in Download Oracle Management Agent Software Installer with Requisite Software section.
- See System Requirements page for a list of supported platforms.
- Ensure that the installer is executed with appropriate privileges and permissions for your operating system:
- On Linux, run with
sudo
or administrative access. - On Windows, run Powershell with administrator privileges.
- On macOS, run with
sudo
, or administrative access and grant Full Disk Access permission.
- On Linux, run with
Installer Details
- Provide Diagnostic Summary with essential information such as agent type, processes, permissions, files, settings, logs, and so on. See Running Agent Installation Diagnostics for detailed information.
- Install JDK 8 and use it to configure and install the Management Agent software.
- Register the instance to the fleet from which the installer was obtained.
- Deploy JMS plug-in.
- On OCI Linux instances within the same tenancy and region as the fleet from which the installer was obtained, the installation process will configure an Oracle Cloud Agent.
- The recommended approach for onboarding OCI Linux instances to the fleet is using the fleet's Add Managed Instance(s) action in the Managed Instances view. See instructions in the OCI Linux section in the Manual Method for Installing Management Agent and Deploying JMS Plug-in.
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.
The installer may also install the following Oracle applications and third-party tools; if they are not already present on the host:
Oracle applications:
- Oracle JDK 11 on OCI host
- OCI Command Line Interface (CLI) on Linux OCI along with Python 3
Third-party tools:
- curl: a command-line tool and library used for transferring data with URLs.
- jq: a command-line JSON processor used to map and transform structured data.
- unzip: utility used to extract files from a zipped single file or similar file archive. This is used only on Ubuntu platform.
- snap: a software packaging and deployment system used embed applications on Linux devices. This is used only on Ubuntu platform.