crm_diff(8) [suse man page]

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)

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

NAME

       crm_attribute - manipulate attributes in the CIB

SYNOPSIS

	   crm_attribute [options]

DESCRIPTION

       The crm_attribute command queries and manipulates node attributes and cluster configuration options that are used in the CIB.

OPTIONS

       --help, -?
	   Print a help message.

       --verbose, -V
	   Turn on debug information.

	       Note
	       Increase the level of verbosity by providing additional instances.

       --quiet, -Q
	   When doing an attribute query using -G, print just the value to stdout. Use this option with -G.

       --get-value, -G
	   Retrieve rather than set the preference.

       --delete-attr, -D
	   Delete rather than set the attribute.

       --attr-value string, -v string
	   Value to set. This is ignored when used with -G.

       --node-uuid node_uuid, -u node_uuid
	   Specify the UUID of the node to change.

       --node-uname node_uname, -U node_uname
	   Specify the uname of the node to change.

       --set-name string, -s string
	   Specify the set of attributes in which to read or write the attribute.

       --attr-name string, -n string
	   Specify the attribute to set or query.

       --type string, -t type
	   Determine to which section of the CIB the attribute should be set or to which section of the CIB the attribute that is queried belongs
	   Possible values are nodes, status, or crm_config.

	   Additional Options:

	   +-----------+--------------------+
	   |Type       | Additional Options |
	   +-----------+--------------------+
	   |nodes      | -(U|u) -n [-s]     |
	   +-----------+--------------------+
	   |status     | -(U|u) -n [-s]     |
	   +-----------+--------------------+
	   |crm_config | -n [-s]	    |
	   +-----------+--------------------+

EXAMPLES

       Query the value of the location attribute in the nodes section for the host myhost in the CIB:

	       crm_attribute -G -t nodes -U myhost -n location

       Query the value of the cluster-delay attribute in the crm_config section in the CIB:

	       crm_attribute -G -t crm_config -n cluster-delay

       Query the value of the cluster-delay attribute in the crm_config section in the CIB. Print just the value:

	       crm_attribute -G -Q -t crm_config -n cluster-delay

       Delete the location attribute for the host myhost from the nodes section of the CIB:

	       crm_attribute -D -t nodes -U myhost -n location

       Add a new attribute called location with the value of office to the set subsection of the nodes section in the CIB (settings applied to the
       host myhost):

	       crm_attribute -t nodes -U myhost -s set -n location -v office

       Change the value of the location attribute in the nodes section for the myhost host:

	       crm_attribute -t nodes -U myhost -n location -v backoffice

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_attribute was written by Andrew Beekhof.

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