chpath Command
Purpose
Changes the operational status of paths to a MultiPath I/O (MPIO) capable
device, or changes an attribute associated with a path to an MPIO capable
device.
Syntax
chpath -dev Name -op OpStatus [ -pdev Parent ] [ -conn Connection ]
chpath -dev Name -pdev Parent [ -conn Connection ] [ -perm ] -attr Attribute=Value...
Description
The chpath command either changes the operational
status of paths to the specified device (the -dev Name flag) or it changes one, or more, attributes associated
with a specific path to the specified device. The required syntax is slightly
different depending upon the change being made.
The first syntax shown above changes the operational status of one or more
paths to a specific device. The set of paths to change is obtained by taking
the set of paths which match the following criteria:
- The target device matches the specified device.
- The parent device matches the specified parent (-pdev Parent), if a parent is specified.
- The connection matches the specified connection (-conn Connection), if a connection is specified.
- The path status is PATH_AVAILABLE
The operational status of a path refers to the usage of the path as part
of MPIO path selection. The value of enable indicates
that the path is to be used while disable indicates that the path is not to
be used. It should be noted that setting a path to disable impacts future
I/O, not I/O already in progress. As such, a path can be disabled, but still
have outstanding I/O until such time that all of the I/O that was already
in progress completes. As such, if -op disable is specified
for a path and I/O is outstanding on the path, this fact will be displayed.
Disabling a path affects path selection at the device driver level. The path_status of the path is not changed in the device configuration
database. The lspath command must be used to see current
operational status of a path.
The second syntax shown above changes one or more path specific attributes
associated with a particular path to a particular device. Note that multiple
attributes can be changed in a single invocation of the chpath command; but all of the attributes must be associated with a single
path. In other words, you cannot change attributes across multiple paths in
a single invocation of the chpath command. To change
attributes across multiple paths, separate invocations of chpath are required; one for each of the paths that are to be changed.
Flags
| -attr Attribute=Value |
Identifies the attribute to change as well as the new
value for the attribute. The Attribute is the name of a path specific attribute.
The Value is the value which is to replace the current value for the Attribute.
The Attribute=Value parameter can use one attribute
value pair or multiple attribute value pairs for one -attr flag. If you use an -attr flag with multiple attribute
value pairs, the list of pairs must be enclosed in quotes with spaces between
the pairs. For example, entering -attr Attribute=Value lists one attribute value pair per flag, while entering -attr 'Attribute1=Value1 Attribute2=Value2' lists more than one attribute value pair. |
| -dev Name |
Specifies the logical device name of the target device
for the path(s) affected by the change. This flag is required in all cases. |
| -pdev Parent |
Indicates the logical device name of the parent device
to use in qualifying the paths to be changed. This flag is required when changing
attributes, but is optional when change operational status. |
| -perm |
Changes the path's characteristics without actually
changing the path. The change takes affect on the path the next time the path
is unconfigured and then configured (possibly on the next boot). |
| -conn Connection |
Indicates the connection information to use in qualifying
the paths to be changed. This flag is optional when changing operational status.
When changing attributes, it is optional if the device has only one path to
the indicated parent. If there are multiple paths from the parent to the device,
then this flag is required to identify the specific path being changed. |
| -op OpStatus |
Indicates the operational status to which the indicated
paths should be changed. The operational status of a path is maintained at
the device driver level. It determines if the path will be considered when
performing path selection.The allowable values for this flag are:
- enable
- Mark the operational status as enabled for MPIO path selection. A path
with this status will be considered for use when performing path selection.
Note that enabling a path is the only way to recover a path from a failed
condition.
- disable
- Mark the operational status as disabled for MPIO path selection. A path
with this status will not be considered for use when performing path selection.
This flag is required when changing operational status. When used in
conjunction with the -attr Attribute=Value flag, a usage error is generated. |
Exit Status
SeeVirtual I/O Server command exit status.
Examples
- To disable the paths between scsi0 and the hdisk1 disk device, enter:
chpath -dev hdisk1 -pdev scsi0 -op disable
The system displays a message similar to one of the following:
paths disabled
or
some paths disabled
The first message indicates
that all PATH_AVAILABLE paths from scsi0 to hdisk1 have been successfully enabled.
The second message indicates that only some of the PATH_AVAILABLE paths from scsi0 to hdisk1 have
been successfully disabled.
Related Information
The cfgdev command,
the chdev command, the lsdev command, the lsmap command, the lspath command, the mkpath command, the mkvdev command,
the rmdev command, and
the rmpath command.