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.

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.