lshost
使用 lshost 命令可生成一张列表,其中列出有关集群系统(系统)的所有可视主机的简明信息以及有关单个主机的详细信息。
语法
>>- lshost-- --+-----------------------------------+-- ---------> '- -filtervalue -- attribute=value -' >--+----------+-- --+-----------------------+-- -- -------------> '- -nohdr -' '- -delim -- delimiter -' >--+-----------------+--+---------------+---------------------->< '- -filtervalue? -' +- object_id ---+ '- object_name -'
参数
- -filtervalue attribute=value
- (可选)指定一个或多个过滤器的列表。仅返回值与过滤器属性值匹配的对象。如果指定了容量,那么还必须包含单位。
- 注: 某些过滤器允许您在输入命令时使用通配符。以下规则适用于将通配符用于 Storwize® V3500 命令行界面 (CLI) 的情况:
- 通配符为星号 (*)。
- 命令最多可包含一个通配符。
- 使用通配符时,必须将过滤器条目包含在双引号 ("") 内,如下所示:
lshost -filtervalue "name=md*"
- -nohdr
- (可选)缺省情况下,将在简明样式视图中显示每个数据列的标题,在详细样式视图中显示每个数据项的标题。-nohdr 参数用于禁止显示这些标题。注: 如果没有要显示的数据,那么不会显示标题。
- -delim delimiter
- (可选)缺省情况下,简明视图中的所有数据列都以空格分隔。每列的宽度设置为每个数据项可能的最大宽度。在详细视图中,每个数据项各占一行,如果显示标题,将用空格来分隔数据与标题。-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
- 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),并且在最近五分钟内至少有一个节点从 WWPN 接收到 SCSI 命令,那么主机端口处于活动状态。
- degraded
- 如果一个或多个具有卷映射的节点未登录到指定的 WWPN,那么主机端口处于降级状态。
- inactive
- 如果具有卷映射的所有节点都登录到指定的 WWPN,但在最近五分钟内没有任何节点从 WWPN 接收到小型计算机系统接口 (SCSI) 命令,那么主机端口处于不活动状态。
- offline
- 如果一个或多个具有卷映射的输入/输出 (I/O) 组未登录到指定的 WWPN,那么主机端口处于脱机状态。
以下列表提供了直接连接 FC 主机端口的各种状态:
- active
- 如果节点已登录到指定的 WWPN,并且该节点在过去 5 分钟内已从该 WWPN 接收到 SCSI 命令,那么主机端口处于活动状态。
- inactive
- 如果具有卷映射的所有节点都登录到指定的 WWPN,但在最近五分钟内没有任何节点从 WWPN 接收到小型计算机系统接口 (SCSI) 命令,那么主机端口处于不活动状态。
- offline
- 如果没有登录到指定的 WWPN,那么主机端口处于脱机状态。
注: 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
- 主机不具有连通性。这可能是因为主机已断电或未开启。切记: 如果 iSCSI 主机仅登录至未配置该主机的 I/O 组,那么关联的主机对象状态为 offline。
- degraded
- 主机未完全连接,这可能是由配置错误或硬件故障引起的。这会导致在任何计划的维护活动期间丢失访问权,应尽快更正。切记: 如果没有映射卷的 iSCSI 主机登录至其所属的某些(并非所有)I/O 组,那么该主机为 degraded。
- mask
- 主机可访问的光纤通道 (FC) I/O 端口(存在于节点上)。
表 1 显示了可能的输出:
属性 | 描述 |
---|---|
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 的数量。 |
host_cluster_id | 指示主机集群的唯一标识。 |
host_cluster_name | 指示主机集群的唯一名称。 |
调用示例
lshost
生成的输出:
id name port_count iogrp_count status mapping_count host_cluster_id host_cluster_name
0 hostone 1 4 offline 0 vardyhost1
1 host0 1 4 degraded 1 vardyhost2
2 host1 1 4 online 2 vardyhost3
详细调用示例
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
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
host_cluster_id 2
host_cluster_name boat3ng