lshostcluster
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.
- -hostcluster hostcluster_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.
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:
|
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