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

Who Should Use This Document

Anyone wanting to upgrade the EUM Server to the latest available version should use this document.

Before You Begin

Before you start upgrading the EUM Server, make sure that you are using the correct update order.

Upgrade Procedure

In addition to showing you how to upgrade your EUM Server, the instructions below also show you how to migrate the EUM data because, for the latest production EUM Server, the EUM MySQL database has been moved from the Controller host machine to the EUM Server host machine.

To upgrade the EUM Server to the latest production installation, follow the instructions below for your version of the EUM Server:

  1. Stop the EUM Server. Be sure not to stop the EUM MySQL database.
  2. Back up the old EUM data as a precaution:
    1. On the Server host, back up the old version by copying the <eum_server_home> (i.e., <installDir>/AppDynamics/EUM) directory to a safe location.
    2. Edit the file <eum_server_home>/eum-processor/bin/, and set a password for the password property.
    3. From a terminal, change to <eum_server_home>/mysql/bin and dump the database eum_db to a file: 

      ./mysqldump -u root -p --databases eum_db -h <eum_server_host> -P <eum_mysql_port>  -S </path/to/socket> --add-drop-database >eum_db1.mysql
  3. Run the latest EUM Server (20.3 or higher) installer on the EUM host machine and follow the steps as prompted. For detailed instructions, see Install a Production EUM Server.

  4. On the host of the newly installed EUM Server, update the schema of the EUM MySQL database:
    1. Change to <eum_server_home>/eum-processor/bin.
    2. In the file, enter the password of the database user eum_user.
    3. Run the following commands to update the schema:

      bash ./eum-schema clearCheckSums
      bash ./eum-schema update
  5. If your older version of the EUM Server was not using an HTTPS proxy, but was using HTTPS, edit the file <eum_server_home>/eum-processor/bin/, set the property processorServer.httpsProduction to true, and assign your HTTPS port to the property processorServer.httpsPort.

    You are strongly recommended to use an HTTPS reverse proxy for the EUM Server instead of configuring the EUM Server to accept HTTPS requests.

  6. If you had customized settings in the, you will need to do the following:

    1. Update the of the new installation of the EUM with those custom properties.

    2. Stop and start the new version of the EUM Server.

  7. Confirm that the EUM Server is running by making a cURL request to your EUM Server. The server will respond with ping as shown below.

    curl http(s)://<eum_server_host>:<port>/eumcollector/ping

Using SSL with the EUM Server

If you are upgrading to EUM Server 4.5.6 or higher, you are recommended to downgrade the version of the JRE bundled with the EUM Server to 1.8.0_152 to avoid performance issues.