lshost
使用 lshost 命令可生成一张列表,其中列出有关对系统可视的所有主机的简明信息以及有关单个主机的详细信息。
语法
参数
- -filtervalue attribute=value
- (可选)指定一个或多个过滤器的列表。仅返回值与过滤器属性值匹配的对象。如果指定了容量,那么还必须包含单位。
- -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
- site_id
- site_name
- status
- type
- 协议 (protocol)
有关过滤属性的更多信息,请参阅-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,那么主机端口处于脱机状态。
以下列表提供了光纤网连接 NVMe/FC 主机端口的各种状态:
- active
- 如果具有卷映射的所有节点都包含指定 NVMe 限定名 (NQN) 的登录,并且在最近 5 分钟内至少有一个节点收到来自 NQN 的 NVMe 命令,那么主机端口处于活动状态。
- degraded
- 如果具有卷映射的一个或多个节点不包含指定 NQN 的登录,那么主机端口处于降级状态。
- inactive
- 如果具有卷映射的所有节点都包含指定 NQN 的登录,但在最近 5 分钟内没有节点收到来自 NQN 的任何 NVMe 命令,那么主机端口处于不活动状态。
- offline
- 如果具有卷映射的一个或多个输入/输出 (I/O) 组不包含指定 NQN 的登录,那么主机端口处于脱机状态。
注: lshost 命令显示已登录到节点的主机 HBA 端口的列表。但在某些情况下,显示信息时可能会包含不再登录或者甚至是属于 SAN 光纤网一部分的主机 HBA 端口。例如,某个主机 HBA 端口已从交换机上拔下,但 lshost 仍显示该 WWPN 已登录到所有节点。如果发生此操作,那么在先前包含已移除的主机 HBA 端口的交换机端口上插入另一个设备后,错误显示的条目即会移除。
以下列表提供所指定
iscsiname 的各种状态: - active
- 如果具有卷映射的所有 I/O 组至少有一个与指定
iscsiname关联的 iSCSI 会话,那么该iscsiname处于活动状态。 - inactive
- 如果主机不包含任何卷映射,但指定的
iscsiname至少有一个 iSCSI 会话,那么该iscsiname处于不活动状态。 - offline
- 如果对一个或多个 I/O 组具有访问权的卷映射到在所有相关 I/O 组上都没有关联
iSCSI 或 iSER 会话的指定 iscsiname,那么
iscsiname处于脱机状态。
以下列表提供 host_status 的各种状态:
- online
- 主机完全连通。如果只使用一种连接样式的主机使用以下某类型,那么该主机处于联机状态:
- 光纤连接光纤通道 (FAFC)
- 每个端口处于活动或不活动状态,并登录到主机在其中具有卷映射的每个 I/O 组中的每个联机节点。
- 直接连接光纤通道 (DAFC)
- 主机具有到 I/O 组(主机具有到这些 I/O 组的卷映射)中每个节点的活动或不活动登录。
- 因特网小型计算机系统接口 (iSCSI)
- 主机具有与每个 I/O 组(主机具有与该 I/O 组的卷映射)的 iSCSI 会话。
- 光纤通道 NVMe (FC-NVMe)
- 所有主机 NQN 都具有与主机在其中具有卷映射的每个 I/O 组中的每个联机节点的 NVMe 关联。
- offline
- 主机不具有连通性。原因可能是主机已断电或未开启。切记: 如果 iSCSI 主机仅登录至未配置该主机的 I/O 组,那么关联的主机对象状态为
offline。 - degraded
- 主机未完全连接,这可能是由配置错误或硬件故障引起的。这会导致在任何计划的维护活动期间丢失访问权,必须尽快更正。切记: 如果没有映射卷的 iSCSI 主机登录至其所属的某些(并非所有)I/O 组,那么该主机为
degraded。 - mask
- 主机可访问的光纤通道 (FC) I/O 端口(存在于节点上)。
下表显示了可能的输出:
| 属性 | 描述 |
|---|---|
| id | 指示唯一的主机标识。 该值为字母数字值。 |
| name | 指示唯一的主机名称。 该值为字母数字字符串。 |
| port_count | 指示端口数。 |
| type | 指示主机类型。 |
| mask | 指示具有 64 位二进制字符串的掩码值。 |
| iogrp_count | 指示 I/O 组数。 |
| status | 指示主机是否为 online 或 offline。 |
| 协议 (protocol) | 指示主机使用 scsi 还是 nvme 访问存储器。 |
| WWPN | 指示含有 16 个字符的十六进制字符串的全球端口名 (WWPN)。 |
| SAS_WWPN | 指示含有 16 个字符的十六进制字符串的串行连接 SCSI (SAS) WWPN。 |
| nqn | 指示 NVMe 限定名。 |
| node_logged_in_count | 指示 WWPN 或 NQN 登录的节点数。 |
| state | 指示 SAS WWPN 登录的状态。 值包括:
|
| sas_wwpn_count | 指示已配置的 SAS WWPN 的数量。 |
| nqn_count | 指示分配给主机的 NVMe NQN 端口数。 |
| site_id | 标识主机的站点标识。 值为 1、2 或空白。 |
| site_name | 标识主机的站点名。 值必须为字母数字字符串或空白。 |
| host_cluster_id | 指示主机集群的唯一标识。 |
| host_cluster_name | 指示主机集群的唯一名称。 |
| status_policy | 显示用于计算主机状态的连接需求。值为 complete 或 redundant。对于 status_policy redundant:
|
| status_site | 显示用于计算主机状态的主机站点连接。结果是以下值之一:
|
| owner_id | 显示所有权组的标识。 |
| owner_name | 显示所有权组的名称。 |
调用示例
lshost
生成的输出:
id name port_count iogrp_count status mapping_count host_cluster_id host_cluster_name protocol site_id site_name owner_id owner_name
0 hostone 1 4 offline 0 1 vardyhost1 scsi 2 chelsea2 0 tenantA
1 host0 1 4 degraded 1 2 vardyhost2 nvme 1 chelsea1 0 tenantA
2 host1 1 4 online 2 3 vardyhost3 scsi 2 chelsea2 0 tenantA
详细调用示例
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 jvardy8protocol scsi
status_policy complete
status_site all
owner_id 0
owner_name tenantA
调用示例
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
protocol scsi
status_policy complete
status_site all
owner_id 0
owner_name tenantA
调用示例
lshost 1生成的输出:
id 1
name host1
port_count 2
type generic
mask 1111111111111111111111111111111111111111111111111111111111111111
iogrp_count 4
status offline
site_id
site_name
host_cluster_id
host_cluster_name
protocol nvme
nqn nqn.2014-08.com.example:nvme.host.sys.xyz
node_logged_in_count 0
state offline
nqn nqn.2014-08.org.nvmexpress:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
node_logged_in_count 0
state offline
status_policy complete
status_site all
owner_id 0
owner_name tenantA