Horizon Cloud Connector 2.0 and Later - Remove the Worker Node from a Horizon Cloud Connector Cluster

To remove the worker node from a Horizon Cloud Connector cluster, use the steps in the following procedure. When you remove the worker node from the cluster, Horizon Cloud Connector application services scale down and run as a single instance on the primary node.

Prerequisites

Get the IP address of the worker node VM that you want to remove from the cluster.

In the deployed Horizon Cloud Connector appliance, locate the script file named primary-cluster-config.sh. For Horizon Cloud Connector version 2.4.1 and earlier 2.x versions, the primary-cluster-config.sh file is located in a sbin directory within the /opt/ directory structure.

Procedure

1. Open a Secure Shell (SSH) session to the primary node of the cluster.

2. Change directories to the location of the primary-cluster-config.sh script file.

3. Run the removal command, where <WORKER_IP> is the IP address of the worker node.

   primary-cluster-config.sh -rs <WORKER_IP>
   

   Allow the removal command to execute without interruption. The command displays progress output describing the removal of each replica service from the node. At the end of the command output, look for lines similar to the following example, where <WORKER_IP> and <PRIMARY_IP> are the IP addresses of the worker node and primary node, respectively.

   Please run the following command on worker node <WORKER_IP> to complete clean up:
   worker-cluster-config.sh -r <PRIMARY_IP>
   

   Make a note of the information in this cleanup command.

4. Open an SSH session to the worker node, change to the directory displayed in the message from step 3, and run the cleanup command:

   worker-cluster-config.sh -r <PRIMARY_IP>
   

   Allow the cleanup command to execute without interruption.

   Note: The command displays progress output describing each cleanup task. You can disregard any messages about manually clearing configurations. No manual cleanup is required when removing a worker node from a Horizon Cloud Connector cluster.

   At the end of the output, look for a line similar to the following example:

   Please restart this VM to complete the clean up.
   

5. Do one of the following.

   • If you plan to add the worker node in the future to the same or another cluster, restart the worker node VM. Then follow the steps described in Horizon Cloud Connector 2.0 and Later: Add a Worker Node to a Horizon Cloud Connector Cluster.
   • If you do not plan to use the worker node again in a cluster, you can shut down the worker node VM and delete it from your vSphere environment.

6. To verify the removal of the worker node from the cluster, run the following command on the primary node VM.

   kubectl get nodes -o wide
   

   In the command output, verify that the worker node is no longer listed as a member of the cluster.