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
[ -filtervalueattribute=value
] [ -nohdr ]
[ -delimdelimiter
]
[ -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 V7000 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 possible 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 one-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
matching 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_name
- host_id
- port_count
- name
- id
- iogrp_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 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 has received SCSI commands from the WWPN
within the last five 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 have seen any Small Computer System Interface (SCSI) commands
from the WWPN within the last five 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 has received SCSI commands
from the WWPN within the last five minutes.
- inactive
- The host port is inactive if all the
nodes with volume mappings have a login for the specified WWPN but
no nodes have seen any Small Computer System Interface (SCSI) commands
from the WWPN within the last five 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 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 using just one style of connectivity
is online if it uses one of these:
- Fiber Attach Fiber 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. This might
be because the host has been 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 should 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.
Table 1 shows
the possible outputs:
Table 1. lshost output
| Attribute |
Description |
| id |
Indicates the unique host ID with an alphanumeric
value. |
| name |
Indicates the unique host name with 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 if 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:
|
| 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. |
An invocation example
lshost
The resulting output:
id name port_count iogrp_count status site_id site_name
0 hostone 1 4 offline 2 chelsea3
1 host0 1 4 degraded 1 chelsea1
2 host1 1 4 online 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 chelsea2
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 offlinesite_id 2
site_name chelsea2