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 users@clusterlabs.org