cdbutil(1m)cdbutil(1m)NAMEcdbutil - Cluster configuration database utility tool
SYNOPSIScdbutil [ option... ] cmd...
DESCRIPTIONcdbutil provides direct access to the Cluster Administration Services
(CAS) configuration database (CDB) by means of commands that correspond
roughly to functions in the CDB library, libcdb. cdbutil can read these
commands from command-line arguments, script files and interactively from
the user.
cdbutil commands consist of a command name followed by zero or more
arguments and terminated by a semicolon or newline. Individual arguments
are normally separated by whitespace; to include whitespace in a single
argument (e.g. a string value) enclose the argument in double quotes. A
single argument or command can be continued across multiple lines in a
script file by ending intermediate lines with a backslash character. If
the first non-whitespace character in a line is a "#" then the rest of
the line will be treated as a comment and discarded.
Individual commands are documented online within cdbutil. For a list of
the commands, type "help" while in interactive mode, or "cdbutil help"
from the command line.
OPTIONScdbutil takes several options:
-c string Process the single argument string as a cdbutil command line.
Multiple commands can be included on this command line by
separating them with semicolons. Unless string is a single
word, it will normally need to be enclosed in quotes so that
it is treated as a single command-line argument by the shell.
This option can be specified any number of times.
-f path Read cdbutil commands from the file path. This option can be
specified any number of times.
-F path Same as "-f", but the file will always be read after any
other commands specified on the command line and/or with the
"-f" option have been processed. This may be useful when
using cdbutil as a shell interpreter. This option can only
be specified once or an error will occur.
-i Switch to interactive mode after any commands specified on
the command line and/or with the "-f" or "-F" options have
been processed. Commands will be accepted from stdin until
the "exit" command is issued or EOF is received.
Page 1
cdbutil(1m)cdbutil(1m)-p Print a prompt before accepting each command in interactive
mode. This is the default behavior; the option is provided
primarily to undo a "-np" option earlier on the command line
or in the CDBUTIL_OPTS environment variable (see below).
-q Turns on "quiet" mode: successful completion messages will
not be printed, though error messages will continue to be
printed as usual. Note that the only purpose of some
commands is to print information (e.g. the value of a node),
and this will not be affected by quiet mode.
-x Enables "expert" mode. If this option is specified, then the
"expert on" command can be used to turn on expert mode. This
will permit some additional operations that are usually not
useful to ordinary users.
-- This will cause the rest of the command line to be treated as
a single command string, with exactly one space between each
of the remaining arguments. Strictly speaking, the "--" is
optional unless it is needed to resolve some ambiguity.
Options can also be specified in the environment variable CDBUTIL_OPTS.
Options specified in this way will be processed before the options on the
command line itself.
The "-i", "-p", "-q" and "-x" options can all be negated later on in the
command line by preceding the letter with "n". For example, "-nq" will
turn off quiet mode. This may be useful to counteract an option
specified in CDBUTIL_OPTS.
The "-c", "-f" and "--" options will be processed in the order they are
encountered. If one of these input sources specifies multiple commands
and one of those commands should fail for some reason, the remainder of
the commands from that source will be discarded and processing will
continue with the next input source. After all of those sources have
been exhausted, then the input file specified by the "-F" option (if
present) will be processed. Following that, cdbutil will enter
interactive mode if the "-i" option was specified.
NOTES
The default location for the CDB database is /var/cluster/cdb/cdb.db#.
To specify a different location, set the environment variable CDB_DB to
the pathname of the database file containing the root node.
Page 2
