lshost

使用 lshost 命令可生成一张列表,其中列出有关集群系统(系统)的所有可视主机的简明信息以及有关单个主机的详细信息。

语法

 lshost   [  -filtervalue  attribute=value  ]   [  -nohdr  ]   [  -delim  delimiter  ]     [  -filtervalue?  ] [ {  object_id  |  object_name  } ]

参数

-filtervalueattribute=value
(可选)指定一个或多个过滤器的列表。 仅返回值与过滤器属性值匹配的对象。 如果指定了容量,那么还必须包含单位。
Note: 某些过滤器允许您在输入命令时使用通配符。 以下规则适用于将通配符用于 Lenovo Storage V7000 命令行界面 (CLI) 的情况:
  • 通配符为星号 (*)。
  • 命令最多可包含一个通配符。
  • 使用通配符时,必须将过滤器条目包含在双引号 ("") 内,如下所示:lshost -filtervalue "name=md*"
-nohdr
(可选)缺省情况下,将在简明样式视图中显示每个数据列的标题,在详细样式视图中显示每个数据项的标题。 -nohdr 参数用于禁止显示这些标题。
Note: 如果不存在可显示的数据,那么不会显示标题。
-delimdelimiter
(可选)缺省情况下,简明视图中的所有数据列都以空格分隔。 每列的宽度设置为每个数据项的最大宽度。 在详细视图中,每个数据项各占一行,如果显示标题,将用空格来分隔数据与标题。 -delim 参数会覆盖此行为。 -delim 参数的有效输入为一个单字节字符。 如果在命令行中输入 -delim :,那么在简明视图中将用冒号字符 (:) 分隔所有数据项;例如,不会出现列间距。 在详细视图中,数据与标题间以指定的定界符分隔。
object_id | object_name
(可选)指定对象的名称或标识。 使用此参数时,将返回特定对象的详细视图,而忽略 -filtervalue 参数指定的所有值。 如果未指定 object_id | object_name 参数,那么将显示与 -filtervalue 参数指定的过滤要求相符的所有对象的简明视图。
-filtervalue?
(可选)指定您希望报告显示有效过滤器属性列表的任何部分或全部。 lshost 命令的有效过滤器属性包括:
  • host_cluster_id
  • host_cluster_name
  • host_name
  • host_id
  • id
  • iogrp_count
  • name
  • port_count
  • site_id
  • site_name
  • status
  • type

有关过滤属性的更多信息,请参阅-filtervalue 参数的属性

描述

此命令返回系统可视的主机的简明列表或详细视图。

对于光纤通道 (FC) 端口,node_logged_in_count 字段提供主机端口登录到的节点的数量。对于因特网小型计算机系统接口 (iSCSI) 端口,node_logged_in_count 字段提供来自主机 iSCSI 限定名 (IQN) 的 iSCSI 会话的数量。

您可以将 iSCSI 主机映射到可通过多个 I/O 组访问的卷。 iSCSI 主机可以访问可通过多个 I/O 组(以及单个 I/O 组)访问的卷。 如果映射到可通过多个 I/O 组访问的卷的 iSCSI 主机至少具有一个活动的 iSCSI 会话(包含访问集的每个 I/O 组),那么其状态为 online。 如果卷未映射到 iSCSI 主机,那么其状态为 degraded

