cdbutil(1m)

NAME
     cdbutil - Cluster configuration database utility tool

SYNOPSIS
     cdbutil [ option... ] cmd...

DESCRIPTION
     cdbutil 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.

OPTIONS
     cdbutil 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.
     -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.