'Virtual machine Consolidation Needed' Warning in vCenter. No snapshots visible under Snapshots tab.

Products

• VMware vSphere ESXi

Issue/Introduction

Manually consolidate a broken or stuck snapshot chain for a VMware vSphere Virtual Machine (VM) using the vmkfstools command-line utility. When there are multiple virtual disks present on a VM and not all virtual disks have a snapshot present.

Environment

vSphere 8.0
vSphere 9.0

Cause

ESX VM snapshot deletion/consolidation is run on all disks simultaneously. When only one disk has a snapshot present manual steps must be taken.

Resolution

Step 1: Identify the Snapshot Disk

1. Log in to the vSphere Client UI.

2. Select the target VM and navigate to Edit Settings.

3. Expand the Hard Disk section and check the Disk File Name.

4. Identify if the file name contains -000###.vmdk appended to it (e.g., VMname-000001.vmdk). This indicates the VM is running on a snapshot disk.

Step 2: Power Down the VM

1. Shut down the guest operating system or select Power Off on the VM in vSphere.

Step 3: Verify Snapshot Chain Consistency

1. Open an SSH session to the ESXi host and navigate to the VM's datastore directory:

   cd /vmfs/volumes/<Datastore_Name>/<VM_Directory>/
   

2. Test the snapshot chain integrity against the latest snapshot descriptor file:

   vmkfstools -e VMname-disk-0000###.vmdk
   

3. Confirm the command returns Snapshot consistent.

Important: If the output indicates the snapshot chain is not consistent, stop immediately. Review host logs (vobd.log / vmware.log) and resolve chain corruption before attempting to clone.

Step 4: Clone and Consolidate the Disk Chain

Execute vmkfstools to clone the target snapshot disk. This merges the entire snapshot chain into a single, consolidated .vmdk file.

vmkfstools -i VMname-disk-0000###.vmdk VMname-disk-consolidated.vmdk

Step 5: Reattach the Consolidated Disk

1. In the vSphere UI, go to Edit Settings for the VM.

2. Locate the hard disk attached to the snapshot chain.

3. Click the X icon to remove the disk.

   • Crucial: Ensure you choose Remove from virtual machine only. Do NOT select "Delete files from datastore."

4. Click Add New Device > Existing Hard Disk.

5. Browse the datastore to locate and select the newly created VMname-disk-consolidated.vmdk.

6. Click Save / OK to apply the configuration.

Step 6: Verification

1. Power on the VM.

2. Verify that the Guest OS boots cleanly and application performance is optimal.

3. After confirming stability, manually clean up or archive the orphaned base disk and snapshot files from the datastore.