docs/diploma

annotate docs/masqmail.cx/install.html @ 1:7b2a5fe2aedd

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