GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CIBADMIN (8)

NAME

Pacemaker - Part of the Pacemaker cluster resource manager

CONTENTS

Synopsis
Description
Options
Examples
Author

SYNOPSIS

cibadmin command [options] [data]

DESCRIPTION

cibadmin - Provides direct access to the cluster configuration.

Allows the configuration, or sections of it, to be queried, modified, replaced and deleted.

Where necessary, XML data will be obtained using the -X, -x, or -p options

OPTIONS

-?, --help This text
-$, --version
  Version information
-V, --verbose
  Increase debug output

    Commands:

-u, --upgrade
  Upgrade the configuration to the latest syntax
-Q, --query
  Query the contents of the CIB
-E, --erase
  Erase the contents of the whole CIB
-B, --bump Increase the CIB’s epoch value by 1
-C, --create
  Create an object in the CIB. Will fail if the object already exists.
-M, --modify
  Find the object somewhere in the CIB’s XML tree and update it. Fails if the object does not exist unless -c is specified
-P, --patch
  Supply an update in the form of an xml diff (See also: crm_diff)
-R, --replace
  Recursivly replace an object in the CIB
-D, --delete
  Delete the first object matching the supplied criteria, Eg. <op id="rsc1_op1" name="monitor"/>
The tagname and all attributes must match in order for the element to be deleted
-d, --delete-all
  When used with --xpath, remove all matching objects in the configuration instead of just the first one
-a, --empty
  Output an empty CIB
-5, --md5-sum
  Calculate the on-disk CIB digest
-6, --md5-sum-versioned
  Calculate an on-the-wire versioned CIB digest

    Additional options:

-f, --force
-t, --timeout=value
  Time (in seconds) to wait before declaring the operation failed
-U, --user=value
  Run the command with permissions of the named user (valid only for the root and hacluster accounts)
-s, --sync-call
  Wait for call to complete before returning
-l, --local
  Command takes effect locally. Should only be used for queries
-c, --allow-create
  (Advanced) Allow the target of a --modify,-M operation to be created if they do not exist
-n, --no-children
  (Advanced) When querying an object, do not return include its children in the result

    Data:

-X, --xml-text=value
  Retrieve XML from the supplied string
-x, --xml-file=value
  Retrieve XML from the named file
-p, --xml-pipe Retrieve XML from stdin
-o, --scope=value
  Limit the scope of the operation to a specific section of the CIB.
Valid values are: nodes, resources, constraints, crm_config, rsc_defaults, op_defaults, status
-A, --xpath=value
  A valid XPath to use instead of --scope,-o
-e, --node-path
  When performing XPath queries, return the address of any matches found.
Eg: /cib/configuration/resources/master[@id=’ms_RH1_SCS’]/primitive[@id=’prm_RH1_SCS’]
-N, --node=value
  (Advanced) Send command to the specified host

EXAMPLES

Query the configuration from the local node:
# cibadmin --query --local
Query the just the cluster options configuration:
# cibadmin --query --scope crm_config
Query all ’target-role’ settings:
# cibadmin --query --xpath "//nvpair[@name=’target-role’]"
Remove all ’is-managed’ settings:
# cibadmin --delete-all --xpath "//nvpair[@name=’is-managed’]"
Remove the resource named ’old’:
# cibadmin --delete --xml-text ’<primitive id="old"/>’
Remove all resources from the configuration:
# cibadmin --replace --scope resources --xml-text ’<resources/>’
Replace the complete configuration with the contents of $HOME/pacemaker.xml:
# cibadmin --replace --xml-file $HOME/pacemaker.xml
Replace the constraints section of the configuration with the contents of $HOME/constraints.xml:
# cibadmin --replace --scope constraints --xml-file $HOME/constraints.xml
Increase the configuration version to prevent old configurations from being loaded accidentally:
# cibadmin --modify --xml-text ’<cib admin_epoch="admin_epoch++"/>’
Edit the configuration with your favorite $EDITOR:
# cibadmin --query > $HOME/local.xml
# $EDITOR $HOME/local.xml
# cibadmin --replace --xml-file $HOME/local.xml

    SEE ALSO:

crm(8), pcs(8), crm_shadow(8)

AUTHOR

Written by Andrew Beekhof

REPORTING BUGS

Report bugs to pacemaker@oss.clusterlabs.org
Search for    or go to Top of page |  Section 8 |  Main Index


Pacemaker 1.1.14 PACEMAKER (8) April 2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.