Upgrade the Events Service

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. 

Cisco 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. Cisco AppDynamics provides a migration utility that helps you migrate the data.

Before the Upgrade

Cisco 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.

Cisco 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.

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.