Changing the IP Address for a Node

After you have deployed a KeyControl node, you cannot change its IP address, hostname, or domain name. In order to work around this restriction, you can do the following:

  1. Deploy a new KeyControl node using the IP address and hostname you want to use and join it with the original node to form a cluster.

    For details, see Installation Overview.

  2. Update any KeyControl Mappings that you have defined in your environment to use the new node. If you are replacing a standalone node, you must then make sure the new Mapping information has been successfully disseminated to all registered VMs before you continue. For more information, see High Availability Between a VM and the KeyControl Cluster.
  3. If there are any VMs that are registered directly with the old KeyControl node, you need to update the KeyControl list on those VMs or create a KeyControl Mapping and assign that Mapping to the VMs. For details see Updating KeyControl Node IP Addresses on an Individual VM or Managing the KeyControl Mapping on a VM.

    Tip: We highly recommend that you use a KeyControl Mapping instead of registering VMs directly with KeyControl to provide more flexibility and high availability between the VM and KeyControl.

  4. When all VMs have been updated to use the new KeyControl IP address, you can decommission the old KeyControl node as described in Decommissioning a KeyControl Node or you can simply remove it from the cluster and destroy the VM as described in Removing a KeyControl Node from a Cluster.