Use the esxcli commands to add a multipathing PSA claim rule to the set of claim rules on the system. For the new claim rule to be active, you first define the rule and then load it into your system.
Before you begin
Install vCLI or deploy the vSphere Management Assistant (vMA) virtual machine. See Getting Started with vSphere Command-Line Interfaces. For troubleshooting, run esxcli commands in the ESXi Shell.
About this task
Examples when you add a PSA claim rule include the following:
You load a new multipathing plug-in (MPP) and must define the paths that this module claims.
You add new paths and want an existing MPP to claim them.
When creating claim rules, avoid a situation where different physical paths to the same LUN are claimed by different MPPs. Unless one of the MPPs is the MASK_PATH MPP, this configuration might cause performance problems.
In the procedure, --server=server_name specifies the target server. The specified target server prompts you for a user name and password. Other connection options, such as a configuration file or session file, are supported. For a list of connection options, see Getting Started with vSphere Command-Line Interfaces.
- To define a new claim rule, run the following command:
esxcli --server=server_name storage core claimrule add
The command takes the following options:
Indicate the adapter of the paths.
The system auto assigns a rule ID.
Indicate the channel of the paths.
Indicate the claim rule class.
Valid values are: MP, Filter, VAAI.
Indicate the device UID.
Indicate the driver of the paths.
Force claim rules to ignore validity checks and install the rule anyway.
Run this command if this advanced user variable is not set to 1.
Indicate the iSCSI Qualified Name for the target.
Indicate the LUN of the paths.
Indicate the model of the paths.
Indicate which PSA plugin. (required)
Indicate the rule ID.
Indicate the target of the paths.
Indicate the transport of the paths.
Valid values are: block, fc, iscsi, iscsivendor, ide, sas, sata, usb, parallel, unknown.
Indicate which type of matching is used for claim/unclaim or claimrule.
Valid values are: vendor, location, driver, transport, device, target. (required)
Indicate the vendor of the paths.
Indicate the World-Wide Node Number for the target.
Indicate the World-Wide Port Number for the target.
- To load the new claim rule into your system, run the following command:
esxcli --server=server_name storage core claimrule load
This command loads all newly created multipathing claim rules from your system's configuration file.
Defining Multipathing Claim Rules
In the following example, you add and load rule # 500. The rule claims all paths with the NewMod model string and the NewVend vendor string for the NMP plug-in.
# esxcli --server=server_name storage core claimrule add -r 500 -t vendor -V NewVend -M NewMod -P NMP
# esxcli --server=server_name storage core claimrule load
After you run the esxcli --server=server_name storage core claimrule list command, you can see the new claim rule appearing on the list.
The following output indicates that the claim rule 500 has been loaded into the system and is active.
Rule Class Rule Class Type Plugin Matches MP 0 runtime transport NMP transport=usb MP 1 runtime transport NMP transport=sata MP 2 runtime transport NMP transport=ide MP 3 runtime transport NMP transport=block MP 4 runtime transport NMP transport=unknown MP 101 runtime vendor MASK_PATH vendor=DELL model=Universal Xport MP 101 file vendor MASK_PATH vendor=DELL model=Universal Xport MP 500 runtime vendor NMP vendor=NewVend model=NewMod MP 500 file vendor NMP vendor=NewVend model=NewMod