Knowledge Base

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

Modifying path information for ESXi/ESX hosts (2000552)

Purpose

This article explains how to enable and disable LUN paths and to change the multipathing policy information for ESXi/ESX hosts.

Resolution

There are two methods that can be used to change multipathing policy and to enable/disable paths on an ESXi/ESX host:
  • ESXi/ESX command line – Use the command line to modify the multipathing information when performing troubleshooting procedures.
  • VMware Infrastructure Client / vSphere Client – Use this option when you are performing system maintenance.

ESXi 5.x

Change multipathing policy

To change the multipathing policy information from the ESXi 5.x host command line:
  1. Log into the ESXi 5.x host.
  2. Run the command:

    # esxcli storage nmp device set --device naa_id --psp path_policy

    Where naa_id is the NAA ID of the device and path_policy is one of the PSP options listed in Multipathing policies in ESXi 5.x and ESXi/ESX 4.x (1011340).

    For example, to change the above device path policy to Round Robin:

    # esxcli storage nmp device set --device naa.6006016010202a0080b3b8a4cc56e011 --psp VMW_PSP_RR
To change multipathing settings for your storage in the vSphere Client:
  1. Select an ESXi host you want to modify, and click the Configuration tab.
  2. Click Storage.
  3. Select a datastore or mapped LUN.
  4. Click Properties.
  5. In the Properties dialog, select the desired extent, if necessary.
  6. Click Extent Device > Manage Paths and obtain the paths in the Manage Path dialog.
  7. Under the Policy section, select the desired multipathing policy from the dropdown.
  8. Click Change to confirm the change in path policy.

To change multipathing settings for your storage in the vSphere 5.x Web Client:
  1. Select your vCenter Server and expand the datacenter that houses your hosts.
  2. Select the ESXi host you want to modify and click the Manage tab at the top of the right-hand pane.
  3. Click Storage > Storage Devices and select the LUN you want to modify.
  4. In the Properties pane, click Edit Multipathing to obtain the paths that are in use.
  5. Under the Policy section, select the desired multipathing policy from the dropdown.
  6. Click OK to apply the change in path policy.
For more information on multipathing options, see Multipathing policies in ESXi 5.x and ESXi/ESX 4.x (1011340).


Enable or disable a path

To enable or disable a path from the ESXi 5.x host command line:
  1. Log into the ESXi 5.x host.
  2. Run the command:

    # esxcli storage core path set --state=state -p path

    Where:
    • path is the particular path to be enabled/disabled
    • device is the NAA ID of the device
    • state is active or off

    For example, to disable path fc.2000001b32865b73:2100001b32865b73-fc.50060160c6e018eb:5006016646e018eb-naa.6006016095101200d2ca9f57c8c2de11, which has a Runtime Name of vmhba3:C0:T1:L0, for device naa.6006016010202a0080b3b8a4cc56e011:

    # esxcli storage core path set --state=off -p fc.2000001b32865b73:2100001b32865b73-fc.50060160c6e018eb:5006016646e018eb-naa.6006016095101200d2ca9f57c8c2de11

To enable or disable a path for your storage in the vSphere Client:
  1. Click the ESXi host you want to modify and click the Configuration tab.
  2. Click Storage.
  3. Click a datastore or mapped LUN.
  4. Click Properties.
  5. In the Properties dialog, select the desired extent, if necessary.
  6. Click Extent Device > Manage Paths and obtain the paths in the Manage Path dialog.
  7. Right-click the desired path and click Disable or Enable.If the currently active path is disabled, it forces a path failover.

To enable or disable a path for your storage in the vSphere 5.x Web Client:
  1. Click your vCenter Server and expand the datacenter that houses your hosts.
  2. Click the ESXi host you want to modify and click the Manage tab at the top of the right-hand pane.
  3. Click Storage > Storage Devices and select the LUN you want to modify.
  4. In the Properties pane, click the Paths tab.
  5. Click the desired path and click the Disable or Enable button. If the currently active path is disabled, it forces a path failover.
For more information on multipathing options, see Multipathing policies in ESXi/ESX 4.x and ESXi 5.x (1011340).

ESXi/ESX 4.x

Change multipathing policy

To change the multipathing policy information from the ESXi/ESX host command line:
  1. Log into the ESXi/ESX 4.x host.
  2. Run the command:

    # esxcli nmp -d naa_id path_policy

    Where naa_id is the NAA ID of the device and path_policy is one of the PSPs listed in Multipathing policies in ESXi 5.x and ESXi/ESX 4.x (1011340).

    For example, to change the device path policy to Round Robin:

    # esxcli nmp device setpolicy -d naa.6006016010202a0080b3b8a4cc56e011 --psp=VMW_PSP_RR
    For more information, see Changing a LUN to use a different Path Selection Policy (PSP) (1036189).

