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. Users
are not advised to use this program directly but instead use the O2CB
init service and/or ocfs2console.
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
Add node5 to an offline cluster:
$ o2cb_ctl -C -n node5 -t node -a number=5
-a ip_address=192.168.0.5 -a ip_port=7777
-a cluster=mycluster
Add node10 to an online cluster:
$ o2cb_ctl -C -i -n node10 -t node -a number=10
-a ip_address=192.168.1.10 -a ip_port=7777
-a cluster=mycluster
Note the -i argument.
Query the IP address of node5:
$ o2cb_ctl -I -n node5 -a ip_address
Change the IP address of node5:
$ o2cb_ctl -H -n node5 -a ip_address=192.168.1.5
SEE ALSO
mkfs.ocfs2(8) fsck.ocfs2(8) tunefs.ocfs2(8) mounted.ocfs2(8)
ocfs2console(8) o2cb(7)
AUTHORS
Oracle Corporation
COPYRIGHT
Copyright © 2004, 2009 Oracle. All rights reserved.