CDIST-TYPE__XYMON_CLIENT(7)

✨ cdist-type__xymon_client ✨

okay bestie, welcome to the cdist manual page for cdist-type__xymon_client 💖 this is one of those cdist type pages, section 7 of the manual, and it's about getting your little Xymon client all set up and reporting home. no cap, it's short, it's sweet, it's giving "install and vibe" 🦋

---

🌸 NAME 🌸

cdist-type__xymon_client — install the Xymon client 💅

---

🎀 DESCRIPTION 🎀

so this cdist type installs the Xymon client and configures it to report with FQDN. that's the whole assignment. it shows up, it installs, it makes sure your client is reporting using its fully qualified domain name, and then it goes back to being iconic 👑

---

⭐ REQUIRED PARAMETERS ⭐

None. zero. nothing. you don't have to give it anything, bestie 🫶 it's a no-argument-needed situation, which honestly? slay.

---

✨ OPTIONAL PARAMETERS ✨

• state — takes 'present' or 'absent', and it defaults to 'present'. so if you say nothing, you're getting a present Xymon client. if you want it gone gone, hit it with 'absent' 💀
• servers — one or more IP addresses (space separated, so you can list several 🍓) of the Xymon server(s) you want to report to. now listen: DNS names are okay, but it's discouraged, okay? like, technically allowed, but don't make it weird. defaults to 127.0.0.1 🌈

---

💜 BOOLEAN PARAMETERS 💜

• msgcache — enable the xymon msgcache. 🐝

⚠️ heads up bestie: XYMONSERVER has to be 127.0.0.1 for using msgcache (see msgcache (8) of the xymon documentation for details). don't skip this one, it's a real requirement, not a suggestion 🙈

---

🔥 EXAMPLES 🔥

okay so here's how you actually use it, copy-paste these, they're verbatim, no notes:

# minimal, report to 127.0.0.1
__xymon_client

# specify server:
__xymon_client --servers "192.168.1.1"

# activate `msgcache` for passive client:
__xymon_client --msgcache

that's it. that's the whole thing. minimal? done. one specific server? done. passive client with msgcache? done and dusted ✨

---

🦋 SEE ALSO 🦋

• cdist__xymon_server(7)
• xymon(7)
• msgcache(8)

go read those if you want the full lore, iykyk 📚

---

👑 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

---

and that's the page, bestie!! this was cdist-type__xymon_client, version 7.0.0, dated Jul 31, 2022, from the cdist corner of the manual. go forth, install your client, report with FQDN, and be the main character of your own infrastructure 💅✨ mwah 🎀