华为ultrapath命令linux,upadm常用命令 - OceanStor UltraPath for Linux 21.2.0 用户指南 04 - 华为...

命令功能

upadm show lun array=array_id {dev=lun_id}命令用于查看UltraPath软件管理的指定存储系统信息。

命令格式

upadm show lun array=array_id {dev=lun_id}

参数说明

关键字及参数

说明

默认值

array_id

存储系统的序号。

无

lun_id

存储系统上主机LUN号。

此处的主机是指ISM/OSM界面上显示的“主机”， 它是一个虚拟创建的主机。当为“主机”添加上端口后，它才能和物理上的应用服务器相对应。

无

说明：

ISM：Integrated Storage Manager

OSM：OceanStor Storage Manager

级别

root用户

使用指南

array_id可以通过使用upadm show array命令查询存储系统获得。

lun_id可以通过登录ISM/OSM查询获得。

使用实例

查询连接到应用服务器上ID为0的存储系统的详细信息。[root@localhost ~]# upadm show lun array=0

Hostname = localhost.localdomain

Domainname = (none)

Time = 02/07/2018 10:36:52

Array Module Information:

-------------------------

ModuleName: Storage-8Ctrl SingleController: N

SN: 2102350SHY10G6000004

Controller '3A' Status:

-----------------------

ControllerFailed: N ControllerPresent: Y

NumberOfPaths: 2 ServiceMode: -

Path #0

---------

ProcDirectory: none PathPresent: Y

PathState: OPTIMAL

hostId: 3, targetId: 0, channelId: 0

Path #1

---------

ProcDirectory: none PathPresent: Y

PathState: OPTIMAL

hostId: 4, targetId: 0, channelId: 0

Controller '3B' Status:

-----------------------

ControllerFailed: N ControllerPresent: Y

NumberOfPaths: 1 ServiceMode: -

Path #2

---------

ProcDirectory: none PathPresent: Y

PathState: OPTIMAL

hostId: 5, targetId: 0, channelId: 0

Information of Lun0 - WWN: 620f17c1001abaa922ea447e00000727 LUN Name: ziyan0000

----------------

LunObject: present CurrentOwningPath: 1B

DevState: OPTIMAL BootOwningPath: -

ReportedPresent: Y PreferredPath: 1B

ReportedMissing: - FailoverInProgress: -

Controller '3A' Path

--------------------

NumLunObjects: 2 RoundRobinIndex: 0

Path #0: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

Path #1: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

Controller '3B' Path

--------------------

...

Controller '3A' Path

--------------------

NumLunObjects: 2 RoundRobinIndex: 0

Path #0: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

Path #1: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

Controller '3B' Path

--------------------

NumLunObjects: 1 RoundRobinIndex: 0

Path #2: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

Information of Lun7 - WWN: 620f17c1001abaa922ea45ef0000072e LUN Name: ziyan0007

----------------

LunObject: present CurrentOwningPath: 1B

DevState: OPTIMAL BootOwningPath: -

ReportedPresent: Y PreferredPath: 1B

ReportedMissing: - FailoverInProgress: -

Controller '3A' Path

--------------------

NumLunObjects: 2 RoundRobinIndex: 0

Path #0: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

Path #1: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

Controller '3B' Path

--------------------

NumLunObjects: 1 RoundRobinIndex: 0

Path #2: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

[root@localhost ~]#

查询连接到应用服务器上ID为0、LUN ID为0的存储系统的详细信息。[root@localhost ~]# upadm show lun array=0 dev=0

Information of Lun0 - WWN: 620f17c1001abaa922ea447e00000727 LUN Name: ziyan0000

----------------

LunObject: present CurrentOwningPath: 1B

DevState: OPTIMAL BootOwningPath: -

ReportedPresent: Y PreferredPath: 1B

ReportedMissing: - FailoverInProgress: -

Controller '3A' Path

--------------------

NumLunObjects: 2 RoundRobinIndex: 0

Path #0: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

Path #1: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

Controller '3B' Path

--------------------

NumLunObjects: 1 RoundRobinIndex: 0

Path #2: LunPathDevice: present

