crm_shadow (8) Linux Manual Page
Pacemaker – Part of the Pacemaker cluster resource manager
Synopsis
crm_shadow (query|command) [modifiers]
Description
crm_shadow – Perform configuration changes in a sandbox before updating the live cluster.
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
- This text
- -$, –version
- Version information
- -V, –verbose
- Increase debug output
Queries:
- -w, –which
- Indicate the active shadow copy
- -p, –display
- Display the contents of the active shadow copy
- -E, –edit
- Edit the contents of the active shadow copy with your favorite $EDITOR
- -d, –diff
- Display the changes in the active shadow copy
- -F, –file
- Display the location of the active shadow copy file
Commands:
- -c, –create=value
- Create the named shadow copy of the active cluster configuration
- -e, –create-empty=value
- Create the named shadow copy with an empty cluster configuration. Optional: –validate-with
- -C, –commit=value
- Upload the contents of the named shadow copy to the cluster
- -D, –delete=value
- Delete the contents of the named shadow copy
- -r, –reset=value
- Recreate the named shadow copy from the active cluster configuration
- -s, –switch=value
- (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 the entire CIB, including status, with –commit
- -v, –validate-with=value
- (Advanced) Create an older configuration version
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
Upload the current shadow configuration (named myShadow) to the running cluster:
- # crm_shadow –commit myShadow
Author
Written by Andrew Beekhof
Reporting Bugs
Report bugs to pacemaker [at] oss.clusterlabs.org