Loading

×Sorry to interrupt
CSS Error

Refresh

Cookie Preference Center

General Information on cookies

When you visit our website, we use cookies to ensure that we give you the best experience. This information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies by clicking on the different category headings to find out more and change your settings. However, blocking some types of cookies may impact your experience on the site and the services we are able to offer. Further information can be found in our

Cookie Policy.

Strictly Necessary

Strictly Necessary

Always Active

Strictly Necessary

Strictly necessary cookies are always enabled since they are essential for our website to function. They enable core functionality such as security, network management, and website accessibility. You can set your browser to block or alert you about these cookies, but this may affect how the website functions. For more information please visit www.aboutcookies.org or www.allaboutcookies.org.

Cookie Details‎

Performance

Performance

Performance

Performance cookies are used to analyze the user experience to improve our website by collecting and reporting information on how you use it. They allow us to know which pages are the most and least popular, see how visitors move around the site, optimize our website and make it easier to navigate.

Cookie Details‎

Please confirm your settings by refreshing the page.

Functional

Functional

Functional

Functional cookies help us keep track of your past browsing choices so we can improve usability and customize your experience. These cookies enable the website to remember your preferred settings, language preferences, location and other customizable elements such as font or text size. If you do not allow these cookies, then some or all of these services may not function properly.

Cookie Details‎

Advertising

Advertising

Advertising

Advertising cookies are used to send you relevant advertising and promotional information. They may be set through our site by third parties to build a profile of your interests and show you relevant advertisements on other sites. These cookies do not directly store personal information, but their function is based on uniquely identifying your browser and internet device.

Cookie Details‎

Advertising Cookies

Consent Leg.Interest

Select All Vendors

Select All Vendors

Select All Hosts

Select All

Clear Filters

Information storage and access

Apply

Confirm My Choices Reject All Allow All

My Subscriptions

Loading

Knowledge Base

Powering on or migrating a virtual machine fails with the error: Virtual Disk 'X' is a mapped direct access LUN that is not accessible (1016210)

Last Updated: 2/27/2024Categories: TroubleshootingTotal Views: 87970Language:
Chinese (Simplified)JapaneseEnglish

4 like this article

Subscribe to get an email
newsletter with new updates

4 people found this helpful Please provide article feedback:

Symptoms

Powering on or migrating (vMotion) a virtual machine with a raw device mapping (RDM) may fail.

You see the error:

Virtual Disk 'X' is a mapped direct access LUN that is not accessible

When checking the VML identifier for a RDM on two or more ESX hosts, you see they are not referring to the same VML ID.

Note: This is referred to as as a VML mismatch.

Cause

This is an informational event which indicates that the host attempting to start or receive the virtual machine cannot access the device (LUN) backing the raw disk mapping.

For more information on raw device mappings, see the Raw Device Mapping section of the ESX/ESXi Server Configuration Guide for your version.

A raw device mapping file contains metadata, specifically SCSI vital product data (VPD) page 0x83, for uniquely identifying a device. A host attempting to access the physical LUN reads the mapping file metadata, and searches the devices known to the host for a LUN with the same VPD page 0x83 information.

The contents of SCSI VPD page 0x83 should match when requested by all hosts in a vSphere cluster, and the RDM should be accessible by all hosts in the cluster. However, discrepancies in device presentation between hosts in a cluster may lead to different hosts receiving different contents for VPD page 0x83 for the same device. In this case, hosts which did not create the RDM mapping file may be unable to locate the raw device mapping LUN when powering on or migrating a virtual machine.

Note: Cold migrations of powered off virtual machines do not require access to the raw device mapping. Symptoms may be noticed after cold migration, when the virtual machine is powered on.

Resolution

Identifying mis-presented devices using VML identifiers

The VPD page 0x83 information, when available, forms the basis of the unique VML identifier which the ESX/ESXi host assigns to each storage device. This VML identifier should be consistent for a given device across each host in a vSphere cluster.

Identify the device being used for a raw device mapping by its VML identifier, such as by reviewing the contents of /vmfs/devices/disks/, on each host in a cluster. Compare the VML identifier obtained for the device on each host. For more information, see Identifying disks when working with VMware ESX (1014953).

The highlighted sections of the VML identifiers in this example do not match between the hosts, indicating a LUN with different presentation to each host:

Host 1:

vml.02000500006006048000019010406353303035344553594d4d4554 -> naa.60060480000190104063533030353445

Host 2:

vml.02004d00006006048000019010406353303035344553594d4d4554 -> naa.60060480000190104063533030353445

Note: In the above example, the highlighted value equates to the device's LUN number represented in hexadecimal. On host 1, the LUN has been presented as LUN 5, and on Host 2, it has been presented as LUN 77.

LUN presentation (including LUN numbering) should be made consistent for every host participating in a cluster that could run the virtual machine. The raw device mapping metadata file should be consistent with that presentation, and vCenter Server's cache of this information should be accurate.

Segmented cluster:

If one segment of a vSphere Cluster has correct presentation of the LUN being used for a raw device mapping, but other segments do not, the virtual machine operates correctly only within the segment with correct presentation. Correct the presentation in the nonworking segment(s):

Unpresent the LUNs from the hosts with incorrect presentation. For more information, see Removing a LUN containing a datastore from VMware ESXi/ESX 4.x (1029786) and Unmounting a LUN or detaching a datastore/storage device from multiple ESXi 5.x hosts (2004605).

