OCI and On-premises Windows
On 32 bit instances, run the script with parameter
--force-32bit-installer
as described in the following steps.
Prerequisites:
Run the installation script with administrator privileges.
- 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. - Install the agent with JMS lower telemetry frequency
configuration.
In Windows 64 bit systems, you have an option to use MACS default telemetry frequency instead of JMS lower telemetry frequency. Change the value of the parameter
low-telemetry-interval
tofalse
in the installation script. The default value istrue
. - Create the
OVERRIDE_VERSION_CHECK
environment variable if it is not present and set it totrue
on Windows 10 instances, overriding the Management Agent Service's version check. Management Agent Service supports only Java Management service on Windows 10 platform.
Run the --help
command to view
the description of options such as enabling or disabling
user name, proxy settings, and so on.
-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'.
--force-32bit-installer Force 32 bit Management Agent installation. Use this parameter to monitor a 32 bit Windows instance.
--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-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").
--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").
--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="C:\Program Files\Java\jdk1.8.0_361").
--low-metrics-frequency Installs the agent with low frequency telemetry configuration instead of MACS default frequency.
Default value is 'true'. Applicable on Windows 64 bit instances only.
Steps
C:\Oracle\mgmt_agent\plugins\jm\stateDir\log
directory.