IBM Support

How to uninstall agents

Question & Answer


Question

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

Cause

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

Answer

ANSWER

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
    OR
  • Execute the request: Delete an agent, if you prefer to use the REST API

[{"Product":{"code":"SS4GSP","label":"IBM UrbanCode Deploy"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"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":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21687857