Removing a KeyControl Node from a Cluster

Log into the KeyControl webGUI on any node you are not removing using an account with Domain Admin privileges.
In the top menu bar, click Cluster.
Click the Servers tab.
Select the node you want to remove.
Select Actions > Remove.
Click Proceed at the prompt to confirm the request.

If this KeyControl node is included in any KeyControl Mappings, KeyControl displays a message stating which mappings it is a part of and giving you the following options. Select an option and click Proceed to continue.

Option	Description
Disable the KeyControl node	Select this option if you are planning to re-join the node to the cluster later (for example, after upgrading it to a new KeyControl version). You will need to manually re-enable the node in the Mapping after you re-join it with the cluster.
Remove the KeyControl node	Select this option if you are removing the node permanently from the cluster.
Do not change the mapping	Select this option if you are planning to re-join the node with the cluster within a short time. Any Policy Agents that attempt to contact the node during this period will fail over to the next node in the KeyControl Mapping.

Option

Description

Disable the KeyControl node

Select this option if you are planning to re-join the node to the cluster later (for example, after upgrading it to a new KeyControl version).

You will need to manually re-enable the node in the Mapping after you re-join it with the cluster.

Remove the KeyControl node

Select this option if you are removing the node permanently from the cluster.

Do not change the mapping

Select this option if you are planning to re-join the node with the cluster within a short time. Any Policy Agents that attempt to contact the node during this period will fail over to the next node in the KeyControl Mapping.

KeyControl removes the node and refreshes the Servers tab.

What to Do Next

If this node was part of a KeyControl Mapping and you elected to remove or disable the node in the Mapping, make sure you shut down the node so that any VMs that are currently connected to this node will fail over to another node in the Mapping. The VMs will not get the updated Mapping from KeyControl until they fail over to another KeyControl node. For more information, see High Availability Between a VM and the KeyControl Cluster.

If you want to rejoin the node to an existing KeyControl cluster, see Joining or Re-joining a KeyControl Cluster.

If you want to remove the node permanently, see Decommissioning a KeyControl Node.