1WATCH-MULTIPLE-MIMDEFANGS(8)System Manager's ManualWATCH-MULTIPLE-MIMDEFANGS(8)
2
3
4
6 watch-multiple-mimdefangs.tcl - Keep an eye on a cluster of MIMEDefang
7 machines
8
10 watch-multiple-mimdefangs.tcl [-n] [-r] [-s] [-t] [-archive] machine-1
11 machine-2 ... machine-N
12
13
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 If you supply any of -n, -r, -s or -t options, then watch-multiple-
27 mimdefangs.tcl uses the rawload1 command rather than rawload command to
28 read performance data. Do not use these options unless all monitored
29 machines are running MIMEDefang 2.74 or newer!.
30
31 The -n, -r, -s, and -t options enable monitoring of scan times, fil‐
32 ter_relay times, filter_sender times and filter_recipient times,
33 respectively.
34
35
37 To use watch-multiple-mimdefangs.tcl to monitor a cluster of machines,
38 you need the following prerequisites:
39
40
41 o A UNIX-like machine with Tcl/Tk 8.4, the X window system and an
42 SSH client. You also need "xterm" to use some of the features.
43
44
45 o The ability to SSH as root to all of the machines you want to
46 monitor. Ideally, you should be using the SSH agent so that you
47 can SSH to the monitored machines as root without being prompted
48 for a password or pass phrase.
49
50
51 o The program md-mx-ctrl on root's path on all the machines you
52 want to monitor.
53
54
56 For each machine specified on the command line, watch-multiple-mimde‐
57 fangs.tcl creates a chart with five columns. The columns are:
58
59
60 o A button with the name of the machine. Clicking the button pops
61 up a menu that lets you take various actions, as described
62 later. If all workers on the machine are busy, the button turns
63 yellow.
64
65
66 o A label showing the number of busy workers in the form
67 "busy/total", where total is the total number of workers.
68
69
70 o A label showing the average number of messages per second over
71 the last 10 seconds.
72
73
74 o A label showing the average number of milliseconds per scan over
75 the last 10 seconds.
76
77
78 o A chart that graphs the average number of busy workers, the
79 average number of messages per second and the average scan time
80 in milliseconds, all averaged over the last 10 seconds.
81
82
84 If you click on a machine name, a menu with three options pops up:
85
86
87 SSH Open an xterm session and ssh as root to the machine.
88
89
90 Busy Workers
91 Monitor the busy workers on the machine. If you click on the
92 process-ID of a worker, an xterm will open up and the command
93 "strace -s 100 -t -p pid" will be executed on the remote
94 machine. This is Linux-specific, but you can edit watch-multi‐
95 ple-mimdefangs.tcl to replace the command with your particular
96 system's command for tracing system calls.
97
98
99 Delete Remove the machine from the list of machines being monitored.
100
101
103 If you need to add a machine to the display, simply type the name of
104 the machine in the "Add Machine:" box and press Enter.
105
106
108 watch-multiple-mimdefangs.tcl was written by Dianne Skoll.
109
110
112 mimedefang.pl(8), mimedefang-filter(5), mimedefang(8), mimedefang-pro‐
113 tocol(7), md-mx-ctrl(8), watch-mimedefang(8)
114
115
116
117
118
1194th Berkeley Distribution 12 January 2007 WATCH-MULTIPLE-MIMDEFANGS(8)