Deleting Hosts
You can delete a host from the managed environment to disassociate it from the Key Manager system. Management data associated to the host is deleted from the Key Manager system. Data located on the deleted host is not modified in any way during deletion: Keys that were set up on the host function similarly before and after host deletion. The Key Manager host ID file (created during initial host discovery) is also left on the host.
Deleting a host from the managed environment irrevocably removes management data gathered from the host, including information about its users, keys, management history, and authorizations from and to the host.
Key‑activity logs are unaffected by host deletion. However, if you add a deleted host back to the managed environment, Key Manager is unable to associate previously gathered key‑activity information to the keys on this host.
Consider the following alternatives before deleting a host:
-
If you only want to prevent Key Manager from performing actions on the host, consider switching the host state to suspended instead of deleting. Switching the host state to suspended prevents Key Manager from modifying the host, while host and key‑management information is preserved.
-
If the target host has management‑connection issues that require the host to be redeployed, you can perform host redeployment instead. Host redeployment allows you to re‑specify and regenerate the credentials used for establishing management connections, without removing any management data associated to the host. Host redeployment is described in Redeploying Hosts.
The Key Manager host ID file on the host is not automatically deleted. If the host ID file is present on the host when it is re‑added, that host will retain the ID value it had before the host was deleted from the managed environment.
Also note that if a deleted host is added back to the managed environment, all keys on that host are given the same key states they had before host deletion.
To delete hosts from the managed environment, navigate to the Hosts page, then perform a Delete action on the target host(s).
Deleting a host removes it from the managed environment. If you want to perform key management on the host in the future, you must add the host back to the managed environment as you would add a new host. To add a previously deleted agentless host, follow the instructions in Adding Agentless Hosts. To add a previously deleted agent‑based host, install a new agent ICB file to the Key Manager agent, then restart the agent‑monitor process. For more information about agent management, see the Installation Manual.