# 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

- [Download Service Pack](https://www.manageengine.com/products/applications_manager/help/eum-agent-update-manager.html#downloadServicePack)
- [Shutdown EUM Agent](https://www.manageengine.com/products/applications_manager/help/eum-agent-update-manager.html#shutdownEUMAgent)
- [Upgrade Process](https://www.manageengine.com/products/applications_manager/help/eum-agent-update-manager.html#upgradeProcess)

**Key Instructions:**

- Start the command line option (**Windows**) as an administrator [cmd → run as the administrator]. Click [here](https://www.manageengine.com/products/applications_manager/images/cmd-admin.png) 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 (x86)/ManageEngine/EUMAgent*. This script invokes the Update Manager tool.

### Download Service Pack

1. [Download the latest service pack](https://www.manageengine.com/products/applications_manager/eum-service-packs.html) 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](https://updates.manageengine.com/certificates/latest.crt) 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:**

- 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*