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.

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.

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.

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.