Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Resignaturing VMFS3 volumes from the command line in ESX/ESXi 3.x

Symptoms


Cause

This article provides information ESX/ESXi 3.x. For vSphere ESX/ESXi 4.x, see ESX/ESXi 4.x handling of LUNs detected as snapshot (1011387).

Resolution

Making this type of change on the storage array results in assigning a new LUN ID (UUID or Serial Number) to all LUNs presented via the modified ports/FAs.

VMFS3 metadata identifies the volumes by several properties which include the LUN number and the LUN ID (UUID or Serial Number). Because the LUNs now have new UUIDs, the resulting mismatch with the metadata leads to LVM identifying the volumes as snapshots.
 
You must resignature the VMFS3 volumes to make them visible again.
 
Caution:
  • Before performing the steps in this article:
    • Wait for a maintenance window
    • Make sure all virtual machines are backed up properly
  • Do not deviate from these steps. 

To resignature the VMFS3 volumes from the command line:

  1. Power off all virtual machines on all ESX hosts that are stored on the volume.
  2. Run the following command to re-read the volume on each ESX host:

    # vmkfstools -V

    If this works, the problem is resolved. If this does not work, proceed to step 3.

  3. Remove all the virtual machines on that volume from the inventory in the VirtualCenter server.

    Warning: Do not delete the virtual machines from disk. Remove them from the inventory.


  4. Log in to each host.
  5. Run the following command to verify which HBAs are providing access to the LUN:

    # esxcfg-mpath -l | less

  6. To set the ESX host to resignature all datastores detected as snapshots on the next rescan, run the following command:
    • For ESX:

      # echo "1" > /proc/vmware/config/LVM/EnableResignature

    • For ESXi:

      # esxcfg-advcfg -s 1 /LVM/EnableResignature

  7. To rescan the storage and perform the resignature on volumes detected as a snapshot, run the command:

    # vmkfstools -V

  8. To disable the resignature flag, run the following command:

    Warning: Do not skip this step.

    • For ESX:

      # echo "0" > /proc/vmware/config/LVM/EnableResignature
    • For ESXi:

      # esxcfg-advcfg -s 0 /LVM/EnableResignature

  9. To ensure that the volumes stay mounted after resignaturing is turned off, run the command:

    # vmkfstools -V

  10. Reinventory the virtual machines.
    1. Open VI Client to the VirtualCenter Server. The virtual machines show as inaccessible.
    2. Right-click on the virtual machine and click Remove From Inventory.
    3. Double-click the datastore to bring up the datastore browser.
    4. Select the folder in which the virtual machines resides.
    5. Right-click the virtual machine file (extension .vmx) or template file (extension .vmtx)
    6. Click Add to Inventory.
    7. Follow the wizard.

Additional Information

See Also

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback


Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.
What can we do to improve this information? (4000 or fewer characters)
Actions