You can upgrade the Events Service either manually or by using the Enterprise Console.

You must upgrade manually if you:

  • Do not use the Enterprise Console to deploy the Events Service
  • Upgrade Events Service nodes hosted on remote Windows machines. The Enterprise Console does not support remote operations on Windows.

For on-premises deployments, 4.5.2 is the latest version of the Events Service. If you upgrade to a version of the Events Service other than the latest, run the Enterprise Console installer for the desired Events Service version. 


AppDynamics On-Premises 23.4.0 includes Events Service that uses Elasticsearch 8.4.3 version. Events Service Cluster 23.x uses Elasticsearch 8.4.3 whereas, Events Service Cluster 4.5.x uses Elasticsearch 2.4.1 version. If you upgrade the Events Service from versions < 23.4.0 to the latest version, you must migrate data from Elasticsearch 2.4.1 to 8.4.3 version. AppDynamics provides a migration utility that helps you migrate the data.

Before the Upgrade

AppDynamics removed Search Guard from the on-premises Events Service version 4.5.2.20561. If your deployment requires Search Guard or a comparable feature, do not upgrade to this version of the Events Service.

AppDynamics will provide an alternative security feature with the next on-premises Events Service release.

See the Support Advisory for more details.

  1. Download and install the new Enterprise Console.
  2. Plan the order in which to upgrade platform components (not just Events Service).
  3. Modify the events-service-api-store.properties file.
    • Replace the absolute path APPLICATION_HOME property in the file with an actual path.
    • This is required because while performing a discover and upgrade job, the Enterprise Console is unable to migrate the data directory for custom environment variables in the file. Failure to modify the file causes the upgraded Events Service to start with a new, blank data set.
  4. Back up your events-service.vmoptions file.
    • This is required because the events-service.vmoptions file is not maintained when the Events Service is upgraded. After the upgrade completes, merge your backup copy of events-service.vmoptions into the new file.

Upgrading to a pre-4.1 Events Service

To upgrade the Events Service software to a version earlier than 4.1, you must first manually upgrade the service to 4.1, and then use the Enterprise Console to discover the Events Service nodes.

Upgrade the Events Service

  1. Run the upgrade Events Service command. 
  2. Discover the Events Service nodes using the Enterprise Console.

Verify the Upgrade

Once the upgrade completes: 

  1. The Events Service process should have restarted—verify its health status in the Enterprise Console GUI.
  2. Merge your backup copy of the events-service.vmoptions file into the new copy of the file created by the upgrade.

Startup Script Paths

After an upgrade, you will find the Events Service startup script paths below:

<installDir>/appdynamics/events-service/processor/bin/events-service.sh
CODE

This may be different from their paths before the upgrade.