Agent Uninstallation - How to

Home » Features » <h1>Agent Uninstallation - How to</h1>

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.
Agent uninstallation
  • For Endpoint Central Cloud, please contact the support for the AgentCleanupTool with any one agent registry export.

Registry Path

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\AdventNet\DesktopCentral\DCAgent

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 in the central server installed machine:

    Command

                                             AgentCleanupTool.exe
  • This will generate the client exe files in the same directory:
    • AgentCleanupToolClient.exe (for Windows agent cleanup)
    • UEMS_MacAgent_UninstallInfo.plist (for Mac agent cleanup)

Step2: Uninstalling the Agent

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
  1. The AgentCleanupToolClient (Windows) and UEMS_MacAgent_unisntallInfo.plist will be valid only for 48 hours.
  2. Do not rename either of the files.
  3. The Client tool should not be executed from the agent installed directory.
  4. If the AgentCleanupToolClient.exe or UEMS_MacAgent_UninstallInfo.plist has expired, regenerate the AgentCleanupToolClient and execute the same in the agent machine.
  5. 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.

Vertraut von