Use the vSphere CLI to add a new 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.

You add a new PSA claim rule when, for example, you load a new multipathing plug-in (MPP) and need to define which paths this module should claim. You may need to create a claim rule if you add new paths and want an existing MPP to claim them.

Caution

When creating new claim rules, be careful to avoid a situation when different physical paths to the same LUN are claimed by different MPPs. Unless one of the MPPs is the MASK_PATH MPP, this configuration will cause performance problems.

1

To define a new claim rule, on the vSphere CLI, run the following command:

esxcli corestorage claimrule add

For information on the options that the command requires, see esxcli corestorage claimrule Options.

2

To load the new claim rule into your system, run the following command:

esxcli corestorage claimrule load

This command loads all newly created multipathing claim rules from your system's configuration file.

Add rule # 500 to claim all paths with the NewMod model string and the NewVend vendor string for the NMP plug-in.

# esxcli corestorage claimrule add -r 500 -t vendor -V NewVend -M NewMod -P NMP

After you load the claim rule and run the esxcli corestorage claimrule list command, you can see the new claim rule appearing on the list.

Note

The two lines for the claim rule, one with the Class of runtime and another with the Class of file, indicate that the new claim rule 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 

Add rule # 321 to claim the path on adapter vmhba0, channel 0, target 0, LUN 0 for the NMP plug-in.

# esxcli corestorage claimrule add -r 321 -t location -A vmhba0 -C 0 -T 0 -L 0 -P NMP

Add rule # 1015 to claim all paths provided by Fibre Channel adapters for the NMP plug-in.

# esxcli corestorage claimrule add -r 1015 -t transport -R fc -P NMP

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

# esxcli corestorage claimrule add --autoassign -t transport -R fc -P NMP