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 Cisco AppDynamics Download Center and download the latest version of the Synthetic Server installer package.
  2. Copy the Synthetic Server installer package (synthetic-installer-linux-<version>.zip) to 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 back up 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).

    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