PACEMAKER(8)

πŸ’… PACEMAKER β€” like, the manual page bestie

okay so first things first: this is page PACEMAKER(8) from System Administration Utilities, and the actual command you'll be typing is crm_mon. Part of the Pacemaker cluster resource manager, iykyk πŸ‘‘

✨ NAME ✨

Pacemaker β€” Part of the Pacemaker cluster resource manager. that's the whole name section, she's brief and iconic πŸŽ€

🌸 SYNOPSIS 🌸

crm_mon [options]

πŸ¦‹ DESCRIPTION πŸ¦‹

Provides a summary of cluster's current state. literally that's her job πŸ’…

Outputs varying levels of detail in a number of different formats. so many formats. she's versatile like that ✨

πŸ’– OPTIONS πŸ’–

πŸŽ€ Help Options:

  • -h, --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

πŸ“ Output Options:

  • --output-as=*FORMAT* β€” Specify output format as one of: console (default), html, text, xml, none
  • --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)

🧚 Display Options:

  • -I, --include=*SECTION(s)* β€” A list of sections to include in the output. See Output Control help for more information.
  • -U, --exclude=*SECTION(s)* β€” A list of sections to exclude from the output. See Output Control help for more information.
  • --node=*NODE* β€” When displaying information about nodes, show only what's related to the given node, or to all nodes tagged with the given tag
  • --resource=*RSC* β€” When displaying information about resources, show only what's related to the given resource, or to all resources tagged with the given tag
  • -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
  • -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)
  • --show-description β€” Show resource descriptions
  • -b, --brief β€” Brief output

🌟 Additional Options:

  • -i, --interval=*TIMESPEC* β€” Update frequency (default is 5 seconds). Note: When run interactively on a live cluster, the display will be updated automatically whenever the cluster configuration or status changes.
  • -1, --one-shot β€” Display the cluster status once and exit
  • -d, --daemonize β€” Run in the background as a daemon. Requires at least one of --output-to and --external-agent.
  • -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).
  • -W, --watch-fencing β€” Listen for fencing events. For use with --external-agent.

πŸ’œ 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 πŸ“

Time Specification:

The TIMESPEC in any command line option can be specified in many different formats. It can be:

  • an integer number of seconds
  • a number plus units (us/usec/ms/msec/s/sec/m/min/h/hr)
  • an ISO 8601 period specification

so yeah, she's flexible like that 😌

🫢 OUTPUT CONTROL 🫢

By default, a particular set of sections are written to the output destination. The default varies based on the output format: XML includes all sections by default, while other output formats include less. no cap πŸŽ€

This set can be modified with the --include and --exclude command line options. Each option may be passed multiple times, and each can specify a comma-separated list of sections. The options are applied to the default set, in order from left to right as they are passed on the command line. For a list of valid sections, pass --include=list or --exclude=list. ✨

πŸ¦„ INTERACTIVE USE πŸ¦„

When run interactively, crm_mon can be told to hide and show various sections of output. To see a help screen explaining the options, press ?. Any key stroke aside from those listed will cause the screen to refresh.

ok this is lowkey the fun part, she's interactive πŸ’…

πŸ”₯ EXAMPLES πŸ”₯

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

crm_mon

Display the cluster status once and exit:

crm_mon -1

Display the 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

Display the cluster status as XML:

crm_mon --output-as xml

πŸ‘‘ AUTHOR πŸ‘‘

Written by Andrew Beekhof and the Pacemaker project contributors. absolute legends, fr fr 🫢


and that's the whole page bestie!! this lil beauty is Pacemaker 3.0.3+20260728.7052..., dated September 2026, and she's out here serving PACEMAKER(8) realness πŸ’–βœ¨ go forth and cluster, mwah πŸŽ€

πŸ“¦ where this page comes from