Skip to main content
Pure Technical Services

Setting the MPIO Policy

Currently viewing public documentation. Please login to access the full scope of documentation.

KP_Ext_Announcement.png

Overview

The Multipath-IO (MPIO) Policy defines how the host distributes IOs across the available paths to the storage. There are several policy options available as shown in the table below.

Parameter Value Description
FOO Fail Over Only - Policy that does not perform load balancing. This policy uses a single active path, and the rest of the paths are standby paths. The active path is used for sending all I/O. If the active path fails, then one of the standby paths is used. When the path that failed is reactivated or reconnected, the standby path that was activated returns to standby.
RR Round Robin - Load balancing policy that allows the Device Specific Module (DSM) to use all available paths for MPIO in a balanced way. This is the default policy that is chosen when the storage controller follows the active-active model, no other default has been set, and the management application does not specifically choose a load-balancing policy.
LQD Least Queue Depth - Load balancing policy that sends I/O down the path with the fewest currently outstanding I/O requests. For example, consider that there is one I/O that is sent to LUN 1 on Path 1, and the other I/O is sent to LUN 2 on Path 1. The cumulative outstanding I/O on Path 1 is 2, and on Path 2, it is 0. Therefore, the next I/O for either LUN will process on Path 2.
LB Least Blocks - Load balancing policy that sends I/O down the path with the least number of data blocks currently being processed. For example, consider that there are two I/Os: one is 10 bytes and the other is 20 bytes. Both are in process on Path 1, and both have completed Path 2. The cumulative outstanding amount of I/O on Path 1 is 30 bytes. On Path 2, it is 0. Therefore, the next I/O will process on Path 2.
None Any currently configured default load balance policy. This is the default Global Load Balancing Policy.

Round Robin and Least Queue Depth

The Round Robin (RR) policy distributes IOs evenly across all Active/Optimized paths and suitable for most environments. Least Queue Depth (LQD), is similar to RR in that IOs are distributed across all available Active/Optimized paths, however it provides some additional benefits. LQD will bias IOs towards paths that are servicing IO quicker (paths with lesser queues). In the event that one path becomes intermittently disruptive or is experiencing higher latency, LQD will prevent the utilization of that path reducing the effect of the problem path. In some situations, usually involving complex storage topologies using multiple hops between server and storage, LQD can cause some paths to be almost entirely avoided.  This reduces maximum throughput and in those environments, RR may perform better. When attempting to maximize throughput, both RR and LQD should be tested to see which MPIO policy performs best.

Best practice recommendations for setting MPIO policy based on testing in Pure labs are as follows. As with all best practices, this is a general guideline and specific testing in the customer environment should be the final determinant. For hosts with 10 or fewer paths to a FlashArray volume, Pure Storage recommends using either Round Robin (RR) or Least Queue Depth (LQD). For hosts which have more than 10 paths to the volume, LQD should be used. Alternatively, Round Robin With Subset (RRWS) can be used to reduce the number of active paths. RRWS cannot be set as a default policy, and must be explicitly set for each volume. When using RRWS, a subset of paths can be designated as active/optimized and will be used for IO to the volume. Paths which have been set as active/unoptimized will be tried when none of the active/optimized paths are available.

Viewing an individual Pure Storage FlashArray volume's multi-path disk device properties is only possible if a volume is connected using Fibre Channel or iSCSI. If there are not connected volumes to the Windows Server host review the following topics before proceeding:

It is possible to set the MPIO Policies using Windows PowerShell for the Windows Server host before any volumes are connected. If this is the case skip to the Using Windows PowerShell section.

When altering the MPIO Policy settings, testing has found that a host reboot is not required and these policy changes are non-disruptive in nature. However, Pure Storage does recommend that you should verify that the policies have taken effect by viewing the Disk Properties (as shown below).

Once the FlashArray volumes are presented to the host and added via the Disk Management console, the policy of Round Robin is applied to those volumes unless another policy type has been set as the Global default.

Setup using Windows Disk Management

  1. Open Computer Management using the Tools menu in Server Manager. Select Disk Management from the left-hand node tree. This will display the currently connected Logical Units (LUNs) to the Windows Server host. 
     
    WS2016_Computer_Management.png  
     
  2. Right-click on Disk 1 (or whatever Disk # represents the newly connected LUN) and select Properties from the menu. This will open the properties dialog for the PURE FlashArray Multi-Path Disk Device. Each of the device paths has a Path State of Active/Optimized
     
    clipboard_ed245e30b4cc99b82caae7b1263f5486c.png  

Using Windows PowerShell

The below PowerShell shows running the Load Balance Policy cmdlet to retrieving the current default Multipath-IO Policy. On a newly installed Windows Server running Get-MSDSMGlobalDefaultLoadBalancePolicy results in None because no default policy has been set as Multipath-IO has just been installed. 

Retrieving the Default MPIO Policy

The next sections walk through each of these management tasks using the graphical user interface (GUI) or Windows PowerShell.

Get-MSDSMGlobalDefaultLoadBalancePolicy

None

Setting the Default MPIO Policy

When setting the default load balance policy the -Policy parameter provides a ValidateSet which includes the following:

When using the Windows PowerShell entering tab after the -Policy parameter will cycle through the different options.

The below PowerShell shows setting the new Multipath-IO Policy Load Balance Policy then retrieving it to ensure it was set properly. 

PS C:\> Set-MSDSMGlobalDefaultLoadBalancePolicy -Policy RR
PS C:\> Get-MSDSMGlobalDefaultLoadBalancePolicy
RR

Volumes connected after the default MPIO policy has been set will use that policy unless explicitly configured to use an alternate policy.

When configuring a single host that is connected to Pure Storage and DellEMC, please refer to the following article Windows Server MPIO and DellEMC PowerPath Coexistence.