For an overview of the Controller and its requirements, including supported operating systems, see Controller System Requirements.

The Controller Installer for Linux

The AppDynamics Controller installer for Linux is an executable binary that you can run in GUI mode, console mode, or in silent mode by passing the installer a response file.

All software components required for Controller installation are bundled with the installer, so you do not normally need to install additional software to install the Controller.

Pre-installation Checklist for Linux

For optimum stability and performance, AppDynamics strongly recommends that you install the Controller on a dedicated machine.
The disk space requirements differ for each of the Controller Performance Profiles. Verify that there is enough disk space for the performance profile that describes your environment.
Verify that you have the right CPU, RAM and Disk I/O capacity for the performance profile you plan to install. Run the Disk I/O measurement tests described at To measure available Disk I/O.
The Controller requires that libaio be installed on the same machine. For more information see Install libaio on Linux.
Make sure the file descriptor limit is set to at least 65535. For more information see Configure File Descriptor Limits on Linux.
Install the Controller on a 64-bit Linux system if you plan to use a Medium, Large, or Extra Large Performance Profile. For details see Controller Performance Profiles.
For the Extra Large performance profile, AppDynamics recommends XFS and RAID, and additional Linux settings. See Configuring a Controller Environment for the Large Enterprise.
New in 3.8.3 When performing the installation, the installer attempts to start up the system. Depending on system resources or other factors, this can take a considerable amount of time. If startup exceeds the 30 minute default timeout, the installer exits but leaves changes on disk, so that you can troubleshoot the issue. When finished, remove the installation directory manually and restart the installation. Optionally, you can extend the timeout by passing the ad-timeout-in-min command line parameter with the new value in minutes to the installer.
Verify that you have Read/Write/Execute permissions on the directory where you install the Controller.
Verify that a ZIP/UNZIP utility is installed on the machine to which you will download the installer.
Make sure that your network permits the Controller to communicate with agents and AppDynamics UI on its HTTP or HTTPS port.

During the installation procedure you configure several accounts for the Controller, including the database account, a root user in the Controller, and an administrator in the Controller. The usernames and password for Controller cannot include the @ character. Also, if this user will be used to authenticate REST calls to the Controller REST API, additional limitations on the use of special characters in usernames apply. See Configure Users for more information.

You do not need to be logged into the operating system as a superuser such as the root user to install the Controller. If you do not have privileges to write to the /opt directory, the installer puts the Controller in your user home directory.

Download and Launch the Linux Installer

The Controller is available at AppDynamics Download Center.

Installer Modes

The Controller installer can run in three different modes:

GUI: By default the installer tries first to start in GUI mode. If the system is not set up to display the GUI, it will start in console mode.
Console: You can force the installer to start in console mode by passing the -c option to the installer.
Silent: You can force the installer to start in silent mode by passing the -q -varfile <path-to-response-file> option. See Install an On-Premise Controller Silently for more information about silent mode and the response file.

To download and launch the Controller on Linux

Download the Linux Controller binary (controller_linux_<version>.sh) file from AppDynamics Download Center.
Assign execute permissions to the downloaded installer binary.
Launch the installer by executing the controller_linux_<version>.sh that you downloaded.

If you want to install in console or silent mode, use the -c or -q options as described above under Installer Modes.

For example, to install in console mode:

./controller_32bit_linux.sh -c

Installing the Controller on Linux

To install the Controller on Linux in Console Mode

When the installer starts, type o, then press the Enter key.
Press the Enter key to scroll through the license agreement. At the end, type 1 to accept the license agreement.
Type 1 to grant or 2 to deny AppDynamics permission to collect usage data statistics from your controller, then press the Enter key.
The purpose of collecting usage data is to improve the quality of AppDynamics products and services.
Set the path of the Controller installation directory or accept the default, then press the Enter key.
Enter the password for the database user account that the Controller will use to log in to the database. The Controller creates an account named root with the password you specific. Repeat the password when prompted.
Type the host name or IP address that the AppDynamics agents and user interface will use to connect to the Controller or accept the default. Then press Enter.
Type the primary HTTP port that the AppDynamics agents and user interface will use to connect to the Controller or accept the default. Then press Enter.
Accept the default internal controller port settings or configure different ports if appropriate. Then press the Enter key.

