Unable to add the host to SDDC Manager; failing with an error: "vSAN Partition found on the host, needs clean-up."

Products

• VMware vSAN

Issue/Introduction

Symptoms: 

• Unable to add / Commission ESXi host in the SDDC manager 

Environment

VCF (All Versions)
VSAN (All versions)
ESXi 7.x 
ESXi 8.x 

Cause

• This issue occurs when existing vSAN partitions are present on the disks.
  
  
• partedUtil command shows following vSAN partitions on the disks

# partedUtil getptbl /dev/disks/naa.500xxxxxx

1 2048 6143 381CFCCC728811E092EE000C2911D0B2 vsan 0
2 6144 250069646 AA31E02A400F11DB9590000C2911D1B8 virsto 0

Resolution

Note: Ensure the host is not part of any active vSAN cluster and does not contain any active objects before proceeding with the steps. 

Ref: Monitor Virtual Objects in the vSAN Cluster

• Delete vSAN partitions from the disks in order to address the issue. 
   

  • UI option: 

    • Make sure that the host is in the connected state.
    • Verify that the devices you plan to erase are not in use.
    • Required privilege: Host.Config.Storage
    • In the vSphere Client, navigate to the ESXi host.
    • Click the Configure tab.
    • Under Storage, click Storage Devices.
    • Select one or more devices and click the Erase Partitions icon.
    • Verify that the partition information you are erasing is not critical.
    • Click OK to confirm your change.
      
      

  • CLI Option:

    • From CLI with the help of partedUtil command the partitions can be deleted
      
      
      • List Partitions on the disk 

# partedUtil getptbl /dev/disks/naa.500xxxxxx
gpt
15566 255 63 250069680
1 2048 6143 381CFCCC728811E092EE000C2911D0B2 vsan 0
2 6144 250069646 AA31E02A400F11DB9590000C2911D1B8 virsto 0

• • • • Delete the Partitions

# partedUtil delete /dev/disks/naa.500xxxxxx 1
# partedUtil delete /dev/disks/naa.500xxxxxx 2

• • • • Verify the Partitions on the disk post deletion

# partedUtil getptbl /dev/disks/naa.500xxxxxx
gpt
15566 255 63 250069680