masqmail-0.2

annotate docs/old-manual/install.html @ 170:0f0e4e7cd762

find changesets by author, revision, files, or words in the commit message
added misc/list-versions This script helps to check if the versions numbers in the project are the same as the one for the release. This script is motivated by the 0.2.27 release in which masqmail introduces itself as being version 0.2.26.
author meillo@marmaro.de
date Mon, 19 Jul 2010 14:01:13 +0200
parents
children
rev   line source
meillo@56 1
meillo@56 2
meillo@56 3
meillo@56 4
meillo@56 5
meillo@56 6
meillo@56 7
meillo@56 8
meillo@56 9 <HTML>
meillo@56 10 <HEAD>
meillo@56 11 <TITLE>MasqMail - Manual
meillo@56 12 </TITLE>
meillo@56 13 </HEAD>
meillo@56 14 <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
meillo@56 15
meillo@56 16 <center>
meillo@56 17 <table width="80%">
meillo@56 18 <tr><td>
meillo@56 19 <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
meillo@56 20 <tr>
meillo@56 21 <td>
meillo@56 22 <a href="manual.html">
meillo@56 23 <img width="20" src = "../images/u_arrow.gif" alt = "manual">
meillo@56 24 </a>
meillo@56 25 </td>
meillo@56 26 <td align=center width="100%"><font size="6" color = "#ffffff">Installation</font></td>
meillo@56 27 <td>
meillo@56 28 <a href="./options.html">
meillo@56 29 <img width="20" src = "../images/r_arrow.gif" alt = "Options">
meillo@56 30 </a>
meillo@56 31 </td>
meillo@56 32 </tr>
meillo@56 33 </table>
meillo@56 34
meillo@56 35
meillo@56 36 <p>You need a user and a group for masqmail to run, I suggest user
meillo@56 37 'mail' and group 'trusted'. Say:</p>
meillo@56 38
meillo@56 39 <pre>
meillo@56 40 groupadd -g 42 trusted
meillo@56 41 useradd -u 42 -g 42 -d / -s /bin/sh -c "Mail Transfer Agent" mail
meillo@56 42 </pre>
meillo@56 43
meillo@56 44 <p>If you use other names than <i>mail</i> and <i>trusted</i> use the options
meillo@56 45 described below for configure. The 42 is just a suggestion, you can
meillo@56 46 use any number you like, but preferably one &lt; 100. It does not have
meillo@56 47 to be the same for the user 'mail' and the group 'trusted'.</p>
meillo@56 48
meillo@56 49 <p>Compliling is a matter of the usual procedure:</p>
meillo@56 50
meillo@56 51 In the source directory, after unpacking do:<br>
meillo@56 52
meillo@56 53 <pre>
meillo@56 54 ./configure
meillo@56 55 make
meillo@56 56 make install
meillo@56 57 </pre>
meillo@56 58
meillo@56 59 <p>Optionally, after you have called make, you can make some tests in
meillo@56 60 the tests directory. Read the README in that directory for
meillo@56 61 instructions.</p>
meillo@56 62
meillo@56 63 <h4>Additional options for configure:</h4>
meillo@56 64
meillo@56 65 <p>
meillo@56 66 <b>--with-user=USER</b> sets the user as which MasqMail will run. Default is
meillo@56 67 <i>mail</i>. USER has to exist before you 'make install'.
meillo@56 68 </p><p>
meillo@56 69 <b>--with-group=GROUP</b> sets the group as which MasqMail will run. Default
meillo@56 70 is <i>trusted</i>. GROUP has to exist before you 'make install'.
meillo@56 71 </p><p>
meillo@56 72 <b>--with-logdir=LOGDIR</b> sets the directory where MasqMail stores its log
meillo@56 73 files. It will be created if it does not exist. Default is /var/masqmail/.
meillo@56 74 </p><p>
meillo@56 75 <b>--with-spooldir=SPOOLDIR</b> sets the directory where MasqMail stores its
meillo@56 76 spool files. It will be created if it does not exist. Default is
meillo@56 77 /var/spool/masqmail/.
meillo@56 78 </p><p>
meillo@56 79 <b>--enable-auth</b> enables ESMTP AUTH support (disabled by default)
meillo@56 80 </p><p>
meillo@56 81 <b>--disable-pop3</b> disables pop3 support (enabled by default)
meillo@56 82 </p>
meillo@56 83
meillo@56 84 <h4>After make install</h4>
meillo@56 85
meillo@56 86 <p>
meillo@56 87 You can also use these instructions to omit 'make install' if you do
meillo@56 88 not want to use it.
meillo@56 89 </p><p>
meillo@56 90 Check that 'make install' worked correctly. The following command:
meillo@56 91 </p><p><pre>
meillo@56 92 ls -ld /usr/sbin/masqmail /var/masqmail/ /var/spool/masqmail /var/spool/masqmail/input
meillo@56 93 </pre></p><p>
meillo@56 94 should give output similar to
meillo@56 95 </p><p>
meillo@56 96 <pre>
meillo@56 97 -rwsr-xr-x 1 root root 86955 Oct 14 14:27 /usr/sbin/masqmail
meillo@56 98 drwxr-xr-x 2 mail trusted 1024 Oct 14 14:29 /var/masqmail/
meillo@56 99 drwxr-xr-x 3 mail trusted 1024 Oct 14 14:27 /var/spool/masqmail
meillo@56 100 drwxr-xr-x 2 mail trusted 1024 Oct 14 18:32 /var/spool/masqmail/input
meillo@56 101 drwxr-xr-x 2 mail trusted 1024 Oct 14 18:32 /var/spool/masqmail/popuidl
meillo@56 102 </pre>
meillo@56 103 </p>
meillo@56 104 <p>
meillo@56 105 (important is the set-user-id bit for /usr/sbin/masqmail and the
meillo@56 106 ownership of all items).
meillo@56 107 </p>
meillo@56 108
meillo@56 109 <p>Edit the configuration files. You can use the files from the
meillo@56 110 examples directory as a template. Copy masqmail.conf to
meillo@56 111 /etc/maqmail.conf, the others to the location given in
meillo@56 112 masqmail.conf.</p>
meillo@56 113
meillo@56 114 <p>If you already have an MTA (eg. sendmail) installed, move that to
meillo@56 115 another location:</p>
meillo@56 116
meillo@56 117 mv /usr/sbin/sendmail /usr/sbin/sendmail.orig<br>
meillo@56 118
meillo@56 119 <p>Then make a link to the new MTA:</p>
meillo@56 120
meillo@56 121 <pre>
meillo@56 122 ln -s /usr/sbin/masqmail /usr/sbin/sendmail
meillo@56 123 </pre>
meillo@56 124
meillo@56 125 <p>Now every mailer that used to call sendmail will now call
meillo@56 126 masqmail. You can now kill your old sendmail if it is running and
meillo@56 127 start masqmail. Usually this is done with the startup scripts. For
meillo@56 128 SuSE this would be (as root):</p>
meillo@56 129
meillo@56 130 <pre>
meillo@56 131 /sbin/init.d/sendmail stop
meillo@56 132 /sbin/init.d/sendmail start
meillo@56 133 </pre>
meillo@56 134
meillo@56 135 <p>or shorter:</p>
meillo@56 136
meillo@56 137 <pre>
meillo@56 138 /sbin/init.d/sendmail restart<br>
meillo@56 139 </pre>
meillo@56 140
meillo@56 141 <p>You can also start it with:</p>
meillo@56 142
meillo@56 143 <pre>
meillo@56 144 /usr/sbin/sendmail -bd -q30m<br>
meillo@56 145 </pre>
meillo@56 146
meillo@56 147 <p>You can also let it be called from inetd (with the -bs option), but
meillo@56 148 this is untested.</p>
meillo@56 149
meillo@56 150 <h4>Configuring for online delivery</h4>
meillo@56 151
meillo@56 152 <p>Now you have to set up the online configuration. The trick is to
meillo@56 153 tell your ip-up script the connection name. You could use the IP
meillo@56 154 number of the far side of the ppp link, but this is a pain and may
meillo@56 155 change each time. But you can give it an additional argument via pppd
meillo@56 156 with ipparam. Somewhere in your dial up script you have a line similar
meillo@56 157 to:</p>
meillo@56 158
meillo@56 159 <pre>
meillo@56 160 /usr/sbin/pppd /dev/ttyS1 connect "/usr/sbin/chat -t 90 -f
meillo@56 161 ${CHATFILE}" -d -d -d user user@somewhere file ${OPTIONS}
meillo@56 162 </pre>
meillo@56 163
meillo@56 164 <p>Just add 'ipparam FastNet' in the command line for pppd if your ISP
meillo@56 165 has the name FastNet. The ip-up script will then get 'FastNet' as a
meillo@56 166 sixth parameter. In your ip-up script you can then call masqmail with</p>
meillo@56 167
meillo@56 168 <pre>
meillo@56 169 /usr/sbin/masqmail -qo $6
meillo@56 170 </pre>
meillo@56 171
meillo@56 172 <p>instead of 'sendmail -q', if you had that in the script
meillo@56 173 before. Masqmail will then read the route configuration specified for
meillo@56 174 the connection name 'FastNet' and deliver the mail destined to the
meillo@56 175 internet. See the <a href="config.html">configuration manual</a> on how
meillo@56 176 to write a route configuration or use one of the examples as a
meillo@56 177 template. <em>I do not know how do configure that for an ISDN adapter,
meillo@56 178 but I am sure you will find something similar in the man
meillo@56 179 pages.</em></p>
meillo@56 180
meillo@56 181 <p>If you want mail that is received by masqmail from your local
meillo@56 182 net to be delivered immediately using the route configuration, you
meillo@56 183 have two possibilities:<p>
meillo@56 184
meillo@56 185 <p>
meillo@56 186 <ul>
meillo@56 187
meillo@56 188 <li>if you are using the masqdialer system, you just have to set the
meillo@56 189 variables <b>online_detect</b> to <i>mserver</i> and
meillo@56 190 <b>mserver_iface</b> to the interface mserver is listening to.</li>
meillo@56 191
meillo@56 192 <li>otherwise you have to add two commands in your ip-up script:<br>
meillo@56 193 echo -n $6 &gt; /tmp/connect_route<br> chmod 644 /tmp/connect_route<br>
meillo@56 194 and you have to remove the file <i>/tmp/connect_route</i> in your
meillo@56 195 ip-down script:<br> rm /tmp/connect_route.<br> Then you have to set
meillo@56 196 <b>online_detect</b> to <i>file</i> and <b>online_file</b> to
meillo@56 197 <i>/tmp/connect_route</i>. </li>
meillo@56 198
meillo@56 199 </ul>
meillo@56 200 </p>
meillo@56 201
meillo@56 202 <p>See the route documentation for more.</p>
meillo@56 203 </td></tr>
meillo@56 204
meillo@56 205 <tr><td>
meillo@56 206 <p>
meillo@56 207 <hr>
meillo@56 208 <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address>
meillo@56 209 Last modified: Tue May 30 15:19:56 CEST 2000
meillo@56 210 <br>
meillo@56 211 This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6
meillo@56 212 </p>
meillo@56 213
meillo@56 214 </table>
meillo@56 215 </center>
meillo@56 216
meillo@56 217 </BODY>
meillo@56 218 </HEAD>
meillo@56 219