XYMONNET-AGAIN.SH(1)

💖 NAME 💖

xymonnet-again.sh — the Xymon network re-test tool, aka your fave lil retry gremlin 🦋

✨ SYNOPSIS ✨

xymonnet-again.sh

No flags, no args, no drama. She just runs. Periodt. 💅

🌸 DESCRIPTION 🌸

okay so bestie, xymonnet-again.sh is an extension script for Xymon that lives on the network test server. What she does is genuinely iconic: she picks up all the failing network tests that the xymonnet(1) program ran, and she re-runs them on a faster test cycle than the normal xymonnet schedule. 👑

Why do we care? Because the way that a server recovers and the network service comes back online, she notices it so much quicker — which means less reported downtime. It's giving "she's already on it" energy, fr fr. ✨

⚠️ but here's the limit, no cap: only tests whose first failure occurred within 30 minutes get included in the tests that xymonnet-again.sh runs.

The 30 minute limit is there for a very real reason — it stops hosts that are down for long periods of time from bogging down xymonnet-again.sh. Like, she's fast, but she's not trying to carry the whole network on her back. 😭

If you wanna change that limit, you can do it with the --frequenttestlimit=SECONDS option when you run xyxmonnet. 🎀

🛠️ INSTALLATION 🛠️

This script runs by default from your tasks.cfg(5) file. That's it, that's the setup. Lowkey the easiest install ever. 🫶

🍓 FILES 🍓

• $XYMONTMP/TESTNAME.LOCATION.status — a temporary status file managed by xyxmonnet, holding the status of tests that have currently failed. 💀
• $XYMONTMP/frequenttests.LOCATION — a temporary file managed by xymonnet with the hostnames that xymonnet-again.sh should test. 📋

👀 SEE ALSO 👀

xymonnet(1), xymon(7), tasks.cfg(5)

okay that's the whole page, bestie!! go forth and let the network heal itself faster 💜

this was the Xymon manual, General Commands Manual vibes, Version 4.3.30: 4 Sep 2019 — mwah, slay, bye!! 💅✨🎀