/etc/sysconfig/o2cb(5)

💖 /etc/sysconfig/o2cb — the OCFS2 Manual Pages, section 5, bestie 💖

okay so. this is the manual page for /etc/sysconfig/o2cb, from the OCFS2 Manual Pages collection (section 5, the file formats girlies 🎀). it's short, it's sweet, it's lowkey the whole personality of your cluster stack. let's get into it.

---

✨ NAME ✨

/etc/sysconfig/o2cb — the cluster configuration file for the o2cb cluster stack.

---

🌸 SYNOPSIS 🌸

The configuration file /etc/sysconfig/o2cb stores the active cluster stack, its name, and the various cluster timeouts for the o2cb cluster stack. that's it. that's the whole job. iconic behavior honestly.

---

🦋 DESCRIPTION 🦋

You can populate this file using the o2cb init script. there's a whole example of that down in the examples section, don't worry, we get there. 🫶

The list of configurable parameters in this file are:

• O2CB_STACK — the name of the cluster stack. possible values are o2cb, pcmk and cman. o2cb is the default cluster stack of the OCFS2 file system. pcmk (Pacemaker) and cman (rgmanager) are the two other cluster stacks that the very same file system supports. so like, pick your fighter. ⭐
• O2CB_BOOTCLUSTER — the name of the active cluster. and here's the tea: while /etc/ocfs2/cluster.conf can hold descriptions of multiple clusters, only one can be active at any one time. the name of that one active cluster goes here. the name itself can be up to 16 alphanumeric characters [0-9A-Za-z] with no special characters. no dashes, no underscores, no vibes. periodt.

---

The remaining configurable parameters (the cluster timeouts) are only relevant for the o2cb cluster stack. these cluster timeouts are what the o2cb cluster stack uses to figure out whether a node is dead or alive. 💀 the default timeouts are just a guide and may need to be tweaked depending on the hardware the software is running on. so like, know your hardware, bestie.

The various cluster timeouts for the o2cb cluster stack are:

• O2CB_HEARTBEAT_THRESHOLD — the disk heartbeat timeout is the number of two second iterations before a node is considered dead. the exact formula used to convert the timeout in seconds to the number of iterations is as follows:

O2CB_HEARTBEAT_THRESHOLD = (((timeout in seconds) / 2) + 1)

For example, to specify a 60 sec timeout, set it to 31. For 120 secs, set it to 61. The default for this timeout is 60 secs (O2CB_HEARTBEAT_THRESHOLD = 31).

While it defaults to 60 secs, multipath users typically set it to 120 secs.

• O2CB_IDLE_TIMEOUT_MS — the network idle timeout specifies the time in milliseconds before a network connection is considered dead. while it defaults to 30000 ms, network bonding users typically set it to 60000 ms.
• O2CB_KEEPALIVE_DELAY_MS — the network keepalive specifies the maximum delay in milliseconds before a keepalive packet is sent to another node to check whether it is alive or not. it defaults to 2000 ms.
• O2CB_RECONNECT_DELAY_MS — the network reconnect specifies the minimum delay in milliseconds between repeated connect attempts. it defaults to 2000 ms.

---

🎀 EXAMPLE 🎀

The example below illustrates populating the o2cb sysconfig file using the o2cb init script. watch and learn. 👑

$ service o2cb configure
Configuring the O2CB driver.

This will configure the on-boot properties of the O2CB driver.
The following questions will determine whether the driver is loaded on
boot.  The current values will be shown in brackets ('[]').  Hitting
<ENTER> without typing an answer will keep that current value.  Ctrl-C
will abort.

Load O2CB driver on boot (y/n) [n]: y
Cluster stack backing O2CB [o2cb]:
Cluster to start on boot (Enter "none" to clear) [ocfs2]: webcluster
Specify heartbeat dead threshold (>=7) [31]: 62
Specify network idle timeout in ms (>=5000) [30000]: 60000
Specify network keepalive delay in ms (>=1000) [2000]:
Specify network reconnect delay in ms (>=2000) [2000]:
Writing O2CB configuration: OK

then you peek at what it wrote:

$ cat /etc/sysconfig/o2cb
#
# This is a configuration file for automatic startup of the O2CB
# driver.  It is generated by running /etc/init.d/o2cb configure.
# On Debian based systems the preferred method is running
# 'dpkg-reconfigure ocfs2-tools'.
#

# O2CB_ENABLED: 'true' means to load the driver on boot.
O2CB_ENABLED=true

# O2CB_STACK: The name of the cluster stack backing O2CB.
O2CB_STACK=o2cb

# O2CB_BOOTCLUSTER: If not empty, the name of a cluster to start.
O2CB_BOOTCLUSTER=webcluster

# O2CB_HEARTBEAT_THRESHOLD: Iterations before a node is considered dead.
O2CB_HEARTBEAT_THRESHOLD=62

# O2CB_IDLE_TIMEOUT_MS: Time in ms before a network connection is considered dead.
O2CB_IDLE_TIMEOUT_MS=60000

# O2CB_KEEPALIVE_DELAY_MS: Max time in ms before a keepalive packet is sent
O2CB_KEEPALIVE_DELAY_MS=2000

# O2CB_RECONNECT_DELAY_MS: Min time in ms between connection attempts
O2CB_RECONNECT_DELAY_MS=2000

---

🌈 SEE ALSO 🌈

• o2cb(7)
• o2cb(8)
• ocfs2.cluster.conf(5)

go read those too, they're the friend group. 💜

---

👑 AUTHORS 👑

Oracle Corporation

---

💅 COPYRIGHT 💅

Copyright © 2004, 2012 Oracle. All rights reserved.

---

and that's the whole page, bestie!! Version 1.8.9, dated January 2012 — yeah she's an elder but she still ate and left no crumbs. mwah 💖✨