masqmail

diff docs/old-manual/install.html @ 56:f6a6f55b7b9e

added old manual from the old website it is dated May/July 2000
author meillo@marmaro.de
date Sat, 29 May 2010 21:51:13 +0200
parents
children
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/docs/old-manual/install.html	Sat May 29 21:51:13 2010 +0200
     1.3 @@ -0,0 +1,219 @@
     1.4 +
     1.5 +
     1.6 +
     1.7 +
     1.8 +
     1.9 +
    1.10 +
    1.11 +
    1.12 +<HTML>
    1.13 +<HEAD>
    1.14 +<TITLE>MasqMail - Manual
    1.15 +</TITLE>
    1.16 +</HEAD>
    1.17 +  <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
    1.18 +    
    1.19 +    <center>
    1.20 +      <table width="80%">
    1.21 +	<tr><td>
    1.22 +	    <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
    1.23 +<tr>
    1.24 +  <td>
    1.25 +  <a href="manual.html">
    1.26 +    <img width="20" src = "../images/u_arrow.gif" alt = "manual">
    1.27 +  </a>
    1.28 +  </td>
    1.29 +<td align=center width="100%"><font size="6" color = "#ffffff">Installation</font></td>
    1.30 +<td>
    1.31 +  <a href="./options.html">
    1.32 +    <img width="20" src = "../images/r_arrow.gif" alt = "Options">
    1.33 +  </a>
    1.34 +</td>
    1.35 +</tr>
    1.36 +</table>
    1.37 +
    1.38 +
    1.39 +<p>You need a user and a group for masqmail to run, I suggest user
    1.40 +'mail' and group 'trusted'. Say:</p>
    1.41 +
    1.42 +<pre>
    1.43 +groupadd -g 42 trusted
    1.44 +useradd -u 42 -g 42 -d / -s /bin/sh -c "Mail Transfer Agent" mail
    1.45 +</pre>
    1.46 +
    1.47 +<p>If you use other names than <i>mail</i> and <i>trusted</i> use the options
    1.48 +described below for configure. The 42 is just a suggestion, you can
    1.49 +use any number you like, but preferably one &lt; 100. It does not have
    1.50 +to be the same for the user 'mail' and the group 'trusted'.</p>
    1.51 +
    1.52 +<p>Compliling is a matter of the usual procedure:</p>
    1.53 +
    1.54 +In the source directory, after unpacking do:<br>
    1.55 +
    1.56 +<pre>
    1.57 +./configure
    1.58 +make
    1.59 +make install
    1.60 +</pre>
    1.61 +
    1.62 +<p>Optionally, after you have called make, you can make some tests in
    1.63 +the tests directory. Read the README in that directory for
    1.64 +instructions.</p>
    1.65 +
    1.66 +<h4>Additional options for configure:</h4>
    1.67 +
    1.68 +<p>
    1.69 +<b>--with-user=USER</b> sets the user as which MasqMail will run. Default is
    1.70 +<i>mail</i>. USER has to exist before you 'make install'.
    1.71 +</p><p>
    1.72 +<b>--with-group=GROUP</b> sets the group as which MasqMail will run. Default
    1.73 +is <i>trusted</i>. GROUP has to exist before you 'make install'.
    1.74 +</p><p>
    1.75 +<b>--with-logdir=LOGDIR</b> sets the directory where MasqMail stores its log
    1.76 +files. It will be created if it does not exist. Default is /var/masqmail/.
    1.77 +</p><p>
    1.78 +<b>--with-spooldir=SPOOLDIR</b> sets the directory where MasqMail stores its
    1.79 +spool files. It will be created if it does not exist. Default is
    1.80 +/var/spool/masqmail/.
    1.81 +</p><p>
    1.82 +<b>--enable-auth</b> enables ESMTP AUTH support (disabled by default)
    1.83 +</p><p>
    1.84 +<b>--disable-pop3</b> disables pop3 support (enabled by default)
    1.85 +</p>
    1.86 +
    1.87 +<h4>After make install</h4>
    1.88 +
    1.89 +<p>
    1.90 +You can also use these instructions to omit 'make install' if you do
    1.91 +not want to use it.
    1.92 +</p><p>
    1.93 +Check that 'make install' worked correctly. The following command:
    1.94 +</p><p><pre>
    1.95 +ls -ld /usr/sbin/masqmail /var/masqmail/ /var/spool/masqmail /var/spool/masqmail/input
    1.96 +</pre></p><p>
    1.97 +should give output similar to
    1.98 +</p><p>
    1.99 +<pre>
   1.100 +-rwsr-xr-x   1 root     root        86955 Oct 14 14:27 /usr/sbin/masqmail
   1.101 +drwxr-xr-x   2 mail     trusted      1024 Oct 14 14:29 /var/masqmail/
   1.102 +drwxr-xr-x   3 mail     trusted      1024 Oct 14 14:27 /var/spool/masqmail
   1.103 +drwxr-xr-x   2 mail     trusted      1024 Oct 14 18:32 /var/spool/masqmail/input
   1.104 +drwxr-xr-x   2 mail     trusted      1024 Oct 14 18:32 /var/spool/masqmail/popuidl
   1.105 +</pre>
   1.106 +</p>
   1.107 +<p>
   1.108 +(important is the set-user-id bit for /usr/sbin/masqmail and the
   1.109 +ownership of all items).
   1.110 +</p>
   1.111 +
   1.112 +<p>Edit the configuration files. You can use the files from the
   1.113 +examples directory as a template. Copy masqmail.conf to
   1.114 +/etc/maqmail.conf, the others to the location given in
   1.115 +masqmail.conf.</p>
   1.116 +
   1.117 +<p>If you already have an MTA (eg. sendmail) installed, move that to
   1.118 +another location:</p>
   1.119 +
   1.120 +mv /usr/sbin/sendmail /usr/sbin/sendmail.orig<br>
   1.121 +
   1.122 +<p>Then make a link to the new MTA:</p>
   1.123 +
   1.124 +<pre>
   1.125 +ln -s /usr/sbin/masqmail /usr/sbin/sendmail
   1.126 +</pre>
   1.127 +
   1.128 +<p>Now every mailer that used to call sendmail will now call
   1.129 +masqmail. You can now kill your old sendmail if it is running and
   1.130 +start masqmail. Usually this is done with the startup scripts. For
   1.131 +SuSE this would be (as root):</p>
   1.132 +
   1.133 +<pre>
   1.134 +/sbin/init.d/sendmail stop
   1.135 +/sbin/init.d/sendmail start
   1.136 +</pre>
   1.137 +
   1.138 +<p>or shorter:</p>
   1.139 +
   1.140 +<pre>
   1.141 +/sbin/init.d/sendmail restart<br>
   1.142 +</pre>
   1.143 +
   1.144 +<p>You can also start it with:</p>
   1.145 +
   1.146 +<pre>
   1.147 +/usr/sbin/sendmail -bd -q30m<br>
   1.148 +</pre>
   1.149 +
   1.150 +<p>You can also let it be called from inetd (with the -bs option), but
   1.151 +this is untested.</p>
   1.152 +
   1.153 +<h4>Configuring for online delivery</h4>
   1.154 +
   1.155 +<p>Now you have to set up the online configuration. The trick is to
   1.156 +tell your ip-up script the connection name. You could use the IP
   1.157 +number of the far side of the ppp link, but this is a pain and may
   1.158 +change each time. But you can give it an additional argument via pppd
   1.159 +with ipparam. Somewhere in your dial up script you have a line similar
   1.160 +to:</p>
   1.161 +
   1.162 +<pre>
   1.163 +/usr/sbin/pppd /dev/ttyS1 connect "/usr/sbin/chat -t 90 -f
   1.164 +${CHATFILE}" -d -d -d user user@somewhere file ${OPTIONS}
   1.165 +</pre>
   1.166 +
   1.167 +<p>Just add 'ipparam FastNet' in the command line for pppd if your ISP
   1.168 +has the name FastNet. The ip-up script will then get 'FastNet' as a
   1.169 +sixth parameter. In your ip-up script you can then call masqmail with</p>
   1.170 +
   1.171 +<pre>
   1.172 +/usr/sbin/masqmail -qo $6
   1.173 +</pre>
   1.174 +
   1.175 +<p>instead of 'sendmail -q', if you had that in the script
   1.176 +before. Masqmail will then read the route configuration specified for
   1.177 +the connection name 'FastNet' and deliver the mail destined to the
   1.178 +internet. See the <a href="config.html">configuration manual</a> on how
   1.179 +to write a route configuration or use one of the examples as a
   1.180 +template. <em>I do not know how do configure that for an ISDN adapter,
   1.181 +but I am sure you will find something similar in the man
   1.182 +pages.</em></p>
   1.183 +
   1.184 +<p>If you want mail that is received by masqmail from your local
   1.185 +net to be delivered immediately using the route configuration, you
   1.186 +have two possibilities:<p>
   1.187 +
   1.188 +<p> 
   1.189 +<ul>
   1.190 +
   1.191 +<li>if you are using the masqdialer system, you just have to set the
   1.192 +variables <b>online_detect</b> to <i>mserver</i> and
   1.193 +<b>mserver_iface</b> to the interface mserver is listening to.</li>
   1.194 +
   1.195 +<li>otherwise you have to add two commands in your ip-up script:<br>
   1.196 +echo -n $6 &gt; /tmp/connect_route<br> chmod 644 /tmp/connect_route<br>
   1.197 +and you have to remove the file <i>/tmp/connect_route</i> in your
   1.198 +ip-down script:<br> rm /tmp/connect_route.<br> Then you have to set
   1.199 +<b>online_detect</b> to <i>file</i> and <b>online_file</b> to
   1.200 +<i>/tmp/connect_route</i>.  </li>
   1.201 +
   1.202 +</ul>
   1.203 +</p>
   1.204 +
   1.205 +<p>See the route documentation for more.</p>
   1.206 +	  </td></tr>
   1.207 +    
   1.208 +	<tr><td>
   1.209 +	    <p>
   1.210 +	    <hr>
   1.211 +	    <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address>
   1.212 +	    Last modified: Tue May 30 15:19:56 CEST 2000
   1.213 +	    <br>
   1.214 +	    This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6
   1.215 +	  </p>
   1.216 +    
   1.217 +      </table>
   1.218 +    </center>
   1.219 +
   1.220 +  </BODY>
   1.221 +</HEAD>
   1.222 +