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
|