手册页部分 1M： 系统管理命令

退出打印视图

 
更新时间： 2014 年 7 月
 
 

mpathadm(1M)

名称

mpathadm - 多路径发现和管理

用法概要

mpathadm subcommand 
direct-object [options] [operand
]

描述

mpathadm 命令用于启用多路径发现和管理。mpathadm 命令是作为一组子命令来实现的，许多子命令都有自己的选项，这些选项在该子命令对应的部分中进行介绍。“选项”部分介绍了不与特定子命令关联的选项。mpathadm 子命令基于 direct-object 运行。这些对象在各个子命令的直接对象部分中进行介绍。子命令中的 direct-objects、initiator-port、target-port 和 logical-unit 与 SCSI 标准定义一致。

mpathadm 命令支持下列子命令，这些子命令将在下表之后的各个小节中详细介绍。

list

显示给定对象的已发现实例列表。

show

显示关于给定对象实例的信息。

modify

修改对象的属性。

enable

启用对象。

disable

禁用对象。

failover

使逻辑单元的目标端口组发生故障转移。

override

设置一个用于覆盖逻辑单元上其他路径的路径。

mpathadm 子命令对 direct-object 进行操作。这些对象在各个子命令的直接对象部分中进行介绍。

list 子命令

list 子命令的语法如下：

# mpathadm list direct-object [
operands...]

list 子命令显示以下直接对象的数据：

mpath-support [mpath-support-name , ...]

列出可由此 CLI 管理的多路径支持。此操作会以通过 MPAPI 框架注册的库名称形式显示多路径支持。如果没有指定多路径支持名称 mpath-support-name，将显示注册的所有多路径支持库。

initiator-port [initiator-port-name , ...]

列出在此系统上发现的启动器端口。如果没有指定 initiator-port-name，将显示发现的所有启动器端口。

{logical-unit | lu} [options] [logical-unit-name, ...]

列出多路径逻辑单元的相关信息。如果未指定 logical-unit-name，将显示发现的所有逻辑单元。

list logical-unit 的选项如下：

–n, ––name name

返回与给定 name 字符串相关联的逻辑单元名称。可从 mpathadm show lu 命令的输出中提取此名称。

–t, ––target-port target-port-name

返回与给定 target-port-name 相关联的逻辑单元名称的列表。

show 子命令

show 子命令的语法如下：

# mpathadm show direct-object [options] [
operands...]

show 子命令显示以下直接对象的详细信息：

mpath-support [mpath-support-name , ...]

显示有关给定 mpath-support-name 的详细信息（如果该名称存在）。如果给定的 mpath-support-name 仅支持有限的一组设备产品，设备产品列表将在输出中列出。

initiator-port [initiator-port-name , ...]

显示给定 initiator-port-name 的详细信息。如果未指定 initiator-port-name，将详细显示搜索到的所有启动器端口。

{logical-unit | lu} [logical-unit-name, ...]

显示有关多路径逻辑单元的详细信息，包括路径和目标端口组信息。如果未指定 logical-unit-name，将显示发现的所有逻辑单元的详细信息。请注意，逻辑单元信息中的名称属性表示该 LUN 的标识符，它是从硬件派生出来的，由该系统使用。如果此名称源自 SCSI Inquiry 重要产品数据 (Vital Product Data, VPD) 页面 83h，则名称类型属性表示 SCSI 标准定义的一个关联标识符类型。

用于显示逻辑单元的选项如下：

–e, –-path-missing

显示搜索到的所有逻辑单元信息，但不包含路径。

modify 子命令

modify 子命令的语法如下：

# mpathadm modify direct-object [
options] [operands...]

modify 子命令修改以下直接对象的特征：

mpath-support [options] mpath-support-name, ...

对 mpath-support 进行配置管理。用于修改 mpath-support 的选项如下：

–a, ––autofailback on | off

设置 autofailback。仅当 mpath-support 提供自动故障恢复支持时才适用。

–p, ––autoprobe on | off

设置 autoprobing。仅当 mpath-support 提供自动探测支持时才适用。

–b, ––loadbalance loadbalance-type

更改缺省负载平衡类型。loadbalance 类型是 show mpath-support 输出中列出的支持类型之一。

{logical-unit | lu} [options] logical-unit-name, ...

对逻辑单元进行配置管理。用于修改 logical-unit 的选项如下所示：

–a, ––autofailback on | off

设置 autofailback。仅当 mpath-support 提供自动故障恢复支持时才适用

–p, ––autoprobe on | off

设置 autoprobing。仅当 mpath-support 提供自动探测支持时才适用。

–b, ––loadbalance loadbalance-type

设置逻辑单元的负载平衡类型。仅当在逻辑单元级别支持负载平衡配置时才适用。

enable 子命令

enable 子命令的语法如下：

# mpathadm enable [options]

enable 子命令支持启用以下直接对象：

path –i initiator-port-name –t target-port-name
–l logical-unit-name

将启用包含指定启动器端口、目标端口和逻辑单元的路径。

disable 子命令

disable 子命令的语法如下：

# mpathadm disable [options]

disable 子命令支持禁用以下直接对象：

path –i initiator-port-name –t target-port-name
–l logical-unit-name

将禁用包含指定启动器端口、目标端口和逻辑单元的路径。

failover 子命令

failover 子命令的语法如下：

# mpathadm failover direct-object [
operand]

failover 子命令支持对以下直接对象进行故障转移：

{logical-unit | lu} logical-unit-name

当给定逻辑单元为非对称且支持显式状态更改时，将对目标端口组进行故障转移。当前活动的目标端口组将更改为备用状态，备用目标端口组将处于活动状态。无法更改不可用的目标端口组的状态。

override 子命令

override 子命令的语法如下：

# mpathadm override [options]

override 子命令控制以下直接对象是否覆盖其他直接对象：

path {–i initiator-port-name – t target-port-name | –c}
–l logical-unit-name

使包含指定启动器端口、目标端口和逻辑单元的路径覆盖逻辑单元上的其他路径。某个路径覆盖其他路径之后，多路径支持将只使用该路径，而不考虑任何其他路径选择配置。–c 选项用于取消设置。将禁用包含指定启动器端口、目标端口和逻辑单元的路径。

用于覆盖路径的选项如下：

–i, ––initiator-port initiator-port-name

表示路径的启动器端口元素。还必须包括 –t 和 –l 选项。

–t, ––target-port target-port-name

表示路径的目标端口元素。还必须包括 –i 和 –l 选项。

–l, ––logical-unit logical-unit

表示路径的逻辑单元元素。还必须包括 –i 和 –t 选项。

–c, ––cancel

取消给定逻辑单元的覆盖设置。还必须包括 –l 选项。

选项

支持以下选项：

–V, ––version

显示版本信息。

–?, ––help

显示上下文帮助。可以在没有参数的 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
示例 8 显示关于主机启动器端口的所有信息

以下命令将显示关于主机启动器端口的所有信息。

# 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
示例 9 显示关于逻辑单元的所有信息，但不包含路径

以下命令将显示关于逻辑单元的所有信息，但不包含路径。

# 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(5)：

属性类型
属性值
可用性
system/storage/multipath-utilities
system/library/storage/libmpapi（exec_attr(4) 条目）
接口稳定性
Committed（已确定）
CLI 输出
Not an interface（不是接口）

另请参见

stmsboot(1M)、libMPAPI(3LIB)、exec_attr(4)、attributes(5)

版权所有 © 1993, 2014, Oracle 和/或其附属公司。 保留所有权利。 法律声明
上一页
下一页