Plan Your Deployment

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 platform-setup-64bit-linux.sh
```

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 Feature	Components 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.

Source	Destination	Traffic	Protocol	Default Port(s)
Cisco AppDynamics users through the web GUI, REST API, Database Agent, Application Server Agent, and Machine and Analytics Agents	Controller	APM/Database Metrics	HTTP	8090
	Controller	APM/Database Metrics	HTTPS	8181
REST API	Events Service Cluster	APM Metrics	HTTP	9080
Analytics Agent	Events Service Cluster	Log and Transaction Analytics Event Data	HTTP	9080
Real User Monitoring (RUM) Agents	End-User Monitoring (EUM) Server	EUM Beacon Data	HTTP	7001
Real User Monitoring (RUM) Agents	End-User Monitoring (EUM) Server	EUM Beacon Data	HTTPS	7002
Real User Monitoring (RUM) Agents Custom EUM Geo Server	End-User Monitoring (EUM) Server	EUM Geo Resolution Mapping Data	HTTP	80
Real User Monitoring (RUM) Agents Custom EUM Geo Server	End-User Monitoring (EUM) Server	EUM Geo Resolution Mapping Data	HTTPS	443
Controller	EUM Server	EUM Metric Data	HTTP	7001
Controller	EUM Server	EUM Metric Data	HTTPS	7002 (demo mode only)
Private Synthetic Agents	Synthetic Server	Private Synthetic Measurement Data	HTTP	10101
Private Synthetic Agents	Synthetic Server	Private Synthetic Measurement Data	HTTPS	10102
Synthetic Agents	Synthetic Server	Synthetic Measurement Data	HTTP	10101
Synthetic Agents	Synthetic Server	Synthetic Measurement Data	HTTPS	10102
Controller	EUM Server	EUM Metric Data	HTTP	7001
Controller	EUM Server	EUM Metric Data	HTTPS	7002 (demo mode only)
EUM Server	Events Service Cluster	Events Service API Store	HTTP(S)	9080
EUM Server	Events Service Cluster	Events Service API Store Admin	HTTP(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.