Unable to remove vSAN capacity or cache drive through UI
search cancel

Unable to remove vSAN capacity or cache drive through UI

book

Article ID: 391955

calendar_today

Updated On:

Products

VMware vSAN VMware vSphere ESXi

Issue/Introduction

  • Attempting to remove a single capacity disk from a vSAN disk group fail.
  • The following error message may be displayed:

    General vSAN error. vSAN disk data evacuation resource check has failed for disk or disk-group vsan:UUID (Disk UUID) with mode noAction on hostname. Go to vSAN Data Migration Pre-Check page for more details.


  • Attempting the remove the disk from the disk group fails with below error:

Environment

VMware vSAN (All Versions)

Cause

The cluster is configured with Deduplication and Compression enabled.

When Deduplication and Compression are enabled in vSAN Original Storage Architecture (OSA), data services are managed at the disk group level. The deduplication hash table is distributed across all capacity devices. Removing a single disk would disrupt data integrity; therefore, vSAN requires the removal of the entire disk group.

Resolution

1. Place the affected host in Maintenance Mode with Ensure Accessibility from vCenter UI.

2. SSH to the ESXi host and the run the command 'esxcli vsan storage list' to fetch the Device name and vSAN UUID.

  # esxcli vsan storage list

naa.#################:
Device: naa.#################
Display Name: naa.##################
Is SSD: true
VSAN UUID: ########-####-####-####-########
VSAN Disk Group UUID: ########-####-####-####-########
VSAN Disk Group Name: naa.##############
Used by this host: true
In CMMDS: true
On-disk format version: 5
Deduplication: true
Compression: true
Checksum: 5356031598619392290
Checksum OK: true
Is Capacity Tier: true
Encryption: false
DiskKeyLoaded: false

3. For cache disks removal, the entire disk group need to be removed. 

# esxcli vsan storage remove -u <VSAN Disk UUID>

Note: For a cache disk the VSAN UUID and VSAN Disk Group UUID fields will match
Output will report: Is Capacity Tier as false

4. For capacity disk removal from disk group:

  • If De-duplication is enabled on the vSAN cluster, it is not possible to remove the capacity disk from the disk group. Need to remove the entire disk group.
    # esxcli vsan storage remove -u <VSAN Disk Group UUID>

  • If De-duplication is not enabled on the vSAN cluster, the capacity disk can removed from the disk group using below commands.
    # esxcli vsan storage remove -d <Display Name>
    # esxcli vsan storage remove -u <UUID of the capacity disk>


Note: Always double check the UUID's before running the command.

Additional Information

Managing and Configuring a vSAN disk group using esxcli commands

Remove Disk Groups or Devices from vSAN

Recreate a Disk Group in vSAN Cluster