Administer Agents › Manage the Decommissioning of a Host with an Agent › Remove Selected Agents in Bulk

Remove Selected Agents in Bulk

When servers used for agents are decommissioned, you can remove the CA Process Automation references to these inactive agents in bulk. Then you can remove, in bulk, the associated empty touchpoints.

When replacement of servers is done a subnet at a time, you can select the associated agents for removal by specifying a CIDR-based search. If the servers being decommissioned have a common pattern in their host names, you can select agents for removal based on a specified pattern matching criteria.

Follow these steps:

1. Click the Configuration tab.
2. Right-click Domain and select Lock.
3. Right-click Domain and select Bulk Agent Removal.
4. Enter search criteria in one of the following ways:
   • Select Search for IP address pattern and enter a subnet in CIDR format that contains the target IP addresses.
   • Select Search by host name pattern and enter a search expression that includes the domain name, for example, *.mycompany.com.
   • Select one of the patterns but leave the search field blank.
5. Click Search.

   The Agents table displays all agents that match the search criteria, but only inactive agents can be selected for removal.

6. From the inactive agents displayed, select the agents to remove and click Delete.

   A confirmation message that states the number of agents selected asks whether to continue or cancel.

7. Select Continue.

   The selected agents are removed from the domain and the change to the domain is automatically saved.

8. Right-click Domain and select Unlock.

More information:

Remove Unused Empty Touchpoints in Bulk

Lock the Domain

Manage the Decommissioning of a Host with an Agent