lshostcluster

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