| 跳过导航链接 | |
| 退出打印视图 | |
|
手册页第 1M 部分：系统管理命令 Oracle Solaris 11.1 Information Library (简体中文) |
| 跳过导航链接 | |
| 退出打印视图 | |
|
|
手册页第 1M 部分：系统管理命令 Oracle Solaris 11.1 Information Library (简体中文) |
- 多路径发现和管理
mpathadm subcommand direct-object [options] [operand]
mpathadm 命令用于启用多路径发现和管理。mpathadm 命令是作为一组子命令来实现的，许多子命令都有自己的选项，这些选项在该子命令对应的部分中进行介绍。“选项”部分介绍了不与特定子命令关联的选项。mpathadm 子命令基于 direct-object 运行。这些对象在各个子命令的直接对象部分中进行介绍。子命令中的 direct-objects、initiator-port、target-port 和 logical-unit 与 SCSI 标准定义一致。
mpathadm 命令支持下列子命令，这些子命令将在下表之后的各个小节中详细介绍。
显示给定对象的已发现实例列表。
显示关于给定对象实例的信息。
修改对象的属性。
启用对象。
禁用对象。
使逻辑单元的目标端口组发生故障转移。
设置一个用于覆盖逻辑单元上其他路径的路径。
mpathadm 子命令基于 direct-object 运行。这些对象在各个子命令的直接对象部分中进行介绍。
list 子命令的语法如下：
# mpathadm list direct-object [operands...]
list 子命令显示以下直接对象的数据：
列出可由此 CLI 管理的多路径支持。此操作会以通过 MPAPI 框架注册的库名称形式显示多路径支持。如果没有指定多路径支持名称 mpath-support-name，将显示注册的所有多路径支持库。
列出在此系统上发现的启动器端口。如果没有指定 initiator-port-name，将显示发现的所有启动器端口。
列出多路径逻辑单元的相关信息。如果没有指定 logical-unit-name，将显示发现的所有逻辑单元。
list logical-unit 的选项如下：
返回与给定 name 字符串相关联的逻辑单元名称。此名称可从 mpathadm show lu 命令的输出中提取。
返回与给定 target-port-name 相关联的逻辑单元名称的列表。
show 子命令的语法如下：
# mpathadm show direct-object [operands...]
show 子命令显示以下直接对象的详细信息：
显示有关给定 mpath-support-name 的详细信息（如果该名称存在）。如果给定的 mpath-support-name 仅支持有限的一组设备产品，设备产品列表将在输出中列出。
显示给定 initiator-port-name 的详细信息。
显示有关多路径逻辑单元的详细信息，包括路径和目标端口组信息。请注意，逻辑单元信息中的名称属性表示该 LUN 的标识符，它是从硬件派生出来的，由该系统使用。如果此名称源自 SCSI Inquiry 重要产品数据 (Vital Product Data, VPD) 页面 83h，则名称类型属性表示 SCSI 标准定义的一个关联标识符类型。
modify 子命令的语法如下：
# mpathadm modify direct-object [options] [operands...]
modify 子命令修改以下直接对象的特征：
对 mpath-support 进行配置管理。用于修改 mpath-support 的选项如下：
设置 autofailback。仅当 mpath-support 提供自动故障恢复支持时才适用。
设置 autoprobing。仅当 mpath-support 提供自动探测支持时才适用。
更改缺省负载平衡类型。loadbalance 类型是 show mpath-support 输出中列出的支持类型之一。
对逻辑单元进行配置管理。用于修改 logical-unit 的选项如下：
设置 autofailback。仅当 mpath-support 提供自动故障恢复支持时才适用
设置 autoprobing。仅当 mpath-support 提供自动探测支持时才适用。
设置逻辑单元的负载平衡类型。仅当在逻辑单元级别支持负载平衡配置时才适用。
enable 子命令的语法如下：
# mpathadm enable [options]
enable 子命令支持启用以下直接对象：
将启用包含指定启动器端口、目标端口和逻辑单元的路径。
disable 子命令的语法如下：
# mpathadm disable [options]
disable 子命令支持禁用以下直接对象：
将禁用包含指定启动器端口、目标端口和逻辑单元的路径。
failover 子命令的语法如下：
# mpathadm failover direct-object [operand]
failover 子命令支持对以下直接对象进行故障转移：
当给定逻辑单元为非对称且支持显式状态更改时，将对目标端口组进行故障转移。当前活动的目标端口组将更改为备用状态，备用目标端口组将处于活动状态。
override 子命令的语法如下：
# mpathadm override [options]
override 子命令控制以下直接对象是否覆盖其他直接对象：
使包含指定启动器端口、目标端口和逻辑单元的路径覆盖逻辑单元上的其他路径。某个路径覆盖其他路径之后，多路径支持将只使用该路径，而不考虑任何其他路径选择配置。-c 选项用于取消设置。将禁用包含指定启动器端口、目标端口和逻辑单元的路径。
用于覆盖路径的选项如下：
表示路径的启动器端口元素。还必须包括 -t 和 -l 选项。
表示路径的目标端口元素。还必须包括 -i 和 -l 选项。
表示路径的逻辑单元元素。还必须包括 -i 和 -t 选项。
取消给定逻辑单元的覆盖设置。还必须包括 -l 选项。
支持以下选项：
显示版本信息。
显示上下文帮助。可以在没有参数的 mpathadm 命令、子命令或子命令直接对象组合后使用。使用适用于您的输入的帮助信息进行响应。例如，如果输入以下内容：
# mpathadm add mpath-support-help
... mpathadm 将返回可用于此子命令和直接对象组合的选项。
示例 1 获取多路径支持列表
以下命令使用 list 子命令列出当前注册的所有 mpath-support 库。
# mpathadm list mpath-support mpath-support: libmpscsi_vhci.so
示例 2 显示特定多路径支持的属性
以下命令使用 show 子命令显示当前注册的 mpath-support 库的属性。
# 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示例 3 获取通过 mpath-support 库发现的启动器端口的列表
以下命令使用 list initiator-port 子命令显示当前注册的 mpath-support 库发现的启动器端口的列表。
# mpathadm list initiator-port Initiator-Port: iqn.1986-03.com.sun:01:080020b7ac2b.437a3b3e,4000002a0000 Initiator-Port: 2000000173018713 Initiator-Port: 2000000173818713
示例 4 显示特定启动器端口的属性
以下命令使用 show initiator-port 子命令显示使用以上示例中的 list initiator-port 子命令发现的特定启动器端口的属性。
# 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示例 5 显示特定逻辑单元的属性
以下命令使用 show logical-unit 子命令显示具有指定名称的逻辑单元的属性。
# 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示例 6 启用路径
以下命令使用 enable path 子命令启用具有指定启动器端口、目标端口以及逻辑单元的路径。
# mpathadm enable path -i 2000000173018713 -t 20030003ba27d095 \ -l /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2
示例 7 修改 mpath-support 以启用 autofailback
# mpathadm modify mpath-support -a on libmpscsi_vhci.so
有关下列属性的说明，请参见 attributes(5)：
|
|