Represent the LUNs in the same manner as the working hosts. For more information, engage your storage array vendor.

Rescan to pick up storage changes. For more information, see Performing a rescan of the storage (1003988).

Verify that the host LUN ID matches on all the hosts in the cluster that have access to that LUN.

Verify that the VML ID for the device matches on all the hosts in the cluster.

If the host LUN ID matches and the VML ID does not match:

Unpresent the LUN on the host where the VML ID does not reflect the correct host LUN ID. For more information, see Removing a LUN containing a datastore from VMware ESXi/ESX 4.x (1029786) or Unmounting a LUN or Detaching a Datastore/Storage Device from multiple ESXi 5.x hosts (2004605).

Perform a rescan, then represent the LUN. Verify that the VML ID matches.

Attempt migration of the virtual machine from the working segment to the corrected hosts.

Note: The above procedure may result in the VML mismatch issue still being present due to the way ESX caches vml devices. If the issue persists, repeat the procedure, but this time represent the LUN from the array with a different LUN ID. This forces a new VML identifier to be created for the LUN.

Note: An alternate method of correcting VML IDs for mispresented LUNs:

Note the NAA_ID of the LUN.

Detach RDM using vSphere client.

Un-present the LUN from host on array.

Rescan host storage.

Remove LUN from detached list using these commands:

esxcli storage core device detached list
esxcli storage core device detached remove -d NAA_ID

Rescan the host storage.

Re-present LUN to host.

Rescan host

If the LUN has been flagged as perennially reserved, this can prevent the removal from succeeding.

Run this command to remove the flag:
# esxcli storage core device setconfig -d NAA_ID --perennially-reserved=false

Now the command to remove the device should work.
# esxcli storage core device detached remove -d NAA_ID

There is no harm in setting the flag to false, even if it is not needed, so it might be simpler to always run both commands.

Whole cluster:

If a virtual machine cannot be started on any host in a vSphere Cluster, the presentation to each host may differ from the VPD Page 0x83 information stored within the raw device mapping file. Recreate the mapping file:

Power down the virtual machine.

Right-click the virtual machine and click Edit Settings.

Make note of the raw device mapped disks which are attached to the virtual machine.

Remove the raw device mapped disks from the virtual machine.

Click OK.

Right-click the virtual machine and click Edit Settings.

Click Add to re-add the previously removed raw device(s).

Click OK.

Power on the virtual machine and re-attempt the operation which previously failed.

vCenter Server cache:

The vCenter Server maintains a cache of storage topology information for virtual machines. If this information has become out of sync with the presentation, power operations or migrations initiated from vCenter Server may fail. Remove the affected virtual machine from inventory and re-register it to clear the cached information:

Power down the virtual machine.

Right-click the virtual machine and remove it from the inventory.

Re-register the virtual machine to the inventory. For more information, see Registering or adding a virtual machine to the inventory (1006160).

Power on the virtual machine and retry the operation which previously failed.

Related Information

Failed to power on virtual machine
Performing a rescan of the storage on an ESX/ESXi host
How to register/add a VM to the Inventory in vCenter Server
Identifying disks when working with VMware ESXi/ESX
Removing a LUN containing a datastore from VMware ESXi/ESX 4.0 and 4.1
How to unmount a LUN or detach a datastore device from ESXi hosts
一つ以上の RDM のディスクが接続された仮想マシンの移行が、次のエラーで失敗する：Target disc should be different than the source disc, unable to access file
仮想マシンのパワーオンまたは移行が次のエラーで失敗する：仮想ディスク 'X' はマップされた直接アクセス LUN です。アクセスできません
打开虚拟机电源或迁移虚拟机失败，并显示错误：虚拟磁盘“X”是映射的直接存取 LUN，但不可访问 (Virtual Disk 'X' is a mapped direct access LUN that is not accessible)

Detectable by VMware SkylineTM

Actions

Copy

link to clipboard
copied!

Print

Language:
Chinese (Simplified)JapaneseEnglish

Attachments

Additional Resources

KB
•
End Of General Availability of the Free vSphere Hypervisor (ESXi 7.x and 8.x) (2107518)

KB
•
Download and Install VMware Fusion (2014097)

Results 1-2 of 2

Ask The Community

Get answers quickly from VMware experts in the community

Post Subject

CONTINUE IN COMMUNITIES

Related Products:

VMware vSphere ESXi

VMware VirtualCenter

VMware vCenter Server

VMware ESX Server

Related Versions:

VMware vSphere ESXi 6.7

VMware vSphere ESXi 6.5

VMware vSphere ESXi 6.0

VMware vSphere ESXi 5.5

VMware vSphere ESXi 5.1

VMware vSphere ESXi 5.0

VMware VirtualCenter 2.5.x

VMware vCenter Server 6.7.x

VMware vCenter Server 6.5.x

VMware vCenter Server 6.0.x

VMware vCenter Server 5.5.x

VMware vCenter Server 5.1.x

VMware vCenter Server 5.0.x

VMware vCenter Server 4.1.x

VMware vCenter Server 4.0.x

VMware ESXi 4.1.x Installable

VMware ESXi 4.1.x Embedded

VMware ESXi 4.0.x Installable

VMware ESXi 4.0.x Embedded

VMware ESXi 3.5.x Installable

VMware ESXi 3.5.x Embedded

VMware ESX Server 3.5.x

VMware ESX Server 3.0.x

VMware ESX 4.1.x

VMware ESX 4.0.x

view all

Take Our Survey

Support Assistant