Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
WATCH-MULTIPLE-MIMDEFANGS(8)System Manager's ManuaWATCH-MULTIPLE-MIMDEFANGS(8)

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.  Note
       that  Tcl/Tk  8.4  or  higher  is required to run watch-multiple-mimde-
       fangs.tcl.

       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.

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

       The  -n,	 -r,  -s, and -t options enable	monitoring of scan times, fil-
       ter_relay times,	filter_sender times and	 filter_recipient  times,  re-
       spectively.

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

       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/to-
	      tal", 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  av-
	      erage number of messages per second and the average scan time in
	      milliseconds, 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  ma-
	      chine.  This is Linux-specific, but you can edit watch-multiple-
	      mimdefangs.tcl to	replace	the command with your particular  sys-
	      tem'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-mimdefangs.tcl was written by Dianne Skoll.

SEE ALSO
       mimedefang.pl(8), mimedefang-filter(5), mimedefang(8),  mimedefang-pro-
       tocol(7), md-mx-ctrl(8),	watch-mimedefang(8)

4th Berkeley Distribution	12 January 2007	  WATCH-MULTIPLE-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://www.freebsd.org/cgi/man.cgi?query=watch-multiple-mimedefangs&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help