以下列表提供了光纤网连接 FC 主机端口的各种状态:
active
如果具有卷映射的所有节点都登录到指定的全球端口名 (WWPN),并且在最近 5 分钟内至少有一个节点从 WWPN 接收到 SCSI 命令,那么主机端口处于活动状态。
degraded
如果一个或多个具有卷映射的节点未登录到指定的 WWPN,那么主机端口处于降级状态。
inactive
如果具有卷映射的所有节点都登录到指定的 WWPN,但在最近 5 分钟内没有任何节点从 WWPN 接收到小型计算机系统接口 (SCSI) 命令,那么主机端口处于不活动状态。
offline
如果一个或多个具有卷映射的输入/输出 (I/O) 组未登录到指定的 WWPN,那么主机端口处于脱机状态。
以下列表提供了直接连接 FC 主机端口的各种状态:
active
如果节点已登录到指定的 WWPN,并且该节点在过去 5 分钟内已从该 WWPN 接收到 SCSI 命令,那么主机端口处于活动状态。
inactive
如果具有卷映射的所有节点都登录到指定的 WWPN,但在最近 5 分钟内没有任何节点从 WWPN 接收到小型计算机系统接口 (SCSI) 命令,那么主机端口处于不活动状态。
offline
如果没有登录到指定的 WWPN,那么主机端口处于脱机状态。
如果某个主机不具有任何卷映射,那么会将其报告为处于脱机或不活动状态。
Note: lshost 命令显示已登录到节点的主机 HBA 端口的列表。 但在某些情况下,显示信息时可能会包含不再登录或者甚至是属于 SAN 光纤网一部分的主机 HBA 端口。例如,某个主机 HBA 端口已从交换机上拔下,但 lshost 仍显示该 WWPN 已登录到所有节点。如果发生此操作,那么在先前包含已移除的主机 HBA 端口的交换机端口上插入另一个设备后,错误显示的条目即会移除。
以下列表提供所指定 iscsiname 的各种状态:
active
如果具有卷映射的所有 I/O 组至少有一个与指定 iscsiname 关联的 iSCSI 会话,那么该 iscsiname 处于活动状态。
inactive
如果主机不包含任何卷映射,但指定的 iscsiname 至少有一个 iSCSI 会话,那么该 iscsiname 处于不活动状态。
offline
如果一个或多个具有卷映射的 I/O 组不包含所指定 iscsiname 的关联 iSCSI 会话,那么该 iscsiname处于脱机状态。
以下列表提供了 host_status 的不同状态:
online
主机完全连通。 如果只使用一种连接样式的主机使用以下某类型,那么该主机处于联机状态:
光纤连接光纤通道 (FAFC)
每个端口处于活动或不活动状态,并登录到主机在其中具有卷映射的每个 I/O 组中的每个联机节点。
直接连接光纤通道 (DAFC)
主机具有到 I/O 组(主机具有到这些 I/O 组的卷映射)中每个节点的活动或不活动登录。
因特网小型计算机系统接口 (iSCSI)
主机具有与每个 I/O 组(主机具有与该 I/O 组的卷映射)的 iSCSI 会话。
offline
主机不具有连通性。 原因可能是主机已断电或未开启。
Remember: 如果 iSCSI 主机仅登录至未配置该主机的 I/O 组,那么关联的主机对象状态为 offline
degraded
主机未完全连接,这可能是由配置错误或硬件故障引起的。 这会导致在任何计划的维护活动期间丢失访问权,必须尽快更正。
Remember: 如果没有映射卷的 iSCSI 主机登录至其所属的某些(并非所有)I/O 组,那么该主机为 degraded
mask
主机可访问的光纤通道 (FC) I/O 端口(存在于节点上)。
lshost 输出 显示了可能的输出:
Table 1. lshost 输出
属性 描述
id 指示唯一的主机标识。 该值为字母数字值。
name 指示唯一的主机名称。 该值为字母数字字符串。
port_count 指示端口数。
type 指示主机类型。
mask 指示具有 64 位二进制字符串的掩码值。
iogrp_count 指示 I/O 组数。
status 指示主机是否为 onlineoffline
WWPN 指示含有 16 个字符的十六进制字符串的全球端口名 (WWPN)。
SAS_WWPN 指示含有 16 个字符的十六进制字符串的串行连接 SCSI (SAS) WWPN。
node_logged_in_count 指示 WWPN 登录的节点数。
state 指示 SAS WWPN 登录的状态。 值包括:
  • offline
  • inactive
  • active
sas_wwpn_count 指示已配置的 SAS WWPN 的数量。
site_id 标识主机的站点标识。 值为 12 或空白。
site_name 标识主机的站点名。 值必须为字母数字字符串或空白。
host_cluster_id 指示主机集群的唯一标识。
host_cluster_name 指示主机集群的唯一名称。

调用示例

lshost

生成的输出:

id name    port_count iogrp_count status mapping_count host_cluster_id  host_cluster_name site_id site_name  
  0  hostone 1          4           offline              0               vardyhost1 2 chelsea3
  1  host0   1          4           degraded             1               vardyhost2 1 chelsea1
  2  host1   1          4           online               2               vardyhost3 2 chelsea2

详细调用示例

lshost 0

生成的输出:

id 0
name ined
port_count 1
type openvms
mask 0000000000000000000000000000000000000000000000000000000000001101
iogrp_count 4
status online
WWPN 10000000C92BB490
node_logged_in_count 1
state inactive
site_id 2
site_name chelsea2
host_cluster_id 1
host_cluster_name jvardy8

调用示例

lshost 0

生成的输出:

id 0
name host0
port_count 10
type generic
mask 1111111111111111111111111111111111111111111111111111111111111111
iogrp_count 4
status offline
SAS_WWPN 1000000000000009
node_logged_in_count 0
state offline
SAS_WWPN 1000000000000008
node_logged_in_count 0
state offline
site_id 2
site_name chelsea2
host_cluster_id 2
host_cluster_name boat3ng