o2cb_ctl(8)

📦
version 1.8.9 · 3 versions
, in fedora 44, ubuntu resolute, ubuntu stonking

💖 o2cb_ctl — the OCFS2 manual, section 8 💖

okay so bestie, welcome to o2cb_ctl(8), straight out of the OCFS2 Manual Pages. this is the little control program for the O2CB cluster service, and she's got ✨ range ✨. let's get into it 🫶

🌸 NAME 🌸

o2cb_ctl — control program for the O2CB cluster service. that's it, that's the whole job description, and she does it flawlessly 💅

✨ SYNOPSIS ✨

here's how you actually call her. copy these exactly, no freestyling:

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 🦋

so o2cb_ctl is the control program for the O2CB cluster service. sounds iconic, right? but here's the tea ☕ — users are not advised to use this program directly. instead you're supposed to go through the O2CB init service and/or ocfs2console. like, she's the backstage queen, not the one you dm first. respect the chain of command, bestie 👑

💅 OPTIONS 💅

the main character flags. learn them, love them:

  • -C — create an object in the OCFS2 Cluster Configuration. new object, who dis ✨
  • -D — delete an object from the existing OCFS2 Cluster Configuration. gone, blocked, unfollowed 💀
  • -I — print information about the OCFS2 Cluster Configuration. she's nosy and we love that 🙈
  • -H — change an object or objects in the existing OCFS2 Cluster Configuration. glow-up mode 🎀
  • -h — displays help and exit. when in doubt, ask for help, no shame 💖
  • -V — print version and exit. vibes check, but make it software 🌈

🌟 OTHER OPTIONS 🌟

these are the supporting cast and honestly? they ate 🔥

  • -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. yes there's a double equals in the second one, that's not a typo, that's the whole point 👀
  • -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. so like, -i is the "and post it immediately" button 📲
  • -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). it's giving name tag at the function 🏷️
  • -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. machine-readable, lowkey gorgeous 🤖
  • -t type — type can be cluster, node or heartbeat. three options, all valid, choose wisely 💜
  • -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. the counterpart to -i, and she's just as important 🫶
  • -z — valid only with -I. this is the default. if one asks o2cb_ctl to list all nodes, it will give a verbose listing. she talks a lot and every word is necessary, periodt 💅

🎀 EXAMPLES 🎀

real scenarios, real commands, all verbatim:

add node5 to an offline cluster:

$ o2cb_ctl -C -n node5 -t node -a number=5
     -a ip_address=192.168.0.5 -a ip_port=7777
     -a cluster=mycluster

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. that's the whole plot twist, don't skip her 😭

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 🔥

go read these next, the lore is deep:

mkfs.ocfs2(8) fsck.ocfs2(8) tunefs.ocfs2(8) mounted.ocfs2(8) o2cb(7)

👑 AUTHORS 👑

Oracle Corporation. the originators, the blueprint, the blueprint-ers 💜

Copyright © 2004, 2010 Oracle. All rights reserved. legal said what she said, respect it ✨

and that's the page, bestie 🫶 this was Version 1.8.9, dated September 2010 — yeah she's a vintage icon and she still slays. bye, love you, go read mkfs.ocfs2(8) next 💖🎀🦋

📦 where this page comes from