lshost

Use the lshost command to generate a list with concise information about all the hosts visible to the system and detailed information about a single host.

Syntax

Parameters

-delim delimiter: (Optional) Specify a delimiter to separate data in the output.
-nohdr: (Optional) Suppress the headings in the output.
-filtervalue attribute=value: (Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.
-filtervalue?: (Optional) Displays a list of valid filter attributes.

object_id | object_name: (Optional) Specifies the name or ID of an object. When you use this parameter, the detailed view of the specific object is returned and any value that is specified by the -filtervalue parameter is ignored. If you do not specify the object_id | object_name parameter, the concise view of all objects that match the filtering requirements that are specified by the -filtervalue parameter are displayed.

Note: In case any existing system is upgraded then all existing host objects will associate with the default portset. Similarly if host objects are created without specifying a portset they will associate with the default portset.

Description

This command returns a concise list or a detailed view of hosts visible to the system.

For Fibre Channel (FC) ports, the node_logged_in_count field provides the number of nodes that the host port is logged in to. For Internet Small Computer System Interface (iSCSI) ports, the node_logged_in_count field provides the number of iSCSI sessions from the host iSCSI qualified name (IQN).

The following list provides the different states for a fabric attach FC host port:

active: The host port is active if all nodes with volume mappings have a login for the specified worldwide port name (WWPN) and at least one node received SCSI commands from the WWPN within the last 5 minutes.
degraded: The host port is degraded if one or more nodes with volume mappings do not have a login for the specified WWPN.
inactive: The host port is inactive if all the nodes with volume mappings have a login for the specified WWPN but no nodes see any Small Computer System Interface (SCSI) commands from the WWPN within the last 5 minutes.
offline: The host port is offline if the input/output (I/O) group with volume mappings does not have a login for the specified WWPN.

The following list provides the different states for a direct attach FC host port:

active: The host port is active if a node has a login for the specified WWPN and the node receives SCSI commands from the WWPN within the last 5 minutes.
inactive: The host port is inactive if all the nodes with volume mappings have a login for the specified WWPN but no nodes see any Small Computer System Interface (SCSI) commands from the WWPN within the last 5 minutes.
offline: The host port is offline if no login exists for the specified WWPN.

If a host does not have any volume mappings, it is reported as offline or inactive.

The following list provides the different states for fabric attached NVMe over FC, NVMe over RDMA, and NVMe over TCP host ports:

active: The host port is active if all nodes with volume mappings have a login for the specified NVMe Qualified Name (NQN) and at least one node has received NVMe commands from the NQN within the last 5 minutes.
degraded: The host port is degraded if one or more nodes with volume mappings do not have a login for the specified NQN.
inactive: The host port is inactive if all the nodes with volume mappings have a login for the specified NQN but no nodes have seen any NVMe commands from the NQN within the last 5 minutes.
offline: The host port is offline if the I/O group with volume mappings does not have a login for the specified NQN.

Note: The lshost command presents a list of host HBA ports that are logged in to nodes. However, situations exist when the information presented can include host HBA ports that are no longer logged in or even part of the SAN fabric. For example, a host HBA port is unplugged from a switch, but lshost still shows the WWPN logged in to all nodes. If this action occurs, the incorrect entry is removed when another device is plugged in to the same switch port that previously contained the removed host HBA port.

The following list provides the different states for a specified iscsiname:

active: The iscsiname is active if the I/O group with volume mappings has at least one associated iSCSI session for the specified iscsiname.
inactive: The iscsiname is inactive if the host has no volume mappings but at least one iSCSI session for the specified iscsiname is present.
offline: The iscsiname is offline if volumes with access to the I/O group is mapped to a specified iscsiname that has no associated iSCSI sessions.

The following list provides the different states for host_status:

online

The host has full connectivity. A host that uses just one style of connectivity is online if it uses one of these types:

Fabric Attach Fibre Channel: Every port is active or inactive, and is logged in to every online node.
Direct Attach Fibre Channel: The host has an active or inactive login to every node.
Internet Small Computer System Interface (iSCSI): The host has an iSCSI session.
NVMe over FC (FC-NVMe), NVMe over RDMA (RDMA-NVMe), and NVMe over TCP (TCP-NVMe): All host NQNs have NVMe associations with every online node.

offline

The host has no connectivity. The reason might be because the host is powered off and is not on.

Remember: If an iSCSI host is only logged in to the I/O group for which it is not configured, the associated host object status is offline.

degraded

The host is not fully connected, which might be introduced by a configuration error or a hardware failure. It can cause a loss of access during any planned maintenance activity and must be corrected as soon as possible.

Remember: An iSCSI host that has no mapped volumes is degraded if it is logged in to the I/O group to which it belongs.

This table shows the possible outputs:

Table 1. lshost output
Attribute	Description
id	Indicates the unique host ID. The value is an alphanumeric value.
name	Indicates the unique host name. The value is an alphanumeric string.
port_count	Indicates the number of ports.
type	Indicates the host type.
status	Indicates whether the host is `online` or `offline`.
protocol	Indicates whether the host uses scsi, fcnvme, tcpnvme, or rdmanvme to access the storage.
WWPN	Indicates the worldwide port name (WWPN) with a 16-character hexadecimal string.
SAS_WWPN	Indicates the serial-attached SCSI (SAS) WWPN with a 16-character hexadecimal string.
nqn	Indicates the NVMe Qualified Name.
node_logged_in_count	Indicates the number of nodes the WWPN or NQN is logged in to.
state	Indicates the state of the SAS WWPN login. The values are: `offline` `inactive` `active`
sas_wwpn_count	Indicates the number of configured SAS WWPNs.
nqn_count	Indicates the number of NVMe NQN ports assigned to the host.
host_cluster_id	Indicates the unique ID for a host cluster.
host_cluster_name	Indicates the unique name for a host cluster.
protocol	Displays the host connectivity protocol.
portset_id	Displays the ID of the portset.
portset_name	Displays the name of the portset.
iSCSI_name	Displays the iSCSI name.
partition_id	Displays the ID of the storage partition in which the host resides.
partition_name	Displays the name of the storage partition in which the host resides.
location1_status	Displays the status of the host at the location 1 system that is associated with the partition.
location2_status	Displays the status of the host at the location 2 system that is associated with the partition.
draft_partition_id	Displays the ID for draft partition associated with this host.
draft_partition_name	Displays the name of draft partition associated with this host.
ungrouped_volume_mapping	Indicates that this host has a mapping to a volume that is not in a volume group.
location_system_name	Indicates the name of the system for the host location.
auth_method	Indicates the mode of authentication. The values are: `none` signifies no authentication. `unidirectional` signifies one-way CHAP configured authentication. `bidirectional` signifies two-way CHAP configured authentication. Note: For a iSCSI host type, it refers to the mode of CHAP authentication.
host_username	Indicates the host username that is associated with the authentication. Note: For iSCSI host type, it refers to an initiator username associated with CHAP authentication.
storage_username	Indicates the storage username that is associated with the authentication. Note: For iSCSI host type, it refers to the target username associated with CHAP authentication.
host_secret	Indicates the host secret that is associated with the authentication. The values can be yes or no. Note: For iSCSI host types, it refers to an initiator secret associated with the CHAP authentication.
storage_secret	Indicates the storage secret associated with the authentication. The values can be yes or no. Note: For iSCSI host types, it refers to the target secret associated with the CHAP authentication.
auto_storage_discovery	Indicates the hosts on which the autostoragediscovery parameter is enabled. This value set to true indicates that the host operating system will automatically rescan the storage at regular intervals to discover new volumes. If this value is set to false, then rescanning new volumes must be performed manually by the server admin.
offline_alert_suppressed	Indicates whether the host transitioning to an offline status will raise an alert or not. The values can be yes or no.