AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.

    Skip to end of metadata
    Go to start of metadata

    The Agent Installer requires microservices configuration performed by AppDynamics. The configurations will be rolled out gradually to SaaS Controllers beginning on June 8, 2020.

    This page guides you through the steps required to use the AppDynamics Agent Installer, which 
    streamlines the deployment of the Java and Machine Agents. The Agent Installer simplifies the agent installation process. With two lines of script, the installer:

    • Deploys the Java and (optionally) Machine Agents
    • Automatically instruments applications 
    • Assigns unique names to tiers and nodes

    Overview of the Agent Installer

    To understand how the Agent Installer works, familiarize yourself with the following terms: 

    • Agent Installer - Executable installer inside the Zero Agent zip file. The Agent Installer installs the Zero Agent along with Java and Machine Agents on a system. Access the installer in the Controller UI.
    • Decorator - Library responsible for automatically instrumenting new processes with AppDynamics APM agents. The library auto-instruments the application and auto-names tiers and nodes for the Controller.
    • Zero Agent - Software bundle that manages the Decorator, Java Agent, and Machine Agent. Enables automatic instrumentation and reports the status of various processes to the Controller UI. Collective term for the decorator, agent daemon, agent binaries.
    • Downloader - Script ( that downloads individual zip files containing the Java, Machine (if applicable), and Zero Agents.


    Make sure you meet the following Agent Installer requirements for components, permissions and supported environments. 

    AppDynamics Components

    • The Agent Installer requires SaaS Controller version 20.6.0 and later. 
    • You also need sufficient APM licenses to use the Java and Machine Agents. No additional license is required for the Zero Agent. 
    • Access to your specific AppDynamics-related URL: <customername>*
    • Access to the AppDynamics download files site:*

    Agent Installer Permission

    To use the Agent Installer, you need Install Agent account-level permission and at least one of the following:

    • Any default role
    • Any application-level permission
    • Any dashboard permission
    • Execute Workflow account-level permission

    Install Agent permission is not added to any default role. See Roles and Permissions for more information on creating roles.

    Supported Environments

    The table below lists supported environments for the Agent Installer. 

    Agent Installer Supported Environments
    Operating System

    Linux (64 bit). Fully tested flavors:

    • CentOS 7, 8
    • Rhel 7, 8
    • Ubuntu 18.04
    • Fedora 31
    • Debian 10

    Other Linux operating systems and versions should work but are not certified by AppDynamics. 

    • Open JDK 1.6 and later
    • Oracle JDK 1.7 and later
    • IBM JDK 1.6 and later
    Application Server
    • Apache Tomcat
    • Jboss Wildfly
    • GlassFish
    • Websphere
    • Weblogic

    Available Agents with the Agent Installer

    The Agent Installer deploys the Zero Agent, which downloads app server agents to your machine. Currently, you can install: 

    • Java Agent version 4.5.15 and later
    • Machine Agent version 4.5.15 and later

    See Java Supported Environments and Machine Agent Requirements and Supported Environments for details regarding Java and Machine Agent version compatibility. 

    The limit for the number of active agent registrations per account is 1000.

    Use the Agent Installer

    To use the Agent Installer:

    1. In the Controller UI, go to Home > Agent Installer.
    2. Select an existing application or click New application

      Application names cannot contain a single quotation mark.

    3. Select the agent(s) you want to install. 
    4. After you select an agent(s), a command is generated. Copy and paste the command in your terminal. 
      When you run the command on a designated host, the agent files download onto that host only. If you want to deploy the Agent Installer to a large number of hosts, see Run the Agent Installer on Multiple Hosts.
    5. Choose how you want to run the installer. 

      1. Instrument processes for all system users - runs the installer with sudo permission and enables the Zero Agent for all users on the host.

      2. Instrument processes for an individual user - runs the installer without sudo permission and enables the Zero Agent for the current user only. 

        See Sudo vs. Non-Sudo Access for more information. 

    6. After you select how to instrument the processes, another script is generated. Input the script in your terminal. 
    7. Restart the application processes. 
    8. Click Next in the Agent Installer UI to finish instrumentation. 

    After you finish installing the agents, you are redirected to the Monitoring Settings tab to view instrumented tiers and nodes. 

    Sudo vs. Non-Sudo Access

    You can run the Agent Installer with or without sudo permission. AppDynamics recommends using the sudo command to install the agents for all users in your system. 

    The table below details the differences between sudo and non-sudo installations. 

    DescriptionInstalls the agents on all supported processes for all users in your systemInstalls the agents for the current user only.
    Automatic Instrumentation ProcessBy default, integrates with systemd to ensure the agents always run. See Customize the Agent Installer to override this behavior.Auto-instruments processes that are started by the installing user, running under a Linux shell such as bash.
    Agent Compatibility

    Works for Java and Java/Machine Agent bundle

    Works for Java Agent only.

    Run the Agent Installer on Multiple Hosts

    You can download the Agent Installer once and run on multiple hosts. To install the agent bundle across multiple hosts, distribute the binaries to all applicable machines. 

    For example, the steps below demonstrate how to move files across hosts with the tar command. 

    1. Download the agent bundle (see steps 1-3 in Use the Agent Installer). 
    2. Distribute the Agent Installer to multiple hosts. 
      1. Make sure you are in the same directory in which you downloaded the agent bundle. 
      2. Use the tar command to put the script in a single file:

        tar cvf zero-agent.tar * 
      3. Copy the file to multiple hosts:

        scp zero-agent.tar <target host>:<directory>
      4. Extract the archived script in the same directory:

        tar xvf zero-agent.tar
    3. Complete the Agent Installer process (see steps 5-8 in Use the Agent Installer).

    Upgrade the Agent Installer

    If you want to upgrade the Java and Machine Agents running through the Agent Installer, you need to uninstall your current agents. In the terminal, navigate to the directory where the Zero Agent is installed and run the following command:

    <install-directory>/bin/zeroctl uninstall

    You can now install the new versions of the Java and Machine Agents with the Agent Installer (see Use the Agent Installer). 

    Customize the Agent Installer

    See Customize the Agent Installer to learn how to modify the agent configuration.

    • No labels