crm_shadow - Man Page
Part of the Pacemaker cluster resource manager
Synopsis
crm_shadow <query>|<command> [options]
Description
perform Pacemaker configuration changes in a sandbox
This command 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.
Options
Help Options
- -h, --help
Show help options
- --help-all
Show all help options
- --help-output
Show output help
- --help-queries
Show query help
- --help-commands
Show command help
- --help-additional
Show additional options
Output Options
- --output-as=FORMAT
Specify output format as one of: text (default), xml
- --output-to=DEST
Specify file name for output (or "-" for stdout)
Queries
- -w, --which
Indicate the active shadow copy
- -p, --display
Display the contents of the active shadow copy
- -d, --diff
Display the changes in the active shadow copy
- -F, --file
Display the location of the active shadow copy file
Commands
- -c, --create=name
Create the named shadow copy of the active cluster configuration
- -e, --create-empty=name
Create the named shadow copy with an empty cluster configuration. Optional: --validate-with
- -C, --commit=name
Upload the contents of the named shadow copy to the cluster
- -D, --delete=name
Delete the contents of the named shadow copy
- -E, --edit
Edit the contents of the active shadow copy with your favorite $EDITOR
- -r, --reset=name
Recreate named shadow copy from the active cluster configuration
- -s, --switch=name
(Advanced) Switch to the named shadow copy
Additional Options
- -f, --force
(Advanced) Force the action to be performed
- -b, --batch
(Advanced) Don't spawn a new shell
- -a, --all
(Advanced) Upload entire CIB, including status, with --commit
- -v, --validate-with
(Advanced) Create an older configuration version
Application Options
- -$, --version
Display software version and exit
- -V, --verbose
Increase debug output (may be specified multiple times)
Examples
Create a blank shadow configuration:
# crm_shadow --create-empty myShadow
Create a shadow configuration from the running cluster
# crm_shadow --create myShadow
Display the current shadow configuration:
# crm_shadow --display
Discard the current shadow configuration (named myShadow):
# crm_shadow --delete myShadow --force
Upload current shadow configuration (named myShadow) to running cluster:
# crm_shadow --commit myShadow
Author
Written by Andrew Beekhof and the Pacemaker project contributors