crm_shadow (8) - Linux Manuals

crm_shadow: Part of the Pacemaker cluster resource manager

NAME

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