This page provides information on installing, configuring, and administering an on-premises AppDynamics Application Performance Monitoring (APM) Platform 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 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 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 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 platform-setup-64bit-linux.sh

You can get the software for installing the platform components from the AppDynamics download site. See Download AppDynamics Software 

Platform Components and Tools

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

The 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 on-premises AppDynamics APM 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 AppDynamics platform.

Product FeatureComponents Involved
Application Performance Management

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

Server Visibility
 Machine Agents reside on monitored servers and report data to the 7 Controller via connection A.
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 B. 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 7Controller (via connection A), which uses the 8Events 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 9 EUM Server via connection C. The EUM Server sends data to the 8 Events Service cluster via connection G. 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 AppDynamics platform components.

Connection
Source
Destination
Traffic
Protocol
Default Port(s)
A

1 AppDynamics users through the web GUI, 2 REST API, 3 Database Agent, 4 Application Server Agent, and 5Machine and Analytics Agents

7 Controller

APM/Database MetricsHTTP8090
HTTPS8181
B
5 Analytics Agent
8 Events Service Cluster

Log and Transaction Analytics

Event Data

HTTP9080
C

6 Real User Monitoring (RUM) Agents

9 End-User Monitoring (EUM) Server

EUM Beacon DataHTTP7001
HTTPS7002
D

6 Real User Monitoring (RUM) Agents

Custom EUM Geo Server

EUM Geo Resolution Mapping DataHTTP80
HTTPS443
E

7 Controller

9 EUM Server

EUM Metric DataHTTP

7001

HTTPS7002 (demo mode only)
F

7 Controller

8 Events Service Cluster

Events Service API StoreHTTP(S)9080
Events Service API Store AdminHTTP(S)9081
G

9 EUM Server

8 Events Service Cluster

Events Service API Store (EUM Event Data)HTTP(S)9080
Events Service API Store Admin (EUM Event Data)HTTP(S)9081
Synthetic Agents

Synthetic Server

Synthetic Measurement DataHTTP10101
HTTPS10102
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 AppDynamics 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 Planning Your Deployment 

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.