Note that the installer checks to make sure that each port is available on the system before suggesting it. If a default port number is already in use, it chooses the next highest available number for the port. For example, if the usual default port of 8090 for the Controller application server is taken, the installer suggests 8091. You only need to edit a default port number if you know it will cause a future conflict or if you have some other specific reason for choosing another port.
Type 1 to configure the Controller in single-tenancy mode or 2 in multi-tenancy mode, then press the Enter key.
See Controller Tenant Mode for more information about tenancy modes.
Enter the password for the root user account in the Controller. Confirm the password when prompted. New in 3.8.4 This password is used for the admin user of the built-in Glassfish application server as well.
The Controller root user is a special type of administrative account that has global privileges in the Controller. The root user credentials let you access the global AppDynamics administration console, where you can create and manage AppDynamics accounts and configure other Controller-wide settings. The Glassfish admin user lets you access the Glassfish console and the asadmin utility.
Configure the initial account settings. Which procedure you use depends on the tenancy mode you chose.
- If you selected single-tenancy mode, type the admin user name and password. Confirm the password when prompted.
  This user will be able to access the single-tenant Controller and create other users. The admin user is the user described as the AppDynamics Administrator.
- If you selected multi-tenancy mode:
  1. Enter the account name for the initial account on the Controller.
  2. Enter the user name and password of the admin user for the initial account. This user is able to create other users in this account.
  3. Note the information listed for the account, including the account access key:
    
    You will need to configure App Agents with this account key and account name to associate the application with a particular account.
Type the number that represents the Controller performance profile that matches your requirements, then press the Enter key.
The installer checks your system for minimum requirements, such as hardware space, and shows a warning if it finds any issues. If it does, enter y to continue the installation anyway or n to cancel the installation.
Type the path to data directory or accept the default. The data directory is where the Controller MySQL data is stored.
Type 2 to configure a high availability primary Controller, 3 to configure a high availability secondary Controller or
1 if you are not enabling HA for this Controller. For more information see Controller High Availability.

When you press enter, the installer completes the installation.

To install the Controller on Linux in GUI Mode

In the Welcome screen click Next.
The license agreement displays.
Scroll down to the bottom and accept the license agreement, then click Next.
Click Yes to grant or No to deny AppDynamics permission to collect usage data statistics from your controller.
The data collected helps AppDynamics improve its products and services.
Set the path of the Controller installation directory in the Destination directory field, then click Next.
Enter the password for the database user that the Controller will use to access the database where it stores its data. The installer creates a user account named root in the database with the password you specify.
Enter the host name (or IP address) and primary port that the AppDynamics App Agents and browsers will use to connect to the Controller.
Scroll down to verify the default configuration of the Controller ports. If needed, click Edit Ports, modify the ports, and then click Next.

Note that the installer checks to make sure that each port is available on the system before suggesting it. If a default port number is already in use, it chooses the next highest available number for the port. For example, if the usual default port of 8090 for the Controller application server is taken, the installer suggests 8091. You only need to edit a default port number if you know it will cause a future conflict or if you have some other specific reason for choosing another port.
Choose single-tenancy or multi-tenancy mode for the Controller, then click Next.

See Controller Tenant Mode for more information about these modes.
Enter the password for the root user account in the Controller and Glassfish administrator.
The Controller root user is a special type of administrative account that has global privileges in the Controller. The root user credentials let you access the global AppDynamics administration console, where you can create and manage AppDynamics accounts and configure other Controller-wide settings. The Glassfish admin user lets you access the Glassfish console and the asadmin utility. See Access the Administration Console for more information.
Configure initial account settings, as follows:
- If you selected single-tenancy mode, enter the username and password for the administrator of the built-in account.
- If you selected multi-tenancy mode:
  1. Enter a name for the initial account in the system, along with a username and password for the administrator for the initial account.
  2. Review and record the settings for the initial account settings and click Next.
    
    You will need to configure the App Agents with this account key and account name to associate the application with a particular account.
Select the Controller performance profile that matches your requirements and click Next.

Note that only Demo and Small profile deployments are available for installation on 32-bit systems. When you click Next, the installer checks your system for minimum requirements and warns you if any are not met.
In the path to the data directory field, type the path to the directory where the Controller's mysql data will be stored or select the default, then click Next.
Select the high availability configuration for the Controller or Not Applicable if you are not enabling HA for this Controller. For more information see Controller High Availability.

The installer completes the Controller installation.

To install the Controller on Linux in Silent Mode

See Install an On-Premise Controller Silently.

Verifying Controller Installation

Wait for the installation status screen to show that the installation is complete. The Controller starts automatically when installation is completed.

To verify the success of your installation, open a browser to the URL for the Controller.

http://<application_server_host_name>:<http-listener-port>/controller

Post-installation Checklist for Linux

Apply the License File
Configure swappiness if the Linux kernel is newer than 2.1.10
Configure Backups

Apply the License File

The license file (license.lic) was provided in your Welcome email from AppDynamics. Copy the downloaded license file to the Controller installation directory.

After copying the license file, allow up to 5 minutes for the license change to take effect.

Configure swappiness if the Linux kernel is newer than 2.1.10

For better performance, configure swappiness. For details see Configure Swappiness on Linux. This feature is available only for Linux kernel versions greater than 2.1.10.

Configure Backups.

See Controller Data Backup and Restore.

Learn More

Install the Controller on Linux