Use the lshost command to generate a
list with concise information about all the hosts visible to the clustered
system (system) and detailed information about a single host.
Syntax
lshost [ -filtervalue attribute=value ] [ -nohdr ] [ -delim delimiter ] [ -filtervalue? ] [ { object_id | object_name } ]
Parameters
- -filtervalueattribute=value
- (Optional) Specifies a list of one or more filters. Only objects
with a value that matches the filter attribute value are returned.
If a capacity is specified, the units must also be included.
Note: Some filters allow the use of a wildcard when you enter
the command. The following rules apply to the use of wildcards with
the
Lenovo Storage V series command-line interface (CLI):
- -nohdr
- (Optional) By default, headings are displayed for each column
of data in a concise style view, and for each item of data in a detailed
style view. The -nohdr parameter suppresses the
display of these headings.
Note: If there is no data to be displayed,
headings are not displayed.
- -delimdelimiter
- (Optional) By default in a concise view, all columns of data are space-separated. The width of
each column is set to the maximum width of each item of data. In a detailed view, each item of data
has its own row, and if the headers are displayed the data is separated from the header by a space.
The -delim parameter overrides this behavior. Valid input for the
-delim parameter is a 1-byte character. If you enter -delim
: on the command line, the colon character (:) separates all items of data
in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data
is separated from its header by the specified delimiter.
- 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 is specified by the -filtervalue parameter are displayed.
- -filtervalue?
- (Optional) Specifies that you want your report to display any
or all of the list of valid filter attributes. The valid filter attributes
for the lshost command are:
- host_cluster_id
- host_cluster_name
- host_name
- host_id
- id
- iogrp_count
- name
- port_count
- site_id
- site_name
- status
For more information about
filtering attributes, see Attributes of the -filtervalue parameters.
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 into. 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).
You can map an iSCSI host to
volumes that are accessible through multiple I/O groups. iSCSI hosts can access volumes that are
accessible through multiple I/O groups (and single I/O groups). An iSCSI host that is mapped to a
volume accessible through multiple I/O groups is online if it has at least one
active iSCSI session with each I/O group of the access set. If volumes are not mapped to an iSCSI
host, it is degraded.
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 one or more input/output (I/O) groups
with volume mappings do 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 there is no login for the specified WWPN.
If a host does not have any volume mappings, it is reported as offline or inactive.
Note: The lshost command presents a list of host HBA ports that are logged in to
nodes. However, there are situations 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 all I/O groups with volume mappings have 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 one or more I/O groups
with volume mappings do not have an associated iSCSI session for the
specified iscsiname.
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:
- Fibre Attach Fibre Channel (FAFC)
- Every port is active or inactive, and is logged into every online node in each I/O group in
which the host has volume mappings.
- Direct Attach Fibre Channel (DAFC)
- The host has an active or inactive login to every node in I/O groups to which the host has
volume mappings.
- Internet Small Computer System Interface (iSCSI)
- The host has an iSCSI session with each I/O group with which the host has volume mappings.
- 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 into I/O groups 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. This 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 some, but not all, of the I/O groups to which it
belongs.
- mask
- The Fiber Channel (FC) I/O ports (which exist on a node) hosts
can access.
lshost output 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. |
| mask |
Indicates the mask value with a 64-bit binary
string. |
| iogrp_count |
Indicates the number of I/O groups. |
| status |
Indicates whether the host is online or
offline. |
| 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. |
| node_logged_in_count |
Indicates the number of nodes the WWPN is logged into. |
| state |
Indicates the state of the SAS WWPN login. The values are:
|
| sas_wwpn_count |
Indicates the number of configured SAS WWPNs. |
| site_id |
Identifies the site ID for the host. The values
are 1, 2, or blank. |
| site_name |
Identifies the site name for the host. The value
must be an alphanumeric string or blank. |
| host_cluster_id |
Indicates the unique ID for a host cluster. |
| host_cluster_name |
Indicates the unique name for a host cluster. |
An
invocation example
lshost
The resulting output:
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
A detailed invocation example
lshost 0
The resulting output:
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 chelsea2host_cluster_id 1
host_cluster_name jvardy8
An invocation example
lshost 0
The resulting output:
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