WATCH-MULT...-MIMDEFANGS(8)

📦 version 3.7.1, in debian bookworm, debian trixie, epel 10, epel 9, fedora 43, fedora 44, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 WATCH-MULT...-MIMDEFANGS(8) 💖

okay bestie, so you've got a whole cluster of MIMEDefang machines and you're just supposed to... vibe? no. no ma'am. this is watch-multiple-mimdefangs.tcl, a page from the System Manager's Manual, and it's here to give your little cluster of chaos a whole dashboard moment. 🦋

✨ NAME ✨

watch-multiple-mimdefangs.tcl — keep an eye on a cluster of MIMEDefang machines 👀

🌸 SYNOPSIS 🌸

watch-multiple-mimdefangs.tcl [-n] [-r] [-s] [-t] [-archive] machine-1
machine-2 ... machine-N

💅 DESCRIPTION 💅

watch-multiple-mimdefangs.tcl is a Tk script that graphically displays the status of mimedefang-multiplexor(8) on a cluster of machines. and like. it's pretty. it's giving monitoring but make it fashion. ✨

not me reminding you that Tcl/Tk 8.4 or higher is required to run watch-multiple-mimdefangs.tcl. no cap, older Tcl/Tk will simply not eat. 💀

If you supply the -archive command-line option, then watch-multiple-mimdefangs.tcl logs the output of md-mx-ctrl rawload for each machine. The output for machine_name is logged in:

$HOME/.watch-multiple-mimedefangs/machine_name/data

so cute, so organized, we love a filesystem moment. 🎀

If you supply any of -n, -r, -s or -t options, then watch-multiple-mimdefangs.tcl uses the rawload1 command rather than rawload command to read performance data.

🚨 Do not use these options unless all monitored machines are running MIMEDefang 2.74 or newer! 🚨 fr fr, this is not a drill, check your versions first bestie.

The -n, -r, -s, and -t options enable monitoring of scan times, filter_relay times, filter_sender times and filter_recipient times, respectively. one option per vibe check, iconic behavior honestly. 👑

🌈 PREREQUISITES 🌈

To use watch-multiple-mimdefangs.tcl to monitor a cluster of machines, you need the following prerequisites:

  • A UNIX-like machine with Tcl/Tk 8.4, the X window system and an SSH client. You also need "xterm" to use some of the features.
  • The ability to SSH as root to all of the machines you want to monitor. Ideally, you should be using the SSH agent so that you can SSH to the monitored machines as root without being prompted for a password or pass phrase. (typing passwords manually? in THIS economy? 🙈)
  • The program md-mx-ctrl on root's path on all the machines you want to monitor.

🎀 DISPLAY 🎀

For each machine specified on the command line, watch-multiple-mimdefangs.tcl creates a chart with five columns. The columns are:

  • A button with the name of the machine. Clicking the button pops up a menu that lets you take various actions, as described later. If all workers on the machine are busy, the button turns yellow. 💛
  • A label showing the number of busy workers in the form "busy/total", where total is the total number of workers.
  • A label showing the average number of messages per second over the last 10 seconds.
  • A label showing the average number of milliseconds per scan over the last 10 seconds.
  • A chart that graphs the average number of busy workers, the average number of messages per second and the average scan time in milliseconds, all averaged over the last 10 seconds. 📈✨

five columns of pure main character energy. slay.

💜 MACHINE MENU 💜

If you click on a machine name, a menu with three options pops up:

  • SSH — Open an xterm session and ssh as root to the machine.
  • Busy Workers — Monitor the busy workers on the machine. If you click on the process-ID of a worker, an xterm will open up and the command strace -s 100 -t -p pid will be executed on the remote machine. This is Linux-specific, but you can edit watch-multiple-mimdefangs.tcl to replace the command with your particular system's command for tracing system calls. 🧚
  • Delete — Remove the machine from the list of machines being monitored. bye bestie, it's not you it's the cluster. 😭

🫶 ADDING A MACHINE 🫶

If you need to add a machine to the display, simply type the name of the machine in the "Add Machine:" box and press Enter. that's it. that's the whole move. easy. 💅

👑 AUTHOR 👑

watch-multiple-mimdefangs.tcl was written by Dianne Skoll. queen behavior, we stan. 🌟

⭐ SEE ALSO ⭐

mimedefang.pl(8), mimedefang-filter(5), mimedefang(8), mimedefang-protocol(7), md-mx-ctrl(8), watch-mimedefang(8)

go read those too, iykyk 📚

okay that's the whole page bestie!! 💖✨ this little legend comes to you from the 4th Berkeley Distribution, dated 12 January 2007 — yeah, it's vintage, it's giving retro-tech, and it still ate. mwah. 💋🦋🌸

📦 where this page comes from