Search the VMware Knowledge Base (KB)
View by Article ID

Resignaturing VMFS3 volumes on VMware ESX 3.x via the VMware Infrastructure Client (9453805)

  • 69 Ratings

Details

Solution

Note: This article applies to VMware ESX 3.x hosts. If you have a VMware ESX 4.x host, see vSphere handling of LUNs detected as snapshot LUNs (1011387).
 
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.
 
Important:
  • If you do not have actual snapshot LUNs presented and have no plans to present any to these hosts, follow the directions in VMFS Volume Can Be Erroneously Recognized as a Snapshot (6482648) , then skip to step 9 below.
  • If you have to resignature a datastore spanned across more than one LUN, you must make sure that all the LUNs that comprise the datastore are in a snapshot state. Failing to do so may result in getting the datastore locked into an inconsistent status, which may require VMware support assistance.

To resignature the VMFS3 volumes in VMware Infrastructure (VI) Client:
 
Note: You can complete this resignaturing procedure from the command line. For more information, see Resignaturing VMFS3 volumes from the command line (1005751).

Caution: This procedure can be time-consuming, depending on the size of the environment. Ensure that you budget time for the outage.
  1. Shut down all virtual machines running on the datastores recognized as snapshots.

    Note: This step is necessary because those datastores are affected by the resignaturing process and it cannot be applied to a datastore that is being used (that is, with active I/O).

  2. Unregister all of the virtual machines on the affected datastore(s). This can be done from VI Client by right-clicking on the virtual machine and selecting Remove from Inventory.

  3. Rescan.

    Note: The /var/log/vmkernel file contains snapshot messages
    .

  4. Enable LVM Resignaturing on the first ESX host :

    1. Log in to the ESX host with VI Client.
    2. Click the Configuration tab.
    3. Select the Advanced setting option.
    4. Choose the LVM section.
    5. Set the value of LVM.EnableResignaturing to 1.
    6. Save the change.
    7. Click the storage adapter tab.
    8. Click Rescan Adapter located at the top right corner of the interface.

      Note: There is no need to select an HBA. All are rescanned.

    9. Leave the default option and proceed.

      You are now able to see the VMFS volumes with labels prefixed with snap.

  5. Disable LVM Resignaturing :

    1. Log on to the ESX host with VI client.
    2. Click the Configuration tab.
    3. Select the Advanced setting option.
    4. Choose the LVM section.
    5. Set the value of LVM.EnableResignaturing to 0 .
    6. Save the change.

      No snapshot messages are visible in /var/log/vmkernel.

  6. Re-label the volume.
    1. Log in to the VirtualCenter Server with VI Client.

      Note: Connecting directly to the ESX host does not offer the view identified in step b.

    2. Click the arrow next to the Inventory menu option and click Datastores.
    3. Select the datastore from the list. It should be prepended with snap. Right-click and select Rename to apply your intended label.

      If you are unable to apply the intended datastore label because it already exists or is in-use (as an Inactive or Inaccessible datastore in italicized, gray letters), ensure that all references to the original datastore have been removed from inventory, per step 2, above.

      Here is such an example of virtual machines not being removed from inventory yet. snap-8a2d0912-SAN cannot assume the original name of SAN until the virtual machines temp and aks-win2k3-r2 have been removed from inventory:



      Note: This requirement includes not only virtual machines, but also attached ISOs or disc images which may reside on the resignatured volume.

      When all references have been removed, the gray datastore instance (SAN, from the above) will disappear from the list of datastores present in the Datastores view. You may then rename the current snap-prepended (resignatured) datastore to your intended name.

    4. Click the arrow next to the Inventory menu option and click Hosts & Clusters to return you to the previous view.

  7. Rescan storage from all ESX hosts. You do not need to rescan from the host that performed the resignature.

    1. Select an ESX host server from the inventory.
    2. Click the Configuration tab.
    3. Select Storage Adapters.
    4. On the top-right, select Rescan.
    5. Accept the defaults when prompted and complete the rescan.

  8. Because the virtual machines are registered against the old UUID, you must re-register them in VirtualCenter.

    To re-register the virtual machine in VirtualCenter:
    1. Log in to the ESX host with VI client.
    2. Click the Configuration tab.
    3. Select Storage (SCSI, SAN & NFS).
    4. Double-click any of the datastores to open the Datastore browser.
    5. Navigate to the .vmx file of any of the virtual machines by clicking the folders.
    6. Right-click and click Add to inventory.

  9. Remap any RDMs.

    If you have a virtual machine that uses an RDM, you must recreate the mapping.

    Caution: If you used multiple RDMs, it may be difficult to identify one from another. If the RDMs are different sizes, you can map them in the correct order by their sizes. If the RDMs are all the same size, this is a more difficult process because you must map the RDMs to one virtual machine at a time, boot the virtual machine, and then verify if it is the correct LUN. To prevent having to map the RDMs to one virtual machine at a time:
    • Make a note of the sizes of the RDMs and which virtual machines they are associated with before starting this process.
    • Make a note of the LUN ID before starting this process. You might be able to use this information to recreate the mapping.

  10. Power on the virtual machines. Reply yes if prompted about a new UUID.

    If any of the virtual machines refer to missing disks when they power up, check the .vmx file and ensure that the SCSI disk references are not made against the old UUID instead of against the label (or new label, if you changed it). For more information, see Unable to power on a virtual machine after a volume resignature (1007022).

  11. Repeat Steps 3 to 9 for all subsequent ESX hosts that still see snapshot volumes. If all ESX hosts share the same volumes, this step is not necessary.

Tags

snapshot-lun

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

  • 69 Ratings

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)




Please enter the Captcha code before clicking Submit.
  • 69 Ratings
Actions
KB: