使用 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 |
指示主机是否为 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 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