crm_diff(8) [debian man page]

PACEMAKER(8)						  System Administration Utilities					      PACEMAKER(8)

NAME

       Pacemaker - Part of the Pacemaker cluster resource manager

SYNOPSIS

       crm_diff original_xml operation [options]

DESCRIPTION

       crm_diff - A utility for comparing Pacemaker configurations (XML format)

       The tool produces a custom (diff-like) output which it can also apply like a patch

OPTIONS

       -?, --help
	      This text

       -$, --version
	      Version information

       -V, --verbose
	      Increase debug output

   Original XML:
       -o, --original=value
	      XML is contained in the named file

       -O, --original-string=value
	      XML is contained in the supplied string

   Operation:
       -n, --new=value
	      Compare the original XML to the contents of the named file

       -N, --new-string=value
	      Compare the original XML to the contents of the supplied string

       -p, --patch=value
	      Patch the original XML with the contents of the named file

   Additional Options:
       -c, --cib
	      Compare/patch the inputs as a CIB (includes versions details)

       -f, --filter
	      Suppress irrelevant differences between the two inputs

EXAMPLES

       Obtain the two different configuration files by running cibadmin on the two cluster setups to compare:

	      # cibadmin --query > cib-old.xml

	      # cibadmin --query > cib-new.xml

       Calculate and save the difference between the two files:

	      # crm_diff --original cib-old.xml --new cib-new.xml > patch.xml

       Apply the patch to the original file:

	      # crm_diff --original cib-old.xml --patch patch.xml > updated.xml

       Apply the patch to the running cluster:

	      # cibadmin --patch patch.xml

AUTHOR

       Written by Andrew Beekhof

REPORTING BUGS

       Report bugs to pacemaker@oss.clusterlabs.org

Pacemaker 1.1.7 						    April 2012							      PACEMAKER(8)

CRM_DIFF(8)							  [FIXME: manual]						       CRM_DIFF(8)

NAME

       crm_diff - identify changes to the cluster configuration and apply patches to the configuration files

SYNOPSIS

	   crm_diff [-?|-V] [-o filename] [-O string] [-p filename] [-n filename] [-N string]

DESCRIPTION

       The crm_diff command assists in creating and applying XML patches. This can be useful for visualizing the changes between two versions of
       the cluster configuration or saving changes so they can be applied at a later time using cibadmin.

OPTIONS

       --help, -?
	   Print a help message.

       --original filename, -o filename
	   Specify the original file against which to diff or apply patches.

       --new filename, -n filename
	   Specify the name of the new file.

       --original-string string, -O string
	   Specify the original string against which to diff or apply patches.

       --new-string string, -N string
	   Specify the new string.

       --patch filename, -p filename
	   Apply a patch to the original XML. Always use with -o.

       --cib, -c
	   Compare or patch the inputs as a CIB. Always specify the base version with -o and provide either the patch file or the second version
	   with -p or -n, respectively.

       --stdin, -s
	   Read the inputs from stdin.

EXAMPLES

       Use crm_diff to determine the differences between various CIB configuration files and to create patches. By means of patches, easily reuse
       configuration parts without having to use the cibadmin command on every single one of them.

	1. Obtain the two different configuration files by running cibadmin on the two cluster setups to compare:

	       cibadmin -Q > cib1.xml
	       cibadmin -Q > cib2.xml

	2. Determine whether to diff the entire files against each other or compare just a subset of the configurations.

	3. To print the difference between the files to stdout, use the following command:

	       crm_diff -o cib1.xml -n cib2.xml

	4. To print the difference between the files to a file and create a patch, use the following command:

	       crm_diff -o cib1.xml -n cib2.xml > patch.xml

	5. Apply the patch to the original file:

	       crm_diff -o cib1.xml -p patch.xml

FILES

       /var/lib/heartbeat/crm/cib.xml--the CIB (minus status section) on disk. Editing this file directly is strongly discouraged.

SEE ALSO

       ???

AUTHOR

       crm_diff was written by Andrew Beekhof.

[FIXME: source] 						    07/05/2010							       CRM_DIFF(8)