Upgrade the Multi-Node Events Service Cluster for Linux

This page describes how to upgrade a scaled-out Events Service on primarily Linux machines using the Enterprise Console.
Note: Upgrade to Events Service 23.2.0 using the Enterprise Console is not supported on Enterprise Console 23.1.1 distributions. Only fresh deployment of Events Service is supported.

Upgrade the Events Service Using GUI

If there is a Events Service upgrade available, you can begin the upgrade process either on the Custom Install or Events Service page in the GUI.

Note:

You do not need to stop the Events Service before upgrading because the Enterprise Console does this for you.

This procedure should be used to upgrade the Events Service when an existing platform in the Enterprise Console is already managing Events Service cluster nodes.

After you upgrade the Events Service, upgrade the EUM server if it is part of your deployment. Then, upgrade the Controller.

To upgrade the Events Service from the previous version to the latest, you can use the Upgrade Events Service feature:

  1. Check that you have fulfilled the Enterprise Console prerequisites before starting.
  2. Upgrade the Enterprise Console to the latest version.
  3. Open a browser and navigate to the GUI:
    CODE 
    http(s)://<hostname>:<port>

    The default port is 9191.

  4. Navigate to the Events Service page of the platform.
  5. Select the Events Service host you would like to upgrade.
  6. Click Upgrade Events Service.
  7. Select an available Target Version from the drop-down list.
    Note:

    The list is populated by versions that the Enterprise Console is aware of. This means that you can upgrade the Events Service to any intermediate version or to the latest version as long as the Enterprise Console installer has been run for those versions.

  8. Confirm the Upgrade.

Upgrade the Events Service Using CLI

If there is an Events Service upgrade available, you can begin the upgrade process using the application CLI.
Note: You do not need to stop the Events Service before upgrading because the Enterprise Console does this for you.

After you upgrade the Events Service, upgrade the EUM server if it is part of your deployment. Then, upgrade the Controller.

Upgrades from the previous version to the latest version can be performed on the Events Service page of the Enterprise Console or with the following commands:

  1. Upgrade the Enterprise Console to the latest version.
  2. Navigate to the <Enterprise Console home directory>/platform-admin directory.
  3. If it has been more than one day since your last session, you will have to log in with the following command:
    CODE 
    bin/platform-admin.sh login --user-name <admin_username> --password <admin_password>
  4. Apply the upgrade to the Events Service nodes with the following command:
    CODE 
    bin/platform-admin.sh submit-job --service events-service --job upgrade --platform-name <name_of_the_platform>

    If your upgrade fails, you can resume by passing the flag useCheckpoint=true as an argument after --args.