CDIST-TYPE__XYMON_CONFIG(7)

✨ NAME ✨

bestie, this is cdist-type__xymon_config — the cdist type that deploys a whole Xymon configuration-directory 💖

---

🦋 DESCRIPTION 🦋

okay so real talk: this cdist type yeets an entire Xymon configuration directory onto the host, straight from the files-dir. it does not play around.

it needs an already-installed Xymon server though — like, one deployed by __xymon_server, yk? it's giving "i can't do my thing unless you set up my thing" and honestly same.

⚠️ WARNING, and I mean this fr fr: this type _replaces_ the /etc/xymon/-directory! the previous contents is replaced/deleted! no take-backs, no undo, no "wait bestie i needed that" 😭💀

---

👑 REQUIRED PARAMETERS 👑

• confdir — the directory in ./files/ that contains the /etc/xymon/-content you wanna deploy. that's the one, that's the whole vibe 🎀

---

🌸 OPTIONAL PARAMETERS 🌸

• owner — passed as-is as --owner to __rsync. no thoughts, just vibes, forwarded directly 🫶
• group — passed as-is as --group to __rsync. same energy, also forwarded as-is 💅

---

🌈 OPTIONAL MULTIPLE PARAMETERS 🌈

• rsync-opts — identical to __rsync type, only ---options are supported ✨

---

🎀 REQUIRED FILES 🎀

the directory you named in confdir has to contain a valid xymon-configuration (/etc/xymon/) _plus_ the ext/-directory that normally resides in /usr/lib/xymon/server/. both. no skipping, bestie, it needs the whole set 🧚

---

🔥 EXAMPLES 🔥

__xymon_config --confdir=xymon.example.com
# this will replace /etc/xymon/ on the target host with
# the contents from __xymon_config/files/xymon.example.com/

## the same but set ownership to `xymon:xymon` and exclude
## the `netrc`-file:
__xymon_config --confdir=xymon.example.com \
   --owner xymon --group xymon \
   --rsync-opts "exclude=netrc"

periodt. first one is the bare-bones slay, second one is the same but with ownership set to xymon:xymon and the netrc-file excluded 💜

---

⭐ SEE ALSO ⭐

• cdist__xymon_server(7)
• cdist__rsync(7)
• xymon(7)

go read those too, iykyk 🌸

---

💜 AUTHORS 💜

Thomas Eckert <tom--@--it-eckert.de> — the icon, the legend, the main character who wrote this 🫶

---

💖 COPYING 💖

Copyright (C) 2018-2019 Thomas Eckert. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. that's the GPL doing its thing, no cap ✨

---

🌟 COPYRIGHT 🌟

ungleich GmbH 2021 👑

---

and that's the whole page bestie!! 🦋 this was version 7.0.0, dated Jul 31, 2022, living under CDIST-TYPE__XYMON_CONFIG(7) — mwah, iconic, go replace that config directory responsibly 💅💖