lshostcluster

Use the lshostcluster command to generate a list with concise information about all the host clusters that are defined on the system or detailed information about a single host cluster.

Syntax

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_id | hostcluster_name: (Optional) Specifies the ID or name of the host cluster to display information about. If you do not enter a host cluster ID or name, the command displays a list of all host clusters.

Description

This command lists concise information about all the host clusters that are defined on the 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.
protocol	Indicates the protocol that the host uses to access the storage. The values are scsi or nvme.
owner_id	Displays the ID of the ownership group.
owner_name	Displays the name of the ownership group.

A concise invocation example

lshostcluster

The resulting output:

id name         status host_count mapping_count port_count protocol owner_id owner_name
0  hostcluster0 online 2          1             4          scsi     0        tenantA

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
protocol scsi
owner_id 0
owner_name tenantA