This page provides information on installing, configuring, and administering an on-premises Cisco AppDynamics deployment. 

Installation Overview

Before you install the platform, review the requirements for the components you plan to install and prepare the host machines. The requirements vary based on the components you deploy and the size of your deployment.

For the Controller and Events Service, you first need to install the Cisco AppDynamics Enterprise Console. You then use the application to deploy the Controller and Events Service. Note that the Events Service can be deployed as a single node or a cluster. The Enterprise Console is not only the installer for the Controller and Events Service; it can manage the entire lifecycle of new or existing Cisco AppDynamics Platforms and components.

You cannot use the Enterprise Console to perform the End User Monitoring (EUM) Server installation. Instead, you must use a package installer that supports interactive GUI or console modes, or a silent response file installation.

Follow these tasks before you start the installation process for the Cisco AppDynamics APM Platform:

  • Review the Platform Requirements.
  • Verify the Enterprise Console host meets the requirements to host the application and the Controller since they share the same host by default for Express Install. You do have the option to install the Enterprise Console on a different host than the Controller's using Custom Install.
  • On Linux, verify that you have assigned execute permissions to the installation script with the following command:

    chmod 775

You can get the software for installing the platform components from the Cisco AppDynamics download site. See Cisco AppDynamics Downloads Portal

Platform Components and Tools

Cisco AppDynamics On-Premises Platform installation consists of several separately installed and configured components. These include the Controller, MySQL database, Events Service, and optionally the EUM Server.

The Cisco AppDynamics Enterprise Console is a GUI and command-line-based application that can manage the installation, configuration, and administration of the Controller and Events Service.

For the EUM Server, you must continue to use the package installer to deploy the EUM Cloud. See EUM Server Deployment

After you install the platform, you can configure and manage different components with component-specific scripts. Based on how you deploy the platform, you might use a combination of the Enterprise Console and package installers to install and manage the various components of the platform.

On-Premises Deployment Architecture

The following diagram depicts the components of a complete Cisco AppDynamics On-Premises Platform deployment. It shows how the components interact to fulfill application, database, infrastructure, end-user monitoring, and more.

On-premises Deployment Architecture

Depending on the scale of your deployment, your requirements, and the products you are using, your own deployment is likely to consist of a subset of the components shown in the diagram.

You can find a more detailed diagram, as well as a SaaS architecture diagram on PDFs. For a diagram of the Enterprise Console, see the Enterprise Console Platforms Architecture. For a diagram of the Synthetic Server Deployment, see the Synthetic Server Deployment Architecture.

Platform Components

The following table describes how the components work together in the Cisco AppDynamics On-Premises platform.

Product FeatureComponents Involved
Application Performance Management

App Server Agents attach to monitored applications and send data to the Controller via connection .

Server Visibility

Machine Agents reside on monitored servers and report data to the Controller via connection .

Application Analytics

The Analytics Dynamic Service (formerly called the Analytics plugin) on the App Server agent communicates with a local Analytics Agent instance. One or more Analytics Agents in a deployment send data to the Events Service via connection . The Analytics Agent is bundled with the Machine Agent but can be installed and run individually as well.

Database Visibility

The Database Agent connects by JDBC to monitored databases. The agent sends data to the Controller (via connection ), which uses the Events Service to store certain types of data.

End-User Monitoring

For an on-premises EUM installation, you configure a connection to the web and mobile real user monitoring agents to the on-premises EUM Server via connection . The EUM Server sends data to the Events Service cluster via connection . The optional Custom EUM Geo Server stores EUM Geo Resolution data taken via connection . The optional Synthetic Server receives synthetic job requests from the Controller, which are then fetched from the Synthetic Services via connection .

Platform Connections

The following table lists and describes the traffic flow between Cisco AppDynamics On-Premises platform components.






Default Port(s)

Cisco AppDynamics users through the web GUI, REST API, Database Agent,

Application Server Agent, and Machine and Analytics Agents


APM/Database MetricsHTTP8090


Events Service Cluster

APM Metrics


Analytics Agent

Events Service Cluster

Log and Transaction Analytics

Event Data


Real User Monitoring (RUM) Agents

End-User Monitoring (EUM) Server

EUM Beacon DataHTTP7001

Real User Monitoring (RUM) Agents

Custom EUM Geo Server

End-User Monitoring (EUM) Server

EUM Geo Resolution Mapping DataHTTP80


EUM Server

EUM Metric DataHTTP


HTTPS7002 (demo mode only)

Private Synthetic Agents

Synthetic Server

Private Synthetic Measurement DataHTTP10101

Synthetic Agents

Synthetic Server

Synthetic Measurement DataHTTP10101


EUM Server

EUM Metric DataHTTP


HTTPS7002 (demo mode only)

EUM Server

Events Service Cluster

Events Service API StoreHTTP(S)9080
Events Service API Store AdminHTTP(S)9081
The default port 9081 is the Admin port (HTTP).

Data Storage Location

Data is stored in the following locations:

  • APM configuration and metric data in the on-premises Controller MySQL database
  • EUM event data in the Events Service
  • Transaction and log analytics data in the Events Service 
  • EUM Geo Resolution data in the on-premises GeoServer
  • EUM Synthetic data in the on-premises Synthetic Server

Installation and Upgrade Overview

The installation and upgrade process for the Cisco AppDynamics On-Premises platform consists of pre-installation steps to prepare your network and host machines for installation, installation tasks, and post-install steps to complete the required configuration. See Installation and Upgrade Overview

After this process, you can perform optional configurations and administrative tasks described in Secure the Platform

To start the installation or upgrade process, see Platform Requirements for information about requirements and pre-installation tasks.