The NMP SATP claim rules specify which SATP should manage a particular storage device. Usually you do not need to modify the NMP SATP rules. If you need to do so, use the esxcli commands to add a rule to the list of claim rules for the specified SATP.

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

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.

Prerequisites

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.

Procedure

  1. To add a claim rule for a specific SATP, run the esxcli --server=server_name storage nmp satp rule add command. The command takes the following options.
    Option Description
    -b|--boot This is a system default rule added at boot time. Do not modify esx.conf or add to 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 will be 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.

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 --server=server_name storage nmp satp rule add -V NewVend -M NewMod -s VMW_SATP_INV

If you run the esxcli --server=server_name storage nmp satp list -s VMW_SATP_INV command, you can see the new rule added to the list of VMW_SATP_INV rules.