This topic 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 higher) 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). 

Install the Machine Agent 

  1. Before installing, review the installation notes here: 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 <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 and port number, and account access key 
    2. (Required for Multi-Tenant Mode or SaaS installations) Configure the Agent Account Information. See Controller Accounts (Multi-Tenancy)
    3. (Optional) Review memory requirements. See Machine Agent Requirements and Supported Environments.
    4. (Optional) To configure the agent to use SSL see Enable SSL for Machine Agent.
    5. (Optional) To configure the agent to use proxy settings see the proxy settings in 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. Usually, if you are installing the Machine Agent on the same server with any APM app agent, you should not specify application name and tier name.
  4. Start the Agent 
    • Windows, in a terminal window: <machine_agent_home>\bin\machine-agent.vbs
    • Windows as a service:  <machine_agent_home>\InstallService.vbs

    • Linux or Unix-like: <machine_agent_home>/bin/machine-agent