To change multipathing settings for your storage in the vSphere Client:
  1. Click the ESXi/ESX host you want to modify and click the Configuration tab.
  2. Click Storage.
  3. Select a datastore or mapped LUN.
  4. Click Properties.
  5. In the Properties dialog, select the desired extent, if necessary.
  6. Click Extent Device > Manage Paths and obtain the paths in the Manage Path dialog.
  7. Under the Policy section, select the desired multipathing policy from the dropdown menu.
  8. Click Change to confirm the change in path policy.
For more information on multipathing options, see Multipathing policies in ESXi 5.x and ESXi/ESX 4.x (1011340).


Enable or disable a path

To enable or disable a path from the ESXi/ESX 4.x host command line:
  1. Log into the ESXi/ESX 4.x host.
  2. Run the command:

    # esxcfg-mpath -P path -s state

    Where:
    • path is the particular path to be enabled/disabled
    • device is the NAA ID of the device
    • state is active or off

    For example, to disable path fc.2000001b32865b73:2100001b32865b73-fc.50060160c6e018eb:5006016646e018eb-naa.6006016095101200d2ca9f57c8c2de11, which has a Runtime Name of vmhba3:C0:T1:L0, for device naa.6006016010202a0080b3b8a4cc56e011:

    # esxcfg-mpath -P fc.2000001b32865b73:2100001b32865b73-fc.50060160c6e018eb:5006016646e018eb-naa.6006016095101200d2ca9f57c8c2de11 -s off

To enable or disable a path for your storage in the vSphere Client:
  1. Select the ESXi/ESX host you want to modify and click the Configuration tab.
  2. Click Storage.
  3. Select a datastore or mapped LUN.
  4. Click Properties.
  5. In the Properties dialog, select the desired extent, if necessary.
  6. Click Extent Device > Manage Paths and obtain the paths in the Manage Path dialog.
  7. Right-click the desired path and click Disable or Enable. If the currently active path is disabled, it forces a path failover.

To change the preferred path for a device or a LUN from the command line:
  1. Log into the ESXi/ESX 4.x host.
  2. To get a list of the paths available and the path policy details, run the command:

    # esxcfg-mpath -l

  3. To change the preferred path, run the command:

    # esxcli nmp fixed setpreferred --device naa_id --path path

    Where:

    • path is the path to be enabled/disabled. For example,vmhba2:3:4.
    • naa_id is the canonical name of the device. For example, naa.6006016010202a0080b3b8a4cc56e011.

  4. To verify the changes to the preferred path, run the command:

    # esxcfg-mpath -l

    Look for the change in On Active preferred for the specified path.
For more information on multipathing options, see Multipathing policies in ESXi 5.x and ESXi/ESX 4.x (1011340).

ESXi/ESX 3.x

Change multipathing policy

To change the multipathing policy information from the ESXi/ESX 3.x host command line:
  1. Log into the ESXi/ESX 3.x host.
  2. Run the command:

    # esxcfg-mpath --policy=path_policy --lun=device

    Where device is the Canonical name of the device and path_policy is one of fixed, mru, or rr.

To change multipathing settings for your storage in the vSphere Client:
  1. Click the ESXi/ESX host you want to modify and click the Configuration tab.
  2. Click Storage.
  3. Select a datastore or mapped LUN.
  4. Click Properties. The Properties dialog appears:



    In this example, you can see that the canonical name is vmhba2:1:0 and the true paths are vmhba2:1:0 and vmhba2:3:0. The active path is vmhba2:1:0 and the policy is Most Recently Used.

  5. Click Manage Paths. The Manage Paths dialog appears:



  6. To change the policy, click Change in the Policy section. The Selection Policy dialog appears:



  7. Click OK to return to the Manage Paths dialog.

Enable or disable path

To enable or disable a path from the ESXi/ESX 3.x host command line:
  1. Log into the ESXi/ESX 3.x host.
  2. Run the command:

    # esxcfg-mpath --path=path --lun=device --state=state

    Where:
    • path is the particular path to be enabled/disabled (for example, vmhba2:3:4)
    • device is the Canonical name of the device (for example, vmhba2.1.4)
    • state is on or off

To enable or disable a path for your storage in the VMware Infrastructure Client:
  1. To enable or disable a path, open the Manage Paths dialog (follow steps 1 to 6 above).
  2. Click the desired path and click Change.



    As the policy for this LUN is Most Recently Used, the Preferred option is unavailable. If you disable the currently active path, it forces a path failover.

  3. Click OK to return to the Manage Paths dialog.

Additional Information

To be alerted when this article is updated, click Subscribe to Document in the Actions box.

Tags

lun-paths

See Also

Update History

10/10/2011 - Added steps to change the preferred path for a device or a LUN from the command line

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

  • 7 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)
  • 7 Ratings
Actions
KB: