Referencing MPCLAIM Examples

  • Article

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

Clear the Policy

1

Failover Only

2

Round Robin

3

Round Robin with Subset

4

Least Queue Depth

5

Weighted Paths

6

Least Blocks

7

Vendor Specific

Examples of common MPCLAIM.exe commands used to configure MPIO

Task Command Examples Notes

Add MPIO support for Fibre Channel devices

mpclaim.exe -r -i -d < _VendorID> < _ProductID>

For example, to add support for a device with Vendor="Vendor8 " and Product="Product16 ", use the following command:

mpclaim -r -i -d "Vendor8 Product16 "

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.

Add MPIO support for all iSCSI devices

mpclaim -r -i -d "MSFT2005iSCSIBusType_0x9"

 

To claim only specific iSCSI devices, see the previous section, “Add MPIO support for Fibre Channel devices.”

Add MPIO support for all devices that are enterprise storage devices

mpclaim.exe -r -i -a ""

 

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.

Remove MPIO support for Fibre Channel devices

mpclaim.exe -r -u -d < _VendorID> < _ProductID>

For example, to add support for a device with Vendor="Vendor8 "and Product="Product16 ", use the following command:

mpclaim -r -u -d "Vendor8 Product16 "mpclaim -r -u -d "ABC WXYZ ""Vendor8 Product16 "

mpclaim -r -u -d "ABC WXYZ " "DE JKLMN "

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

Remove MPIO support for all iSCSI devices

mpclaim.exe -r -u -d "MSFT2005iSCSIBusType_0x9"

 

To remove only specific iSCSI devices, see the previous section, “Remove MPIO support for Fibre Channel devices.”

Remove MPIO support for all devices on the system

mpclaim.exe -r -u -a ""

 

The tool removes MPIO support for all devices on the system, even if multiple paths do not exist to the array.

To view all detected enterprise storage

Mpclaim -e

This command also displays the associated Vendor ID and Product ID required to add or remove support for the given device.

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

Mpclaim -r

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:

MPIO Storage Snapshot on Tuesday, 05 May 2009, at 14:51:45.023
Registered DSMs: 1
================
+--------------------------------|-------------------|----|----|----|---|-----+
|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 Load-Balancing 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 Load-Balancing 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 DSM-wide default load-balancing policy settings: Round Robin

No target-level default load-balancing policy settings have been set.