NAME

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

Pacemaker 2.1.2                                    March 2023                                       PACEMAKER(8)