SYNOPSIS
vicfg-mpath35 [OPTIONS]
DESCRIPTION
vicfg-mpath35 provides an interface to configure multipath settings for Fibre Channel or iSCSI LUNs on ESX/ESXi version 3.5 hosts. Use vicfg-mpath for ESX/ESXi 4.0 and later hosts.
OPTIONS
- --help
- Prints a help message for each command-specific and each connection option. Calling the command with no arguments or with
--help
has the same effect. - --list | -l
- Lists all LUNs and the paths to these LUNs through adapters on the system. For each LUN, the command displays the type, internal name, console name, size, and paths, and the policy used for path selection.
- --policy | -p
- Sets the policy for a given LUN 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) rotates through all available paths. Fixed (fixed) uses only the active path. This option requires that you also specify the --lun option.
- --state | -s
- Sets the state of a given LUN path to either "on" or "off". This option requires that you also specify the
--lun
and--path
options. - --preferred | -f
- Sets the given path to be the "preferred" path for a given LUN. This option requires that you also specify the
--lun
and--path
options. - --query | -q
- Queries a specific LUN for its information and print it. This option requires that you also specify the
--lun
option. - --path | -P
- Specifies the path to use in other operations. You cannot use this option by itself.
- --lun | -L
- Specifies the LUN to use in other operations. You cannot use this option by itself.
- --detailed | -d
- Displays all information about a LUN and its paths including the vml name of the LUN.
- --bulk | -b
- Shows all LUNs and paths in a format easily parsed by scripts.
- --hbas | -a
- Prints the list of HBAs that can be identified by a unique ID. This option lists Fibre Channel and iSCSI devices. Parallel and Block devices do not appear in the list.
- --vihost | -h
- When you execute this command with
--server
pointing to a vCenter Server system, you can use--vihost
to specify the ESX/ESXi host to run the command against.
EXAMPLES
List all LUNs and the paths to these LUNs through adapters on the system:
vicfg-mpath35 --server <servername> --username <user name>
--password <password> -l
Set the policy for a specific LUN. Requires --lun is also specified to indicate the LUN to operate on:
vicfg-mpath35 --server <server name> --username <user name>
--password <password> --policy mru --lun vmhba0:8:0
Set the state for a specific LUN path. Requires both --lun and --path are specified. This operation may appear to fail if there is active I/O on a path that is set to "off":
vicfg-mpath35 --server <server name> --username <user name>
--password <password> --state <on|off> --path <path flag> --lun <lunname>
Set the given path to be the preferred path for the given LUN. Requires both --path and --lun are specified:
vicfg-mpath35 --server <server name> --username <user name>
--password <password> --preferred --path vmhba0:8:0 --lun vmhba0:8:0
Query the information on a specific LUN:
vicfg-mpath35 --server <server name> --username <user name>
--password <password> --query --lun vmhba0:8:0
Indicate which LUN to operate on. You can specify the LUN either with its internal VMkernel vmhba name (vmhbaX:X:X) or with its vml name as found in /vmfs/devices/disks:
vicfg-mpath35 --server <server name> --username <user name>
--password <pasword> --policy mru --lun vmhba0:8:0
Return a bulk path listing suitable for parsing:
vicfg-mpath35 --server <server name> --username <user name>
--password <password> -b