Versions Compared


    • This line was added.
    • This line was removed.
    • Formatting was changed.
    Comment: Published by Scroll Versions from this space and version 20.3
    Appd tocbox

    On this page:

    Table of Contents

    This page lists the Synthetic Server requirements, offers sizing guidance, and shows you how to modify the default settings.

    AppDynamics Platform Requirements

    To deploy the Synthetic Server, you need to install the following AppDynamics platforms:

    ComponentMinimum Version
    Controller4.5.0 and higher
    Events Service4.5.0 and higher
    Synthetic Agent
    • Synthetic Private Agent 4.5.4 or higher
    • Synthetic Hosted Agent 4.5.13 or higher

    Certain Synthetic Server features—specifically, Synthetic Sessions Analytics, features of Application Analytics that extend the functionality of Synthetic Sessions—require access to the AppDynamics Events Service. 


    The following table lists the requirements for deploying Synthetic Private Agents and Synthetic Hosted Agents.

    Synthetic AgentRequirements
    Synthetic Private AgentsSee Requirements for the Synthetic Private Agent.
    Synthetic Hosted Agents
    • Synthetic Hosted Agent license
    • AppDynamics Access (HMAC) Key (part of the license file for Synthetic Hosted Agent)

    Hardware Requirements

    These requirements assume that the Synthetic Server is installed on a separate machine. If other AppDynamics platforms are installed on the same machine, the requirements (particularly for memory) could vary greatly and require many more resources.


    The Synthetic Server is supported on the following operating systems:

    Linux (64 bit)

    • RHEL 6.x and 7.x
    • CentOS 6 and 7
    • Ubuntu 14 and 16
    • SUSE 12

     You can use the following file systems for machines that run Linux:


    The Synthetic Server requires the following software to run and function correctly. You are required to have outbound internet access to install Python, pip, and flake8.

    SoftwareRequired VersionFunction

    The Synthetic Server requires JDK 8 to run services such as Synthetic Scheduler and Synthetic Shepherd.

    You need to set the environmental variable JAVA_HOME to the home directory of the JDK.


    The Synthetic Server relies on Python to validate scripts.


    Python uses pip to install software. For example, pip could be used on some Linux distributions to install flake8, a Python utility used to lint scripts. 

    If the machine where you're installing the Synthetic Server does not have Internet access, run the following steps to fetch and install flake8:

    1. From a machine with internet access and pip installed:

      1. Create a directory for the flake8 library:

        Code Block
         mkdir ~/flake8
      2. Download the flake8 package:

        Code Block
         pip download flake8 -d ~/flake8
      3. Zip and tar the flake8 package:

        Code Block
        tar cvfz flake8.tgz ~/flake8
      4. Copy flake8.tgz to the $HOME directory of the host machine of the Synthetic Server.

    2. From the host of the Synthetic Server that has no internet access, but does have pip installed:
      1. Unzip and extract the flake8.tgz file:

        Code Block
        tar xvfz flake8.tgz ~/flake8
      2. Change to the flake8 directory.

      3. Install the flake8 library with pip with the following command, replacing <version> with the correct version.

        Code Block
        pip install flake8-<version>-py2.py3-none-any.whl -f ./ --no-index

    The Synthetic Server requires the libaio library to be on the system. This library facilitates asynchronous I/O operations on the system.

    See How to Install libaio for instructions.

    How to Install libaio 


    The following table provides instructions on how to install libaio for some common flavors of the Linux operating system. Note, if you have a NUMA based architecture, then you are required to install the numactl package.

    Linux Flavor
    Red Hat and CentOS

    Use yum to install the library, such as:

    • yum install libaio
    • yum install numactl

    Install the library RPM from the Fedora website:

    • yum install libaio
    • yum install numactl

    Use apt-get, such as:

    • sudo apt-get install libaio1
    • sudo apt-get install numactl
    DebianUse a package manager such as APT to install the library (as described for the Ubuntu instructions above).