ENADIS.CGI(8)

📦 version 4.3.30, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 ENADIS.CGI(8) — the group chat guide to your fave little CGI 💅

okay bestie, buckle up, because enadis.cgi is genuinely one of the most useful little gremlins in the whole System Manager's Manual and I need you to be obsessed with it like I am. ✨

✨ NAME ✨

enadis.cgi — a CGI program that enables and disables Xymon tests. that's it. that's the whole vibe. 🎀

🦋 SYNOPSIS 🦋

enadis.cgi (invoked via CGI from webserver)

like she doesn't take arguments from you directly, she gets invoked by the webserver. main character energy fr fr. 💖

🌈 DESCRIPTION 🌈

so enadis.cgi is a CGI tool for disabling and enabling hosts and tests monitored by Xymon. no cap, that's her whole thing. and she's flexible too: you can disable monitoring of

  • a single test,
  • all tests for a host,
  • or multiple hosts,

and you can do it immediately or at a future point in time. the scheduling?? iconic. 🗓️✨

she runs as a CGI program, invoked by your webserver. normally she's run via a wrapper shell-script in the secured CGI directory for Xymon. iykyk. 🐚

and here's the part that matters: enadis.cgi is the back-end script for the enable/disable form that lives on the "info" status-pages. she can also run in "stand-alone" mode, and in that case she displays a web form letting users select what to enable or disable. so she's both the back-end AND the front-facing queen. multitasking, we love to see it. 👑

💅 OPTIONS 💅

  • --no-cookies — normally, enadis.cgi uses a cookie sent by the browser to initially filter the list of hosts presented. if that's not the vibe for you, you can turn this behaviour off by calling acknowledge.cgi with the --no-cookies option. (yes, bestie, that is literally what it says, i'm just the messenger 🫶) this would normally be placed in the CGI_ENADIS_OPTS setting in cgioptions.cfg(5).
  • --env=FILENAME — load the environment from FILENAME before executing the CGI. like a lil pre-game ritual. 🍓
  • --area=NAME — load environment variables for a specific area. NB: if used, this option must appear before any --env=FILENAME option. order matters, bestie, don't test her. 😭

🎀 FILES 🎀

  • $XYMONHOME/web/maint_{header,form,footer} — HTML template header

💀 BUGS 💀

okay so this is the part where she's not perfect and we have to be honest: when using alternate pagesets, hosts will only show up on the Enable/Disable page if this is accessed from the primary page in which they are defined. so if you have hosts on multiple pages, they will only be visible for disabling from their main page — which is, and i quote, "not what you would expect." 💀 not me getting jump-scared by this behaviour. anyway. forewarned is forearmed. 🙈

🌟 SEE ALSO 🌟

and that's the whole page, bestie!! you understood the assignment 🫶

this lil love letter was brought to you by Xymon, Version 4.3.30: 4 Sep 2019. slay, bye 💖✨🎀

📦 where this page comes from