Tuesday, October 11, 2011

Managing Paths with vicfg-mpath

To list all devices with their corresponding paths, state of the path, adaptor type, and other information, run vicfg-mpath  <conn_options>  --list-paths


To display a short listing of all paths, run
vicfg-mpath  <conn_options>  --list-compact


To display all paths with adapter and device mappings, run
vicfg-mpath  <conn_options>  --list-map


List paths and detailed information by specifying the path UID (long path). The path UID is the first item
in the vicfg-mpath --list display.
vicfg-mpath <conn_options> --list -P sas.5001c231c79c4a00-sas.1221000001000000-naa.5000c5000289c61b

In the below screen shot, the path UID for iSCSI would be
vicfg-mpath  <conn_options>  -l -P iqn.1998-01.com.vmware:esx1-0f770b14-00023d0000002,iqn.2006-01.com.openfiler:tsn.b6998f7991b6644F6D23626A435D207248425
It contains source and destination iqn.

List paths and detailed information by specifying the path runtime name.
vicfg-mpath <conn_options> -l -P vmhba32:C0:T0:L0


List detailed information for the paths for the device specified with --device.
vicfg-mpath <conn_options> -l -d mpx.vmhba32:C0:T1:L0
vicfg-mpath <conn_options> --list --device naa.60060...


Changing the State of a Path
To disable a path
1 (Optional) List all devices and corresponding paths.
vicfg-mpath <conn_options> --list-paths
The display includes information about each path’s state.
2 Set the state of a LUN path to off.
vicfg-mpath <conn_options> --state off --path vmhba32:C0:T1:L0
If you are changing a path’s state:
n The change operation fails if I/O is active when the path setting is changed. Reissue the command.
n You must issue at least one I/O operation before the change takes effect.
To reenable a path
When you are ready, set the path state to active again.
vicfg-mpath <conn_options> --state active --path vmhba32:C0:T1:L0

No comments: