masqmail-0.2

annotate docs/old-manual/install.html @ 92:10d00e3235f2

find changesets by author, revision, files, or words in the commit message
updated docs (online_file, mserver_iface) - the default location of the online_file is /var/run/masqmail/masqmail-route - the online file can and should (!) end with a newline (this once was different) - marked the online detect method `mserver' as obsolete
author meillo@marmaro.de
date Mon, 21 Jun 2010 10:04:36 +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