Upgrade EUM Agent with Update Manager

For EUM Agent versions 21.4 and above, users can upgrade to the latest version by installing the service pack (.ppm file) over the existing EUM Agent installation. The service pack may include bug fixes and new feature additions. This document explains how to use the Update Manager to install the Service Pack over the EUM Agent.

Note: The Update Manager incorporates useful validation features, including compatibility checks. It prevents the installation of an incompatible service pack, ensuring a seamless upgrade process.

Steps to install Service Pack

Key Instructions:
  • Start the command line option (Windows) as an administrator [cmd → run as the administrator]. Click here to see the screenshot.
  • <EUM Agent Home> refers to the directory in which you have installed the EUM Agent. This directory location is specified by you when you install the agent. For example, C:/Program Files/ManageEngine/EUMAgent. This script invokes the Update Manager tool.

Download Service Pack

  1. Download the latest service pack from the provided link in the PPM archive file. Place the downloaded file inside a folder on the machine where the EUM Agent is installed.
  2. If prompted, you may need to import the ManageEngine public key certificate file during the upgrade process. Please download the latest certificate file (.crt) from this link and have it ready. Note: This is a one-time process done to verify the integrity of the PPM file.

Shutdown EUM Agent

Windows:

  • If the EUM Agent service is currently installed on your system, cease its operation promptly by navigating to the Services application and locating the EUM Agent service.
    •                                                                                                                                (or)
  • Using the command line option, execute the following command from the <EUM Agent Home> folder to stop the EUM Agent

    StopServer.bat -force

Linux:

  • If the EUM Agent service is currently installed on your system, cease its operation promptly.
    •                                                                                                                                (or)
  • Using the command line option, execute the following command from the <EUM Agent Home> folder to stop the EUM Agent

    sh StopServer.sh -force

Upgrade Process

  1. Run the following script located in the <EUM Agent Home>/bin folder:
    • For Windows: UpdateManager.bat
    • For Linux: sh UpdateManager.sh
  2. Browse to locate and select the service pack file (.ppm) saved on your computer.
  3. Click Install to initiate the upgrade process.
  4. If asked, browse and select the latest .crt file downloaded in the first step.
  5. Once the 'Installed' message appears on your screen, click Finish to complete the installation.
  6. Now, using the command line option, execute the following command from the <EUM Agent Home> folder to start the EUM Agent:
    • For Windows: StartServer.bat
    • For Linux: sh StartServer.sh