1/etc/sysconfig/o2cb(5)        OCFS2 Manual Pages        /etc/sysconfig/o2cb(5)
2
3
4

NAME

6       /etc/sysconfig/o2cb  -  Cluster configuration file for the o2cb cluster
7       stack.
8

SYNOPSIS

10       The configuration file /etc/sysconfig/o2cb stores  the  active  cluster
11       stack,  its  name and the various cluster timeouts for the o2cb cluster
12       stack.
13
14

DESCRIPTION

16       This file can be populated using the o2cb init script.  An  example  of
17       the same is illustrated in the examples section.
18
19       The list of configurable parameters in this file are:
20
21
22       O2CB_STACK
23              Name  of  the  cluster stack. The possible values are o2cb, pcmk
24              and cman.  o2cb is the default cluster stack of the  OCFS2  file
25              system.  pcmk (Pacemaker) and cman (rgmanager) are the two other
26              cluster stacks that are supported by the same file system.
27
28
29       O2CB_BOOTCLUSTER
30              Name of the active cluster.  While  /etc/ocfs2/cluster.conf  can
31              hold  descriptions  of multiple clusters, only one can be active
32              at any one time. The name of that active  cluster  is  specified
33              here.  The  name  itself can be up to 16 alphanumeric characters
34              [0-9A-Za-z] with no special characters.
35
36       The remaining configurable parameters (cluster timeouts) are only rele‐
37       vant for the o2cb cluster stack. These cluster timeouts are used by the
38       o2cb cluster stack to determine whether a node is dead  or  alive.  The
39       default  timeouts are just a guide and may need to be tweaked depending
40       on the hardware the software is running on.
41
42       The various cluster timeouts for the o2cb cluster stack are:
43
44       O2CB_HEARTBEAT_THRESHOLD
45              The disk heartbeat timeout is the number of  two  second  itera‐
46              tions  before  a node is considered dead. The exact formula used
47              to convert the timeout in seconds to the number of iterations is
48              as follows:
49
50                  O2CB_HEARTBEAT_THRESHOLD = (((timeout in seconds) / 2) + 1)
51
52              For  example, to specify a 60 sec timeout, set it to 31. For 120
53              secs, set it to 61.  The default for this  timeout  is  60  secs
54              (O2CB_HEARTBEAT_THRESHOLD = 31).
55
56              While  it  defaults to 60 secs, multipath users typically set it
57              to 120 secs.
58
59
60       O2CB_IDLE_TIMEOUT_MS
61              The network idle timeout specifies the time in milliseconds  be‐
62              fore  a network connection is considered dead. While it defaults
63              to 30000 ms, network bonding users typically set it to 60000 ms.
64
65
66       O2CB_KEEPALIVE_DELAY_MS
67              The network keepalive specifies the maximum delay  in  millisec‐
68              onds  before a keepalive packet is sent to another node to check
69              whether it is alive or not. It defaults to 2000 ms.
70
71
72       O2CB_RECONNECT_DELAY_MS
73              The network reconnect specifies the minimum delay  in  millisec‐
74              onds between repeated connect attempts. It defaults to 2000 ms.
75

EXAMPLE

77       The  example below illustrates populating the o2cb sysconfig file using
78       the o2cb init script.
79
80
81       $ service o2cb configure
82       Configuring the O2CB driver.
83
84       This will configure the on-boot properties of the O2CB driver.
85       The following questions will determine whether the driver is loaded on
86       boot.  The current values will be shown in brackets ('[]').  Hitting
87       <ENTER> without typing an answer will keep that current value.  Ctrl-C
88       will abort.
89
90       Load O2CB driver on boot (y/n) [n]: y
91       Cluster stack backing O2CB [o2cb]:
92       Cluster to start on boot (Enter "none" to clear) [ocfs2]: webcluster
93       Specify heartbeat dead threshold (>=7) [31]: 62
94       Specify network idle timeout in ms (>=5000) [30000]: 60000
95       Specify network keepalive delay in ms (>=1000) [2000]:
96       Specify network reconnect delay in ms (>=2000) [2000]:
97       Writing O2CB configuration: OK
98
99
100       $ cat /etc/sysconfig/o2cb
101       #
102       # This is a configuration file for automatic startup of the O2CB
103       # driver.  It is generated by running /etc/init.d/o2cb configure.
104       # On Debian based systems the preferred method is running
105       # 'dpkg-reconfigure ocfs2-tools'.
106       #
107
108       # O2CB_ENABLED: 'true' means to load the driver on boot.
109       O2CB_ENABLED=true
110
111       # O2CB_STACK: The name of the cluster stack backing O2CB.
112       O2CB_STACK=o2cb
113
114       # O2CB_BOOTCLUSTER: If not empty, the name of a cluster to start.
115       O2CB_BOOTCLUSTER=webcluster
116
117       # O2CB_HEARTBEAT_THRESHOLD: Iterations before a node is considered dead.
118       O2CB_HEARTBEAT_THRESHOLD=62
119
120       # O2CB_IDLE_TIMEOUT_MS: Time in ms before a network connection is considered dead.
121       O2CB_IDLE_TIMEOUT_MS=60000
122
123       # O2CB_KEEPALIVE_DELAY_MS: Max time in ms before a keepalive packet is sent
124       O2CB_KEEPALIVE_DELAY_MS=2000
125
126       # O2CB_RECONNECT_DELAY_MS: Min time in ms between connection attempts
127       O2CB_RECONNECT_DELAY_MS=2000
128
129

SEE ALSO

131       o2cb(7) o2cb(8) ocfs2.cluster.conf(5)
132
133

AUTHORS

135       Oracle Corporation
136
137
139       Copyright © 2004, 2012 Oracle. All rights reserved.
140
141
142
143Version 1.8.7                    January 2012           /etc/sysconfig/o2cb(5)
Impressum