AVArcher
Virtual Infrastructure Specialists
HOME SERVICES ABOUT US PARTNERS CONTACT US

esxcfg-mpath - VMware ESX Server multipathing information

esxcfg-mpath

NAME
esxcfg-mpath - VMware ESX Server multipathing information

COPYRIGHT
VMware ESX Server is Copyright 2006 VMware, Inc. All rights reserved.

SYNOPSIS
esxcfg-mpath OPTIONS

DESCRIPTION
esxcfg-mpath configures multipath settings for Fibre Channel or iSCSI LUNs.

OPTIONS

-l -list
List all LUNs and the paths to these LUNs through adapters on the system. Each LUN will contain the type, internal name, console name, size, paths, and the policy used for path selection.
-p -policy
Set the policy for a given to one of "mru", "rr", or "fixed". Most Recently Used (mru) selects the path most recently used to send I/O to a device. Round Robin (rr) will rotate through all available paths. Fixed (fixed) will use only the active path. This parameter requires that the --lun parameter is also passed to indicate one which LUN to operate.
-s -state
Set the state of a given LUN path to either "on" or "off". This flag requires both the --lun and --path flags to be set. This operation may appear to fail if there is active I/O on a path that is set to "off".
-f -preferred
Set the given path to be considered "preferred" for a given LUN. This flag requires both the --lun and --path flags to be set.
-q -query
Query a specific LUN for its information and print it. This flag requires the --lun flag to be set.
-P -path
Required to specify the path to use in operations. This is a required parameter for other options and does not itself indicate an operation.
-L -lun
Required to specify the LUN to use in operations. This is a required parameter for other options and does not itself indicate an operation.
-v -verbose
Show all information about a LUN and its paths including the vml name of the LUN.
-b -bulk
Show all LUNs and paths in a format easily parsed by scripts.
-a -hbas
Print the list of HBAs that are identifiable by a unique ID. This includes FibreChannel and iSCSI devices. Parallel and Block devices will not appear in this list.
-h -help
Print the help message.
-r -restore
Restore path setting to configured values on system start. This should not be used by end users as it may cause unintended consequences when executed on a running system.

EXAMPLES

To see all paths :
esxcfg-mpath -l

To see paths for disk vml.123456 :
esxcfg-mpath -q --lun=vml.123456


To set policy for disk vmhba0:0:1 to mru :
esxcfg-mpath --policy=mru --lun=vmhba0:0:1


To set preferred path for disk vmhba0:0:1 ;
esxcfg-mpath --preferred --path=vmhba1:0:1 --lun=vmhba0:0:1


To enable a path for disk vmhba0:0:1 :
esxcfg-mpath --path=vmhba1:0:1 --lun=vmhba0:0:1 --state=on


To disable a path and set policy to fixed for disk vmhba0:0:1 :
esxcfg-mpath --path=vmhba0:1:1 --state=off --lun=vmhba0:0:1 -p
fixed

 

© 2002-2010 AVArcher