Related pages:

The Enterprise Console can run on the same host as the Controller and the embedded Events Service. If this is the case, the machine you choose to run the Enterprise Console must meet the requirements for all the components that run on that machine. 

However, we recommend that you place the Enterprise Console on its own separate dedicated host, particularly if you deploy Controllers as High Availability pairs.

Supported Web Browsers

The AppDynamics Enterprise Console UI is an HTML 5-based browser application that works best with the latest version of any browser. 

The Enterprise Console UI has been tested with and supports the last two versions of these browsers:

  • Safari
  • Chrome
  • Firefox
  • Microsoft Edge
  • Internet Explorer

Certain types of ad blockers can interfere with features in the Enterprise Console UI. We recommend disabling adblockers while using the Enterprise Console UI.

CPU Requirements

The Enterprise Console is not CPU intensive and therefore can manage multiple platforms with two Cores.

Memory Space Requirements

The Enterprise Console requires an additional memory of one GB of free RAM for Java and MySQL processes. 

Disk Space Requirements

The Enterprise Console requires ten GB of free space to install. After the Enterprise Console installation, there must be at least one GB of additional space on the Enterprise Console host in order to perform any operations, such as installing a remote Controller.

Network Protocol Requirements

The Enterprise Console requires SSH and Secure File Transfer Protocol (SFTP) to be properly configured and enabled for it to use remote hosts.

To access remote hosts, the Enterprise Console uses Java Secure Channel (JSch) API with the provided key file. The Enterprise Console does not support SSH Jump Server. If you use an SSH Jump Server, or have jump host configuration, please contact your AppDynamics representative for deployment options.

Microsoft Visual C++ 2019 Redistributable Package Requirement for Windows

Starting Enterprise Console version 23.7, the MySQL database is upgraded to version 8. MySQL 8 on windows environment requires Microsoft Visual C++ 2019 redistributable package. Install the package from Microsoft Download Center before you install or upgrade Enterprise Console to version 23.7 or higher in Windows environment.

Software Requirements

On systems that run Linux, you must have cURL and netstat installed. Linux systems must also have the libaio library installed. This library provides for asynchronous I/O operations on the system. 

See Required Libraries for how to install libaio and other libraries on some common flavors of the Linux operating system.

Required Libraries

Linux systems must include these libraries for Enterprise Console operation:

  • libaio
  • numactl package, which includes libnuma.so.1 for RHEL, CentOS, and Fedora, and libnuma1 for Ubuntu and Debian

  • glibc2.12 

    This glibc version is included into a given operating system release, and therefore cannot be updated.

  • tzdata for RHEL, CentOS, Fedora, , openSUSE Leap 12 and Leap 15, and Ubuntu version 16 and higher

    The tzdata package is also required by the MySQL connector.

  • libncurses5 (and above) for Ubuntu, CentOS, Debian, openSUSE Leap 12 and Leap 15, and Amazon Linux 2

    As of MySQL 5.5.57 and 5.7.19, libtinfo.so.5 is a required prerequisite library.

  • ncurses-libs-5.x for RHEL and CentOS

    As of MySQL 5.5.57 and 5.7.19, libtinfo.so.5 is a required prerequisite library.

  • SLES12 and SLES15 using libxml2-2 and libxml2-tools

This table provides instructions on how to install the libraries on some common flavors of the Linux operating system.

If you cannot install the library, check that you have a supported version of your Linux flavor.

Linux FlavorCommand
  • Red Hat
  • CentOS
  • CentOS Stream
  • Amazon

Use yum to install the library, such as:

  • yum install libaio
  • yum install numactl
  • yum install tzdata
  • yum install ncurses-libs-5.x

Ensure that only one package mgr for rpm and is installed before running the Enterprise Console installer.


For RHEL8, CentOS8, and Amazon2 you can either manually install version 5 of ncurses or use version 6.

  • To install version 5, follow these steps:
  1. sudo rpm -ivh --force ncurses-base-5.x.rpm 
  2. sudo rpm -ivh --force ncurses-libs-5.x.rpm

The ncurses-libs depends on the ncurses-base so you must install the ncurses-base first. These are examples of a trusted source for rpm download:

  • To install version 6, follow these steps:

You must either create symlinks for ncurses-libs-5 which points to ncurses-libs-6, or install the ncurses-compat-libs package, to provide ABI version 5 compatibility.

RHEL8 symlink:
sudo ln /usr/lib64/libtinfo.so.6.1 /usr/lib64/libtinfo.so.5
sudo ln /usr/lib64/libncurses.so.6.1 /usr/lib64/libncurses.so.5

CentOS8 symlink:
sudo ln /usr/lib64/libtinfo.so.6.1 /usr/lib64/libtinfo.so.5
sudo ln /usr/lib64/libncurses.so.6.1 /usr/lib64/libncurses.so.5

Amazon2 symlink:
sudo ln -s /usr/lib64/libncurses.so.6.0 /usr/lib64/libncurses.so.5
sudo ln -s /usr/lib64/libtinfo.so.6.0 /usr/lib64/libtinfo.so.5

RHEL8 compat-libs:
sudo yum install -y ncurses-compat-libs
CentOS8 compat-libs:

sudo yum install -y ncurses-compat-libs

