This page describes the common configuration, tuning, and environment requirements for the machine that hosts the Controller.

These considerations apply whether the machine runs Linux or Windows or is a virtual machine. For specific considerations for your operating system type, see the related pages links. 

Time Synchronization Service

A time synchronization service, such as the Network Time Protocol daemon (ntpd), should be enabled on the Controller host machine. 

MySQL Conflict

Certain Linux installation types include MySQL as a bundled package. No MySQL instances other than the one included in the Controller host should run on the Controller host. Verify that no such MySQL processes are running.

Virtual Memory Space

The virtual memory size (swap space on Linux or Pagefile space on Windows) should be at least 10 GB on the target system, and ideally 20 GB.

Verify the size of virtual memory on your system and modify it if it is less than 10 GB. Refer to the documentation for your operating system for instructions on modifying the swap space or Pagefile size. 

Disk Space

In addition to the minimum disk space required to install the Controller for your profile size, the Enterprise Console writes temporary files to the system temporary directory, typically /tmp on Linux or c:\tmp on Windows. The Enterprise Console requires 1024 MB of free temp space on the controller host

On Windows, in case of an error due to not meeting the above requirement, you can set the temporary directory environment variable to a directory with sufficient space for the duration of the installation process. You can restore the setting to the original temp directory when the installation is complete.

Network Ports

Review the ports that the Controller uses to communicate with agents and the rest of the AppDynamics platform.  For more information, see Port Settings.

Note that on Linux systems, port numbers below 1024 may be considered privileged ports that require root access to open. The default Controller listen ports are not configured for numbers under 1024, but if you intend to set them to a number below 1024 (such as 80 for the primary HTTP port), you need to run the Enterprise Console as the root user.