FreeBSD Manual Pages
WATCH-MULT...-MIMDEFANGS(8) System Manager's Manual WATCH-MULT...-MIMDEFANGS(8) NAME watch-multiple-mimdefangs.tcl - Keep an eye on a cluster of MIMEDefang ma- chines SYNOPSIS watch-multiple-mimdefangs.tcl [-n] [-r] [-s] [-t] [-archive] machine-1 ma- chine-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. Note that Tcl/Tk 8.4 or higher is required to run watch-multiple-mimdefangs.tcl. If you supply the -archive command-line option, then watch-multiple-mimde- fangs.tcl logs the output of md-mx-ctrl rawload for each machine. The out- put for machine_name is logged in: $HOME/.watch-multiple-mimedefangs/machine_name/data. If you supply any of -n, -r, -s or -t options, then watch-multiple-mimde- fangs.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!. The -n, -r, -s, and -t options enable monitoring of scan times, filter_re- lay times, filter_sender times and filter_recipient times, respectively. PREREQUISITES To use watch-multiple-mimdefangs.tcl to monitor a cluster of machines, you need the following prerequisites: o 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. o The ability to SSH as root to all of the machines you want to moni- tor. Ideally, you should be using the SSH agent so that you can SSH to the monitored machines as root without being prompted for a pass- word or pass phrase. o 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-mimde- fangs.tcl creates a chart with five columns. The columns are: o 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. o A label showing the number of busy workers in the form "busy/total", where total is the total number of workers. o A label showing the average number of messages per second over the last 10 seconds. o A label showing the average number of milliseconds per scan over the last 10 seconds. o A chart that graphs the average number of busy workers, the average number of messages per second and the average scan time in millisec- onds, all averaged over the last 10 seconds. 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-mimde- fangs.tcl to replace the command with your particular system's com- mand 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-mimdefangs.tcl was written by Dianne Skoll. SEE ALSO mimedefang.pl(8), mimedefang-filter(5), mimedefang(8), mimedefang-proto- col(7), md-mx-ctrl(8), watch-mimedefang(8) 4th Berkeley Distribution 12 January 2007 WATCH-MULT...-MIMDEFANGS(8)
NAME | SYNOPSIS | DESCRIPTION | PREREQUISITES | DISPLAY | MACHINE MENU | ADDING A MACHINE | AUTHOR | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=watch-multiple-mimedefangs&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>