Use the lshostcluster command to generate a list with concise
information about all the host clusters visible to the system or detailed information about a
single host cluster.
Syntax
lshostcluster [ -nohdr ] [ -delimdelimiter ] [ -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 cluster 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 output| Attribute |
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 in the range 0 - 127. |
| mapping_count |
Indicates the number of shared mappings between the host cluster and
any existing volumes. The value must be a number in the range 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 in the range 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