Amazon2 compat-libs:
sudo yum install -y ncurses-compat-libs

 Use the following prerequisites to install on CentOS Stream:

  • sudo yum install -y libaio.x86_64
  • sudo yum install -y numactl.x86_64
  • sudo yum install -y tzdata
  • sudo yum install -y ncurses-compat-libs.x86_64
FedoraInstall the library RPM from the Fedora website:
  • yum install libaio
  • yum install numactl
  • yum install tzdata
Ubuntu

Use apt-get, such as:

  • sudo apt-get install libaio1
  • sudo apt-get install numactl
  • sudo apt-get install tzdata
  • sudo apt-get install libncurses5

Ensure that only one package mgr between dpkg and rpm is installed before running the Enterprise Console installer. This pkg manager utility will be used to verify mandatory pkgs before the Enterprise Console installation.


For Ubuntu20 you can install libncurses5 or libncurses6.

  • If you choose libncurses5:

    sudo apt-get install libncurses5

  • If you choose libncurses6:

    sudo apt-get install libncurses6

    Note: For libncurses6 you need to create symlink for libncurses5 pointing to libncurses6.

    sudo ln -s /usr/lib/x86_64-linux-gnu/libncurses.so.6.2 /usr/lib/x86_64-linux-gnu/libncurses.so.5
    sudo ln -s /usr/lib/x86_64-linux-gnu/libtinfo.so.6.2 /usr/lib/x86_64-linux-gnu/libtinfo.so.5

DebianUse a package manager (such as APT) to install the library (as previously described in the Ubuntu instructions). 
openSUSE Leap 12 and Leap 15

Use zypper to install the library, such as:

  • sudo zypper install libaio
  • sudo zypper install libnuma1

  • sudo zypper install tzdata

  • sudo zypper install libncurses5

    For openSUE Leap 15, you can install libncurses5 or libncurses6.

    • If you choose libncurses5:

      sudo zypper install libncurses5

    • If you choose libncurses6:

      sudo zypper install libncurses6

      Note: For libncurses6 you need to create symlink for libncurses5 pointing to libncurses6.

      sudo ln /lib64/libncurses.so.6.1 /lib64/libncurses.so.5
      sudo ln -s /lib64/libtinfo.so.6.1 /lib64/libtinfo.so.5ncurses-compat-libs

Ensure that only one package mgr for rpm and is installed before running the Enterprise Console installer. Also, you need to add the openSUSE machine repository before installing the tzdata package.

For openSUSE Tumbleweed run the following as root:
zypper addrepo https://download.opensuse.org/repositories/home:amshinde/openSUSE_Tumbleweed/home:amshinde.repo
zypper refresh
zypper install tzdata

For openSUSE Leap 42.1 run the following as root:
zypper addrepo https://download.opensuse.org/repositories/home:amshinde/openSUSE_Leap_42.1/home:amshinde.repo
zypper refresh
zypper install tzdata

For openSUSE 13.2 run the following as root:
zypper addrepo https://download.opensuse.org/repositories/home:amshinde/openSUSE_13.2/home:amshinde.repo
zypper refresh
zypper install tzdata

For openSUSE 13.1 run the following as root:
zypper addrepo https://download.opensuse.org/repositories/home:amshinde/openSUSE_13.1/home:amshinde.repo
zypper refresh
zypper install tzdata

You may run into file conflicts when two packages attempt to install files with the same name but different contents. If you choose to continue, the old files and their contents will be replaced.
See the openSUSE website (https://software.opensuse.org/download.html?project=home%3Aamshinde&package=tzdata) to manually download and install the tzdata package.
SLES12 and SLES15

Use zypper to install the library, such as:

  • sudo zypper install libxml2-2
  • sudo zypper install libxml2-tools
  • sudo zypper install libaio1
  • sudo zypper install numactl
  • sudo zypper install libcurses5
  • sudo zypper install tzdata

See Platform Requirements for operating system support information.

High Availability Requirements

You must install rsync if you plan on deploying a Controller (HA) pair. In addition, when using SSH or an SSH client, note that OpenSSH 5.3p1 is the minimum version supported by the Enterprise Console for HA.

Supported SSH Key Exchanges, Cipher Algorithms, MAC and Host Key Type

You can use these ssh key exchanges, cipher algorithms, MAC types, and host key types to customize the ssh configuration on your host(s):

Supported sshDetails
Key Exchanges
  • diffie-hellman-group-exchange-sha1
  • diffie-hellman-group1-sha1
  • diffie-hellman-group14-sha1
  • diffie-hellman-group-exchange-sha256
  • ecdh-sha2-nistp256
  • ecdh-sha2-nistp384
  • ecdh-sha2-nistp521
Cipher Algorithms
  • blowfish-cbc
  • 3des-cbc
  • aes128-cbc
  • aes192-cbc
  • aes256-cbc
  • aes128-ctr
  • aes192-ctr
  • aes256-ctr
  • 3des-ctr
  • arcfour
  • arcfour128
  • arcfour256

MAC Type

  • hmac-md5
  • hmac-sha1
  • hmac-md5-96
  • hmac-sha1-96
Host Key Type
  • ssh-dss
  • ssh-rsa
  • ecdsa-sha2-nistp256
  • ecdsa-sha2-nistp384
  • ecdsa-sha2-nistp521