lscluster

The list report style can be used to obtain two styles of report.
  1. A list containing concise information about all clusters. (Each entry in the list corresponds to a single cluster.)
  2. The detailed information about a single, user specified, cluster.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svcinfo -- -- lscluster -- --------------------------------->

>--+--------------------------------+-- --+----------+-- ------->
   '- -filtervalue -- attrib=value -'     '- -nohdr -'

>--+----------+-- --+-----------------------+-- ---------------->
   '- -bytes -'     '- -delim -- delimiter -'

>--+-------------+-- --+-----------------+---------------------><
   +- object_id -+     '- -filtervalue? -'
   '- name ------'

Parameters

-nohdr
By default, headings are displayed for each column of data (in a concise style view), and each item of data (in a detailed style view). Using the -nohdr parameter will suppress the display of these headings.
Note:Note: If there is no data to be displayed (for example, an empty view has been returned), then headings are not displayed irrespective of whether the -nohdr option was used or not.
-bytes
Optionally used to display all capacities as bytes.
-delim delimiter
By default in a concise view, all columns of data are space separated. The width of each column is set to the maximum possible 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. Using the -delim parameter will override this behavior. Valid input for the -delim parameter is a one byte character. If, for example, you entered -delim : a colon will be used to separate all items of data in a concise view (for example, the spacing of columns does not occur) and in a detailed view the data is separated from its header by a colon.
-filtervalue attribute=value
Optionally specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are returned. If a capacity is specified, the units must also be included.
object_id | name
Optionally specifies the name or ID of an object. If not supplied, the concise view of all objects, or all of those objects matching the filtering requirements in -filtervalue (if specified), of the given type are returned. If supplied, the detailed view of the specific object is returned, and any filtervalue entry (if entered) is ignored.
-filtervalue?
Display a list of valid filter attributes. The valid filters for the svcinfo lscluster command are:
  • cluster_name
  • cluster_unique_id
  • id
  • name

Description

This command will return a concise list or a detailed view, of clusters.

The following list provides possible values that are applicable to the attributes that are displayed as data in the output views:

location local, remote
statistics status on, off
SNMP setting none, all, hardware_only

The location, partnership and bandwidth fields are relevant to Remote Copy configurations where the SAN fabrics of two clusters are linked together. Information about the remote cluster will be reported by the lscluster command if the mkpartnership command has been issued from the local cluster to the remote cluster, ie. if the partnership has been at least partially established from the local cluster.

You can issue the svcinfo lscluster command to display a concise view of the cluster.
svcinfo lscluster -delim : 10030a007e5
where 10030a007e5 is the name of the cluster. The output from this command will include the following for each cluster on the fabric:

For the remote cluster, these fields indicate the following:
location: remote
partnership: partially_configured (mkpartnership command has only been
issued from the local cluster to the remote cluster)
fully_configured (mkpartnership command has been issued
in both directions)
bandwidth: MB/sec (the bandwidth available on the inter-cluster link for
background copy)

Possible failures

Examples

A concise invocation example

svcinfo lscluster -delim :

The concise resulting output

id:name:location:partnership:bandwidth:cluster_IP_address:
id:name:location:partnership:bandwidth:cluster_IP_address:
cluster_service_ip_address:id_alias
0000020062813ABA:clusterA:local:::9.20.247.210:1.1.1.1:0000020062813ABA
0000020062006746:clusterB:remote:fully_configured:50:9.20.247.211:
1.1.1.1:0000020062006746

Examples

A detailed invocation example

svcinfo lscluster -delim : 10030a007e5

The detailed resulting output

id:1521071282978998
name:cluster1
location:local
partnership:
bandwidth:
cluster_IP_address:9.20.165.16
cluster_service_IP_address:9.20.165.17
total_mdisk_capacity:59.8GB
space_in_mdisk_grps:0
space_allocated to vdisks:0
total_free_space:59.8GB
statistics_status:on
statistics_frequency:300
required_memory:1280
subnet_mask:255.255.255.0
default_gateway:9.20.165.1
cluster_locale:en_US
SNMP_setting:snmp all
SNMP_community:
SNMP_server_IP_address:9.20.165.18
time_zone:522 UTC
email_setting:all
email_id:another@uk.ibm.com 
code_level:1.20abcG
FC_port_speed:1Gb
id_alias:1521071282978998

Examples

A concise invocation example for a Remote Copy configuration, where clusterA has issued the mkpartnership to clusterB, and the intercluster bandwidth is set to 50 MB/s.

svcinfo lscluster -delim :

The concise resulting output

id:name:location:partnership:bandwidth:
	cluster IP address:cluster service IP address
0000020062813ABA:clusterA:local:::9.20.247.210:1.1.1.1
0000020062006746:clusterB:remote:
	fully_configured:50:9.20.247.211:1.1.1.1

Related topics

(C) Copyright International Business Machines Corporation 2003, 2004