Home > Blogs > VMware Support Insider


Listing VAAI Filters and Plug-ins – teaser

Mostafa KhalilMostafa Khalil is already well known to many of our readers. He is a Senior Staff Engineer with VMware Global Support Services. He has been with VMware for over 13 years, and his specialty is Storage.

Mostafa has the following impressive list of certifications: VCDX3, VCDX4, VCDX5, VCAP4-DCA, VCAP4-DCD, VCAP5-DCD, VCP2, 3, 4 and 5.

He has a new book coming out shortly titled: Storage Implementation in vSphere 5.0

 URLs where you can buy the book:

Ship date is: 8/28/2012, but available for pre-order at the above links.

The following is an excerpt from the book, posted here from the VAAI chapter.

For a device to be claimed by a VAAI plug-in, it must be first claimed by the VAAI Filter plug-in as shown in the output of:

esxcli storage core claimrule list –claimrule-class=Filter

Or the short-hand version

esxcli storage core claimrule list -c Filter

The parameter Filter must use uppercase F.

Figure 1 shows the output of this command.

Fig1
Figure 1 Listing VAAI Filter claim rules

To verify if a VAAI plug-in has been installed, you can list the VAAI claim rules using this command:

esxcli storage core claimrule list –claimrule-class=VAAI

Or the short-hand version

esxcli storage core claimrule list -c VAAI

Note that the parameter VAAI must be all uppercase. Also, the long-hand version of the option –claimrule-class can be used with or without the equal sign. vSphere 4.1 required the equal sign. The short-hand version is documented without the equal sign. However, it accepts it if used. In other words, both the long-hand and short-hand versions of the command can be used with or without the equal sign.

Figure 2 show the output of this command.

Fig2
Figure 2 Listing VAAI plug-in claim rules

In this example, only in-box plug-ins have been preinstalled on this host. The claim rules have similar structure to the NMP claim rules discussed in Chapter 5, “VMware Pluggable Storage Architecture (PSA),” in the “MP Claim Rules” section. To recap, when a device is discovered by the PSA framework, the rule is matched to its corresponding VAAI plug-in by the Vendor and Model strings identified from the response to the INQUIRY command.

For example, in this output an HP P4000 is a LeftHand Network storage array that returns a Vendor string LEFTHAND and any model will be claimed by the VMW_ VAAIP_LHN plug-in.

One of the plug-ins listed in Figure 2 is VMW_VAAIP_MASK. If you have a family of storage arrays that share the same Vendor and Model strings and you want to prevent the ESXi5 host from using VAAI with it, you may add a claim rule for VMW_VAAIP_MASK with a number smaller than 65429.

An example of adding a VAAI MASK claim rule is

esxcli storage core claimrule add –rule=65428 –type=vendor –plugin VMW_

VAAIP_MASK –vendor=EMC –claimrule-class=VAAI

Or the short-hand version:

esxcli storage core claimrule add -r 65428 -t vendor -P VMW_VAAIP_MASK -V EMC -c VAAI

This adds a VAAI claim rule for the VMW_VAAIP_MASK plug-in to claim all devices whose Vendor string is EMC. Because that device already has a filter claim rule in place, you only need to add the VAAI claim rule.

The command does not return any feedback unless there is an error. To verify that the rule was added successfully, run this command:

esxcli storage core claimrule list -c VAAI

The output is shown in Figure 3.

Fig3

Figure 3 Result of adding a VAAIP_MASK claim rule

Because rule number 65428 is lower than the existing VAAI claim rule number 65430 for the EMC devices, the MASK claim rule claims all EMC devices instead of being claimed by the VMW_VAAIP_SYMM.

The only remaining step is to load the claim rule for it to take effect. To do that, run this command:

esxcli storage core claimrule load –claimrule-class=VAAI

Or you may use the short-hand version:

esxcli storage core claimrule load -c VAAI

The command does not return any feedback unless there is an error.

To verify the outcome, run:

esxcli storage core claimrule list -c VAAI

The output is shown in Figure 4

Fig4
Figure 4 VAAI MASK claim rule loaded

Similar to MP claim rules, the class column of the output of loaded VAAI claim rules shows runtime as well as file.

Mostafa will have a book signing event at VMworld 2012 if you are going.

2 thoughts on “Listing VAAI Filters and Plug-ins – teaser

Comments are closed.