跳过导航链接 | |
退出打印视图 | |
手册页第 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):
|