IMPORTANT ANNOUNCEMENT: On May 6, 2024, Carbon Black User eXchange (UeX) and Case Management will move to a new platform!
The Community will be in read-only mode starting April 19th, 7:00 AM PDT. Check out the blog post!
You will still be able to use the case portal to create and interact with your support cases until the transition, view more information here!

App Control: How to Uninstall an Agent Using the Uninstall Tool

App Control: How to Uninstall an Agent Using the Uninstall Tool

Environment

  • App Control Agent: All Supported Versions
  • Microsoft Windows: All Supported Versions

Objective

This document describes how to uninstall an Agent using the Uninstall Utility.

Resolution

The latest Agent Uninstall Tool version is 1.0.0.33. Please don't use any other version of the tool.
  • The Global CLI Password is only required for disabling the agent's Tamper Protection
  • If the Agent's Tamper Protection has been disabled already then the global password can be replaced with any value (e.g 1234)
  • If the Agent is in a Disconnected state, or you are unable to otherwise authenticate with the Agent, please first attempt the Safe Mode Removal Method.
  • The Agent Uninstall Tool should be considered a "Last resort" tool when all other methods of removal fail
How to use the Agent Uninstall Utility:
  1. Open a Support case and provide info and/or logs from any failed Agent uninstall attempt to confirm the utility is needed
  2. Save the utility to a directory outside the Agent directory (e.g. C:\Temp)
  3. Open CMD as and Administrator (it can also be executed remotely via Psexec or Powershell)
  4. Run the following command:
    AgentUninstallUtility -password GlobalPassword -logfile "%userprofile%\Desktop\Uninstall.log" -uninstall
  5. System reboot is not needed unless there were errors removing the agent's files and registry keys (check the uninstall log)
  6. If there were errors and some of the agent's files or keys were not removed during the first run, reboot the System and run the tool again

Additional Notes

  • To run the Agent Uninstall Tool in Test Mode (without actual uninstall), remove the "-uninstall" option from the command
  • "-uninstall" flag is case sensitive, if there is a typo the tool will be run test mode
  • To identify the tool is running in test mode the keyword :"TEST" will be included at the beginning of every line in the log generated
  • The Global password is not required for test mode
    AgentUninstallUtility -password GlobalCLIPassword -logfile "%userprofile%\Desktop\UninstallUtility.log"

Related Content


Labels (1)
Was this article helpful? Yes No
34% helpful (1/3)
Article Information
Author:
Creation Date:
‎12-17-2018
Views:
31082
Contributors