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.

Options

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). If a Policy Agent attempts to contact KeyControl during this time, it will automatically skip this node when determining which IP address to use from the available addresses in the KeyControl Mapping. 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 experience a timeout failure and will then contact 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).

If a Policy Agent attempts to contact KeyControl during this time, it will automatically skip this node when determining which IP address to use from the available addresses in the KeyControl Mapping.

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 experience a timeout failure and will then contact the next node in the KeyControl Mapping.

KeyControl removes the node and refreshes the Servers tab.

What to Do Next

If you want to upgrade the KeyControl software, see KeyControl Upgrade Requirements.

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.