NAME

watch-multiple-mailmunges.tcl - Keep an eye on a cluster of Mailmunge machines

SYNOPSIS

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

DESCRIPTION

watch-multiple-mailmunges.tcl is a Tk script that graphically displays the status of mailmunge-multiplexor on a cluster of machines. Note that Tcl/Tk 8.4 or higher is required to run watch-multiple-mailmunges.tcl.

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

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

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

The -n, -r, -s, and -t options enable monitoring of scan times, filter_relay times, filter_sender times and filter_recipient times, respectively.

PREREQUISITES

To use watch-multiple-mailmunges.tcl to monitor a cluster of machines, you must have 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.
The program mm-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-mailmunges.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.

Underneath the button is a label that reads something like:
```
v=VER m=MTA
```
where VER is the version of Mailmunge running on the remote machine and MTA is the MTA that was detected (either Sendmail or Postfix).
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.

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-mailmunges.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.

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.

AUTHOR

watch-multiple-mailmunges.tcl was written by Dianne Skoll.

LICENSE

This code is licensed under the terms of the GNU General Public License, version 2.