The NMP SATP claim rules define which SATP manages a storage device. Usually, you can use the default SATPs provided for storage devices. If default settings are not sufficient, use the esxcli commands to change the SATP for a specific device.

You might need to create an SATP rule when you install a third-party SATP for a specific storage array.

Prerequisites

Install ESXCLI. See Getting Started with ESXCLI. For troubleshooting, run esxcli commands in the ESXi Shell.

Procedure

  1. To add a claim rule for a specific SATP, run the esxcli storage nmp satp rule add command. The command takes the following options.
    Option Description
    -b|--boot This rule is a system default rule added at boot time. Do not modify esx.conf or add to a host profile.
    -c|--claim-option=string Set the claim option string when adding a SATP claim rule.
    -e|--description=string Set the claim rule description when adding a SATP claim rule.
    -d|--device=string Set the device when adding SATP claim rules. Device rules are mutually exclusive with vendor/model and driver rules.
    -D|--driver=string Set the driver string when adding a SATP claim rule. Driver rules are mutually exclusive with vendor/model rules.
    -f|--force Force claim rules to ignore validity checks and install the rule anyway.
    -h|--help Show the help message.
    -M|--model=string Set the model string when adding SATP a claim rule. Vendor/Model rules are mutually exclusive with driver rules.
    -o|--option=string Set the option string when adding a SATP claim rule.
    -P|--psp=string Set the default PSP for the SATP claim rule.
    -O|--psp-option=string Set the PSP options for the SATP claim rule.
    -s|--satp=string The SATP for which a new rule is added.
    -R|--transport=string Set the claim transport type string when adding a SATP claim rule.
    -t|--type=string Set the claim type when adding a SATP claim rule.
    -V|--vendor=string Set the vendor string when adding SATP claim rules. Vendor/Model rules are mutually exclusive with driver rules.
    Note: When searching the SATP rules to locate a SATP for a given device, the NMP searches the driver rules first. If there is no match, the vendor/model rules are searched, and finally the transport rules. If there is still no match, NMP selects a default SATP for the device.
  2. Reboot your host.

Example: Defining an NMP SATP Rule

The following sample command assigns the VMW_SATP_INV plug-in to manage storage arrays with vendor string NewVend and model string NewMod.

# esxcli storage nmp satp rule add -V NewVend -M NewMod -s VMW_SATP_INV

When you run the esxcli storage nmp satp list -s VMW_SATP_INV command, you can see the new rule on the list of VMW_SATP_INV rules.