crm_diff - Man Page

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

Referenced By

cibadmin(8).

June 2026 Pacemaker 3.0.2-3.fc45 System Administration Utilities