Scroll to navigation

PACEMAKER(8) System Administration Utilities PACEMAKER(8)

NAME

Pacemaker - Part of the Pacemaker cluster resource manager

SYNOPSIS

crm_shadow <query>|<command> [options]

DESCRIPTION

perform Pacemaker configuration changes in a sandbox

This command 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 Options:

Show help options
Show all help options
Show output help
Show query help
Show command help
Show additional options

Output Options:

Specify output format as one of: text (default), xml
Specify file name for output (or "-" for stdout)

Queries:

Indicate the active shadow copy
Display the contents of the active shadow copy
Display the changes in the active shadow copy
Display the location of the active shadow copy file

Commands:

Create the named shadow copy of the active cluster configuration
Create the named shadow copy with an empty cluster configuration. Optional: --validate-with
Upload the contents of the named shadow copy to the cluster
Delete the contents of the named shadow copy
Edit the contents of the active shadow copy with your favorite $EDITOR
Recreate named shadow copy from the active cluster configuration
(Advanced) Switch to the named shadow copy

Additional Options:

(Advanced) Force the action to be performed
(Advanced) Don't spawn a new shell
(Advanced) Upload entire CIB, including status, with --commit
(Advanced) Create an older configuration version

Application Options:

-$, --version
Display software version and exit
Increase debug output (may be specified multiple times)

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 --force

Upload current shadow configuration (named myShadow) to running cluster:

# crm_shadow --commit myShadow

AUTHOR

Written by Andrew Beekhof and the Pacemaker project contributors

November 2024 Pacemaker 2.1.9+20241107.c3b66b02d0-1.1