.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.8.
.TH PACEMAKER "8" "November 2020" "Pacemaker 2.0.1" "System Administration Utilities"
.SH NAME
Pacemaker \- Part of the Pacemaker cluster resource manager
.SH SYNOPSIS
.B crm_simulate
\fI\,datasource operation \/\fR[\fI\,additional options\/\fR]
.SH DESCRIPTION
crm_simulate \- Tool for simulating the cluster's response to events
.SH OPTIONS
.TP
\-?, \fB\-\-help\fR
This text
.TP
\-$, \fB\-\-version\fR
Version information
.TP
\fB\-Q\fR, \fB\-\-quiet\fR
Display only essentialoutput
.TP
\fB\-V\fR, \fB\-\-verbose\fR
Increase debug output
.SS "Operations:"
.TP
\fB\-R\fR, \fB\-\-run\fR
Determine the cluster's response to the given configuration and status
.HP
\fB\-S\fR, \fB\-\-simulate\fR Simulate the transition's execution and display the resulting cluster status
.HP
\fB\-X\fR, \fB\-\-in\-place\fR Simulate the transition's execution and store the result back to the input file
.TP
\fB\-s\fR, \fB\-\-show\-scores\fR
Show allocation scores
.HP
\fB\-U\fR, \fB\-\-show\-utilization\fR Show utilization information
.TP
\fB\-P\fR, \fB\-\-profile\fR=\fI\,value\/\fR
Run all tests in the named directory to create profiling data
.SS "Synthetic Cluster Events:"
.TP
\fB\-u\fR, \fB\-\-node\-up\fR=\fI\,value\/\fR
Bring a node online
.TP
\fB\-d\fR, \fB\-\-node\-down\fR=\fI\,value\/\fR
Take a node offline
.TP
\fB\-f\fR, \fB\-\-node\-fail\fR=\fI\,value\/\fR
Mark a node as failed
.TP
\fB\-i\fR, \fB\-\-op\-inject\fR=\fI\,value\/\fR
Generate a failure for the cluster to react to in the simulation
.IP
Value is of the form ${resource}_${task}_${interval_in_ms}@${node}=${rc}.
Eg. memcached_monitor_20000@bart.example.com=7
For more information on OCF return codes, refer to: https://clusterlabs.org/pacemaker/doc/en\-US/Pacemaker/2.0/html/Pacemaker_Administration/ch07.html#s\-ocf\-return\-codes
.TP
\fB\-F\fR, \fB\-\-op\-fail\fR=\fI\,value\/\fR
If the specified task occurs during the simulation, have it fail with return code ${rc}
.IP
Value is of the form ${resource}_${task}_${interval_in_ms}@${node}=${rc}.
Eg. memcached_stop_0@bart.example.com=1
.TP
The transition will normally stop at the failed action.
Save the result with \fB\-\-save\-output\fR and re\-run with \fB\-\-xml\-file\fR
.TP
\fB\-t\fR, \fB\-\-set\-datetime\fR=\fI\,value\/\fR
Set date/time (ISO 8601 format, see https://en.wikipedia.org/wiki/ISO_8601)
.TP
\fB\-q\fR, \fB\-\-quorum\fR=\fI\,value\/\fR
Specify a value for quorum
.TP
\fB\-w\fR, \fB\-\-watchdog\fR=\fI\,value\/\fR
Assume a watchdog device is active
.TP
\fB\-g\fR, \fB\-\-ticket\-grant\fR=\fI\,value\/\fR
Grant a ticket
.TP
\fB\-r\fR, \fB\-\-ticket\-revoke\fR=\fI\,value\/\fR
Revoke a ticket
.TP
\fB\-b\fR, \fB\-\-ticket\-standby\fR=\fI\,value\/\fR
Make a ticket standby
.TP
\fB\-e\fR, \fB\-\-ticket\-activate\fR=\fI\,value\/\fR
Activate a ticket
.SS "Output Options:"
.TP
\fB\-I\fR, \fB\-\-save\-input\fR=\fI\,value\/\fR
Save the input configuration to the named file
.TP
\fB\-O\fR, \fB\-\-save\-output\fR=\fI\,value\/\fR
Save the output configuration to the named file
.TP
\fB\-G\fR, \fB\-\-save\-graph\fR=\fI\,value\/\fR
Save the transition graph (XML format) to the named file
.TP
\fB\-D\fR, \fB\-\-save\-dotfile\fR=\fI\,value\/\fR
Save the transition graph (DOT format) to the named file
.TP
\fB\-a\fR, \fB\-\-all\-actions\fR
Display all possible actions in the DOT graph \- even ones not part of the transition
.SS "Data Source:"
.TP
\fB\-L\fR, \fB\-\-live\-check\fR
Connect to the CIB mamager and use the current CIB contents as input
.TP
\fB\-x\fR, \fB\-\-xml\-file\fR=\fI\,value\/\fR
Retrieve XML from the named file
.TP
\fB\-p\fR, \fB\-\-xml\-pipe\fR
Retrieve XML from stdin
.SH EXAMPLES
Pretend a recurring monitor action found memcached stopped on node fred.example.com and, during recovery, that the memcached stop action failed
.IP
# crm_simulate \-LS \-\-op\-inject memcached:0_monitor_20000@bart.example.com=7 \-\-op\-fail memcached:0_stop_0@fred.example.com=1 \-\-save\-output /tmp/memcached\-test.xml
.PP
Now see what the reaction to the stop failure would be
.IP
# crm_simulate \-S \-\-xml\-file /tmp/memcached\-test.xml
.SH AUTHOR
Written by Andrew Beekhof
.SH "REPORTING BUGS"
Report bugs to users@clusterlabs.org