On this page:

Your Rating:
4 rates

This page describes how to upgrade the Synthetic Server to the latest version. This is often done alongside an upgrade to the other platform components, such as the EUM Server, the Controller, and the Events Service.  

What the Upgrade Does

The upgrade procedure updates the schemas for the EUM Server database and the JAR files for the Synthetic Server if either is needed.

The upgrade steps will not update 3rd-party software such as the Python library Flake8.

Who Should Use This Document

To upgrade the Synthetic Server to the latest available version, use this document.

Before You Begin

Before you upgrade the Synthetic Server:

  1. Back up your current installation. There is no way to downgrade and changes are permanent.
  2. Update platform components in the correct update order

Upgrade Procedure

Follow the instructions below to upgrade your Synthetic Server:

Get the Latest Synthetic Server Installer

  1. Go to the AppDynamics Downloads site and download the latest version of the Synthetic Server installer package.
  2. Copy the Synthetic Server installer package (synthetic-installer-linux-<version>.zipto the machine hosting your Synthetic Server.

Stop the Synthetic Server

  1. Log on to the machine that is hosting the Synthetic Server.
  2. Open a terminal window.
  3. Change to the root directory of the Synthetic Service installer. 
  4. To stop the Synthetic Server, run:

    unix/deploy.sh stop

Install the New Installer


  1. Open a terminal window.
  2. Move the latest version of the Synthetic Server installer package to the directory containing the Synthetic Server:

    mv appdynamics-synthetic-server-<version>.zip <installDirSyntheticServer>

    Change directories to the root directory of the Synthetic Server.

  3. Unzip the latest Synthetic Server installer. When prompted, enter "A" to replace all the previous files.
  4. Run the update command to update/upgrade the Synthetic Server:
unix/deploy.sh update


Verify the New Version Has Been Installed


  1. Once the installation is complete, confirm the Synthetic Server is running by entering:

    ps aux | grep synthetic-processor
    netstat -lan | grep "1[0,2,6]10[1,2]"
  2. To view the updated version, curl to the version endpoint:

    curl <on-prem-synthetic_server>:10101/version
    curl <on-prem-synthetic_server>:12101/version
    curl <on-prem-synthetic_server>:16101/version
  • No labels