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.

Pre-requisite

The previous version of the Synthetic services database should be maintained. 

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.

Upgradation Steps

To upgrade Synthetic services first go to the installed Synthetic services path cd <Synthetic_home> and follow the steps given here:

  1. Run the following command to stop Synthetic services:

    ./unix/deploy.sh stop
    CODE
  2. Take a backup of inputs.grovy file from <Synthetic_home> before deleting contents of <Synthetic_Home>. This is done to preserve previous configuration details.

  3. Delete all the files and folders under <Synthetic_home>.
  4. Copy and unzip the new Synthetic services installer under <Synthetic_home>.

  5. Replace inputs.groovy.sample file with the backed-up file (mentioned in step 2). Do not copy or use the YAML from previous installations as the structure may have changed in later versions.

    You must update the JAVA_HOME environmental variable to point to Java 17 when you migrate from Synthetic Server Java 8 to Synthetic Server Java 17.

  6. Run the following command to install new services:

    ./unix/deploy.sh install
    CODE

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]"
    BASH
  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
    BASH