OCI Linux
This section describes the steps to set up the Oracle Cloud Agent and deploy the JMS plug-ins on an Oracle Linux Compute Instance using the installation script. For Oracle Linux instances in different region and/or tenancy, and other supported Linux platforms, follow the On-premises Linux instructions to set up Oracle Management Agent.
Note
- 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.
- In the case of OCI instance pools, you need to individually set up the agent on each instance part of the OCI instance pool.
Prerequisites:
- Run the installation script with
sudo
or administrative access. - Make sure the following policy is added before you run the installation script on OCI Linux instances.
ALLOW dynamic-group JMS_DYNAMIC_GROUP TO MANAGE instances IN COMPARTMENT <instance_compartment_ocid>
Note
By default, the installation script will:
- Generate usage tracker with additional functionality to collect the
user.name
property for better identification of applications running on Application Servers like WebLogic and Tomcat. If you do not want to enable this feature, update the parameter--enable-user-name=false
in the installation script. You can modify the Java Usage Tracker properties file in the future to add or removeuser.name
from theadditionalProperties
section. - Disable Federal Information Processing Standards (FIPS) mode for plug-ins. To enable FIPS mode in USGov relams, update the parameter
--enable-fips-mode=true
in the installation script. - Install the agent with MACS default telemetry frequency.
Run the --help
command to view the description of options such as enabling or disabling user name, proxy settings, FIPS, and so on.
The following are the optional parameters along with the
description:
-u, --uninstall Uninstall plug-ins, delete configuration files or restore originals from backups and exit.
-r, --reinstall Uninstall plug-ins, delete configuration files or restore originals from backups and continue installation.
-h, --help Print usage message end exit.
--diagnostic Determine if prerequisite conditions are met on the host machine to allow successful
agent installation and plug-in deployment.
--enable-user-name Generate usage tracker with additional functionality to collect the 'user.name' property for better identification
of applications running on Application Servers like WebLogic and Tomcat servers.
Default value is 'true'.
--enable-fips-mode Enable FIPS mode for plug-ins in USGov realms.
Format is --enable-fips-mode=true|false (for example, --enable-fips-mode=false).
Modify /etc/environment and create a line with ENV_AGENT_PLUGIN_FIPS_APPROVED=true or false.
Default value is false.
--install-management-agent Installation of OMA on the OCI compute instance.
--uninstall-management-agent Uninstallation of OMA on the OCI compute instance.
--reinstall-management-agent Force OMA installation on the OCI compute instance and remove existing OMA.
--ignore-unsupported The setup will proceed on an unsupported platform.
Installation might be successful, but not all functionality might work as intended.
--proxy-host Add proxy host to curl commands, add or replace line 'ProxyHost = VALUE' in install key before Management Agent setup.
Format is --proxy-host="VALUE" (for example, --proxy-host="100.0.0.10").
Default is no proxy.
--proxy-port Add proxy port to curl commands, add or replace line 'ProxyPort = VALUE' in install key before Management Agent setup.
Format is --proxy-port="VALUE" (for example, --proxy-port="8050").
--proxy-user Add proxy user to curl commands, add or replace line 'ProxyUser = VALUE' in install key before Management Agent setup.
Format is --proxy-user="VALUE" (for example, --proxy-user="opc").
--proxy-password Add proxy password to curl commands, add or replace line 'ProxyPassword = VALUE' in install key before Management Agent setup.
Format is --proxy-password="VALUE" (for example, --proxy-password="example").
--proxy-realm Add or replace line 'ProxyRealm = VALUE' in install key before Management Agent setup.
Format is --proxy-realm="VALUE" (for example, --proxy-realm="OC1").
--use-agent-installer-path Path to management agent installation file if it isn't in the same folder as the install script.
--use-java-path Specify the Oracle Java 8 installation path for agent installation.
If the path is not specified, the script will attempt to find a suitable Oracle Java 8 installation path from the file system.
Format is --use-java-path={CUSTOM_PATH}(for example, --use-java-path=/usr/java/jdk1.8.0_361)).
Steps
The log files are located in the
/var/log/oracle-cloud-agent/plugins/oci-jms/
directory.