o2cb_ctl(8)

1o2cb_ctl(8)                   OCFS2 Manual Pages                   o2cb_ctl(8)
2
3
4

NAME

6       o2cb_ctl - Control program for the O2CB cluster service.
7

SYNOPSIS

9       o2cb_ctl -C -n object -t type [-i] [-a attribute ]
10       o2cb_ctl -D -n object [-u]
11       o2cb_ctl -I [-o-z] -l manager> [-n object>] [-t type] [-a attribute]
12       o2cb_ctl -H [-n object] [-t type>] [-a attribute>]
13       o2cb_ctl -h
14       o2cb_ctl -V
15
16

DESCRIPTION

18       o2cb_ctl  is  the  control program for the O2CB cluster service.  Users
19       are not advised to use this program directly but instead use  the  O2CB
20       init service and/or ocfs2console.
21
22

OPTIONS

24       -C     Create an object in the OCFS2 Cluster Configuration.
25
26
27       -D     Delete an object from the existing OCFS2 Cluster Configuration.
28
29
30       -I     Print information about the OCFS2 Cluster Configuration.
31
32
33       -H     Change  an  object or objects in the existing OCFS2 Cluster Con‐
34              figuration.
35
36
37       -h     Displays help and exit.
38
39
40       -V     Print version and exit.
41
42

OTHER OPTIONS

44       -a <attribute>
45              With -C, <attribute> is in format "parameter=value",  where  the
46              parameter  is  a  valid  parameter  that  can be set in the file
47              /etc/ocfs2/cluster.conf.  With -I, <attribute> may  be  "parame‐
48              ter",  indicating an attribute to be listed in the output, or it
49              may be "parameter==value", indicating that only objects matching
50              "parameter=value" are to be displayed.
51
52
53       -i     Valid  only  with -C. When creating something (node or cluster),
54              it will also install it in the live cluster. If the parameter is
55              not specified, then only update the /etc/ocfs2/cluster.conf.
56
57
58       -n object
59              object  is  usually  the  node  name  or  cluster  name.  In the
60              /etc/ocfs2/cluster.conf file, it would be the value of the  name
61              parameter for any of the sections (cluster or node).
62
63
64       -o     Valid  only  with -I. Using this parameter, if one asks o2cb_ctl
65              to list all nodes, it will output it in a  format  suitable  for
66              shell parsing.
67
68
69       -t type
70              type can be cluster, node or heartbeat.
71
72
73       -u     Valid  only  with -D. When deleting something (node or cluster),
74              it will also remove it from the live cluster. If  the  parameter
75              is not specified, then only update the /etc/ocfs2/cluster.conf.
76
77
78       -z     Valid only with -I. This is the default. If one asks o2cb_ctl to
79              list all nodes, it will give a verbose listing.
80
81

EXAMPLES

83       Add node5 to an offline cluster:
84
85              $ o2cb_ctl -C -n node5 -t node -a number=5
86                   -a ip_address=192.168.0.5 -a ip_port=7777
87                   -a cluster=mycluster
88
89
90       Add node10 to an online cluster:
91
92              $ o2cb_ctl -C -i -n node10 -t node -a number=10
93                   -a ip_address=192.168.1.10 -a ip_port=7777
94                   -a cluster=mycluster
95
96              Note the -i argument.
97
98
99       Query the IP address of node5:
100
101              $ o2cb_ctl -I -n node5 -a ip_address
102
103
104       Change the IP address of node5:
105
106              $ o2cb_ctl -H -n node5 -a ip_address=192.168.1.5
107
108

AUTHORS

114       Oracle Corporation
115
116

COPYRIGHT

118       Copyright © 2004, 2010 Oracle. All rights reserved.
119
120
121
122Version 1.8.6                   September 2010                     o2cb_ctl(8)