How to Uninstall agent using AgentCleanupTool?

When the agent upgradation fails, the admin will have to wipe off the existing agent completely and install the new agent.
Uninstallation of the agent from the control panel will not remove the entire files and tasks. Using this AgentCleanupTool will clear all the files and folders related to the agent.

Important

If the Central server is uninstalled and you still have the agents in your machine, please contact support with Agent registry export. The support will provide the AgentCleanupTool for proper cleanup of the agent.

For Endpoint Central Cloud, please contact the support for the AgentCleanupTool with any one agent registry export.

Step1: Generating cleanup files

Downloading the AgentCleanupTool

Generate cleanup clients

Open the command prompt as Admin and navigate to the directory where the file is downloaded

Execute the following command as an administrator:

Command

                                                                             AgentCleanupTool.exe UEMS

This will generate:
- AgentCleanupToolClient.exe (for Windows agent cleanup)
- UEMS_MacAgent_UninstallInfo.plist (for Mac agent cleanup)

Uninstall Windows agent using Agent cleanup tool

Copy the AgentCleanuptoolClient.exe manually to the target machine where the agent needs to be uninstalled
Run this AgentCleanupToolClient.exe on the agent machine, as an administrator to remove the agent.

Uninstalling mac agent using Agent cleanup tool

Download UEMS_MacAgent_Cleanup_Tool.pkg
Copy both UEMS_MacAgent_UninstallInfo.plist (generated in Step 1) and UEMS_MacAgent_Cleanup_Tool.pkg to the target Mac machine.
Ensure both files are in the same folder.
Run UEMS_MacAgent_Cleanup_Tool.pkg (double-click the file), and complete the prompts as an admin user to perform the cleanup.

Important

The AgentCleanupToolClient (Windows) and UEMS_MacAgent_unisntallInfo.plist will be valid only for 48 hours.
Do not rename either of the files.
The Client tool should not be executed from the agent installed directory.
If the AgentCleanupToolClient.exe or UEMS_MacAgent_UninstallInfo.plist has expired, regenerate the AgentCleanupToolClient and execute the same in the agent machine.
Agent cleanup tool will remove only the agent from the machines. To remove the computer from the Central Server, navigate to Agent > Computers, select the desired computers to be removed and select remove computers.

Applies to: Endpoint Central Uninstallation, Agent Uninstallation.

Keywords: Uninstall Agents, Agent Uninstallation, Endpoint Central Agent Uninstallation.