Use the lshostcluster command to generate a list with concise
information about all the host clusters visible to the clustered system or detailed information
about a single host cluster.
Syntax
lshostcluster [ -nohdr ] [ -delim delimiter ] [ -hostcluster { hostcluster_id | hostcluster_name } ]
Parameters
- -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 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.
- -hostclusterhostcluster_id | hostcluster_name
- (Required) Specifies the ID or name of the host to display information about. If you do not
enter a host system ID or name, the command displays a list of all recognized host clusters and
volume mappings. The value for the ID must be a number and the value for the name must be an
alphanumeric string.
Description
This command lists concise information about all the host clusters visible to the clustered
system or detailed information about a single host cluster.
This table provides the attribute values that can be displayed as output view data.
Table 1. lshostcluster outputAttribute |
Description |
id |
Indicates the host cluster ID. |
name |
Indicates host cluster name. The value must be an alphanumeric string of no
more than 64 characters. |
status |
Indicates the status of the host cluster. The values are: - online indicates that all hosts or members are online
- host_degraded indicates that no hosts are offline but at least one host is
degraded
- host_cluster_degraded indicates that one or more hosts are offline and at least
one host is online or degraded
- offline indicates that all hosts are offline or there are no hosts or members
in the host cluster
|
host_count |
Indicates the number of hosts that are in the host cluster. The value must be
a number from 0 - 127. |
mapping_count |
Indicates the number of shared mappings between the host cluster and any
existing volumes. The value must be a number from 0 - 2047. |
port_count |
Indicates the number of host ports that are used for the host cluster mappings
to any volumes. The value must be a number from 0 - 255. |
A concise invocation example
lshostcluster
The detailed resulting output:
id name status host_count mapping_count port_count
0 hostcluster0 online 2 1 4
A detailed invocation example
lshostcluster : hostcluster0
The detailed resulting output:
id:0
name:hostcluster0
status:online
host_count:6
mapping_count:32
port_count:12