IBM Support

How to uninstall agents

Question & Answer


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

[{"Product":{"code":"SS4GSP","label":"IBM UrbanCode Deploy"},"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Component":"Documentation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF022","label":"OS X"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"6.0;6.0.1;6.1","Edition":""}]

Document Information

Modified date:
17 June 2018