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:
       -h, --help
              Show help options

       --help-all
              Show all help options

       --help-output
              Show output help

       --help-queries
              Show query help

       --help-commands
              Show command help

       --help-additional
              Show additional options

   Output Options:
       --output-as=FORMAT
              Specify output format as one of: text (default), xml

       --output-to=DEST
              Specify file name for output (or "-" for stdout)

       --text-fancy
              Use more highly formatted output (requires --output-as=text)

   Queries:
       -w, --which
              Indicate the active shadow copy

       -p, --display
              Display the contents of the active shadow copy

       -d, --diff
              Display the changes in the active shadow copy

       -F, --file
              Display the location of the active shadow copy file

   Commands:
       -c, --create=name
              Create the named shadow copy of the active cluster configuration

       -e, --create-empty=name
              Create  the  named  shadow  copy  with  an  empty cluster configuration.  Optional:
              --validate-with

       -C, --commit=name
              Upload the contents of the named shadow copy to the cluster

       -D, --delete=name
              Delete the contents of the named shadow copy

       -E, --edit
              Edit the contents of the active shadow copy with your favorite $EDITOR

       -r, --reset=name
              Recreate named shadow copy from the active cluster configuration

       -s, --switch=name
              (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
              (Advanced) Create an older configuration version

   Application Options:
       -$, --version
              Display software version and exit

       -V, --verbose
              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