XYMONCLIENT.CFG(5)

💖 XYMONCLIENT.CFG — xymonclient.cfg 💖

okay bestie, gather round, because this is the file that tells your Xymon client who it is and where it's going 🦋 it's a page from the File Formats Manual, and honestly? it's giving backstage pass. let's get into it.

✨ NAME ✨

xymonclient.cfg — the Xymon client environment variables, aka the group chat settings file for your whole client setup 💅

🌸 DESCRIPTION 🌸

so. Xymon programs don't just use the normal set of environment variables — they've got their own extra little stash too 👑 and for the Xymon client, all those environment definitions live in the file ~xymon/client/etc/xymonclient.cfg.

every single line in this file looks like:

NAME=VALUE

and that one line defines one environment variable called NAME with the value VALUE. simple. iconic. no cap. ✨

🎀 SETTINGS 🎀

these are the big ones, the main character variables fr fr:

• XYMSRV — the IP-address used to contact the Xymon server. Default: chosen back when the Xymon client was compiled. so like, it was decided for you at build time, periodt 💀
• XYMSERVERS — a whole list of IP-addresses of Xymon servers 💖 your data gets sent to all of the servers listed here. important caveat tho: this setting is only used if XYMSRV=0.0.0.0. iykyk.
• XYMONDPORT — the port number used to contact the Xymon server. Default: 1984.
• XYMONHOME — the Xymon client top-level directory. Default: the $XYMONCLIENTHOME setting inherited from the "runclient.sh" script which starts the Xymon client 🫶
• XYMONCLIENTLOGS — the directory for the Xymon clients' own log files. Default: $XYMONHOME/logs 📝
• XYMONTMP — the directory used for temporary files. Default: $XYMONHOME/tmp/ 🗂️
• XYMON — full path to the xymon(1) client program. Default: $XYMONHOME/bin/xymon.

⭐ Commands ⭐

lots of extension scripts expect a whole series of environment variables to point at various system utilities 🌈 and these get included in the file when the client is built. so they're just... there. preloaded. slay.

🧚 INHERITED SETTINGS 🧚

some environment variables are inherited from the "runclient.sh" script which launches the Xymon client — like, they're not really defined here, they're handed down, and the file just knows about them:

• MACHINEDOTS — the hostname of the local system. Default: taken from "uname -n".
• MACHINE — the hostname of the local system, but with the dots replaced by commas 🦋 For compatibility with Big Brother extension scripts.
• SERVEROSTYPE — the operating system of the local system, in lowercase. Default: taken from "uname -s".
• XYMONCLIENTHOME — the top-level directory for the Xymon client. Default: the location of the "runclient.sh" script.

💜 SEE ALSO 💜

• xymon(7)

and that's the whole vibe check bestie, you ate that 🍓💅

Xymon — Version 4.3.30: 4 Sep 2019 — mwah, kisses, go configure something beautiful 💖✨🎀