Define NMP SATP Rules

The NMP SATP claim rules define which SATP manages a particular storage device. Usually, you can use the default settings for the NMP SATP rules. If you need to modify the rules, use the esxcli commands to add a rule to the list of claim rules for the specific 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 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 --server=server_name storage nmp satp rule add -V NewVend -M NewMod -s VMW_SATP_INV

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