crm_mon man page

Pacemaker — Part of the Pacemaker cluster resource manager

Synopsis

crm_mon mode [options]

Description

Provides a summary of cluster's current state.

Outputs varying levels of detail in a number of different formats.

Options

Help Options

-?, --help

Show help options

--help-all

Show all help options

--help-output

Show output help

--help-display

Show display options

--help-additional

Show additional options

--help-deprecated

Show deprecated options

Output Options

--output-as=FORMAT

Specify output format as one of: console (default), html, text, xml

--output-to=DEST

Specify file name for output (or "-" for stdout)

--html-cgi

Add CGI headers (requires --output-as=html)

--html-stylesheet=URI

Link to an external stylesheet (requires --output-as=html)

--html-title=TITLE

Specify a page title (requires --output-as=html)

--text-fancy

Use more highly formatted output (requires --output-as=text)

Display Options

-n, --group-by-node

Group resources by node

-r, --inactive

Display inactive resources

-f, --failcounts

Display resource fail counts

-o, --operations

Display resource operation history

-t, --timing-details

Display resource operation history with timing details

-c, --tickets

Display cluster tickets

-W, --watch-fencing

Listen for fencing events. For use with --external-agent

-m, --fence-history=LEVEL

Show fence history: 0=off, 1=failures and pending (default without option), 2=add successes (default without value for option), 3=show full history without reduction to most recent of each flavor

-L, --neg-locations

Display negative location constraints [optionally filtered by id prefix]

-A, --show-node-attributes

Display node attributes

-D, --hide-headers

Hide all headers

-R, --show-detail

Show more details (node IDs, individual clone instances)

-b, --brief

Brief output

-s, --simple-status

Display the cluster status once as a simple one line output (suitable for nagios)

Additional Options

-i, --interval=TIMESPEC

Update frequency (default is 5 seconds)

-1, --one-shot

Display the cluster status once on the console and exit

-d, --daemonize

Run in the background as a daemon. Requires at least one of --output-to and --external-agent.

-p, --pid-file=FILE

(Advanced) Daemon pid file location

-E, --external-agent=FILE

A program to run when resource operations take place

-e, --external-recipient=RCPT

A recipient for your program (assuming you want the program to send something to someone).

Deprecated Options

-h, --as-html=FILE

Write cluster status to the named HTML file. Use --output-as=html --output-to=FILE instead.

-X, --as-xml

Write cluster status as XML to stdout. This will enable one-shot mode. Use --output-as=xml instead.

-N, --disable-ncurses

Disable the use of ncurses. Use --output-as=text instead.

-w, --web-cgi

Web mode with output suitable for CGI (preselected when run as *.cgi). Use --output-as=html --html-cgi instead.

Application Options

-$, --version

Display software version and exit

-V, --verbose

Increase debug output (may be specified multiple times)

-Q, --quiet

Be less descriptive in output.

Notes

If this program is called as crm_mon.cgi, --output-as=html --html-cgi will automatically be added to the command line arguments.

Time Specification

The TIMESPEC in any command line option can be specified in many different formats.  It can be just an integer number of seconds, a number plus units (ms/msec/us/usec/s/sec/m/min/h/hr), or an ISO 8601 period specification.

Examples

Display the cluster status on the console with updates as they occur:

crm_mon

Display the cluster status on the console just once then exit:

crm_mon -1

Display your cluster status, group resources by node, and include inactive resources in the list:

crm_mon --group-by-node --inactive

Start crm_mon as a background daemon and have it write the cluster status to an HTML file:

crm_mon --daemonize --output-as html --output-to /path/to/docroot/filename.html

Start crm_mon and export the current cluster status as XML to stdout, then exit:

crm_mon --output-as xml

Author

Written by Andrew Beekhof

Referenced By

pcs(8).

November 2019 Pacemaker 2.0.3-1.fc32 System Administration Utilities