Visit Azul.com Support

List-Clusters

Table of Contents
Need help?
Schedule a consultation with an Azul performance expert.
Contact Us

Lists existing clusters in a domain.

Synopsis

 
asadmin [asadmin-options] list-clusters [--help] [target]

Description

The list-clusters subcommand lists existing clusters in a domain. The list can be filtered by cluster, instance, node, or configuration. For each cluster that is listed, the subcommand indicates whether the cluster is running.

This subcommand is supported in remote mode only.

Options

asadmin-options: Options for the asadmin utility. For information about these options, see the asadmin help page. --help: -?: Displays the help text for the subcommand.

Operands

target: Filters the list of clusters by specifying the target for which the clusters are to be listed. Valid values are as follows:
domain;; Lists all clusters in the domain (default). cluster-name;; Lists only the specified cluster. instance-name;; Lists the cluster of which the specified instance is a member. node-name;; Lists the clusters that contain an instance that resides on the specified node. For example, if instance pmdi1 in cluster pmdc and instance ymli1 in cluster ymlc reside on node n1, pmdc and ymlc are listed. configuration-name;; Lists all clusters that contain instances whose configuration is defined by the named configuration.

Examples

Example 1 Listing All Clusters in a Domain

This example lists all clusters in the current domain.

 
asadmin> list-clusters pmdclust not running ymlclust not running Command list-clusters executed successfully.

Example 2 Displaying the Status of a Cluster

This example displays status of the cluster ymlclust, which is not running.

 
asadmin> list-clusters ymlclust ymlclust not running Command list-clusters executed successfully.

Example 3 Listing All Clusters That Are Associated With a Node

This example lists the clusters that contain an instance that resides on the node sj02.

 
asadmin> list-clusters sj02 ymlclust not running Command list-clusters executed successfully.

Exit Status

0: command executed successfully 1: error in executing the command

See Also