Use the vSphere CLI to add a new 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 new claim rule if you add new paths and want an existing MPP to claim them.


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 errors.


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

esxcli corestorage claimrule add -r <claimrule_ID> -t <type> <required_option (based on type)> -P <MPP_name>

For information on the options that the command requires, see esxcli corestorage Command-Line Options.


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

esxcli corestorage claimrule load

This command has no options. It loads all newly created claim rules from your system's configuration file.

In the following example, you define the claim rule # 500, which specifies that the NMP module claims all paths to the NewMod model of the NewVend storage array. You then load this claim rule into your system.


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


# esxcli corestorage claimrule load

If you now run the esxcli corestorage claimrule list command, you can see the new claim rule appearing on the list.


The two lines for the claim rule, one with the Class of runtime another with the Class of file, indicate that the new claim rule has been loaded into the system and is active.

Rule  Class     Type        Plugin              Matches
0     runtime   transport   NMP                 transport=usb
1     runtime   transport   NMP                 transport=sata
2     runtime   transport   NMP                 transport=ide
3     runtime   transport   NMP                 transport=block
101   runtime   vendor      MASK_PATH           vendor=DELL model=Universal Xport
101   file      vendor      MASK_PATH           vendor=DELL model=Universal Xport
500   runtime   vendor      NMP                 vendor=NewVend model=NewMod 
500   file      vendor      NMP                 vendor=NewVend model=NewMod