home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 February / CHIP_2_98.iso / doc / HOWTO / mini / Qmail+MH < prev    next >
Text File  |  1997-06-19  |  12KB  |  362 lines
  1.   mini-HOWTO install qmail with MH
  2.   Christopher Richardson (rdn@tara.n.eunet.de)
  3.   v1.3 13.06.97
  4.  
  5.   I am just documenting my installation experiences to offer some help
  6.   to other users who wish to use the above combination for their email.
  7.  
  8.   1.  Introduction
  9.  
  10.   My thanks to all netizens who have helped me, especially Tony Nugent
  11.   (tony@trishul.sci.gu.edu.au), David Summers
  12.   (david@summersoft.fay.ar.us) and S.u.S.E ( Linux distribution) who has
  13.   made installing Linux so much easier, and the authors of the above
  14.   excellent programs.
  15.  
  16.   What is qmail and why should I use it?  Here is the author┤s (Dan
  17.   Bernstein) blurb:
  18.  
  19.   qmail is a secure, reliable, efficient, simple message transfer agent.
  20.   It is meant as a replacement for the entire sendmail-binmail system on
  21.   typical Internet-connected UNIX hosts.  Secure: Security isn't just a
  22.   goal, but an absolute requirement. Mail delivery is critical for
  23.   users; it cannot be turned off, so it must be completely secure. (This
  24.   is why I started writing qmail: I was sick of the security holes in
  25.   sendmail and other MTAs.)  Reliable: qmail's straight-paper-path
  26.   philosophy guarantees that a message, once accepted into the system,
  27.   will never be lost. qmail also supports maildir, a new, super-reliable
  28.   user mailbox format. Maildirs, unlike mbox files and mh folders, won't
  29.   be corrupted if the system crashes during delivery. Even better, not
  30.   only can a user safely read his mail over NFS, but any number of NFS
  31.   clients can deliver mail to him at the same time.  Efficient: On a
  32.   Pentium under BSD/OS, qmail can easily sustain 200000 local messages
  33.   per day---that's separate messages injected and delivered to mailboxes
  34.   in a real test! Although remote deliveries are inherently limited by
  35.   the slowness of DNS and SMTP, qmail overlaps 20 simultaneous
  36.   deliveries by default, so it zooms quickly through mailing lists.
  37.   (This is why I finished qmail: I had to get a big mailing list set
  38.   up.)  Simple: qmail is vastly smaller than any other Internet MTA.
  39.   Some reasons why: (1) Other MTAs have separate forwarding, aliasing,
  40.   and mailing list mechanisms. qmail has one simple forwarding mechanism
  41.   that lets users handle their own mailing lists. (2) Other MTAs offer a
  42.   spectrum of delivery modes, from fast+unsafe to slow+queued. qmail-
  43.   send is instantly triggered by new items in the queue, so the qmail
  44.   system has just one delivery mode: fast+queued. (3) Other MTAs
  45.   include, in effect, a specialized version of inetd that watches the
  46.   load average.  qmail's design inherently limits the machine load, so
  47.   qmail-smtpd can safely run from your system's inetd.  Replacement for
  48.   sendmail: qmail supports host and user masquerading, full host hiding,
  49.   virtual domains, null clients, list-owner rewriting, relay control,
  50.   double-bounce recording, arbitrary RFC 822 address lists, cross-host
  51.   mailing list loop detection, per-recipient checkpointing, downed host
  52.   backoffs, independent message retry schedules, etc. In short, it's up
  53.   to speed on modern MTA features. qmail also includes a drop-in
  54.   ``sendmail'' wrapper so that it will be used transparently by your
  55.   current UAs.
  56.  
  57.   2.  My System Details
  58.  
  59.   Cyrix 6x86, with the SuSE Linux Distribution. Kernel patched to 2.0.28
  60.   with the unofficial Cyrix patch ( from http://www.escnet.com/). Elsa
  61.   Winner Trio +64 graphics card.
  62.   PPP link to ISP
  63.  
  64.   3.  Qmail Installation
  65.  
  66.   Follow the INSTALL instructions exactly.
  67.  
  68.   Notes:
  69.  
  70.   Please take the time to read the Fine documentation  completely.  The
  71.   numerals refer to the installation steps in the above INSTALL doc.
  72.  
  73.   ╖  2  - I had to set up the groups and users manually as per
  74.      INSTALL.ids
  75.  
  76.   ╖  7  - ./qmail-makectl did not work on my system. I added my domain
  77.      name (mickey.n.eunet.de) manually in /var/qmail/control/me
  78.  
  79.   ╖  23 - Make sure qmail-smtpd is spelt correctly in the inetd-conf
  80.      file.  (I spelt it incorrectly i.e. qmail-smptd, which took me two
  81.      days to find:( ) smtp  stream  tcp     nowait  qmaild
  82.      /var/qmail/bin/tcp-env tcp-env /var/qmail/bin/qmail-smtpd
  83.  
  84.   3.1.  Maildir2smtp
  85.  
  86.   Dan Bernstein has provided a package for sending queued email to an
  87.   ISP via dial-in. This package is available as serialmailxxx from his
  88.   site.
  89.  
  90.   Install this package as described in the man page (Thanks Rupert
  91.   Mazzucco (maz@pap.univie.ac.at), it works out of the box!
  92.  
  93.          maildir2smtp - blast a maildir across SMTP
  94.  
  95.          maildir2smtp is designed to pass messages along a SLIP  or
  96.          PPP  link.  To set this up on the disconnected end, create
  97.          a new maildir in alias:
  98.  
  99.             # maildirmake ~alias/pppdir
  100.             # chown -R alias ~alias/pppdir
  101.  
  102.          Put
  103.  
  104.             :alias-ppp
  105.  
  106.          into control/virtualdomains and
  107.  
  108.             ./pppdir/
  109.  
  110.          into ~alias/.qmail-ppp-default.  Don't  forget  the  extra
  111.          slash in pppdir/.  Then, in the PPP startup script, do
  112.  
  113.             maildir2smtp ~alias/pppdir alias-ppp- $IP `hostname`
  114.  
  115.          replacing  $IP with the remote IP address.
  116.  
  117.   Notes:
  118.  
  119.   ╖  Please read the Fine manual page completely.
  120.  
  121.   ╖  Maildir2smtp requires the dotted IP address of your mail server. If
  122.      you do not have this then ping YourMail.host.country which will
  123.      return the IP.
  124.  
  125.   ╖  This command can be included in your login script to flush all
  126.      queued mail after logging in to your ISP.
  127.  
  128.   4.  MH Installation
  129.  
  130.   In addition to this, I also replaced /mh-6.8.4/mts/sendmail/smail.c
  131.   with Dan Bernstein┤s mh-qmail-smail.c
  132.  
  133.   This is what my mh-6.8.4/conf/MH looks like:
  134.  
  135.   ______________________________________________________________________
  136.  
  137.   bin     /usr/bin/mh
  138.   etc     /usr/lib/mh
  139.   #mail
  140.   #mandir /usr/man
  141.   #manuals        standard
  142.   chown   /bin/chown
  143.   #cp     cp
  144.   #ln     ln
  145.   #remove mv -f
  146.   cc      gcc
  147.   ccoptions -traditional -O2 -m486 -D_NFILE='getdtablesize()'
  148.             -DSIGEMT=SIGUSR1
  149.   curses  -lncurses
  150.   #ldoptions      -s
  151.   #ldoptlibs
  152.   lex     flex
  153.   #oldload        off
  154.   #ranlib on
  155.   mts     sendmail
  156.   #mf     off
  157.   #bboards        off
  158.   #bbdelivery     off
  159.   #bbhome /usr/spool/bboards
  160.   pop     on
  161.   popdir  /usr/lib/mh
  162.   sharedlib       sys5
  163.   slflags -fPIC
  164.   slibdir /usr/lib
  165.   mailgroup       mail
  166.   signal  void
  167.   sprintf int
  168.   #editor prompter
  169.   #debug  off
  170.   #regtest        off
  171.   options ATHENA
  172.   options BIND
  173.   options DPOP
  174.   options DUMB
  175.   options FCNTL
  176.   options MHE
  177.   options MHRC
  178.   options MIME
  179.   options MORE='"/usr/bin/less"'
  180.   options OVERHEAD
  181.   options POP2
  182.   options POPSERVICE='"pop3"'
  183.   options RENAME
  184.   options RPATHS
  185.   options RPOP
  186.   options SOCKETS
  187.   options SVR4
  188.   options SYS5
  189.   options SYS5DIR
  190.   options TERMINFO
  191.   options UNISTD
  192.   options VSPRINTF
  193.  
  194.   ______________________________________________________________________
  195.  
  196.   Notes:
  197.  
  198.   ╖  I have only compiled ``mts sendmail'' - read in comp.mail.mh
  199.      somewhere that /smtp can cause problems. Dominic Mitchell
  200.      (hdm@demon.net) wrote in comp.mail.mh (13 June 1997):
  201.  
  202.      ``Not quite. With this option MH still talks SMTP, just over a pipe
  203.      and not over a network. You *really* need a line in your
  204.      /.mh_profile which says:
  205.  
  206.      postproc: /usr/local/nmh/lib/spost
  207.  
  208.      Or whever it's kept on your system. This will pass the message
  209.      directly to sendmail in the traditional manner. You're using qmail
  210.      of course, so sendmail will be qmail's wrapper script, but that's
  211.      just fine.'' Thanks Dominic.
  212.  
  213.   ╖  I have remmed out ``mail'' because I want to control it via
  214.      mtstailor
  215.  
  216.   4.1.  mtstailor
  217.  
  218.   As qmail delivers mail to the home directory (~/Mailbox). I added the
  219.   following to my mtstailor
  220.  
  221.        localname:      mickey
  222.        localdomain:    n.eunet.de
  223.        mmdfldir:
  224.        mmdflfil:       Mailbox
  225.        uucpldir:
  226.        uucplfil:
  227.        mmdelim1:       \001\001\001\001\n
  228.        mmdelim2:       \001\001\001\001\n
  229.        mmailid:        0
  230.        umincproc:
  231.        lockldir:
  232.        sendmail:       /usr/lib/sendmail
  233.  
  234.   Notes:
  235.  
  236.   ╖  sendmail: /usr/lib/sendmail is a link to the qmail sendmail wrapper
  237.      in /var/qmail/bin
  238.  
  239.   ╖  MH does not like the tilde notation (~/) use /home instead or leave
  240.      blank which according to the docs defaults to $HOME.
  241.  
  242.   ╖  I recently installed MH and qmail on my office machine which is
  243.      connect via ethernet. I added the following line to mtstailor:
  244.  
  245.      servers: mailserver.company.country
  246.  
  247.   4.2.  mh_profile
  248.  
  249.   Here is my .mh_profile
  250.  
  251.        Path: Mail
  252.        draft-folder: drafts
  253.        unseen-sequence: unseen
  254.        AliasFile: /home/rdn/.mh_aliases
  255.        send: -msgid
  256.        comp: -form /home/rdn/.mymh-components
  257.        MailDrop: /home/rdn/Mailbox
  258.  
  259.   Notes:
  260.  
  261.   ╖  I put in the MailDrop line to be ``sure to be sure''.
  262.  
  263.   5.  Fetchmail
  264.  
  265.   I decided to use fetchmail because I have a multiuser (my family :).
  266.   Linux and fetchmail delivers mail to the smtp port where qmail takes
  267.   over.
  268.  
  269.   Installation was no problem, but I have not got the multidrop working
  270.   correctly.
  271.  
  272.   Here is my .fetchmailrc
  273.  
  274.        poll PersonalMail.Germany.EU.net
  275.        protocol pop3
  276.        username myname
  277.        password mypassword
  278.  
  279.   6.  Exmh
  280.  
  281.   This is my mailer by choice. I love it.
  282.  
  283.   There is one problem - most pre-compiled TCL/TK packages have the
  284.   security option compiled in.  The following script .xserverrc.secure
  285.   which came with SuSE solves this.
  286.  
  287.   ______________________________________________________________________
  288.  
  289.   #!/bin/sh
  290.  
  291.   #
  292.   # move this file to ~/.xserverrc, if you don't want to allow everybody to
  293.   # get access to your X-Server
  294.   #
  295.   if [ -x /usr/bin/keygen ]; then
  296.       if [ ! -x /usr/bin/hostname -a ! -x /bin/hostname \
  297.            -a ! -x /usr/bsd/hostname ];
  298.       then
  299.           echo "startx: can't get my hostname - exiting"
  300.           exit 1
  301.       else
  302.           host=`hostname`
  303.       fi
  304.  
  305.       xauth add $host:0 . `/usr/bin/keygen`
  306.       sleep 2
  307.       xauth add $host/"unix":0 . `/usr/bin/keygen`
  308.       exec X :0 -auth .Xauthority $*
  309.   else
  310.       exec X :0 $*
  311.   fi
  312.   ______________________________________________________________________
  313.  
  314.   7.  Disclaimers
  315.  
  316.   The usual no guarantees, no money back, use at your own risk.
  317.  
  318.   8.  Procmail
  319.  
  320.   The qmail FAQ gives this command:
  321.  
  322.   In  /.qmail add the line
  323.  
  324.        | preline procmail
  325.  
  326.   On my system this works iff when using vi to generate the .qmail file,
  327.   I included an empty line after the command.
  328.  
  329.   I recompiled the procmail package with my defaults. I added a link
  330.   from my /usr/local/bin/procmail to /bin/procmail, because I was not
  331.   sure that the command could find procmail in /usr/local/bin.
  332.  
  333.   Procmail is an excellently documented program. Read the man pages for
  334.   examples on how to set up your .procmailrc file.
  335.  
  336.   9.  Sources
  337.  
  338.   Required Packages
  339.  
  340.   ╖  Find Qmail, setserial on http://pobox.com/~djb/qmail.html for other
  341.      qmail-related software and a pointer to the qmail mailing list.
  342.  
  343.   ╖  Find MH on ftp.ics.uci.edu:/pub/mh
  344.  
  345.      Tony Nugent has prepared a patch for the clean mh-6.8.3 sources
  346.      (patch available ftp://ftp.gw.com/pub/unix/mail/mh/patches/linux/).
  347.  
  348.   ╖  Find Metamail (for MIME support, including 8-bit charsets) on
  349.      ftp.bellcore.com:/pub/nsb
  350.  
  351.   ╖  Find Fetchmail on ftp://ftp.ccil.org/pub/esr/fetchmail Or you can
  352.      get it from Eric's home page: http://www.ccil.org/~esr
  353.  
  354.   ╖  Find Glimpse, the full text search engine, at University of
  355.      Arizona: http://glimpse.cs.arizona.edu:1994/
  356.  
  357.   ╖  Find Exmh ftp.sunlabs.com/pub/tcl/exmh/
  358.  
  359.   ╖  Find TCL and TK on ftp.sunlabs.com:/pub/tcl
  360.      ftp.aud.alcatel.com:/tcl ftp.cs.berkeley.edu:/ucb/tcl
  361.  
  362.