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 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, 2010 Oracle. All rights reserved.