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<<EM>time</EM>></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>
|