Upgrade RUM Agent with Update Manager

For RUM Agent versions 3.9 and above, users can upgrade to the latest version by installing the service pack (.ppm file) over the existing RUM Agent installation. The service pack typically includes bug fixes and new feature additions. This document provides instructions on how to use the Update Manager to install the Service Pack over the RUM 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.
  • The Update Manager for the RUM Agent is only supported for RUM Agent version v3.9 and above.

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.
  • <RUM Agent Home> refers to the directory in which you have installed the RUM Agent. This directory location is specified by you when you install the agent. For example, C:/Program Files/ManageEngine/RUMAgent. 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 RUM 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 RUM Agent

Windows:

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

    StopServer.bat -force

Linux:

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

    sh StopServer.sh -force

    Note: As a good practice, we recommend that you take a complete backup of the <RUM Agent Home> folder.

Upgrade Process

  1. Run the following script located in the <RUM Agent Home>/bin folder which invokes the Update Manager tool:
    • For Windows: UpdateManager.bat
    • For Linux: sh UpdateManager.sh
  2. Browse 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 <RUM Agent Home> folder to start the RUM Agent:
    • For Windows: StartServer.bat
    • For Linux: sh StartServer.sh