Replacing a master node

When a hardware failure occurs, you might find that the master node is not working properly. Complete these steps to replace a master node.

1. Recreate the new master node. Ensure that the new master node has the same host name, IP address, and interface name as the old master node.
2. Configure SSH authentication for the new master node. Keep the same password or SSH key authentication as the old master node.

3. Run a command to replace master node:

   • For Linux®, run the following command:

     docker run -t --net=host -e LICENSE=accept -v $(pwd):/installer/cluster ibmcom/icp-inception-amd64:3.1.2-ee install -l master-node-ip
     

   • For Linux® on Power® (ppc64le), run the following command:

     docker run -t --net=host -e LICENSE=accept -v $(pwd):/installer/cluster ibmcom/icp-inception-ppc64le:3.1.2-ee install -l master-node-ip
     

   • For IBM® Z, run the following command:

     docker run -t --net=host -e LICENSE=accept -v $(pwd):/installer/cluster ibmcom/icp-inception-s390x:3.1.2-ee install -l master-node-ip
     

Updating the etcd members

If the etcd pod runs on the new master node, it might fail to start due to inconsistent data. To update the etcd members, see the steps in etcd pod failed to start due to inconsistent data.