.\" 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_shadow
\fI\,(query|command) \/\fR[\fI\,modifiers\/\fR]
.SH DESCRIPTION
crm_shadow \- Perform configuration changes in a sandbox before updating the live cluster.
.PP
Sets up an environment in which configuration tools (cibadmin, crm_resource, etc) work offline instead of against a live cluster, allowing changes to be previewed and tested for side\-effects.
.SH OPTIONS
.TP
\-?, \fB\-\-help\fR
This text
.TP
\-$, \fB\-\-version\fR
Version information
.TP
\fB\-V\fR, \fB\-\-verbose\fR
Increase debug output
.SS "Queries:"
.TP
\fB\-w\fR, \fB\-\-which\fR
Indicate the active shadow copy
.TP
\fB\-p\fR, \fB\-\-display\fR
Display the contents of the active shadow copy
.TP
\fB\-E\fR, \fB\-\-edit\fR
Edit the contents of the active shadow copy with your favorite $EDITOR
.TP
\fB\-d\fR, \fB\-\-diff\fR
Display the changes in the active shadow copy
.TP
\fB\-F\fR, \fB\-\-file\fR
Display the location of the active shadow copy file
.SS "Commands:"
.TP
\fB\-c\fR, \fB\-\-create\fR=\fI\,value\/\fR
Create the named shadow copy of the active cluster configuration
.TP
\fB\-e\fR, \fB\-\-create\-empty\fR=\fI\,value\/\fR
Create the named shadow copy with an empty cluster configuration. Optional: \fB\-\-validate\-with\fR
.TP
\fB\-C\fR, \fB\-\-commit\fR=\fI\,value\/\fR
Upload the contents of the named shadow copy to the cluster
.TP
\fB\-D\fR, \fB\-\-delete\fR=\fI\,value\/\fR
Delete the contents of the named shadow copy
.TP
\fB\-r\fR, \fB\-\-reset\fR=\fI\,value\/\fR
Recreate the named shadow copy from the active cluster configuration
.TP
\fB\-s\fR, \fB\-\-switch\fR=\fI\,value\/\fR
(Advanced) Switch to the named shadow copy
.SS "Additional Options:"
.TP
\fB\-f\fR, \fB\-\-force\fR
(Advanced) Force the action to be performed
.TP
\fB\-b\fR, \fB\-\-batch\fR
(Advanced) Don't spawn a new shell
.TP
\fB\-a\fR, \fB\-\-all\fR
(Advanced) Upload the entire CIB, including status, with \fB\-\-commit\fR
.TP
\fB\-v\fR, \fB\-\-validate\-with\fR=\fI\,value\/\fR
(Advanced) Create an older configuration version
.SH EXAMPLES
Create a blank shadow configuration:
.IP
# crm_shadow \-\-create\-empty myShadow
.PP
Create a shadow configuration from the running cluster:
.IP
# crm_shadow \-\-create myShadow
.PP
Display the current shadow configuration:
.IP
# crm_shadow \-\-display
.PP
Discard the current shadow configuration (named myShadow):
.IP
# crm_shadow \-\-delete myShadow \-\-force
.PP
Upload the current shadow configuration (named myShadow) to the running cluster:
.IP
# crm_shadow \-\-commit myShadow
.SH AUTHOR
Written by Andrew Beekhof
.SH "REPORTING BUGS"
Report bugs to users@clusterlabs.org