Using the vxdmpadm utility in Veritas Dynamic Multi-pathing for Windows
Article ID: 100010854
Updated On:
Description
vxdmpadm
The vxdmpadm utility provides the following commands for Dynamic Multi-Pathing (DMP DSMs) administration.
vxdmpadm dsminfo
vxdmpadm dsminfo | p#c#t#l#>
This command displays the DSM name, arrays in the DSM, and the array load balance policy. The DiskName parameter can be specified by the device name (such as Harddisk2). The #s in the p#c#t#l# parameter correspond to the port, channel, target, and LUN of a disk.
Example
vxdmpadm dsminfo Harddisk5
Displays the DSM information in which Harddisk5 participates.
vxdmpadm arrayinfo
vxdmpadm arrayinfo | p#c#t#l#>
This command displays the array name, the devices in the array, and the array load balance policy. It also displays the tunable parameters (control timer settings) that affect the testing and failover of paths. The DiskName parameter can be specified by the device name (such as Harddisk2). The #s in the p#c#t#l# parameter correspond to the port, channel, target, and LUN of a disk.
vxdmpadm deviceinfo
vxdmpadm deviceinfo | p#c#t#l#>...
This command displays the device name, the internal disk name, number of paths, status, and load balance policy. The DiskName parameter can be specified by the device name (such as Harddisk2). The p#c#t#l# parameter corresponds to the port, channel, target, and LUN of a disk.
Example
vxdmpadm deviceinfo Harddisk5 Harddisk6
Displays DMP DSMs related information about Harddisk5 and Harddisk 6.
vxdmpadm pathinfo
vxdmpadm pathinfo | p#c#t#l#>...
This command displays path status, load balance policy, port, target, and LUN along with device name, internal disk name, and number of paths. The DiskName parameter can be specified by the device name (such as Harddisk2). The p#c#t#l# parameter corresponds to the port, channel, target, and LUN of a disk.
Example
vxdmpadm pathinfo Harddisk5 Harddisk6
Displays path information for Hardisk5 and Harddisk6.
Displays path information for Hardisk5 and Harddisk6.
vxdmpadm arrayperf
vxdmpadm arrayperf | p#c#t#l#>
This command displays the date and time of the performance statistics, the array name, all the devices in the array, the paths for each device, and the performance statistics of all the devices in the array. The statistics are grouped by each path that is connected to a device. The DiskName parameter can be specified by the device name (such as Harddisk2). The #s in the p#c#t#l# parameter correspond to the port, channel, target, and LUN of a disk.
vxdmpadm deviceperf
vxdmpadm deviceperf | p#c#t#l#>...
This command displays the date and time of the performance statistics, the device name, the paths for the device, and the performance statistics of the device. The statistics are grouped by each path connected to the device. The DiskName parameter can be specified by the device name (such as Harddisk2). The p#c#t#l# parameter corresponds to the port, channel, target, and LUN of a disk.
The performance statistics represent the aggregate workload of the device. It includes the following number of:
The performance statistics represent the aggregate workload of the device. It includes the following number of:
■ Reads
■ Writes
■ Bytes read
■ Bytes written
■ Writes
■ Bytes read
■ Bytes written
Example
vxdmpadm deviceperf Harddisk6
Displays the performance statistics of Harddisk6.
Displays the performance statistics of Harddisk6.
vxdmpadm pathperf
vxdmpadm pathperf | p#c#t#l#>...
vxdmpadm allperf
vxdmpadm allperf
This command displays performance information of the paths for all devices. For devices, this includes the following:
■ Name of the counter
■ Path name
■ Device name
■ Array name
■ Counter value
■ Path name
■ Device name
■ Array name
■ Counter value
For path summaries, this includes the following:
■ Name of the counter
■ Path name
■ Array name
■ Counter value
■ Path name
■ Array name
■ Counter value
vxdmpadm cleardeviceperf
vxdmpadm cleararrayperf
vxdmpadm cleararrayperf | p#c#t#l#>
This command resets the performance I/O statistics of an array that contains the specified disk.
The following attributes apply:
The following attributes apply:
vxdmpadm clearallperf
vxdmpadm setdsmscsi3
vxdmpadm setarrayscsi3
vxdmpadm setarrayscsi3 scsi3support=0|1 | p#c#t#l#>
This command enables or disables SCSI3 support in the registry of the array that contains the specified disk.
The following attributes apply:
The following attributes apply:
vxdmpadm setattr array
vxdmpadm setattr array [loadbalancepolicy=FO|RR|RS [path#=state#]
|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#] [testpathretrycount=# scsicmdtimeout=# kernalsleeptime=# failoverretrycount=# ] | p#c#t#l#>
|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#] [testpathretrycount=# scsicmdtimeout=# kernalsleeptime=# failoverretrycount=# ]
This command sets the load balance policy and primary path of the array to which the designated disk belongs. It also allows you to set tunable parameters (control timer settings) that affect the testing and failover of the paths.
The following attributes apply:
The following attributes apply:
vxdmpadm setattr device
vxdmpadm setattr device [loadbalancepolicy=FO|RR|RS [path#=state#]
|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#]
| p#c#t#l#>
|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#]
This command sets the load balance policy and primary path of the device to which the designated disk belongs.
The following attributes apply:
The following attributes apply:
vxdmpadm setattr path
vxdmpadm setattr path [loadbalancepolicy=FO|RR|RS [path#=state#]|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#] | p#c#t#l#>...
This command sets the load balance policy and primary path of the designated disk.
The following attributes apply:
The following attributes apply:
vxdmpadm set isislog
vxdmpadm set isislog level=<#|default> [reg=]
This command alters trace level of the VEA/ISIS log dynamically.
The following attributes apply:
The following attributes apply:
vxdmpadm rescan
vxdmpadm [-b] rescan
Rescans all the storage system objects on the computer, including disks, volumes, and file systems. The -b option runs the command in the background.
vxdmpadm disk list
vxdmpadm disk [-v] list
Resolution
vxdmpadm
The vxdmpadm utility provides the following commands for Dynamic Multi-Pathing (DMP DSMs) administration.
| Displays information about the DSM. | |
| arrayinfo | Displays information about an array. |
| deviceinfo | Displays information about a device (that is, a hard disk in an array). |
| pathinfo | Provides information about a path. |
| arrayperf | Displays performance statistics about an array. |
| deviceperf | Displays performance statistics about a device. |
| pathperf | Displays performance statistics about the paths connected to a device. |
| allperf | Displays performance statistics for all paths for all devices. |
| iostat | Displays I/O statistics for a single disk or for all disks in an array. |
| cleardeviceperf | Resets the performance I/O statistics of a device. |
| cleararrayperf | Resets the performance I/O statistics of an array that contains the specified disk. |
| clearallperf | Resets the performance I/O statistics of all arrays under the control of the DMP DSMs that the specified disk belongs to. |
| setdsmscsi3 | Enables or disables SCSI3 support for the DMP DSMs that controls the specified disk. |
| setarrayscsi3 | Enables or disables SCSI3 support in the registry of the array that contains the specified disk. |
| setattr dsm | Sets DSM attributes. |
| setattr array | Sets array attributes. |
| setattr device | Sets device attributes. |
| setattr path | Sets path attributes. |
| set isislog | Alters trace level of the VEA/ISIS log dynamically. |
| rescan | Rescans all the storage system objects on the computer. |
| disk list | Lists details of all the disks on the managed server. |
A full explanation of the DMP DSMs software and commands is available in the VXDMPADM section in the Veritas Dynamic Multi-Pathing for Windows Administrator's Guide. You can find your version of this Administrator's Guide in the Related Articles section, below.
Each keyword is followed by the volume name or drive letter. Typing the following sequence for each keyword brings up a description of its syntax:
Each keyword is followed by the volume name or drive letter. Typing the following sequence for each keyword brings up a description of its syntax:
vxdmpadm -?
vxdmpadm dsminfo
vxdmpadm dsminfo | p#c#t#l#>
This command displays the DSM name, arrays in the DSM, and the array load balance policy. The DiskName parameter can be specified by the device name (such as Harddisk2). The #s in the p#c#t#l# parameter correspond to the port, channel, target, and LUN of a disk.
Example
vxdmpadm dsminfo Harddisk5
Displays the DSM information in which Harddisk5 participates.
vxdmpadm arrayinfo
vxdmpadm arrayinfo | p#c#t#l#>
This command displays the array name, the devices in the array, and the array load balance policy. It also displays the tunable parameters (control timer settings) that affect the testing and failover of paths. The DiskName parameter can be specified by the device name (such as Harddisk2). The #s in the p#c#t#l# parameter correspond to the port, channel, target, and LUN of a disk.
Example
vxdmpadm arrayinfo Harddisk5
Displays the array information for the array in which Harddisk5 participates.
vxdmpadm deviceinfo
vxdmpadm deviceinfo | p#c#t#l#>...
This command displays the device name, the internal disk name, number of paths, status, and load balance policy. The DiskName parameter can be specified by the device name (such as Harddisk2). The p#c#t#l# parameter corresponds to the port, channel, target, and LUN of a disk.
Example
vxdmpadm deviceinfo Harddisk5 Harddisk6
Displays DMP DSMs related information about Harddisk5 and Harddisk 6.
vxdmpadm pathinfo
vxdmpadm pathinfo | p#c#t#l#>...
This command displays path status, load balance policy, port, target, and LUN along with device name, internal disk name, and number of paths. The DiskName parameter can be specified by the device name (such as Harddisk2). The p#c#t#l# parameter corresponds to the port, channel, target, and LUN of a disk.
Example
vxdmpadm pathinfo Harddisk5 Harddisk6
Displays path information for Hardisk5 and Harddisk6.
Displays path information for Hardisk5 and Harddisk6.
vxdmpadm arrayperf
vxdmpadm arrayperf | p#c#t#l#>
This command displays the date and time of the performance statistics, the array name, all the devices in the array, the paths for each device, and the performance statistics of all the devices in the array. The statistics are grouped by each path that is connected to a device. The DiskName parameter can be specified by the device name (such as Harddisk2). The #s in the p#c#t#l# parameter correspond to the port, channel, target, and LUN of a disk.
The performance statistics represent the aggregate workload of the array. It includes the following number of:
■ Reads
■ Writes
■ Bytes read
■ Bytes written
■ Writes
■ Bytes read
■ Bytes written
Example
vxdmpadm arrayperf Harddisk5
Displays the performance statistics of the devices in the array in which Harddisk5 participates.
Displays the performance statistics of the devices in the array in which Harddisk5 participates.
vxdmpadm deviceperf
vxdmpadm deviceperf | p#c#t#l#>...
This command displays the date and time of the performance statistics, the device name, the paths for the device, and the performance statistics of the device. The statistics are grouped by each path connected to the device. The DiskName parameter can be specified by the device name (such as Harddisk2). The p#c#t#l# parameter corresponds to the port, channel, target, and LUN of a disk.
The performance statistics represent the aggregate workload of the device. It includes the following number of:
The performance statistics represent the aggregate workload of the device. It includes the following number of:
■ Reads
■ Writes
■ Bytes read
■ Bytes written
■ Writes
■ Bytes read
■ Bytes written
Example
vxdmpadm deviceperf Harddisk6
Displays the performance statistics of Harddisk6.
Displays the performance statistics of Harddisk6.
vxdmpadm pathperf
vxdmpadm pathperf | p#c#t#l#>...
This command displays the date and time of the performance statistics, the device name, and the performance statistics of the device. The statistics are grouped by each path connected to the device. The DiskName parameter can be specified by the device name (such as Harddisk2). The p#c#t#l# parameter corresponds to the port, channel, target, and LUN of a disk.
The performance statistics represent the workload of the paths connected to the device.
It includes the following number of:
It includes the following number of:
■ Reads
■ Writes
■ Bytes read
■ Bytes written
■ Writes
■ Bytes read
■ Bytes written
Example
vxdmpadm pathperf Harddisk6
Displays the performance statistics of Harddisk6.
Displays the performance statistics of Harddisk6.
vxdmpadm allperf
vxdmpadm allperf
This command displays performance information of the paths for all devices. For devices, this includes the following:
■ Name of the counter
■ Path name
■ Device name
■ Array name
■ Counter value
■ Path name
■ Device name
■ Array name
■ Counter value
For path summaries, this includes the following:
■ Name of the counter
■ Path name
■ Array name
■ Counter value
■ Path name
■ Array name
■ Counter value
vxdmpadm iostat
vxdmpadm iostat [showdevice|showarray] [interval=#] [count=#]
This command displays the I/O statistics for a single disk or for all disks in an array. The statistics can be displayed after a specified number of seconds and for a specified number of times.
The following attributes apply:
showdevice|showarray
Display I/O statistics:
■ showdevice specifies paths of the disk. (Default is showdevice.)
■ showarray specifies all the paths of the array that contains the disk.
■ showdevice specifies paths of the disk. (Default is showdevice.)
■ showarray specifies all the paths of the array that contains the disk.
interval=#
# specifies the amount of time (seconds) between displays of the I/O statistics.
(Default value is 5 seconds between displays.)
(Default value is 5 seconds between displays.)
count=#
# specifies the number of times the I/O statistics are displayed. (Default is infinite number of displays.)
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.
vxdmpadm cleardeviceperf
vxdmpadm cleardeviceperf
| p#c#t#l#>
This command resets the performance I/O statistics of a device.
The following attributes apply:
The following attributes apply:
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.
vxdmpadm cleararrayperf
vxdmpadm cleararrayperf | p#c#t#l#>
This command resets the performance I/O statistics of an array that contains the specified disk.
The following attributes apply:
The following attributes apply:
The designated disk, which can be specified by the device name (such as Harddisk2).
vxdmpadm clearallperf | p#c#t#l#>
This command resets the performance I/O statistics of all arrays under the control of the DMP DSMs that the specified disk belongs to.
The following attributes apply:
The following attributes apply:
The designated disk, which can be specified by the device name (such as Harddisk2).
vxdmpadm setdsmscsi3 scsi3support=0|1 | p#c#t#l#>
This command enables or disables SCSI3 support in the registry of the DMP DSMs that controls the specified disk.
The following attributes apply:
The following attributes apply:
scsi3support=0|1
■ 0 disables SCSi3 support in the DMP DSMs
■ 1 enables SCSi3 support in the DMP DSMs
■ 1 enables SCSi3 support in the DMP DSMs
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.
vxdmpadm setarrayscsi3
vxdmpadm setarrayscsi3 scsi3support=0|1 | p#c#t#l#>
This command enables or disables SCSI3 support in the registry of the array that contains the specified disk.
The following attributes apply:
The following attributes apply:
scsi3support=0|1
■ 0 disables SCSi3 support in the DMP DSMs
■ 1 enables SCSi3 support in the DMP DSMs
■ 1 enables SCSi3 support in the DMP DSMs
The designated disk, which can be specified by the device name (such as Harddisk2).
vxdmpadm setattr dsm [loadbalancepolicy=FO|RR|LQ|LB|BP [blockshift=#]]
[primarypath=#] [testpathretrycount=# scsicmdtimeout=#
kernalsleeptime=# failoverretrycount=#] | p#c#t#l#>
[primarypath=#] [testpathretrycount=# scsicmdtimeout=#
kernalsleeptime=# failoverretrycount=#]
This command sets the load balance policy and primary path of the DSM to which the designated disk belongs. It also allows you to set tunable parameters (control timer settings) that affect the testing and failover of the paths. The following attributes apply:
loadbalancepolicy= FO|RR|LQ|LB|BP
Specifies the load balance policy for the DSM where:
■ FO specifies Fail Over Only (Active/Passive)
■ RR specifies Round Robin (Active/Active)
■ LQ specifies Dynamic Least Queue Depth
■ LB specifies Least Blocks
■ BP specifies Balanced Path
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.)
(Default value is 2048 blocks.)
primarypath=#
# specifies the primary path of the DSM. For example, primarypath=1-1-1 sets path 1-1-1 as the primary path of the DSM.
testpathretrycount=#
# specifies the number of times the testpath routine will retry 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. Default is 30 seconds. Maximum is 120 seconds.
kernalsleeptime=#
# specifies the interval of time the DMP DSMs kernal waits between attempts to recover a path from an error condition. Default is 200 milliseconds. Maximum is 10000 milliseconds.
failoverretrycount=#
# specifies the number of times DMP DSMs attempts a failover to another path when the current path fails. Default is 0. Maximum is 50 times.
Note: For DMP DSMs, Failover Retry Count does not apply to the EMC Symmetrix array.
Note: For DMP DSMs, Failover Retry Count does not apply to the EMC Symmetrix array.
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.
Example
vxdmpadm setattr dsm loadbalancepolicy=FO primarypath=1-1-0 scsicmdtimout=34 Harddisk6
Sets the load balance policy of the DSM to Fail Over Only (Active/Passive), the primary path to path 1-1-0, the scsicmdtimeout to 34 seconds.
vxdmpadm setattr array
vxdmpadm setattr array [loadbalancepolicy=FO|RR|RS [path#=state#]
|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#] [testpathretrycount=# scsicmdtimeout=# kernalsleeptime=# failoverretrycount=# ] | p#c#t#l#>
|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#] [testpathretrycount=# scsicmdtimeout=# kernalsleeptime=# failoverretrycount=# ]
This command sets the load balance policy and primary path of the array to which the designated disk belongs. It also allows you to set tunable parameters (control timer settings) that affect the testing and failover of the paths.
The following attributes apply:
The following attributes apply:
loadbalancepolicy= FO|RR|RS|LQ|WP|LB|BP
Specifies the load balance policy for the array where:
■ FO specifies Fail Over Only (Active/Passive)
■ RR specifies Round Robin (Active/Active)
■ RS specifies Round Robin with Subset
■ LQ specifies Dynamic Least Queue Depth
■ WP specifies Weighted Paths
■ LB specifies Least Blocks
■ BP specifies Balanced Path
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.
■ RR specifies Round Robin (Active/Active)
■ RS specifies Round Robin with Subset
■ LQ specifies Dynamic Least Queue Depth
■ WP specifies Weighted Paths
■ LB specifies Least Blocks
■ BP specifies Balanced Path
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 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.)
(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.)
(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 will retry 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.
Range: 30 ~ 120 seconds. Default is 30 seconds.
kernalsleeptime=#
# specifies the interval of time the DMP DSMs kernal waits between attempts to recover a path from an error condition.
Range: 200 ~ 10000 milliseconds. Default is 200 milliseconds.
Range: 200 ~ 10000 milliseconds. Default is 200 milliseconds.
failoverretrycount=#
# specifies the number of times the failover routine will retry 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.
Range: 0 ~ 50 times. Default: 0.
Note: For DMP DSMs, Failover Retry Count does not apply to the EMC Symmetrix array.
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).
vxdmpadm setattr device
vxdmpadm setattr device [loadbalancepolicy=FO|RR|RS [path#=state#]
|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#]
| p#c#t#l#>
|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#]
This command sets the load balance policy and primary path of the device to which the designated disk belongs.
The following attributes apply:
The following attributes apply:
loadbalancepolicy= FO|RR|RS|
LQ| WP|LB
LQ| WP|LB
Specifies the load balance policy for the device where:
■ FO specifies Fail Over Only (Active/Passive)
■ RR specifies Round Robin (Active/Active)
■ RS specifies Round Robin with Subset
■ LQ specifies Dynamic Least Queue Depth
■ WP specifies Weighted Paths
■ LB specifies Least Blocks
■ BP specifies Balanced Path
■ RR specifies Round Robin (Active/Active)
■ RS specifies Round Robin with Subset
■ LQ specifies Dynamic Least Queue Depth
■ WP specifies Weighted Paths
■ LB specifies Least Blocks
■ BP specifies Balanced Path
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).)
(Default state of a path is active (1).)
path#=weight#
weight# specifies the weight 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.)
(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.)
(Default value is 2048 blocks.)
primarypath=#
# specifies the primary path of the device. For example, primarypath=1-1-1 sets path 1-1-1 as the primary path of the device.
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.
Example
vxdmpadm setattr device loadbalancepolicy=FO primarypath=1-1-0 Harddisk6
Sets the load balance policy of the device to Fail Over Only (Active/Passive) and the primary path to path 1-1-0 for Harddiskd6.
vxdmpadm setattr path
vxdmpadm setattr path [loadbalancepolicy=FO|RR|RS [path#=state#]|LQ|WP [path#=weight#]|LB|BP [blockshift=#]] [primarypath=#] | p#c#t#l#>...
This command sets the load balance policy and primary path of the designated disk.
The following attributes apply:
The following attributes apply:
loadbalancepolicy=FO|RR|RS|LQ|WP|LB
Specifies the load balance policy for the device where:
■ FO specifies Fail Over Only (Active/Passive)
■ RR specifies Round Robin (Active/Active)
■ RS specifies Round Robin with Subset
■ LQ specifies Dynamic Least Queue Depth
■ WP specifies Weighted Paths
■ LB specifies Least Blocks
■ BP specifies Balanced Path
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).)
(Default state of a path is active (1).)
path#=weight#
weight# specifies the weight 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.)
(Default value is 2048 blocks.)
primarypath=#
# specifies the primary path of the device. For example, primarypath=1-1-1 sets path 1-1-1 as the primary path of the device.
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.
Example
vxdmpadm setattr path loadbalancepolicy=FOprimarypath=1-1-0 Harddisk6
Sets the load balance policy of the device to Fail Over Only (Active/Passive) and the primary path to path 1-1-0 for Harddiskd6.
vxdmpadm set isislog
vxdmpadm set isislog level=<#|default> [reg=]
This command alters trace level of the VEA/ISIS log dynamically.
The following attributes apply:
The following attributes apply:
level=#
Specifies the trace level to be set as current trace level, where #can be:
■ 1 specifies the trace level Info1
■ 2 specifies the trace level Info2
■ 3 specifies the trace level Info3
■ 4 specifies the trace level Info
■ 5 specifies the trace level Warning
■ 6 specifies the trace level Error (default)
■ 2 specifies the trace level Info2
■ 3 specifies the trace level Info3
■ 4 specifies the trace level Info
■ 5 specifies the trace level Warning
■ 6 specifies the trace level Error (default)
reg=y|n
Specifies whether to update the trace level in the registry or not.
■ Specify reg=y to update the trace level in the registry.
■ Specify reg=n to not update the trace level in the registry.
■ Specify reg=n to not update the trace level in the registry.
By default, the trace level is not updated in the registry if this attribute is not specified.
Examples
vxdmpadm set isislog level=default
Sets the trace level to 'Error'(6) and does not update the trace level in the registry.
vxdmpadm set isislog level=4 reg=y
Sets the trace level to 'Info'(4) and updates the trace level in the registry.
vxdmpadm rescan
vxdmpadm [-b] rescan
Rescans all the storage system objects on the computer, including disks, volumes, and file systems. The -b option runs the command in the background.
vxdmpadm disk list
vxdmpadm disk [-v] list
Lists device name, internal disk name, disk group, disk partition style, size, free space, LUN, status, serial number, ThinProvisioningType (ThinNoReclaim or ThinReclaim for thin provisioned disks), ProvisionedSize (current size of thin provisioned disks), etc. for all the disks on the managed server.
The -g option limits the list of disks to the specified disk group.
The -v (verbose) option displays signature, status, bus type, port, target, channel, LUN, track alignment offset, and track alignment setting information for the disks in the list.
Note: Not all manufacturers of thin provisioned disks enable the display of the current provisioned size.
Example
vxdmpadm -v list
Gives information on all the disks on the managed server. The -v option includes the signature, status, bus type, port, channel, target, and LUN information.
Issue/Introduction
The vxdmpadm utility offers many tools to administer your Veritas Dynamic Multi-pathing for Windows. This article details this utility and its commands.
Was this article helpful?
Yes
No
Powered by
