File: spec_52.html

package info (click to toggle)
exim-html 3.20-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k, sarge, woody
  • size: 2,868 kB
  • ctags: 4,188
  • sloc: makefile: 40; sh: 19
file content (174 lines) | stat: -rw-r--r-- 6,404 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<HTML>
<HEAD>
<!-- This HTML file has been created by texi2html 1.52
     from spec on 25 November 2000 -->

<TITLE>Exim Specification - 52. Day-to-day management</TITLE>
</HEAD>
<body bgcolor="#FFFFFF" text="#00005A" link="#FF6600" alink="#FF9933" vlink="#990000">
Go to the <A HREF="spec_1.html">first</A>, <A HREF="spec_51.html">previous</A>, <A HREF="spec_53.html">next</A>, <A HREF="spec_59.html">last</A> section, <A HREF="spec_toc.html">table of contents</A>.
<P><HR><P>


<H1><A NAME="SEC864" HREF="spec_toc.html#TOC864">52. Day-to-day management</A></H1>
<P>
This chapter describes some of the regular tasks that need to be done to keep
Exim running smoothly.

</P>

<P>



<H2><A NAME="SEC865" HREF="spec_toc.html#TOC865">52.1 The panic log</A></H2>

<P>
When certain disasters occur, Exim writes entries to its panic log. These are
often copied to the main log as well, but can get lost amid the mass of other
entries. The panic log should be empty under normal circumstances. It is
therefore a good idea to check it (or to have a <EM>cron</EM> script check it)
regularly, in order to become aware of any problems.

</P>



<H2><A NAME="SEC866" HREF="spec_toc.html#TOC866">52.2 The reject log</A></H2>

<P>
<A NAME="IDX1912"></A>
If checking of sender addresses on incoming mail is enabled, the headers of
rejected messages are written to the reject log. Other policy rejections also
cause entries in this log, which should be regularly inspected to ensure that
the checking is working properly, and to pick up errors such as missing DNS
entries.

</P>



<H2><A NAME="SEC867" HREF="spec_toc.html#TOC867">52.3 Log cycling</A></H2>

<P>
<A NAME="IDX1913"></A>
The <EM>exicyclog</EM> script (see chapter 53) cycles the names of log files,
compresses all but the most recent, and deletes the oldest. This should be run
at intervals dependent on the amount of mail traffic. For a system with a
reasonable amount of mail, running it daily via <EM>cron</EM> is suggested.

</P>



<H2><A NAME="SEC868" HREF="spec_toc.html#TOC868">52.4 Statistics</A></H2>

<P>
The <EM>eximstats</EM> script (see chapter 53) produces statistics about
messages received and delivered, by analysing log files.

</P>



<H2><A NAME="SEC869" HREF="spec_toc.html#TOC869">52.5 What is Exim doing?</A></H2>

<P>
<A NAME="IDX1914"></A>
<A NAME="IDX1915"></A>
<A NAME="IDX1916"></A>
On systems that can restart a system call after receiving a signal, Exim
responds to the SIGUSR1 signal by writing a line describing what it is
doing to
the file <EM>exim-process.info</EM> in its spool directory.
The <EM>exiwhat</EM> script (see chapter 53) sends the signal to all Exim
processes it can find, having first emptied the
file.
It then waits for one second to allow the Exim processes to react before
displaying the results. In order to run <EM>exiwhat</EM> successfully you have to have
sufficient privilege to send the signal to the Exim processes, so it is
normally run as root.

</P>
<P>
When the number of processes handling incoming SMTP calls is limited by setting
the
<A NAME="IDX1917"></A>
<EM>smtp_accept_max</EM> option, the daemon uses the SIGCHLD signal to
detect when any of its subprocesses finishes. On some operating systems
this signal sometimes gets lost when the system is very busy.
However, Exim's daemon cleans up subprocesses every time it wakes up, so even
if SIGCHLD doesn't happen, the completion of subprocesses should
eventually get noticed.

</P>


<H2><A NAME="SEC870" HREF="spec_toc.html#TOC870">52.6 Changing the configuration</A></H2>

<P>
<A NAME="IDX1918"></A>
<A NAME="IDX1919"></A>
<A NAME="IDX1920"></A>
A changed configuration file is picked up immediately by any Exim processes
that are subsequently started, and by any existing process that re-execs Exim,
but it will not be noticed by any existing processes. The daemon process can be
caused to restart itself by sending it the SIGHUP signal, which should also
be sent when a new version of the Exim binary is installed. Restarting causes
its process id to change.
<A NAME="IDX1921"></A>
<A NAME="IDX1922"></A>
The current process id is written to a file whose name depends on the type of
daemon being run. By default, the file is written in Exim's spool directory,
but a compile-time configuration of PID_FILE_PATH can be used to cause it
to be placed elsewhere. When the daemon is both listening for incoming SMTP on
the standard port and periodically starting queue runner processes, the file is
called <EM>exim-daemon.pid</EM>. If it is doing only one of these things, the option
that started it (either -<EM>bd</EM> or -<EM>q&#60;<EM>time</EM>&#62;</EM>) is added to the file name. It is
not necessary to use SIGHUP when changing the contents of any files
referred to in the configuration (for example, alias files) since each delivery
process reads such files independently.

</P>



<H2><A NAME="SEC871" HREF="spec_toc.html#TOC871">52.7 Watching the queue</A></H2>

<P>
The queue of messages awaiting delivery can be examined by running the Exim
monitor (see chapter 54), or by obeying <EM>exim -bp</EM> (or its
variants) periodically. The <EM>exiqsumm</EM> utility script can be called to obtain a
summary of the waiting messages for each domain, sorted by domain, age, or
message count.

</P>
<P>
<A NAME="IDX1923"></A>
If any messages are frozen, their header files and message log files should be
examined to determine the cause of the problem. Once the problem is believed to
be fixed, the messages can be unfrozen by the administrator, who can also kick
off an immediate delivery attempt, and also change recipient and sender
addresses if necessary.
<font color=green>
There are a number of command line options whose names begin with -<EM>M</EM> for
doing these things, and they can also be done from the Exim monitor.
</font>

</P>


<H2><A NAME="SEC872" HREF="spec_toc.html#TOC872">52.8 Holding domains</A></H2>

<P>
The option <EM>hold_domains</EM> allows mail for particular domains to be held on the
queue manually. This option is intended as a temporary operational measure
for delaying the delivery of mail while some problem is being sorted out, or
some new configuration tested.

</P>

<P><HR><P>
Go to the <A HREF="spec_1.html">first</A>, <A HREF="spec_51.html">previous</A>, <A HREF="spec_53.html">next</A>, <A HREF="spec_59.html">last</A> section, <A HREF="spec_toc.html">table of contents</A>.
</BODY>
</HTML>