Referencing MPCLAIM Examples in Microsoft Multipath I/O (MPIO)

http://technet.microsoft.com/en-us/library/ee619743(WS.10,printer).aspx

Referencing MPCLAIM Examples

Updated: October 7, 2009 Applies To: Windows Server 2008 R2 Note We recommend that you use Windows Management Instrumentation (WMI) to make these changes. If you choose to use the alternatives listed later in this section, you must restart the computer before changes that are made to these settings will take effect.

List the disks that are currently claimed by MPIO

The following command, mpclaim.exe s d, returns the following additional information: The MPIO disk number that is used with mpclaim commands The system disk number as it corresponds to the number that is used in Disk Management The current load-balancing policy setting The device-specific module (DSM) that is managing the device

Change the load-balancing policy settings

To change the load-balancing policy setting to Least Blocks for all disks that are claimed by Microsoft DSM, use the following command: mpclaim.exe L M 6 To clear the load-balancing policy settings for all disks claimed by Microsoft DSM and reset to the default, use the following command: mpclaim.exe L M 0 Valid load-balancing policy settings for the L switch are as follows:

Parameter Definition 0 1 2 Clear the Policy Failover Only Round Robin

1 of 4

10/17/2011 8:57 PM

Referencing MPCLAIM Examples in Microsoft Multipath I/O (MPIO)

http://technet.microsoft.com/en-us/library/ee619743(WS.10,printer).aspx

3 4 5 6 7

Round Robin with Subset Least Queue Depth Weighted Paths Least Blocks Vendor Specific

Examples of common MPCLAIM.exe commands used to configure MPIO

Task

Command

Examples

Notes Note that the vendor string length is 8 characters, the product string length is 16 characters, and both fields are padded with spaces as needed.

For example, to add support for a device with Add MPIO Vendor="Vendor8 " and support for mpclaim.exe -r -i -d < _VendorID> Product="Product16 ", use Fibre Channel < _ProductID> the following command: devices mpclaim -r -i -d "Vendor8 Product16 "

Add MPIO mpclaim -r -i -d support for all "MSFT2005iSCSIBusType_0x9" iSCSI devices

To claim only specific iSCSI devices, see the previous section, Add MPIO support for Fibre Channel devices. The tool analyzes all devices that are seen by the system, determines if there are multiple paths to the device, and if there are, adds MPIO support for them. If any iSCSI disk devices are found, MPIO support is added for them. For example, to add support for a device with Vendor="Vendor8 "and Product="Product16 ", use the following command:

Add MPIO support for all devices that mpclaim.exe -r -i -a "" are enterprise storage devices

Remove MPIO support for mpclaim.exe -r -u -d < Fibre Channel _VendorID> < _ProductID> devices

Note that the vendor string length is 8 characters, and the product string length is 16 characters.

2 of 4

10/17/2011 8:57 PM

Referencing MPCLAIM Examples in Microsoft Multipath I/O (MPIO)

http://technet.microsoft.com/en-us/library/ee619743(WS.10,printer).aspx

mpclaim -r -u -d "Vendor8 Product16 "mpclaim -r -u -d "ABC WXYZ ""Vendor8 Product16 " mpclaim -r -u -d "ABC WXYZ " "DE JKLMN " To remove only specific iSCSI devices, see the previous section, Remove MPIO support for Fibre Channel devices. The tool removes MPIO support for all devices on the system, even if multiple paths do not exist to the array. This command also displays the associated Vendor ID and Product ID required to add or remove support for the given device.

Remove MPIO mpclaim.exe -r -u -d support for all "MSFT2005iSCSIBusType_0x9" iSCSI devices

Remove MPIO support for all mpclaim.exe -r -u -a "" devices on the system

To view all detected enterprise storage

Mpclaim -e

To view all storage that is currently Mpclaim -r claimed by the Microsoft DSM

Capture the MPIO configuration with MPCLAIM.exe

Note To use mpclaim, you must be running cmd.exe with administrator privileges.

mpclaim.exe v C:\Config.txt Using this command results in a report saved to the current command path, such as the following: other MPIO Storage Snapshot on Tuesday, 05 May 2009, at 14:51:45.023 Registered DSMs: 1

3 of 4

10/17/2011 8:57 PM

Referencing MPCLAIM Examples in Microsoft Multipath I/O (MPIO)

http://technet.microsoft.com/en-us/library/ee619743(WS.10,printer).aspx

================ +||||||+ |DSM Name | Version |PRP | RC | RI |PVP| PVE | |||||||| |Microsoft DSM |006.0001.07100.0000|0020|0003|0001|030|False| +||||||+ Microsoft DSM ============= MPIO Disk1: 02 Paths, Round Robin, ALUA Not Supported SN: 600D310010B00000000011 Supported LoadBalancing Policy Settings: FOO RR RRWS LQD WP LB Path ID State SCSI Address Weight 0000000077030002 Active/Optimized 003|000|002|000 0 Adapter: Microsoft iSCSI Initiator... (B|D|F: 000|000|000) Controller: 46616B65436F6E74726F6C6C6572 (State: Active) 0000000077030001 Active/Optimized 003|000|001|000 0 Adapter: Microsoft iSCSI Initiator... (B|D|F: 000|000|000) Controller: 46616B65436F6E74726F6C6C6572 (State: Active) MPIO Disk0: 01 Paths, Round Robin, ALUA Not Supported SN: 600EB37614EBCE8000000044 Supported LoadBalancing Policy Settings: FOO RR RRWS LQD WP LB Path ID State SCSI Address Weight 0000000077030000 Active/Optimized 003|000|000|000 0 Adapter: Microsoft iSCSI Initiator... (B|D|F: 000|000|000) Controller: 46616B65436F6E74726F6C6C6572 (State: Active) Microsoft DSMwide default loadbalancing policy settings: Round Robin No targetlevel default loadbalancing policy settings have been set.

Community Content
2011 Microsoft. All rights reserved.

4 of 4

10/17/2011 8:57 PM