svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
mpathadm(8)
System Administration Commands mpathadm(8)
NAME
mpathadm - multipath discovery and administration
SYNOPSIS
mpathadm subcommand direct-object [options] [operand]
DESCRIPTION
The mpathadm command enables multipathing discovery and management. The
mpathadm command is implemented as a set of subcommands, many with
their own options, that are described in the section for that subcom‐
mand. Options not associated with a particular subcommand are described
under OPTIONS. The mpathadm subcommands operate on a direct-object.
These are described in this section for each subcommand. The direct-
objects, initiator-port, target-port, and logical-unit in the subcom‐
mands are consistent with SCSI standard definitions.
The mpathadm command supports the following subcommands, which are
described in detail in subsections that follow.
list Display a list of discovered instances for a given object.
show Display information about a given object instance.
modify Modify properties of an object.
enable Enable an object.
disable Disable an object.
failover Cause target port group failover for a logical-unit.
override Set a path to be used over other paths on a logical-unit.
The mpathadm subcommands operate on a direct-object. These are
described in this section for each subcommand.
list Subcommand
The syntax for the list subcommand is:
# mpathadm list direct-object [operands...]
The list subcommand displays data for following direct-objects:
mpath-support [mpath-support-name, ...]
List the multipathing support that can be administered by this CLI.
This presents itself in the form of a library name registered
through the MPAPI framework. If no mpath-support name mpath-sup‐
port-name is specified, all registered multipathing support
libraries will be displayed.
initiator-port [initiator-port-name, ...]
List the initiator ports that are discovered on this system. If no
initiator-port-name is specified, all discovered initiator ports
are displayed.
{logical-unit | lu} [options] [logical-unit-name, ...]
List the information on multipath logical units. If no logical-
unit-name is specified, all discovered logical-units will be dis‐
played.
Options for list logical-unit are as follows:
-n, --name name
Return the logical unit name that is associated with the given
name string. This name can be extracted from the output of the
mpathadm show lu command.
-t, --target-port target-port-name
Return the list of logical units names that are associated with
the given target-port-name.
show Subcommand
The syntax for the show subcommand is:
# mpathadm show direct-object [options] [operands...]
The show subcommand displays detailed information for following the
direct-objects:
mpath-support [mpath-support-name, ...]
Show the detailed information on the given mpath-support-name if
the name exists. If the given mpath-support-name supports only a
limited set of device products, the list of device products will be
listed as part of the output.
initiator-port [initiator-port-name, ...]
Show the detailed information for the given initiator-port-name. If
no initiator-port-name is specified, all discovered initiator-ports
will be displayed in detail.
{logical-unit | lu} [logical-unit-name, ...]
Display the detailed information on multipath logical unit(s),
including path and target port group information. If no logical-
unit-name is specified, all discovered logical unit(s) will be dis‐
played in detail. Note that the name property in the logical unit
information represents the identifier for this LUN, derived from
the hardware, and used by this system. If the name is derived from
SCSI Inquiry Vital Product Data (VPD) page 83h, the name type prop‐
erty represents an associated identifier type defined by the SCSI
standards.
Options for show logical-unit are as follows:
-e, --path-missing Display overall discovered logical unit
information with only missing paths.
modify Subcommand
The syntax for the modify subcommand is:
# mpathadm modify direct-object [options] [operands...]
The modify subcommand modifies characteristics of the following direct-
objects:
mpath-support [options] mpath-support-name, ...
Configuration management of an mpath-support. Options to modify
mpath-support are as follows:
-a, --autofailback on | off
Set autofailback. Applicable only when mpath-support provides
auto failback support.
-p, --autoprobe on | off
Set autoprobing. Applicable only when mpath-support provides
auto probing support.
-b, --loadbalance loadbalance-type
Change the default load balance type. The loadbalance type is
one of the supported types listed in the show mpath-support
output.
{logical-unit | lu} [options] logical-unit-name, ...
Configuration management of a logical unit. Options to modify logi‐
cal-unit are as follows:
-a, --autofailback on | off
Set autofailback. Applicable only when mpath-support provides
auto failback support
-p, --autoprobe on | off
Set autoprobing. Applicable only when mpath-support provides
auto probing support.
-b, --loadbalance loadbalance-type
Set load balance type for the logical unit. Applicable only
when load balance configuration is supported at the logical
unit level.
enable Subcommand
The syntax for the enable subcommand is:
# mpathadm enable [options]
The enable subcommand supports the following direct-objects to be
enabled:
path -i initiator-port-name -t target-port-name
-l logical-unit-name
The path that consists of the specified initiator port, target
port, and logical unit will be enabled.
disable Subcommand
The syntax for the disable subcommand is:
# mpathadm disable [options]
The disable subcommand supports the following direct-objects to be dis‐
abled:
path -i initiator-port-name -t target-port-name
-l logical-unit-name
The path that consists of the specified initiator port, target
port, and logical unit will be disabled.
failover Subcommand
The syntax for the failover subcommand is:
# mpathadm failover direct-object [operand]
The failover subcommand supports failover for the following direct-
objects:
{logical-unit | lu} logical-unit-name
The target port group will failover when the given logical-unit is
asymmetric and supports explicit state change. The currently active
target port group will be changed to the standby state and the
standby target port group will be active. State of an unavailable
target port group cannot be changed.
override Subcommand
The syntax for the override subcommand is:
# mpathadm override [options]
The override subcommand controls whether or not the following direct-
objects override another:
path {-i initiator-port-name -t target-port-name | -c}
-l logical-unit-name
Cause a path that consists of the specified initiator port, target
port, and logical unit to override other paths on the logical unit.
Once a path overrides other paths, the mpath-support uses only that
path regardless of any other path selection configuration. The -c
option cancels the setting. The path that consists of the specified
initiator port, target port, and logical unit will be disabled.
Options for override path are as follows:
-i, --initiator-port initiator-port-name
Represent the initiator port element of a path. Options -t and
-l must also be included.
-t, --target-port target-port-name
Represent the target port element of a path. Options -i and -l
must also be included.
-l, --logical-unit logical-unit
Represent the logical unit element of a path. Options -i and -t
must also be included.
-c, --cancel
Cancels overriding setting for the given logical unit. Option
-l must also be included.
OPTIONS
The following options are supported:
-V, --version Display the version information.
-?, --help Display context help. Can be used following an
mpathadm command with no arguments, following a sub‐
command, or following a subcommand direct-object com‐
bination. Responds with help information appropriate
for your entry. For example, if you enter:
# mpathadm add mpath-support-help
... mpathadm responds with a display of the options
available for that combination of subcommand and
direct-object.
EXAMPLES
Example 1 Obtaining a List of Multipathing Support
The following command uses the list subcommand to list all currently
registered mpath-support libraries.
# mpathadm list mpath-support
mpath-support: libmpscsi_vhci.so
Example 2 Displaying the Properties of a Particular Multipathing Sup‐
port
The following command uses the show subcommand to display the proper‐
ties for a currently registered mpath-support library.
# mpathadm show mpath-support libmpscsi_vhci.so
mpath-support: libmpscsi_vhci.so
Vendor: Sun Microsystems
Driver Name: scsi_vhci
Default Load Balance: round-robin
Supported Load Balance Types:
round-robin
logical-block
Allows To Activate Target Port Group Access: yes
Allows Path Override: no
Supported Auto Failback Config: 1
Auto Failback: on
Failback Polling Rate (current/max): 0/0
Supported Auto Probing Config: 0
Auto Probing: NA
Probing Polling Rate (current/max): NA/NA
Supported Devices:
Vendor: SUN
Product: T300
Revision:
Supported Load Balance Types:
round-robin
Vendor: SUN
Product: T4
Revision:
Supported Load Balance Types:
round-robin
Example 3 Obtaining a List of Initiator Ports Discovered Through the
mpath-support Libraries
The following command uses the list initiator-port subcommand to dis‐
play a list of initiator ports discovered by the currently registered
mpath-support libraries.
# mpathadm list initiator-port
Initiator-Port: iqn.1986-03.com.sun:01:080020b7ac2b.437a3b3e,4000002a0000
Initiator-Port: 2000000173018713
Initiator-Port: 2000000173818713
Example 4 Displaying the Properties of a Particular Initiator Port
The following command uses the show initiator-port subcommand to dis‐
play the properties of a particular initiator port discovered using the
list initiator-port subcommand in an example above.
# mpathadm show initiator-port 2000000173018713
initiator-port: 2000000173018713
Transport Type: Fibre Channel
OS device File: devices/pci@1f,4000/pci@2/SUNW,qlca@5/fp@0,0:fc
Example 5 Displaying the Properties of a Particular Logical Unit
The following command uses the show logical-unit subcommand to display
the properties of the logical unit with the specified name.
# mpathadm show lu /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2
Logical Unit: /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2
mpath-support libmpscsi_vhci.so
Vendor: SUN
Product: T4
Revision: 0301
Name Type: SCSI Inquiry VPD Page 83 type 3
Name: 60003ba27d2120004204ac2b000dab00
Asymmetric: yes
Current Load Balance: round-robin
Logical Unit Group ID: NA
Aauto Failback: on
Auto Probing: NA
Paths:
Initiator Port Name: 2000000173818713
Target Port Name: 20030003ba27d212
Override Path: NA
Path State: OK
Disabled: no
Initiator Port Name: 2000000173018713
Target Port Name: 20030003ba27d095
Override Path: NA
Path State: OK
Disabled: no
Target Port Group:
ID: 2
Explicit Failover: yes
Access State: standby
Target Ports:
Name: 20030003ba27d212
Relative ID: 0
ID: 5
Explicit Failover: yes
Access State: active
Target Ports
Name: 20030003ba27d095
Relative ID: 0
Example 6 Enabling a Path
The following command uses the enable path subcommand to enable the
path with the specified initiator port, target port, and logical unit.
# mpathadm enable path -i 2000000173018713 -t 20030003ba27d095 \
-l /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2
Example 7 Modifying mpath-support To Turn On autofailback
# mpathadm modify mpath-support -a on libmpscsi_vhci.so
Example 8 Displaying the Overall Information About Host Initiator Port
The following command displays the overall information about host ini‐
tiator port.
# mpathadm show initiator-port
Initiator Port: 210100e08ba41feb
Transport Type: Fibre Channel
OS Device File: /devices/pci@1,0/pci1022,7450@1/pci1077,141@2,1/fp@0,0
Initiator Port: iqn.1986-03.com.sun:01:ffffffffffff.519c6677,4000002a00ff
Transport Type: iSCSI
OS Device File: /devices/iscsi
Example 9 Displaying the Overall Information About the Logical Unit
With Only Missing Paths
The following command displays the overall information about the logi‐
cal unit with only missing paths.
# mpathadm show lu -e
Logical Unit: /dev/rdsk/c0t600A0B800026D63A000091344DBF39C4d0s2
mpath-support: libmpscsi_vhci.so
Vendor: SUN
Product: CSM200_R
Revision: 0660
Name Type: unknown type
Name: 600a0b800026d63a000091344dbf39c4
Asymmetric: yes
Current Load Balance: round-robin
Logical Unit Group ID: NA
Auto Failback: on
Auto Probing: NA
Paths:
Initiator Port Name: 210100e08ba41feb
Target Port Name: 200900a0b826d63b
Override Path: NA
Path State: OK
Disabled: no
Initiator Port Name: 210100e08ba41feb
Target Port Name: 200800a0b826d63c
Override Path: NA
Path State: unavailable
Disabled: no
Target Port Groups:
ID: 1
Explicit Failover: yes
Access State: active
Target Ports:
Name: 200900a0b826d63b
Relative ID: 0
ID: 3
Explicit Failover: yes
Access State: unavailable
Target Ports:
Name: 200800a0b826d63c
Relative ID: 0
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Availabilitysystem/storage/multipath-utilities _ T{
system/library/storage/libmpapi (exec_attr(5) entry) T} _ Interface
StabilityCommitted _ CLI OutputNot an interface
SEE ALSO
libMPAPI(3LIB), exec_attr(5), attributes(7), stmsboot(8)
Oracle Solaris 11.4 21 Feb 2012 mpathadm(8)