IBM Support

How to uninstall agents

Technote (FAQ)


How do you uninstall agents in IBM UrbanCode Deploy, so that they can be reinstalled using the same agent name?


If you uninstall an agent from its host, you will not be able to reinstall the agent using the same name.



To properly uninstall an agent, you must also delete it from the server as follows:

  1. Stop the agent

  2. Delete the main directory for the agent. The default agent installation directory is:
    /opt/ibm-ucd/agent on Linux
    C:\Program Files\agent on Microsoft Windows.
  3. Do the following from the UrbanCode Deploy server GUI:

  4. Click on Resources > Agents

  5. Click the Delete action for the agent you previously uninstalled

You can use one of the following alternative procedures instead of the Steps 3-5, if you need to delete many agents:
  • Use the command: deleteAgent, if you prefer to use the Command Line Interface
  • Execute the request: Delete an agent, if you prefer to use the REST API

Document information

More support for: IBM UrbanCode Deploy

Software version: 6.0, 6.0.1, 6.1

Operating system(s): AIX, HP-UX, Linux, OS X, Solaris, Windows, z/OS

Reference #: 1687857

Modified date: 06 December 2014