NAME

       Pacemaker - Part of the Pacemaker cluster resource manager

SYNOPSIS

       crm_mon [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, 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)

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

   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)

       -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.

       -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).

       -W, --watch-fencing
              Listen for fencing events. For use with --external-agent.

   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.

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

       -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 and --html-cgi are automatically 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 an  integer
       number  of  seconds,  a  number  plus  units  (us/usec/ms/msec/s/sec/m/min/h/hr),  or  an ISO 8601 period
       specification.

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. 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.

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