ESXi - 6.7 esxcli storage core claimrule add

From Da Nerd Mage Wiki
Jump to navigation Jump to search
-A|--adapter=<str>    Indicate the adapter of the paths to use in this
                       operation.
 -u|--autoassign       The system will auto assign a rule id.
 -C|--channel=<long>   Indicate the channel of the paths to use in this
                       operation.
 -c|--claimrule-class=<str>
                       Indicate the claim rule class to use in this operation
                       [MP, Filter, VAAI].
 -d|--device=<str>     Indicate the Device Uid to use for this operation.
 -D|--driver=<str>     Indicate the driver of the paths to use in this operation.
 -f|--force            Force claim rules to ignore validity checks and install
                       the rule anyway.
 --force-reserved      Override protection of reserved rule id ranges.
 --if-unset=<str>      Execute this command if this advanced user variable is not
                       set to 1
 -i|--iqn=<str>        Indicate the iSCSI Qualified Name for the target to use in
                       this operation.
 -L|--lun=<long>       Indicate the LUN of the paths to use in this operation. It
                       must not be higher than the value of the advanced config
                       option /Disk/MaxLUN
 -M|--model=<str>      Indicate the model of the paths to use in this operation.
 -P|--plugin=<str>     Indicate which PSA plugin to use for this operation.
                       (required)
 -r|--rule=<long>      Indicate the rule ID to use for this operation.
 -T|--target=<long>    Indicate the target of the paths to use in this operation.
 -R|--transport=<str>  Indicate the transport of the paths to use in this
                       operation.  Valid Values are:  [block, fc, iscsi,
                       iscsivendor, ide, sas, sata, usb, parallel, fcoe, unknown]
 -t|--type=<str>       Indicate which type of matching used for claim/unclaim or
                       claimrule. Valid values are:  [vendor, location, driver,
                       transport, device, target] (required)
 -V|--vendor=<str>     Indicate the vendor of the paths to user in this
                       operation.
 --wwnn=<str>          Indicate the World-Wide Node Number for the target to use
                       in this operation.
 --wwpn=<str>          Indicate the World-Wide Port Number for the target to use
                       in this operation.
 -m|--xcopy-max-transfer-size=<long>
                       Maximum transfer size in MB to use for XCOPY commands if
                       admin wants to use a transfer size different than array
                       reported. This option only takes effect when --xcopy-use-
                       array-values is specified. This option is deprecated. Use
                       --xcopy-max-transfer-size-kib  instead
 -k|--xcopy-max-transfer-size-kib=<long>
                       Maximum transfer size in KiB to use for XCOPY commands if
                       admin wants to use a transfer size different than array
                       reported. This option only takes effect when --xcopy-use-
                       array-values is specified. This option takes precedence
                       over --xcopy-max-transfer-size option
 -a|--xcopy-use-array-values
                       Use array reported values for XCOPY commands.
 -s|--xcopy-use-multi-segs
                       Use multiple segments for XCOPY commandsThis option only
                       takes effect when --xcopy-use-array-values is specified.

Examples:

Add rule #321 for the Filter plugin type that will claim the given device for the VAAI Filter plugin

  • esxcli storage core claimrule add -r 321 -t device -P VAAI_FILTER --claimrule-class=Filter --device=mpx.vmhba0

Add rule #321 for the VAAI plugin type that will claim the given device for the VMW_VAAIP_SYMM plugin

  • esxcli storage core claimrule add -r 321 -t device -P VMW_VAAIP_SYMM --claimrule-class=VAAI --device=naa.1234

Add rule #321 that will claim the path on adapter vmhba0, channel 0, target 0, LUN 0 for the NMP plugin

  • esxcli storage core claimrule add -r 321 -t location -A vmhba0 -C 0 -T 0 -L 0 -P NMP

Add rule #429 for the MP claim rule type that will claim all paths provided by an adapter with the mptscsi driver for the MASK_PATH plugin.

  • esxcli storage core claimrule add -r 429 -t driver -D mptscsi -P MASK_PATH --claimrule-class=MP

Add rule #914 to claim all paths with a vendor string matching "VMWARE" and a model string "Virtual" for the NMP plugin

  • esxcli storage core claimrule add -r 914 -t vendor -V VMWARE -M Virtual -P NMP

Add rule #1015 to claim all paths provided by Fibre Channel type adapters for the NMP plugin.

  • esxcli storage core claimrule add -r 1015 -t transport -R fc -P NMP

Add rule #429 to claim all paths provided by Fibre Channel Target on given WWNN and WWPN.

  • esxcli storage core claimrule add -r 429 -P NMP -t target -R fc --wwnn 50:06:01:60:ba:60:11:53 --wwpn 50:06:01:60:3a:60:11:53

Add rule #429 to claim paths to LUN 5 provided by iSCSI Target on given IQN.

  • esxcli storage core claimrule add -r 429 -P NMP -t target -R iscsi --iqn iqn.2001-04.com.example:storage.disk2.sys1.xyz --lun 5

Add a rule with a system assigned rule id to claim all paths provided by Fibre Channel type adapters for the NMP plugin.

  • esxcli storage core claimrule add --autoassign -t transport -R fc -P NMP

Add a VAAI rule enabling using array reported values & multiple segments while issuing XCOPY Commands.

  • esxcli storage core claimrule add -r 65430 -t vendor -V EMC -M SYMMETRIX -P VMW_VAAIP_SYMM -c VAAI -a -s -m 200

Add a VAAI rule enabling using array reported values & set maxTransferSize in KiB whileissuing XCOPY Commands.

  • esxcli storage core claimrule add -r 65430 -t vendor -V EMC -M SYMMETRIX -P VMW_VAAIP_SYMM -c VAAI -a -k 256

Add a VAAI rule enabling using array reported values & set maxTransferSize in KiB whileissuing XCOPY Commands.

  • esxcli storage core claimrule add -r 65430 -t vendor -V EMC -M SYMMETRIX -P VMW_VAAIP_SYMM -c VAAI -a -s -k 204800