Provided by: ocfs2-tools_1.1.5-0ubuntu5_i386 bug

NAME

       o2cb_ctl - Control program for the O2CB cluster service.

SYNOPSIS

       o2cb_ctl -C -n object -t type [-i] [-a attribute ]
       o2cb_ctl -D -n object [-u]
       o2cb_ctl -I [-o-z] -l manager> [-n object>] [-t type] [-a attribute]
       o2cb_ctl -H [-n object] [-t type>] [-a attribute>]
       o2cb_ctl -h
       o2cb_ctl -V

DESCRIPTION

       o2cb_ctl  is  the control program for the O2CB cluster service.  One is
       strongly recommended not to use this  tool  directly  but  instead  use
       ocfs2console to do the same.

OPTIONS

       -C     Create an object in the OCFS2 Cluster Configuration.

       -D     Delete  an object from the existing OCFS2 Cluster Configuration.

       -I     Print information about the OCFS2 Cluster Configuration.

       -H     Change an object  or  objects  in  the  existing  OCFS2  Cluster
              Configuration.

       -h     Displays help and exit.

       -V     Print version and exit.

OTHER OPTIONS

       -a <attribute>
              With  -C,  <attribute> is in format "parameter=value", where the
              parameter is a valid parameter that  can  be  set  in  the  file
              /etc/ocfs2/cluster.conf.     With   -I,   <attribute>   may   be
              "parameter", indicating an attribute to be listed in the output,
              or  it  may  be "parameter==value", indicating that only objects
              matching "parameter=value" are to be displayed.

       -i     Valid only with -C. When creating something (node  or  cluster),
              it will also install it in the live cluster. If the parameter is
              not specified, then only update the /etc/ocfs2/cluster.conf.

       -n object
              object is  usually  the  node  name  or  cluster  name.  In  the
              /etc/ocfs2/cluster.conf  file, it would be the value of the name
              parameter for any of the sections (cluster or node).

       -o     Valid only with -I. Using this parameter, if one  asks  o2cb_ctl
              to  list  all  nodes, it will output it in a format suitable for
              shell parsing.

       -t type
              type can be cluster, node or heartbeat.

       -u     Valid only with -D. When deleting something (node  or  cluster),
              it  will  also remove it from the live cluster. If the parameter
              is not specified, then only update the  /etc/ocfs2/cluster.conf.

       -z     Valid only with -I. This is the default. If one asks o2cb_ctl to
              list all nodes, it will give a verbose listing.

EXAMPLES

       In the cluster "mycluster", create the node "node5":

              o2cb_ctl -C -n node5 -t node -a number=5
                   -a ip_address=139.185.118.5 -a ip_port=7777
                   -a cluster=mycluster

       To query the IP address of node5:

              o2cb_ctl -I -n node5 -a ip_address

       To change the IP address of node5:

              o2cb_ctl -H -n node5 -a ip_address=130.35.68.5

SEE ALSO

       mkfs.ocfs2(8)    fsck.ocfs2(8)     tunefs.ocfs2(8)     mounted.ocfs2(8)
       ocfs2console(8) ocfs2cdsl(8)

AUTHORS

       Oracle Corporation

COPYRIGHT

       Copyright © 2004, 2005 Oracle. All rights reserved.