lshost
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
- -filtervalue attribute=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 Storwize® V3500 command-line interface (CLI):
- The wildcard character is an asterisk (*).
- The command can contain a maximum of one wildcard.
- When using a wildcard character, you must enclose the filter entry
within double quotation marks ("" ), as follows:
lshost -filtervalue "name=md*"
- -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.
- -delim delimiter
- (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_cluster_id
- host_cluster_name
- host_name
- host_id
- id
- iogrp_count
- name
- port_count
- 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.
- 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.
- 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.
- 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.
- online
- The host has full connectivity. A host using just one style of connectivity is online if it uses
one of these:
- 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. 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.
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. |
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
0 hostone 1 4 offline 0 vardyhost1
1 host0 1 4 degraded 1 vardyhost2
2 host1 1 4 online 2 vardyhost3
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
host_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
host_cluster_id 2
host_cluster_name boat3ng