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 < 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 > /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: