crm_shadow man 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 users@clusterlabs.org

Referenced By

cibadmin(8).

December 2016 Pacemaker 1.1.16-1.fc26 System Administration Utilities