DRBDLINKS(8)

💖 DRBDLINKS 💖

okay bestie, so this is the drbdlinks manual page from the System Manager's Manual section, and honestly? she's a baddie. let's get into it. 🦋

---

✨ NAME ✨

drbdlinks — she manages links into a shared DRBD partition. that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

drbdlinks [OPTION]... [start|stop|auto|status|monitor|checklinks]

---

🎀 DESCRIPTION 🎀

so, drbdlinks is a program that will manage creation and removal of symbolic links. she's primarily used with clusters of machines using either shared storage or the "DRBD" replicated block device. iconic behavior fr fr. ✨

and like, even though the name of the program is "drbdlinks", it can be used in any shared-storage sort of environment where the shared storage is only mounted on the active node. but in cases like NFS where the shared storage is always mounted on all nodes, drbdlinks is not necessary. know the difference bestie, it matters. 😌

the advantage over creating static symbolic links is that package updates often require that directories point at real files, so updates can often fail if you do not have the shared storage mounted. so like, static links? lowkey a trap. 🪤

drbdlinks also supports multiple instances of links, in the case of active/active clusters. for example, if you have MySQL running in one resource group, and Apache running in another, you can use the "-c" switch to specify a configuration file for each resource group. one program, many girlies, no cap. 👑

a simple configuration file, /etc/drbdlinks.conf, specifies the links. this can be used to manage links for /etc/httpd, /var/lib/pgsql, and other system directories that need to appear as if they are local to the system when running applications after a drbd shared partition has been mounted. it's giving pretend-it's-local energy. 🌈

optionally, configuration directives can also be written to files in /etc/drbdlinks.d with the suffix .conf, which are loaded after the /etc/drbdlinks.conf file, in sorted order. order matters, don't play. 🫶

when run with "start" as the mode, drbdlinks will rename the existing files/directories, and then make symbolic links into the DRBD partition. "stop" does the reverse. simple as that. 💫

mode "checklinks" will report any links that do not exist in the destination area. during initial setup and configuration, this can help check that you have the destination file-system set up with the required components. it's the vibe check for your links. 🔍

if run with "initialize_shared_storage", destination links specified in the configuration file will be populated from the source storage. this is useful for initial setup to populate the shared storage. preceding paths will be populated if they share the same name from source to destination. populating the shared storage from scratch, we love a fresh start. 🌱

the "monitor" and "status" modes will check the file-system against the configuration file and will report "running" (monitor mode) or "OK" (status mode) if all links appear to be up. otherwise they report "down" or "stopped" (respectively). she's either thriving or she's not, no in between. 😭

by default, the rename appends .drbdlinks to the name, but this can be overridden in the configuration file. customize her. 💅

the "list" mode just show the list of links, with each line showing the link, destination, and a 0/1 flag for bindMount status. this may be useful for user scripts without having to parse the configuration. for the script girlies who don't wanna parse anything. 🤖

an init script is included which runs "stop" before heartbeat starts, and after heartbeat stops. this is done to try to ensure that when the shared partition isn't mounted, the links are in their normal state. protective queen behavior honestly. 🛡️

---

✨ OPTIONS ✨

drbdlinks has several options, using either short or long variants. pick your fave, both slay.

• -h, --help — print a short help message describing the available options and exit. the classic "help me bestie" move. 🙈
• -c, --config-file=CONFIGFILE — specify an alternate config file. the default config file is /etc/drbdlinks.conf. alternate config files should have a "drbdlinks-" prefix, e.g. "drbdlinks-httpd.conf". yes the prefix is required, it's the rules. 📋
• -s, --suffix=SUFFIX — name to append to the local file-system name when the link is in place. the default is "drbdlinks", which would result in a renamed file like /etc/httpd.drbdlinks. you can change her suffix, she won't mind. 🎀
• -v, --verbose — increase verbosity level by 1 for every occurrence of this option. stack it, stack it, stack it. 🗣️

---

🌈 EXAMPLES 🌈

here are a few examples of how drbdlinks can be used. come get your demo, bestie.

the most straight-forward, and default, method for starting drbdlinks:

drbdlinks start

to use a suffix different from the default when linking to a file or directory, the -s option can be used, specifying the desired string:

drbdlinks -s orig start

would rename the file-system name to "name.orig".

increase the verbosity to assist in debugging:

drbdlinks -v -v start

use an alternate configuration file, possibly from with a DRBD mounted file-system:

drbdlinks -c /shared1/drbdlinks-httpd.conf start

this would use the specified configuration file, found on our DRBD device mounted on /shared1. this would allow us to easily keep drbdlinks configurations tied to a specific set of data on a DRBD disk in an active/active sort of HA configuration. keeping the config and the data together, that's a power couple. 💞

---

🦋 SEE ALSO 🦋

DRBD(8), drbdadm(8), drbdsetup(8), heartbeat(8).

---

👑 AUTHOR 👑

drbdlinks was written by Sean Reifschneider <jafo@tummy.com>. legend behavior. 🫶

this manual page was written by Cyril Bouthors <cyril@bouthors.org>, for the Debian project (but may be used by others). Sean Reifschneider modified it for status and monitor arguments, and included it in the base drbdlinks release. Mike Loseke <mike@tummy.com> added the sections on options and examples. collab of the century, no notes. 🌟

---

and that's the whole page bestie, you ate that. this was the version from September 3, 2008, part of the System Manager's Manual on the DRBDLINKS(8) page. go forth and link responsibly. 💖✨