使用 lshost 命令可生成一张列表,其中列出有关集群系统(系统)的所有可视主机的简明信息以及有关单个主机的详细信息。
语法
lshost
[ -filtervalue attribute=value
] [ -nohdr ] [ -delim
delimiter ]
[ -filtervalue? ] [ {
object_id | object_name } ]
参数
- -filtervalueattribute=value
- (可选)指定一个或多个过滤器的列表。仅返回值与过滤器属性值匹配的对象。如果指定了容量,那么还必须包含单位。
Note: 某些过滤器允许您在输入命令时使用通配符。以下规则适用于将通配符用于
Lenovo Storage V7000 命令行界面 (CLI) 的情况:
- -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
有关过滤属性的更多信息,请参阅-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 端口(存在于节点上)。
Table 1 显示了可能的输出:
Table 1. lshost 输出
属性 |
描述 |
id |
指示唯一的主机标识。该值为字母数字值。 |
name |
指示唯一的主机名称。该值为字母数字字符串。 |
port_count |
指示端口数。 |
type |
指示主机类型。 |
mask |
指示具有 64 位二进制字符串的掩码值。 |
iogrp_count |
指示 I/O 组数。 |
status |
指示主机是否为 online 或 offline。 |
WWPN |
指示含有 16 个字符的十六进制字符串的全球端口名 (WWPN)。 |
SAS_WWPN |
指示含有 16 个字符的十六进制字符串的串行连接 SCSI (SAS) WWPN。 |
node_logged_in_count |
指示 WWPN 登录的节点数。 |
state |
指示 SAS WWPN 登录的状态。值包括:
|
sas_wwpn_count |
指示已配置的 SAS WWPN 的数量。 |
site_id |
标识主机的站点标识。值为 1、2 或空白。 |
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 inactivesite_id 2
site_name chelsea2host_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 chelsea2host_cluster_id 2
host_cluster_name boat3ng