crm_diff(8)

PACEMAKER(8) System Administration Utilities PACEMAKER(8)

NAME

Pacemaker - Part of the Pacemaker cluster resource manager

SYNOPSIS

crm_diff original_xml operation [options]

DESCRIPTION

Compare two Pacemaker configurations (in XML format) to produce a custom diff-like output, or apply such an output as a patch

OPTIONS

Help Options:

-h, --help
Show help options
--help-all
Show all help options
--help-output
Show output help
--help-xml
Show original XML options
--help-operation
Show operation options
--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)

Original XML:

-o, --original=FILE
XML is contained in the named file. Currently --original-string overrides this. In a future release, the last one specified will be used.
-O, --original-string=STRING
XML is contained in the supplied string. Currently this takes precedence over --original. In a future release, the last one specified will be used.

Operation:

-n, --new=FILE
Compare the original XML to the contents of the named file. Currently --new-string overrides this. In a future release, the last one specified will be used.
-N, --new-string=STRING
Compare the original XML with the contents of the supplied string. Currently this takes precedence over --patch and --new. In a future release, the last one specified will be used.
-p, --patch=FILE
Patch the original XML with the contents of the named file. Currently --new-string and (if specified later) --new override the input source specified here. In a future release, the last one specified will be used. Note: even if this input source is overridden, the input source will be applied as a patch to the original XML.

OPTIONS

Additional Options:

-c, --cib
Compare/patch the inputs as a CIB (includes version details)
-u, --no-version
Generate the difference without version details

Application Options:

-$, --version
Display software version and exit
-V, --verbose
Increase debug output (may be specified multiple times)

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 -x patch.xml

AUTHOR

Written by Andrew Beekhof and the Pacemaker project contributors

June 2026 Pacemaker 3.0.2-alt1