crm_shadow - Man Page

Part of the Pacemaker cluster resource manager

Synopsis

crm_shadow <query>|<command> [options]

Description

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

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

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

# crm_shadow --commit myShadow

Author

Written by Andrew Beekhof

Reporting Bugs

Report bugs to users@clusterlabs.org

Referenced By

cibadmin(8).

September 2021 Pacemaker 2.1.1-9.fc36 System Administration Utilities