7 Advanced Management Console Agent Installation and Configuration
The Advanced Management Console agent runs as a native service with the operating systems (Windows as well as macOS) on a client desktop. The agent finds all the installed Java Runtime Environments (JREs), and then enables and automatically configures Java Usage Tracker. In an enterprise network, the agent enables the Java Usage Tracker on agent-managed desktops. At system startup, the agent reports the data on the Advanced Management Console client. The agent periodically reports data (operating system family, version, and installed JREs) to the Advanced Management Console server. The agent downloads and applies the Deployment Rule Set to the installed JREs. It automatically enables the Java Usage Tracker on installed JREs on Windows as well as macOS operating systems.
This topic contains the following sections that describe the Advanced Management Console agent, agent bundle, agent installation, and agent distribution:
About Advanced Management Console Agent
The Advanced Management Console agent is a background service.
The Advanced Management Console agent performs the following tasks:
-
Identifies all the installed JREs on the desktop and reports the resulting list to the Advanced Management Console server.
-
Enables Java Usage Tracker for each JRE in which Java Usage Tracker is available.
-
Downloads deployment rule sets from the Advanced Management Console server and installs them on each JRE.
As the Advanced Management Console agent is not supported on Linux desktops, these desktops require additional manual Java Usage Tracker configurations. See Software Prerequisites and System Requirements for Advanced Management Console Components for the JRE versions that contain Java Usage Trackers.
The Advanced Management Console server and all its components use different protocols to communicate.
Advanced Management Console Agent Bundle
The Advanced Management Console agent bundle is specific to the Advanced Management Console server that it has been downloaded from. This agent bundle does not work with another Advanced Management Console server.
The Advanced Management Console agent is bundled as a .zip
file. The bundle file is configured with the following details: Application server URL and Application server certificate chain. You can download the agent bundle from the Advanced Management Console server through the Advanced Management Console User Interface (UI). The bundle installs the agent on the desktop that must be managed by the Advanced Management Console server.
Installing Advanced Management Console Agent
The Advanced Management Console agent installation requires administrator privileges and should be performed by a system administrator.
Configuring the Agent Proxy and the Agent Intervals
The agent proxy server is included in the bundle. If the bundle is already downloaded and the proxy is changed later, the bundle will not contain the proxy settings.
Installing Advanced Management Console Agent on Windows
To install the agent on Windows:
Note:
The Advanced Management Console supports the agent on Windows 32-bit and 64-bit operating systems only. The agent-bundle-win32.zip
bundle works for both 32-bit and 64-bit Windows operating systems.
Installing Advanced Management Console Agent on macOS
You can use the bin/AMCAgent.sh
script file to install and uninstall the Advanced Management Console on the macOS operating system. The Advanced Management Console is a launched daemon that you can start, stop, or restart by using the launchctl
command.
/Library/Application Support/Oracle/Java_AMC
directory, the .plist
file to /Library/LaunchDaemons/
, and starts the daemon.
Advanced Management Console Agent Logging
The Advanced Management Console agent utilizes the Java logger to log information about tasks performed by the agent as well as any errors that are encountered.
In Windows, the log files are available in the
%PROGRAMDATA%\Oracle\Java_AMC
directory. In a macOS
environment, the logs are available in the /Library/Application
Support/Oracle/Java_AMC
directory. The logs are rotated according to
a policy. Beginning with Advanced Management Console 2.7, the maximum size of the log files and the number of files are
configurable through AMCAgent.properties. By default, the
rotation uses three log files with a maximum size of 64K. This means that when the
first log file grows to a size of 64K, logs are directed to the second log
file. When the third log becomes full, the log rotates back to the first file,
overwriting any existing contents there. See Configuring the Agent Proxy and the Agent Intervals for procedures you can use to edit logging parameters.
Unstalling Advanced Management Console Agent
Uninstalling the Advanced Management Console Agent on Windows
On Windows, you can run the -remove
command to uninstall the Advanced Management Console agents and remove all Java Usage Tracker Properties files on the Advanced Management Console server.
usagetracker.properties
) on the desktop are also removed.
Uninstalling the Advanced Management Console Agent on macOS
On macOS, you can run the -remove
command to uninstall the
Advanced Management Console agents and remove all Java Usage Tracker Properties files on the
Advanced Management Console server.
usagetracker.properties
on the desktop are removed. The script stops the daemon and deletes the.plist
file from the following directories:
-
/Library/LaunchDaemons/
-
/Library/Application Support/Oracle/Java_AMC
Unregistering Desktops with the Advanced Management Console User Interface
After running -remove
to uninstall the Advanced Management Console agents on Windows and macOS, you can use the Advanced Management Console to remove any desktops that cannot contact the Advanced Management Console server.
Distributing Advanced Management Console Agent
Distribution of the Advanced Management Console agent bundle is not handled by Advanced Management Console.
You can download the Advanced Management Console agent bundle from the Advanced Management Console web UI. A Software Management System, such as Microsoft SCCM, can be used to distribute the agent bundle to desktops in your enterprise.
The Software Management System that you use must provide customized options to support Advanced Management Console secure agent distribution. This system must handle the following operations using administrator privileges:
-
Extraction of the agent bundle as described in Installing Advanced Management Console Agent on Windows. Incorrect extraction may cause improper file permissions that prevents agent from starting.
-
Configuration of the bundle based on the desktop owner's user credentials.
-
Installation of the agent using the install command.
After the agent is distributed, each desktop that receives the agent is registered with the Advanced Management Console server using the user credentials that were configured for the desktop. The agent also automatically configures Java Usage Tracker and associates the Java Usage Tracker records with the user credentials that were configured for the desktop. The agent then periodically reports data, such as operating system family and version, and installed JREs to the Advanced Management Console server.
To view the desktops that are registered with the Advanced Management Console server, log in to the Advanced Management Console web UI and click the Desktops tab.