watch-multiple-mimedefangs(8)

1WATCH-MULTIPLE-MIMDEFANGS(8)System Manager's ManualWATCH-MULTIPLE-MIMDEFANGS(8)
2
3
4

NAME

6       watch-multiple-mimdefangs.tcl  - Keep an eye on a cluster of MIMEDefang
7       machines
8

SYNOPSIS

10       watch-multiple-mimdefangs.tcl  [-archive]   machine-1   machine-2   ...
11       machine-N
12
13

DESCRIPTION

15       watch-multiple-mimdefangs.tcl  is a Tk script that graphically displays
16       the status of mimedefang-multiplexor(8) on a cluster of machines.  Note
17       that  Tcl/Tk  8.4  or  higher  is required to run watch-multiple-mimde‐
18       fangs.tcl.
19
20       If you supply the -archive command-line  option,  then  watch-multiple-
21       mimdefangs.tcl  logs the output of md-mx-ctrl rawload for each machine.
22       The output for machine_name is logged in:
23
24       $HOME/.watch-multiple-mimedefangs/machine_name/data.
25
26

PREREQUISITES

28       To use watch-multiple-mimdefangs.tcl to monitor a cluster of  machines,
29       you need the following prerequisites:
30
31
32       o      A  UNIX-like machine with Tcl/Tk 8.4, the X window system and an
33              SSH client.  You also need "xterm" to use some of the features.
34
35
36       o      The ability to SSH as root to all of the machines  you  want  to
37              monitor.  Ideally, you should be using the SSH agent so that you
38              can SSH to the monitored machines as root without being prompted
39              for a password or pass phrase.
40
41
42       o      The  program  md-mx-ctrl  on root's path on all the machines you
43              want to monitor.
44
45

DISPLAY

47       For each machine specified on the command  line,  watch-multiple-mimde‐
48       fangs.tcl creates a chart with five columns.  The columns are:
49
50
51       o      A button with the name of the machine.  Clicking the button pops
52              up a menu that lets  you  take  various  actions,  as  described
53              later.   If all slaves on the machine are busy, the button turns
54              yellow.
55
56
57       o      A  label  showing  the  number  of  busy  slaves  in  the   form
58              "busy/total", where total is the total number of slaves.
59
60
61       o      A  label  showing the average number of messages per second over
62              the last 10 seconds.
63
64
65       o      A label showing the average number of milliseconds per scan over
66              the last 10 seconds.
67
68
69       o      A chart that graphs the average number of busy slaves, the aver‐
70              age number of messages per second and the average scan  time  in
71              milliseconds, all averaged over the last 10 seconds.
72
73

MACHINE MENU

75       If you click on a machine name, a menu with three options pops up:
76
77
78       SSH    Open an xterm session and ssh as root to the machine.
79
80
81       Busy Slaves
82              Monitor  the  busy  slaves  on the machine.  If you click on the
83              process-ID of a slave, an xterm will open  up  and  the  command
84              "strace  -s  100  -t  -p  pid"  will  be  executed on the remote
85              machine.  This is Linux-specific, but you can edit  watch-multi‐
86              ple-mimdefangs.tcl  to  replace the command with your particular
87              system's command for tracing system calls.
88
89
90       Delete Remove the machine from the list of machines being monitored.
91
92

ADDING A MACHINE

94       If you need to add a machine to the display, simply type  the  name  of
95       the machine in the "Add Machine:" box and press Enter.
96
97

AUTHOR

99       watch-multiple-mimdefangs.tcl was written by David F. Skoll.
100
101