Skip navigation.
Downloads | Product Documentation | Support

WebLogic Server Command Reference

## CLUSTERSTATE

Returns the number and state of servers in a cluster.

### Syntax

>     java [ SSL Arguments ] weblogic.Admin
>          [-url URL]
>          [ User Credentials Arguments ]
>        CLUSTERSTATE -clusterName clusterName

Argument | Definition
--- | ---
{-url [`protocol``://`]`listen-address:listen-port``}` | Specify the listen address and listen port of any server instance that is currently active and that belongs to the cluster. If you specify a secure listen port, you must also specify a secure protocol. If you do not specify a value, the command assumes `t3://localhost:7001`. For more information, refer to the -url entry in Table 1-3 on page 11 and Protocol Support.
`-clusterName` `clusterName` | The name of the cluster as specified in the domain's configuration file (`config.xml`).

### Example

The following example returns information about a cluster:

>     java weblogic.Admin -url AdminHost:7001
>       -username weblogic -password weblogic
>       CLUSTERSTATE -clustername MedRecCluster

For more information about the environment in which this example runs, refer to Example Environment.

If the command succeeds, it returns output similar to the following:

>     There are 3 server(s) in cluster: MedRecCluster

>     The alive servers and their respective states are listed below:
>     MedRecManagedServer2---RUNNING
>     MedRecManagedServer3---RUNNING

>     The other server(s) in the cluster that are not active are:
>     MedRecManagedServer1