IoCount: 0

DevState: OPTIMAL

[root@localhost ~]#

输出说明

命令执行成功后，系统显示的字段说明如表A-8所示。

表A-8  upadm show lun array=array_id {dev=lun_id}命令显示字段介绍字段

说明

Hostname

应用服务器名称。

Domainname

应用服务器域名。

Time

格林尼治时间。

Array Module Information：以下显示的信息为存储系统信息。

ModuleName

存储系统名称。

SingleController

应用服务器与该存储系统上的控制器连接方式是否处于单连接状态：Y：单连接状态。

N：双连接状态或多连接状态。

说明：

单连接状态是指应用服务器仅与存储系统上的一个控制器处于连通状态，且只有这个控制器对应用服务器提供服务。

双连接状态是指应用服务器与存储系统上的两个控制器处于连通状态，此时两个控制器都对应用服务器提供服务。

多连接状态是指应用服务器和存储系统之间通过VIS多节点集群方式进行连接。

SN

存储系统的SN。

Controller 'X' Status:以下显示的信息为存储系统上当前控制器的信息。

ControllerFailed

应用服务器到该控制器上的所有路径是否失效：Y：失效。

N：正常。

ControllerPresent

控制器是否在位：Y：在位。

N：不在位。

NumberOfPaths

该控制器可到达应用服务器上的路径数。

ServiceMode

控制器状态的标志：Y：处于非正常状态。

N：处于正常状态。

说明：

只有在控制器处于正常状态下，UltraPath for Linux 软件所提供的Failover和Failback功能才能启用。

以下显示的信息为控制器可到达存储系统上的路径信息。

ProcDirectory

在Proc目录下是否成功建立多路径信息：present：成功。

Null：失败。

PathPresent

应用服务器到达控制器上的路径是否可用：Y：可用。

N：不可用。

PathState

路径状态：OPTIMAL：最佳状态。

OPTIMAL_NEED_CHECK：需要检查路径是否处于最佳状态。

OPTIMAL_CHECKING：正在检查路径是否处于最佳状态。

FAILED：失败状态。

FAILED_NEED_CHECK：需要检查路径是否处于失败状态。

FAILED_CHECKING：正在检查路径是否处于失败状态。

hostId

HBA端口标识号。

targetId

存储系统的端口标识号。

channelId

该字段尚未使用，作为以后版本的保留字段。

Lun Information：以下显示的信息为从所查询的存储系统中映射到应用服务器上所有LUN的相关信息。

WWN

LUN的WWN。

LUN Name

LUN名称

LunObject

该字段尚未使用，作为以后版本的保留字段。

CurrentOwningPath

应用服务器访问该LUN时，当前经过的控制器。

BootOwningPath

系统启动时，LUN的当前工作控制器。 取值为A/B或0～7 之间的整数(包括0和7)，其中A、B表示控制器或控制器B，0～7之间的整数(包括0和7)表示

VIS的节点ID。

控制器A指在控制框上位于左侧的控制器，控制器B则指控制框上位于右侧的控制器。

ReportedPresent

应用服务器是否扫描到LUN：Y：扫描到。

N：未扫描到。

PreferredPath

LUN的归属控制器。

说明：

LUN的归属控制器：在存储系统划分LUN的时候，LUN所归属的控制器。

ReportedMissing

应用服务器是否未扫描到LUN：Y：未扫描到。

N：扫描到。

FailoverInProgress

表示LUN是否正在进行Failover：Y：是。

N：不是。

NumLunObjects

控制器到该LUN的路径数。

RoundRobinIndex

控制器上的轮流发送路径号。

LunPathDevice

LUN 路径所指定的设备是否存在：present：存在。

none：不存在。

IoCount

在该路径上成功进行的I/O次数。

DevState

LUN的状态：OPTIMAL：最佳状态。

OPTIMAL_NEED_CHECK：最佳需要检测状态。

OPTIMAL_CHECKING：最佳检测中状态。

FAILED：失败状态。

FAILED_NEED_CHECK：失败需要检测状态。

FAILED_CHECKING：失败检测中状态。