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