ganeti-noded(8)

📦
version 3.1.0~rc2 · 4 versions
, in debian trixie, ubuntu questing, ubuntu resolute

💖 ganeti-noded(8) — the Ganeti node daemon 💖

okay bestie, gather round, because this is the page for ganeti-noded, straight out of the Ganeti manual, version 3.1.0~rc2. it's the little daemon that runs on every node and does, like, everything. let's get into it ✨

🌸 SYNOPSIS 🌸

ganeti-noded [-f] [-d] [-p PORT] [-b ADDRESS] [-i INTERFACE]
[--max-clients CLIENTS] [--no-mlock] [--syslog] [--no-ssl]
[-K SSL_KEY_FILE] [-C SSL_CERT_FILE]

🦋 DESCRIPTION 🦋

so ganeti-noded is the daemon that handles all the node-level functions in the Ganeti system. it's the one holding it down on each node, fr fr.

here's the tea: by default, ganeti-noded locks itself into RAM using mlockall(2). why? because it wants to be able to do stuff like node powercycling even on systems where the root disk is absolutely cooked. iconic resilience behavior. if you don't want that, pass --no-mlock to the daemon and it'll chill.

if you're just testing, give it the -f option and the program won't detach from the running terminal — it stays right there with you, main character energy, not leaving the chat. 🫶

want debug-level messages? hit it with -d. that's it, that's the whole vibe.

logging to syslog instead of its own log file? enable that with --syslog. yes bestie, we love a flexible logger. 💅

now the networking bit, listen up: the ganeti-noded daemon listens on port 1811 TCP, on all interfaces, by default. you can override that port with an entry in the services database (usually /etc/services) or by passing the -p option. the -b option lets you specify the address to bind to (and it defaults to 0.0.0.0, no cap). alternatively, the -i option lets you specify the interface to bind do.

(yes the original really says "bind do", and honestly? we respect it, we're leaving it exactly as it is 😭)

the maximum number of simultaneous client connections is configurable with the --max-clients option, and it defaults to 20. important detail though: connections above that count are still accepted, but no responses get sent until enough connections are closed. so it's not a hard rejection, it's more like... the queue. the waiting room. the "we'll get to you when we get to you" energy.

Ganeti noded communication is protected via SSL, with a key generated at cluster init time. you can turn that off with --no-ssl, or you can point it at a different SSL key and certificate using the -K and -C options. 🔐

👑 ROLE 👑

the role of the node daemon is to do basically almost all the actions that change the state of the node. think: creating disks for instances, activating disks, starting and stopping instances, and so on — all of that goes through the node daemon. it's the one doing the actual work, lowkey carrying the whole operation.

also, in some cases the startup/shutdown of the master daemon is done via the node daemon, and the cluster IP address is also added/removed to the master node via it. so yeah, it's involved in the master's business too.

now, real talk: if the node daemon is stopped, the instances are not affected. your instances are fine. but the master won't be able to talk to that node. so like... everything still runs, but the master is left on read. 💀

📡 COMMUNICATION PROTOCOL 📡

currently the master-node RPC is done using a simple RPC protocol built using JSON over HTTP(S). simple, clean, no drama. ✨

😭 REPORTING BUGS 😭

found a bug? report it to the project's issue tracker, or contact the developers using the Ganeti mailing list. they want to hear from you, bestie.

🔥 SEE ALSO 🔥

Ganeti overview and specifications:

Ganeti commands:

Ganeti daemons:

Ganeti htools:

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, babe 🎀 this was ganeti-noded(8) from the Ganeti manual, version 3.1.0~rc2. go forth and daemon responsibly. mwah 💋💖

📦 where this page comes from