Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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:
       -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 configura-
	      tion.  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 clus-
       ter:

	      #	crm_shadow --commit myShadow

AUTHOR
       Written by Andrew Beekhof and the Pacemaker project contributors

Pacemaker 2.1.7			   May 2025			  PACEMAKER(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=crm_shadow&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>

home | help