Permanently Decommissioning a node from a vSAN Cluster
search cancel

Permanently Decommissioning a node from a vSAN Cluster

book

Article ID: 326861

calendar_today

Updated On:

Products

VMware vSAN

Issue/Introduction

To document the correct procedure when decommissioning a vSAN node.

Environment

VMware vSAN 5.5.x
VMware vSAN 6.x
VMware vSAN 7.0.x

Resolution

It is important to follow the correct procedure when you are looking to permanently decommission a vSAN node. If the disk groups are left behind or the node is not disassociated with the cluster, residual components can be left behind which can have an impact on cluster stability.
 
1. Ensure there is sufficient capacity in the vSAN disk groups to decommission a node.
2. Put the host into maintenance mode with full data migration selected. This will evacuate all disk groups.
3. Wait for resync traffic to complete and the host to enter maintenance mode.
4. For vSAN 8 OSA and below delete the disk group(s) that reside on the host you want to decommission
   Select the vSAN cluster>Configure>Disk Management>Select the host to be decommissioned>View Disks> Select the disk group >Remove the Disk group
   For vSAN 8 ESA remove the disks that reside on the host you want to decommission
   Select the vSAN cluster>Configure>Disk Management>Select the host to be decommissioned>View Disks>Select the disks>Remove Disk
5. Move the ESXi host out of the cluster to disassociate it from vSAN
   Note: You may also run esxcli vsan cluster leave command from the command line to leave the cluster
6. Shutdown the ESXi host.

To fully disable a vSAN cluster, see Disable vSAN.

Note: If you need to decommission a vSAN node that has failed in a vSAN cluster engage vSAN support for further assistance.


Additional Information

To determine disk usage, use the esxcli vsan debug disk overview command.