AppDynamics Inc.

Skip to end of metadata
Go to start of metadata

On this page:

Your Rating:
1 Star2 Star3 Star4 Star5 Star
14 rates

To use the AppDynamics Universal Agent, you install it on each machine where you want to use it to manage runtime agents, as described here. 

When invoked, the installer checks your system for some requirements, such as sufficient disk space. When done, it leaves the agent running and installed as a Windows service.  

Install the Universal Agent on Microsoft Windows 

The two files on the download site for Microsoft Windows installations are MSI and ZIP. The ZIP file is designed to be uploaded to the repository and used for Universal Agent self-upgrade via rulebook rules. To install the Universal Agent on Windows, use the MSI installer.

  1. Prepare to install: Installing the Universal Agent on Windows requires the Universal C Runtime. If you have not installed the Universal C Runtime on your Windows server, you should install the Update for Universal C Runtime in Windows.
  2. Download the MSI installation package from the AppDynamics download site.
  3. Start the installation from the command line as follows. For your package, you must use the path of your MSI file and specify a location for the installation log.

    msiexec /i "C:\MyPackage\Example.msi" /L*V "C:\log\example.log"

    The installer starts and the End User Agreement appears. 

  4. As you review the license information, scroll to the end of the agreement. 
  5. Select the checkbox that indicates your acceptance of the agreement, and then click Next to continue the installation. 
  6. In the Configure pane, enter the following information and then click Next:
    1. Controller host: The hostname or IP address for the Controller. 

    2. Controller port: The primary listening port for the Controller. If not specified, the Universal Agent uses port 80 or 443 (with SSL enabled), by default. 

    3. Account name: The name and access key for the Controller account where the agents should report data. You can get the Account Name and Access Key value from the License Management page in the Controller UI.

    4. Account access key: The name and access key for the Controller account where the agents should report data. You can get the Account Name and Access Key value from the License Management page in the Controller UI.  

  7. Confirm the destination directory for the Universal Agent runtime files and local data and click Install

    The local data directory will contain the configuration files for the agent. The installer installs and configures the agent. 
  8. When the installation is complete, click Finish

When done, the Universal Agent is running and installed as an automatically starting service.

Windows Installer Command Line Arguments

Instead of using the GUI installer, you can pass Universal Agent configuration settings to the MSI program from the command line in the following format:  

msiexec.exe /i <name_of_UA_package>.msi  /qn [ CONTROLLERHOST=<hostname> ] [ CONTROLLERPORT=<primaryport>] [ ACCOUNTNAME=<accountname> ] [ ACCOUNTACCESSKEY=<accountkey>] [ SSL_ENABLED= ]

The /qn switch suppresses the UI.

The command arguments are: 


Required. AppDynamics Controller hostname.


Required. AppDynamics controller port number.


Required. Name of the account under which the Universal Agent will report to the controller. If you are running a single tenant controller, use the name of the default, built-in account, customer1.


Required. Account access key for the Universal Agent to authenticate with the controller.


Optional. Specifies whether or not to use SSL for the connection. If included in the command line and set to any value, the Controller uses SSL. If excluded from the command line, SSL is not required.


The command line is in the following format:  

msiexec.exe /i universalagent-setup- /qn CONTROLLERPORT=8090 ACCOUNTNAME=customer1 ACCOUNTACCESSKEY=ABCd-10123-XYZD-0123 CONTROLLERSSLENABLED=1

Start and Stop the Universal Agent Windows Service

You can stop and start the Universal Agent from the Windows services manager. To do so, find the Universal Agent service and use the services manager controls to stop and start it.

Uninstall the Universal Agent

To uninstall the Universal Agent, use the Windows MSI program, as follows:

  1. Disable auto-java (if you enable it) before uninstalling the Universal Agent. Use the  --disable-auto-java command.

  2. From the command terminal, enter the following command: 

    msiexec.exe /x <name_of_UA_package>.msi
  3. Follow the MSI tool prompts to complete the uninstallation. 
  4. Reboot the machine after the uninstall is complete.
  • No labels