The lshost command generates a list with concise information about all the hosts visible to the cluster and detailed information about a single host.
Syntax
>>- svcinfo -- -- lshost-- -------------------------------------> >--+--------------------------------+-- --+----------+-- -------> '- -filtervalue -- attrib=value -' '- -nohdr -' >--+-----------------------+-- -- --+-----------------+---------> '- -delim -- delimiter -' '- -filtervalue? -' >--+---------------+------------------------------------------->< +- object_id ---+ '- object_name -'
Parameters
- -filtervalue attrib=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 SAN Volume Controller 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:
svcinfo 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 svcinfo lshost command are:
- host_name
- host_id
- port_count
- name
- id
- iogrp_count
Description
This command returns a concise list or a detailed view, of hosts visible to the cluster.
The following list provides the different states
for a host:
- offline
- The host is offline if one or more I/O groups with VDisk mappings does not have a login for the specified WWPN.
- degraded
- The host is degraded if one or more nodes with VDisk mappings do not have a login for the specified WWPN.
- inactive
- The host is inactive if all the nodes with VDisk mappings have a login for the specified WWPN, however, no nodes have seen any SCSI commands from the WWPN in the last 5 minutes.
- active
- The host is active if all the nodes with VDisk mappings have a login for the specified WWPN, however, at least one node has seen SCSI commands from the WWPN in the last 5 minutes.
Note: The svcinfo
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 which are no longer logged in
or even part of the SAN fabric. For example: A host HBA port is unplugged
from a switch but scvinfo 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.
A concise invocation example
svcinfo lshost
The concise resulting output
id name port_count iogrp_count 0 mchost20 1 4 1 mchost30 1 4 2 mchost200 1 4 3 mchost40 1 4 4 mchost240 1 4 5 mchost170 1 4 6 mchost120 1 4 7 mchost60 1 4 8 mchost180 1 4 9 mchost13 2 4
A detailed invocation example
svcinfo lshost mchost13
The detailed resulting output
id 9 name mchost13 port_count 2 type generic mask 1111 iogrp_count 4 iscsiname mc13host node_logged_in_count 0 state offline iscsiname mchost13 node_logged_in_count 0 state offline