Dynamic Multi-Pathing 8.0.1 Administrator's Guide - Windows
- Understanding DMPW
- Setting up DMPW
- Administering DMPW
- DMP DSMs menus
- View array, disk, and path status
- vxdmpadm
- Performance tuning
- Troubleshooting
- Glossary
vxdmpadm setattr array
vxdmpadm setattr array [loadbalancepolicy=FO|RR|RS [path#=state#] |LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#] [testpathretrycount=# scsicmdtimeout=# kernalsleeptime=# failoverretrycount=# ]<DiskName> | p#c#t#l#>
This command sets the load balance policy and primary path of the array to which the designated disk belongs. It also lets you set tunable parameters (control timer settings) that affect the testing and failover of the paths. The following attributes apply:
loadbalancepolicy= FO|RR|RS |LQ|WP |LB|BP | Specifies the load balance policy for the array where:
Note: Round Robin with Subset and Weighted Paths are available for A/PC and ALUA arrays only at the device level. They are not available at the array level. |
path#=state# | state# specifies either standby (0) or active (1) state of the specified path#. For example, 1-1-1=0 means that path 1-1-1 is assigned a state of standby. (Default state of a path is active (1).) |
path#=weight# | weight# specifies the weight that is assigned to the specified path#. For example, 1-1-1=10 means that path 1-1-1 is assigned a weight of 10. The path with the lowest weight indicates the most-favored path for I/O. (Range of values for weight#: 0 - 255.) |
blockshift=# | # specifies the number of contiguous I/O blocks that are sent along a path to an Active/Active array before switching to the next available path. (Default value is 2048 blocks.) |
primarypath=# | # specifies the primary path of the array. For example, primarypath=1-1-1 sets path 1-1-1 as the primary path of the array. |
testpathretrycount=# | # specifies the number of times the testpath routine retries to test the health of the path. Range: 0 ~ 50 times. Default: 0. |
scsicmdtimeout=# | # specifies the amount of time a SCSI command waits for a device to respond to a SCSI command. Range: 30 ~ 120 seconds. Default is 30 seconds. |
kernalsleeptime=# | # specifies the interval of time the DMP DSMs kernel waits between attempts to recover a path from an error condition. Range: 200 ~ 10000 milliseconds. Default is 200 milliseconds. |
failoverretrycount=# | # specifies the number of times the failover routine retries to failover the path. Range: 0 ~ 50 times. Default: 0. Note: For DMP DSMs, Failover Retry Count does not apply to the EMC Symmetrix array. |
<DiskName> | The designated disk, which can be specified by the device name (such as Harddisk2). |
p#c#t#l# | The #s correspond to the port, channel, target, and LUN of a disk. |
Examples
vxdmpadm setattr array loadbalancepolicy=FO primarypath=2-1-0 testpathretrycount=4 Harddisk6
Sets the load balance policy of the array to Fail Over Only (Active/Passive), the primary path to path 2-1-0, the testpathretrycount to 4 times.
vxdmpadm setattr array loadbalancepolicy=RR Harddisk6
Sets the load balance policy of the array to Round Robin (Active/Active).