1/etc/sysconfig/o2cb(5) OCFS2 Manual Pages /etc/sysconfig/o2cb(5)
2
6 /etc/sysconfig/o2cb - Cluster configuration file for the o2cb cluster
7 stack.
8
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
16 This file can be populated using the o2cb init script. An example of
17 the same is illustrated in the examples section.
18 The list of configurable parameters in this file are:
20 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 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 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 The various cluster timeouts for the o2cb cluster stack are:
43 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 O2CB_HEARTBEAT_THRESHOLD = (((timeout in seconds) / 2) + 1)
51 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 While it defaults to 60 secs, multipath users typically set it
57 to 120 secs.
58 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 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 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
77 The example below illustrates populating the o2cb sysconfig file using
78 the o2cb init script.
79 $ service o2cb configure
82 Configuring the O2CB driver.
83 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 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 $ 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 # O2CB_ENABLED: 'true' means to load the driver on boot.
109 O2CB_ENABLED=true
110 # O2CB_STACK: The name of the cluster stack backing O2CB.
112 O2CB_STACK=o2cb
113 # O2CB_BOOTCLUSTER: If not empty, the name of a cluster to start.
115 O2CB_BOOTCLUSTER=webcluster
116 # O2CB_HEARTBEAT_THRESHOLD: Iterations before a node is considered dead.
118 O2CB_HEARTBEAT_THRESHOLD=62
119 # O2CB_IDLE_TIMEOUT_MS: Time in ms before a network connection is considered dead.
121 O2CB_IDLE_TIMEOUT_MS=60000
122 # O2CB_KEEPALIVE_DELAY_MS: Max time in ms before a keepalive packet is sent
124 O2CB_KEEPALIVE_DELAY_MS=2000
125 # O2CB_RECONNECT_DELAY_MS: Min time in ms between connection attempts
127 O2CB_RECONNECT_DELAY_MS=2000
128
131 o2cb(7) o2cb(8) ocfs2.cluster.conf(5)
132
135 Oracle Corporation
136
139 Copyright © 2004, 2012 Oracle. All rights reserved.
140Version 1.8.7 January 2012 /etc/sysconfig/o2cb(5)