meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: <HTML>
meillo@56: <HEAD>
meillo@56: <TITLE>MasqMail - Manual
meillo@56: </TITLE>
meillo@56: </HEAD>
meillo@56:   <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
meillo@56:     
meillo@56:     <center>
meillo@56:       <table width="80%">
meillo@56: 	<tr><td>
meillo@56: 	    <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
meillo@56: <tr>
meillo@56:   <td>
meillo@56:   <a href="manual.html">
meillo@56:     <img width="20" src = "../images/u_arrow.gif" alt = "manual">
meillo@56:   </a>
meillo@56:   </td>
meillo@56: <td align=center width="100%"><font size="6" color = "#ffffff">Installation</font></td>
meillo@56: <td>
meillo@56:   <a href="./options.html">
meillo@56:     <img width="20" src = "../images/r_arrow.gif" alt = "Options">
meillo@56:   </a>
meillo@56: </td>
meillo@56: </tr>
meillo@56: </table>
meillo@56: 
meillo@56: 
meillo@56: <p>You need a user and a group for masqmail to run, I suggest user
meillo@56: 'mail' and group 'trusted'. Say:</p>
meillo@56: 
meillo@56: <pre>
meillo@56: groupadd -g 42 trusted
meillo@56: useradd -u 42 -g 42 -d / -s /bin/sh -c "Mail Transfer Agent" mail
meillo@56: </pre>
meillo@56: 
meillo@56: <p>If you use other names than <i>mail</i> and <i>trusted</i> use the options
meillo@56: described below for configure. The 42 is just a suggestion, you can
meillo@56: use any number you like, but preferably one &lt; 100. It does not have
meillo@56: to be the same for the user 'mail' and the group 'trusted'.</p>
meillo@56: 
meillo@56: <p>Compliling is a matter of the usual procedure:</p>
meillo@56: 
meillo@56: In the source directory, after unpacking do:<br>
meillo@56: 
meillo@56: <pre>
meillo@56: ./configure
meillo@56: make
meillo@56: make install
meillo@56: </pre>
meillo@56: 
meillo@56: <p>Optionally, after you have called make, you can make some tests in
meillo@56: the tests directory. Read the README in that directory for
meillo@56: instructions.</p>
meillo@56: 
meillo@56: <h4>Additional options for configure:</h4>
meillo@56: 
meillo@56: <p>
meillo@56: <b>--with-user=USER</b> sets the user as which MasqMail will run. Default is
meillo@56: <i>mail</i>. USER has to exist before you 'make install'.
meillo@56: </p><p>
meillo@56: <b>--with-group=GROUP</b> sets the group as which MasqMail will run. Default
meillo@56: is <i>trusted</i>. GROUP has to exist before you 'make install'.
meillo@56: </p><p>
meillo@56: <b>--with-logdir=LOGDIR</b> sets the directory where MasqMail stores its log
meillo@56: files. It will be created if it does not exist. Default is /var/masqmail/.
meillo@56: </p><p>
meillo@56: <b>--with-spooldir=SPOOLDIR</b> sets the directory where MasqMail stores its
meillo@56: spool files. It will be created if it does not exist. Default is
meillo@56: /var/spool/masqmail/.
meillo@56: </p><p>
meillo@56: <b>--enable-auth</b> enables ESMTP AUTH support (disabled by default)
meillo@56: </p><p>
meillo@56: <b>--disable-pop3</b> disables pop3 support (enabled by default)
meillo@56: </p>
meillo@56: 
meillo@56: <h4>After make install</h4>
meillo@56: 
meillo@56: <p>
meillo@56: You can also use these instructions to omit 'make install' if you do
meillo@56: not want to use it.
meillo@56: </p><p>
meillo@56: Check that 'make install' worked correctly. The following command:
meillo@56: </p><p><pre>
meillo@56: ls -ld /usr/sbin/masqmail /var/masqmail/ /var/spool/masqmail /var/spool/masqmail/input
meillo@56: </pre></p><p>
meillo@56: should give output similar to
meillo@56: </p><p>
meillo@56: <pre>
meillo@56: -rwsr-xr-x   1 root     root        86955 Oct 14 14:27 /usr/sbin/masqmail
meillo@56: drwxr-xr-x   2 mail     trusted      1024 Oct 14 14:29 /var/masqmail/
meillo@56: drwxr-xr-x   3 mail     trusted      1024 Oct 14 14:27 /var/spool/masqmail
meillo@56: drwxr-xr-x   2 mail     trusted      1024 Oct 14 18:32 /var/spool/masqmail/input
meillo@56: drwxr-xr-x   2 mail     trusted      1024 Oct 14 18:32 /var/spool/masqmail/popuidl
meillo@56: </pre>
meillo@56: </p>
meillo@56: <p>
meillo@56: (important is the set-user-id bit for /usr/sbin/masqmail and the
meillo@56: ownership of all items).
meillo@56: </p>
meillo@56: 
meillo@56: <p>Edit the configuration files. You can use the files from the
meillo@56: examples directory as a template. Copy masqmail.conf to
meillo@56: /etc/maqmail.conf, the others to the location given in
meillo@56: masqmail.conf.</p>
meillo@56: 
meillo@56: <p>If you already have an MTA (eg. sendmail) installed, move that to
meillo@56: another location:</p>
meillo@56: 
meillo@56: mv /usr/sbin/sendmail /usr/sbin/sendmail.orig<br>
meillo@56: 
meillo@56: <p>Then make a link to the new MTA:</p>
meillo@56: 
meillo@56: <pre>
meillo@56: ln -s /usr/sbin/masqmail /usr/sbin/sendmail
meillo@56: </pre>
meillo@56: 
meillo@56: <p>Now every mailer that used to call sendmail will now call
meillo@56: masqmail. You can now kill your old sendmail if it is running and
meillo@56: start masqmail. Usually this is done with the startup scripts. For
meillo@56: SuSE this would be (as root):</p>
meillo@56: 
meillo@56: <pre>
meillo@56: /sbin/init.d/sendmail stop
meillo@56: /sbin/init.d/sendmail start
meillo@56: </pre>
meillo@56: 
meillo@56: <p>or shorter:</p>
meillo@56: 
meillo@56: <pre>
meillo@56: /sbin/init.d/sendmail restart<br>
meillo@56: </pre>
meillo@56: 
meillo@56: <p>You can also start it with:</p>
meillo@56: 
meillo@56: <pre>
meillo@56: /usr/sbin/sendmail -bd -q30m<br>
meillo@56: </pre>
meillo@56: 
meillo@56: <p>You can also let it be called from inetd (with the -bs option), but
meillo@56: this is untested.</p>
meillo@56: 
meillo@56: <h4>Configuring for online delivery</h4>
meillo@56: 
meillo@56: <p>Now you have to set up the online configuration. The trick is to
meillo@56: tell your ip-up script the connection name. You could use the IP
meillo@56: number of the far side of the ppp link, but this is a pain and may
meillo@56: change each time. But you can give it an additional argument via pppd
meillo@56: with ipparam. Somewhere in your dial up script you have a line similar
meillo@56: to:</p>
meillo@56: 
meillo@56: <pre>
meillo@56: /usr/sbin/pppd /dev/ttyS1 connect "/usr/sbin/chat -t 90 -f
meillo@56: ${CHATFILE}" -d -d -d user user@somewhere file ${OPTIONS}
meillo@56: </pre>
meillo@56: 
meillo@56: <p>Just add 'ipparam FastNet' in the command line for pppd if your ISP
meillo@56: has the name FastNet. The ip-up script will then get 'FastNet' as a
meillo@56: sixth parameter. In your ip-up script you can then call masqmail with</p>
meillo@56: 
meillo@56: <pre>
meillo@56: /usr/sbin/masqmail -qo $6
meillo@56: </pre>
meillo@56: 
meillo@56: <p>instead of 'sendmail -q', if you had that in the script
meillo@56: before. Masqmail will then read the route configuration specified for
meillo@56: the connection name 'FastNet' and deliver the mail destined to the
meillo@56: internet. See the <a href="config.html">configuration manual</a> on how
meillo@56: to write a route configuration or use one of the examples as a
meillo@56: template. <em>I do not know how do configure that for an ISDN adapter,
meillo@56: but I am sure you will find something similar in the man
meillo@56: pages.</em></p>
meillo@56: 
meillo@56: <p>If you want mail that is received by masqmail from your local
meillo@56: net to be delivered immediately using the route configuration, you
meillo@56: have two possibilities:<p>
meillo@56: 
meillo@56: <p> 
meillo@56: <ul>
meillo@56: 
meillo@56: <li>if you are using the masqdialer system, you just have to set the
meillo@56: variables <b>online_detect</b> to <i>mserver</i> and
meillo@56: <b>mserver_iface</b> to the interface mserver is listening to.</li>
meillo@56: 
meillo@56: <li>otherwise you have to add two commands in your ip-up script:<br>
meillo@56: echo -n $6 &gt; /tmp/connect_route<br> chmod 644 /tmp/connect_route<br>
meillo@56: and you have to remove the file <i>/tmp/connect_route</i> in your
meillo@56: ip-down script:<br> rm /tmp/connect_route.<br> Then you have to set
meillo@56: <b>online_detect</b> to <i>file</i> and <b>online_file</b> to
meillo@56: <i>/tmp/connect_route</i>.  </li>
meillo@56: 
meillo@56: </ul>
meillo@56: </p>
meillo@56: 
meillo@56: <p>See the route documentation for more.</p>
meillo@56: 	  </td></tr>
meillo@56:     
meillo@56: 	<tr><td>
meillo@56: 	    <p>
meillo@56: 	    <hr>
meillo@56: 	    <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address>
meillo@56: 	    Last modified: Tue May 30 15:19:56 CEST 2000
meillo@56: 	    <br>
meillo@56: 	    This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6
meillo@56: 	  </p>
meillo@56:     
meillo@56:       </table>
meillo@56:     </center>
meillo@56: 
meillo@56:   </BODY>
meillo@56: </HEAD>
meillo@56: