ganeti-wconfd(8)

💅 ganeti-wconfd — the manual page, but make it cute

okay bestie, sit down, hydrate, because we're talking about ganeti-wconfd from Ganeti Version 3.1.0~rc2, and she is the main character of your cluster's config. ✨

---

✨ NAME ✨

ganeti-wconfd — the Ganeti configuration writing daemon 🎀

like. the config writer. the one with the pen. the moment. 👑

---

🌸 SYNOPSIS 🌸

ganeti-wcond [-f] [-d] [--syslog] [--no-user-checks] [--no-voting
--yes-do-it] [--force-node]

ngl the synopsis says ganeti-wcond with no f and we are keeping it exactly like that, no cap, don't @ me, that's what the page says 💀

---

💖 DESCRIPTION 💖

so. ganeti-wconfd is the daemon that has authoritative knowledge about the configuration and is the only entity that can accept changes to it. the only one. everyone else has to ask her nicely. it's giving queen bee and honestly? deserved. 👑

every single job that needs to modify the configuration does it by sending appropriate requests to this daemon. no sneaking in through the back window, bestie. requests only. 🦋

for testing purposes, you can give the -f option and the program won't detach from the running terminal. she'll just... stay. right there. in your terminal. with you. 💅

debug-level messages can be activated by giving the -d option. 🔍

logging to syslog, rather than its own log file, can be enabled by passing in the --syslog option. 📝

the ganeti-wconfd daemon listens on a Unix socket at /var/run/ganeti/socket/ganeti-query, on which it accepts all requests in an internal protocol format, used by Ganeti jobs. ✨

the daemon will refuse to start if the user and group do not match the one defined at build time — this behaviour can be overridden by the --no-user-checks option. 😤

the daemon will also refuse to start if it cannot verify that the majority of cluster nodes believes that it is running on the master node. to allow failover in a two-node cluster, this can be overridden by the --no-voting option. 🗳️

⚠️ but because this is dangerous, the --yes-do-it option has to be given as well. yes, you have to say yes. consent is key. 🫶

also, if the option --force-node is given, it will accept to run on a non-master node. it should not be necessary to give this option manually, but gnt-cluster masterfailover will use it internally to start the daemon in order to update the master-node information in the configuration. 🔥

---

🙈 REPORTING BUGS 🙈

report bugs to the project's issue tracker or contact the developers using the Ganeti mailing list. they're nice, fr fr. 💜

---

🌈 SEE ALSO 🌈

Ganeti overview and specifications:

• ganeti(7) — general overview
• ganeti-os-interface(7) — guest OS definitions
• ganeti-extstorage-interface(7) — external storage providers

Ganeti commands:

• gnt-cluster(8) — cluster-wide commands
• gnt-job(8) — job-related commands
• gnt-node(8) — node-related commands
• gnt-instance(8) — instance commands
• gnt-os(8) — guest OS commands
• gnt-storage(8) — storage commands
• gnt-group(8) — node group commands
• gnt-backup(8) — instance import/export commands
• gnt-debug(8) — debug commands

Ganeti daemons:

• ganeti-watcher(8) — automatic instance restarter
• ganeti-cleaner(8) — job queue cleaner
• ganeti-noded(8) — node daemon
• ganeti-rapi(8) — remote API daemon

Ganeti htools:

• htools(1) — generic binary
• hbal(1) — cluster balancer
• hspace(1) — capacity calculation
• hail(1) — IAllocator plugin
• hscan(1) — data gatherer from remote clusters
• hinfo(1) — cluster information printer
• mon-collector(7) — data collectors interface

---

👑 COPYRIGHT 👑

Copyright (C) 2006-2015 Google Inc. All rights reserved.

redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

🫶 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

---

and that's the whole page, bestie 🦋 this was Ganeti, ganeti-wconfd(8), Version 3.1.0~rc2 — go update your master node's config info responsibly, mwah 💋✨