Upgrade a Single-Node Events Service

Perform the following steps to upgrade a single Events Service node:

Before you Begin

Note:

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

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 an Events Service Node

Perform the following steps to upgrade an Events Service node:
Note:

In Windows machine, use the Enterprise Console only for the single node setup. By default, Enterprise Console doesn't support adding multiple hosts in the platform.

You must create the required environment to upgrade the multi-node Events Service. See Upgrade the Multi-Node Events Service Cluster for Windows.

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

Verify the Upgrade

Once the upgrade completes, the Events Service process restarts. Perform the following:

  1. 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:
CODE 
<installDir>/appdynamics/events-service/processor/bin/events-service.sh

This may be different from their paths before the upgrade.