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 [-n] [-r] [-s] [-t] [-archive]  machine-1
11       machine-2 ... 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       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

PREREQUISITES

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

DISPLAY

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

MACHINE MENU

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

ADDING A MACHINE

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

AUTHOR

108       watch-multiple-mimdefangs.tcl was written by Dianne Skoll.
109
110