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).

June 2017 Pacemaker 1.1.17-0.1.rc3.fc27 System Administration Utilities