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.
Before you begin
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.
About this task
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.
- 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.
This is a system default rule added at boot time. Do not modify esx.conf or add to host profile.
Set the claim option string when adding a SATP claim rule.
Set the claim rule description when adding a SATP claim rule.
Set the device when adding SATP claim rules. Device rules are mutually exclusive with vendor/model and driver rules.
Set the driver string when adding a SATP claim rule. Driver rules are mutually exclusive with vendor/model rules.
Force claim rules to ignore validity checks and install the rule anyway.
Show the help message.
Set the model string when adding SATP a claim rule. Vendor/Model rules are mutually exclusive with driver rules.
Set the option string when adding a SATP claim rule.
Set the default PSP for the SATP claim rule.
Set the PSP options for the SATP claim rule.
The SATP for which a new rule will be added.
Set the claim transport type string when adding a SATP claim rule.
Set the claim type when adding a SATP claim rule.
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.
- 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.