Debug: fix transport-wait DB message. Bug 3082
[exim.git] / configs / config.samples / S002
1 From: John Jetmore <jetmore@cinergycom.com>
2 Date: Wed, 24 Sep 2003 13:12:58 -0500 (CDT)
3
4 I'm sure that everyone who's interested in something like this has already
5 come up with their own way to do this, but here's my solution:
6
7 When I moved from smail to exim I built a program that took individual
8 config pieces stripped all the comments and built a config file.  As a
9 bonus, it also runs exim -C <testfile> -bV on the new file and reports any
10 config errors before copying it over the old config.  In addition to just
11 being familiar in general w/ all the files being broken up according to
12 their major categories, I also got the benfit of being able to have config
13 pieces that were easily updatable (just replace the whole file and rebuild
14 the configure file).
15
16 The script has some site-specific stuff hard coded, but it's easily
17 fixable.  Essentially in my exim configd I have a directory called
18 subconfigure, which can contain directories named \d\d.\w+.  Mine
19 currently contains:
20 10.general/  30.routers/     50.retry/    70.authenticators/
21 20.acls/     40.transports/  60.rewrite/  80.local_scan/
22
23 Each of these directories can contain files in the form \d\d.\w+.  For
24 instance, my 30.routers contains:
25 00.begin              80.l_user_delivery_normal   _50.l_mx
26 10.r_forcepaths       _12.r_static_route_junk     _60.l_psp
27 15.r_stalemail        _17.r_internal_route        _72.l_aliases_list
28 33.r_mailrtrd_router  _20.r_conditionalforce      _74.l_aliases_isp
29 40.r_standard         _31.r_mailrtrd_bypass_spam  _76.l_aliases_mer
30 70.l_aliases          _39.r_smarthost             _80.l_user_delivery_isp
31
32 those files prefixed by "_" will not be used to build the live configure
33 file.  They are "turned off".  This allows me to keep a general list of
34 configure pieces that are easily updatable but not necessarily every rule
35 is used on every machine.  Not every file contains a single router - for
36 instance 60.l_psp is our virtual hosting solution and contains 10 routers.
37 They're just grouped by logical role.
38
39 All of these sub pieces are built in to the configure file w/ a shell
40 script called mkconfigure, inline below.  Again, my assumption is that
41 anyone who wants a system like this built it for themselves, but it
42 would be kind of fun to flesh this script out to be more generic.
43 Maybe post it and some samples on a webpage.  Or no one responds to this
44 and I shut up about it =).
45
46 This system is way overkill for some people (for instance, my home machine
47 uses a single configure file because I don't do that much special with
48 it), but it's useful in a larger system role.
49
50 --John
51
52 mkconfigure:
53
54 #!/bin/ksh
55
56 # I have found that our custom set up of exim's configure file is overly
57 # confusing.  To help alleviate this, I have broken the file out into its
58 # core pieces (general, tansports, directors, routers, retry, rewrite, and
59 # authentication), and then each of those into logical sub-pieces (SIS,
60 # for instance.  This program is to take all of those sub pieces and put
61 # them back together into the file that exim understands.
62
63 # No one should every touch the 'configure' file from now on, one should
64 # instead manipulate the files in the subconfigure directory and run this
65 # program
66
67 # jetmore 20011119
68
69 EXIMD=$1
70 CONFIGSUFF=$2
71
72 if [ "X$EXIMD" == "X" ] ; then
73   EXIMD=/local/exim
74 fi
75 if [ ! -d "$EXIMD" ] ; then
76   echo "$EXIMD is not a directory" >&2
77   exit 1
78 fi
79 ETCD=$EXIMD/etc
80 SUBCD=$ETCD/subconfigure$CONFIGSUFF
81 CONFIGF=$ETCD/configure$CONFIGSUFF
82
83 if [ ! -d $SUBCD ] ; then
84   echo "$SUBCD is not a directory" >&2
85   exit 1
86 fi
87
88 GREP=/bin/grep
89
90 # initialize the temporary config file in case some trash got left around
91 cat /dev/null > $CONFIGF.t
92
93 # print the banner to the temp config file
94 echo                                                             >> $CONFIGF.t
95 echo "#########################################################" >> $CONFIGF.t
96 echo "# DO NOT DIRECTLY MANIPULATE THIS FILE                   " >> $CONFIGF.t
97 echo "#                                                        " >> $CONFIGF.t
98 echo "# if you need to make configuration change, do so in     " >> $CONFIGF.t
99 echo "# $SUBCD and run the mkconfigure"                          >> $CONFIGF.t
100 echo "# command.  Changes made to this file will be lost       " >> $CONFIGF.t
101 echo "#                                                        " >> $CONFIGF.t
102 echo "# See jetmore w/ questions                               " >> $CONFIGF.t
103 echo "#########################################################" >> $CONFIGF.t
104 echo                                                             >> $CONFIGF.t
105
106 # get the major categories
107 for CAT in $SUBCD/[0-9]*
108 do
109     # print which category we're in
110     echo                                                         >> $CONFIGF.t
111     echo "## major category $CAT"                                >> $CONFIGF.t
112     echo                                                         >> $CONFIGF.t
113
114     # get the subcategories
115     for SUBCAT in $CAT/[0-9]*
116     do
117         # print which sub category we're in
118         echo "## sub category $SUBCAT"                           >> $CONFIGF.t
119         echo                                                     >> $CONFIGF.t
120
121         # place the contents of any non-comment line into the configure file
122         $GREP -v "^ *#" $SUBCAT                                  >> $CONFIGF.t
123         echo                                                     >> $CONFIGF.t
124     done
125 done
126
127 # check and make sure there aren't any typos in the new config file
128 $EXIMD/bin/exim -C $CONFIGF.t -bV > $CONFIGF.test 2>&1
129 if [ "$?" -eq "1" ] ; then
130     #/bin/rm $CONFIGF.t
131     echo
132     echo "There is a problem with the configure file.  "
133     echo "moving paniclog to paniclog.mkfail"
134     echo "$CONFIGF.test has details:"
135     echo
136     echo #####################################################################
137     cat $CONFIGF.test
138     echo #####################################################################
139     echo
140     echo "$CONFIGF not changed!"
141     /bin/mv -f /log/exim/paniclog /log/exim/paniclog.mkfail
142     exit 1
143 fi
144 /bin/rm $CONFIGF.test
145
146 /bin/mv $CONFIGF.t $CONFIGF
147 echo "$CONFIGF updated successfully."
148 echo "Don't forget to HUP the mail daemon"
149 exit 0
150