This page describes how to install the Machine Agent using the zip file that does not include the JRE. You can use this zip file if your environment already has Java >= 1.8, or when installing on an OS environment that does not have an OS-specific installation package on the AppDynamics download site. The agent uses the JRE specified in the $JAVA_HOME environment variable or the default JRE for the server (enter which java in a terminal window). 

The following steps are for the Machine Agent with a bundled JRE. The standalone Machine Agent does not require these steps.

Install the Machine Agent 

  1. Before installing, review Install the Machine Agent.
  2. Download and unzip the ZIP file. Extract the contents to the agent installation directory, <machine_agent_home>.
  3. Gather your configuration details and configure the agent by editing the <machine_agent_home>/conf/controller-info.xml file or by adding system properties to the JVM startup script file. See Plan the Machine Agent Configuration.
    1. (Required) Configure the Controller host name, port number, and account access key.
    2. (Required for Multi-Tenant Mode or SaaS installations) Configure the Agent Account Information. See Multi-Tenant Controller Accounts.
    3. (Optional) Review memory requirements. See Machine Agent Requirements and Supported Environments.
    4. (Optional) Configure the agent to use SSL. See Enable SSL for Machine Agent.
    5. (Optional) Configure the agent to use proxy settings. See Machine Agent Configuration Properties.
    6. (Optional) For application and tier name, see Machine Agent Installation Scenarios to determine if you need to specify an application name and tier name. If you are installing the Machine Agent on the same server with any APM app agent, do not specify the application name and tier name.
  4. Start the Agent:
    • Windows in a terminal window: <machine_agent_home>\bin\machine-agent.vbs
    • Linux or Unix-like: <machine_agent_home>/bin/machine-agent