CDIST-TYPE__XYMON_SERVER(7)

💖 cdist-type__xymon_server 💖

okay bestie, gather round, because this is the manual page for cdist-type__xymon_server — part of the cdist fam, section 7 of the manual. it installs a whole Xymon server for you and it's genuinely iconic. let's get into it 🫶

---

✨ NAME ✨

cdist-type__xymon_server — Install a Xymon server 👑

---

🌸 DESCRIPTION 🌸

so this cdist type installs a Xymon server (their site is https://www.xymon.com/, go look, it's giving monitoring royalty) plus — if you want — the helper packages it needs. 💅

the Xymon client comes along as a dependency, so NO NEED to install __xymon_client separately. it's already in the bag, bestie, we got you. 🎀

now, to actually access the webinterface you're gonna need a webserver. that's where __xymon_apache comes in — that cdist-type installs and configures the apache webserver for use with Xymon. ✨

and for the further, day-to-day configuration of Xymon, you've got options: you can do it manually in /etc/xymon/, or you can let that directory be deployed and managed by __xymon_config. dealer's choice, no cap. 🦋

---

💜 REQUIRED PARAMETERS 💜

None.

like, literally none. zero. not a single one. go off, we love a low-maintenance type. 😌

---

🌈 OPTIONAL PARAMETERS 🌈

• state — takes 'present' or 'absent', and defaults to 'present'. oh and heads up: if you specify --install_helpers together with 'absent', the helper packages will be un-installed. so that combo actually does something, bestie. 💀

---

⭐ BOOLEAN PARAMETERS ⭐

• install_helpers — installs the helper packages that Xymon uses: fping, heirloom-mailx, traceroute, ntpdate. that's the whole squad right there. 🔥

---

🦋 EXAMPLES 🦋

here's where it gets fun, fr fr:

# minmal
__xymon_server

# the same
__xymon_server --state present

# also install helper packages:
__xymon_server --install_helpers

# examples to give a more complete picture: __xymon_server installed on
# `xymon.example.com` w/ IP 192.168.1.1:
#
# install webserver and grant 2 private subnets access to the webinterface:
__xymon_apache --ipacl "192.168.0.0/16 10.0.0.0/8"
# deploy server-configuration with __xymon_config:
__xymon_config --confdir=xymon.example.com

# install xymon-client on other machines (not needed on the server):
__xymon_client --servers "192.168.1.1"

(yes, minmal is spelled like that in the original — we're keeping it exactly as-is, periodt. 💖)

---

🧚 SEE ALSO 🧚

• cdist__xymon_apache(7)
• cdist__xymon_config(7)
• cdist__xymon_client(7)
• xymon(7)

---

👑 AUTHORS 👑

Thomas Eckert <tom--@--it-eckert.de>

---

💅 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.

---

🌸 COPYRIGHT 🌸

ungleich GmbH 2021

---

k that's the whole page, bestie. go install a Xymon server and be the main character of your monitoring infra. 🫶

mwah 💋 this was cdist version 7.0.0, dated Jul 31, 2022, page CDIST-TYPE__XYMON_SERVER(7) — ty for coming to my ted talk, ily, bye ✨