7장. Displaying cluster status

There are a variety of commands you can use to display the status of a cluster and its components.

Displaying the full cluster configuration

Use the following command to display the full current cluster configuration:

# pcs config

Displaying status of cluster and cluster resources

You can display the status of the cluster and the cluster resources with the following command:

# pcs status

Displaying status of a cluster component

You can display the status of a particular cluster component with the commands parameter of the pcs status command, specifying resources, cluster, nodes, or pcsd.

pcs status commands

For example, the following command displays the status of the cluster resources:

# pcs status resources

The following command displays the status of the cluster, but not the cluster resources:

# pcs cluster status

Delaying status display until actions are completed

If you run the pcs status command before Pacemaker has completed any actions required by changes to the CIB, the cluster state at that time might not match the desired status. You can ensure that Pacemaker does not need to take any further actions by running the pcs status wait command.

The pcs status wait command waits until the cluster has completed all current actions before returning a value. If any actions unrelated to your recent changes are in progress, the command waits until those are completed. The pcs status wait command returns a value of 0 as soon as Pacemaker completes pending actions.

You can specify a period of time to wait. If the current actions have not completed after that time period, the command prints an error and returns a value of 1.

The following command waits until Pacemaker has applied configuration changes:

# pcs status wait
Waiting for the cluster to apply configuration changes...

The following command waits up to one minute until Pacemaker has applied configuration changes:

# pcs status wait 1min
Waiting for the cluster to apply configuration changes (timeout: 60 seconds)...