Updated docs

LDP/howto/linuxdoc/Qmail-VMailMgr-Courier-imap-HOWTO.sgml

@@ -1,6 +1,6 @@
 <!doctype linuxdoc system>
 
-<!-- LinuxDoc file was created by hand by <Dan Kuykendall> Wed April 19 -->
+<!-- LinuxDoc file was created by hand by <Dan Kuykendall> Wed April 23 -->
 <article>
 <title>
   Qmail VMailMgr and Courier-Imap HOWTO
@@ -9,14 +9,13 @@
   Dan Kuykendall &lt;dan@kuykendall.org&gt;
 </author>
 <date>
-  v1.2, 19 April 2000
+  v1.4, 23 April 2000
 </date>
 <abstract>
   This document is about building a mail server that will
   support virtual domain hosting and provide smtp, pop3 and imap services, 
   using a powerful alternative to sendmail.
 </abstract>
-
 <toc>
 <sect>Introduction<label id="Introduction" > 
 <p>
@@ -134,8 +133,8 @@
   get your email system up and running. 
   Combinations that work for me are:
 <itemize>
-  <item> RedHat 6.2, Linux 2.2.14, Qmail 1.03+patches-12, VMailMgr 0.96.5, Courier-imap 0.31
+  <item> RedHat 6.2, Linux 2.2.14, Qmail 1.03+patches-12, VMailMgr 0.96.6, Courier-imap 0.31
-  <item> Mandrake 7.0, Linux 2.2.13, Qmail 1.03+patches-12, VMailMgr 0.96.5, Courier-imap 0.31
+  <item> Mandrake 7.0, Linux 2.2.13, Qmail 1.03+patches-12, VMailMgr 0.96.6, Courier-imap 0.31
 </itemize>
 
 <sect1>History<label id="History" > 
@@ -145,7 +144,7 @@
 </p>
 <sect1>New versions 
 <p>
-  The newest version of this can be found on my homepage <url url="http://www.clearrivertech.com/linux"> in its SGML source.
+  The newest version of this can be found on my homepage <url url="http://www.clearrivertech.com/linux/HOWTO"> as SGML source, as HTML and as TEXT.
   Other versions may be found in different formats at the LDP homepage <url url="http://www.linuxdoc.org/">.
 </p>
 <sect1>Comments 
@@ -195,34 +194,26 @@
   <item>Built proper SGML version.
 </itemize>
 </p>
-<sect1>Copyrights and Trademarks 
 <p>
-  (c) 2000-2001 Dan Kuykendall
+  v1.4 (April 23, 2000)
-</p>
-<p>
-  This manual may be reproduced in whole or in part, without fee, subject
-  to the following restrictions:
 </p>
 <p>
 <itemize>
-  <item>The copyright notice above and this permission notice must be preserved
+  <item>Updated the Courier-IMAP setup information for new VMailMgr version.
-        complete on all complete or partial copies 
+  <item>Switched the license to the GNU FDL.
-  <item>Any translation or derived work must be approved by the author in writing
+  <item>Other minor additions and corrections.
-        before distribution. 
-  <item>If you distribute this work in part, instructions for obtaining the complete
-        version of this manual must be included, and a means for obtaining a complete
-        version provided. 
-  <item>Small portions may be reproduced as illustrations for reviews or quotes
-        in other works without this permission notice if proper citation is given.
 </itemize>
 </p>
+<sect1>Copyrights and Trademarks 
 <p>
-  Exceptions to these rules may be granted for academic purposes: Write to
+  Copyright (c)  Dan Kuykendall.
-  the author and ask. These restrictions are here to protect us as authors, not
+  Permission is granted to copy, distribute and/or modify this document
-  to restrict you as learners and educators. Any source code (aside from the
+  under the terms of the GNU Free Documentation License, Version 1.1
-  SGML this document was written in) in this document is placed under the GNU
+  or any later version published by the Free Software Foundation
-  General Public License, available via anonymous FTP from 
+</p>
-  <url url="ftp://ftp.gnu.org/GNU/COPYING" name="the GNU archive">.
+<p>
+  A copy of the license is available at
+  <url url="http://www.gnu.org/copyleft/fdl.txt" name="GNU Free Documentation License">.
 </p>
 <sect1>Acknowledgements and Thanks 
 <p>
@@ -252,7 +243,7 @@
   <item> daemontools-0.70-1.src.rpm - <url url="http://em.ca/~bruceg/rpms/daemontools/"> 
   <item> supervise-scripts-2.4-1.src.rpm - <url url="http://em.ca/~bruceg/supervise-scripts/">
   <item> qmail-1.03+patches-12.src.rpm - <url url="http://em.ca/~bruceg/qmail+patches/">
-  <item> vmailmgr-0.96.5-1.src.rpm - <url url="http://em.ca/~bruceg/vmailmgr/">
+  <item> vmailmgr-0.96.6-1.src.rpm - <url url="http://em.ca/~bruceg/vmailmgr/">
   <item> courier-imap-0.31.tar.gz - <url url="http://www.inter7.com/courierimap/">
 </itemize>
   For Courier-imap you must build the source rpm from the tar 
@@ -273,7 +264,7 @@
   <item> daemontools-0.70-1.i386.rpm - <url url="http://em.ca/~bruceg/rpms/daemontools/"> 
   <item> supervise-scripts-2.4-1.i386.rpm - <url url="http://em.ca/~bruceg/supervise-scripts/">
   <item> qmail-1.03+patches-12.src.rpm - <url url="http://em.ca/~bruceg/qmail+patches/">
-  <item> vmailmgr-0.96.5-1.src.rpm - <url url="http://em.ca/~bruceg/vmailmgr/">
+  <item> vmailmgr-0.96.6-1.src.rpm - <url url="http://em.ca/~bruceg/vmailmgr/">
   <item> courier-imap-0.31.tar.gz - <url url="http://www.inter7.com/courierimap/">
 </itemize>
   For Courier-imap you must build the binary rpm from the tar 
@@ -287,7 +278,7 @@
   <item> daemontools-0.70.tar.gz - <url url="http://cr.yp.to/daemontools/daemontools-0.70.tar.gz">
   <item> supervise-scripts-2.4.tar.gz - <url url="http://em.ca/~bruceg/supervise-scripts/">
   <item> qmail-1.03.tar.gz - <url url="http://cr.yp.to/software/qmail-1.03.tar.gz"> (*)
-  <item> vmailmgr-0.96.5.tar.gz - <url url="http://em.ca/~bruceg/vmailmgr/">
+  <item> vmailmgr-0.96.6.tar.gz - <url url="http://em.ca/~bruceg/vmailmgr/">
   <item> courier-imap-0.31.tar.gz - <url url="http://www.inter7.com/courierimap/">
 </itemize>
 
@@ -478,76 +469,39 @@
   make install
 </code>
 </p>
-
 <sect1>Install VMailMgr
-<p>
-  At the time of this writing Bruce had not released a binary version of VMailMgr 
-  that included Courier-imap support. This means until the next version of 
-  VMailMgr is release, you will be required to build the RPMS yourself.
-  
 <sect2>Install with RPMS
 <sect3>Compiling SRC.RPM's
 <p>
-  Now for the fun part, since VMailMgr needs the courier-imap sources during
+  Simply run the following command
-  its compile to build the auth lib, I had to take the following steps.
+  <verb>rpm --rebuild &lt;package.src.rpm&gt;</verb>
-  (please edit to suit your environment)
+  -Example-
-
+<code>
-  1) copy the courier-imap-0.31.tar.gz to non-root users home dir
+  rpm --rebuild vmailmgr-0.96.6-1.src.rpm  
-
+</code>
-  <tt>cp courier-imap-0.31.tar.gz ~user1/ </tt>
+</p>
-
-  2) with my user account: untar, run config and make
-<verb>
-  su user1
-  cd ~/
-  tar zxf courier-imap-0.31.tar.gz
-  cd courier-imap-0.31
-  ./configure
-  make
-</verb>
-
-  3) Install the VMailMgr sources and modify the spec file to support courier-imap
-<verb>
-  rpm -ivh VMailMgr-0.96.5-1.src.rpm
-  edit /usr/src/redhat/SPECS/VMailMgr-0.96.5.spec
-  on the ./configure line (line 49) add the following text to the end
-  --with-courier-imap=/home/user1/courier-imap-0.31/
-</verb>
-
-  4) Compile VMailMgr based on the modified spec file
-  <tt>rpm -bb /usr/src/redhat/SPECS/VMailMgr-0.96.5.spec</tt>
-
-  * I will mention again, that I have built the binaries, and if you email me *
-  * at dan@kuykendall.org, I will email them back to you. *
-
 <sect3>Installing RPM's
 <p>
-  After compiling the source rpms, the binaries will be located 
+  If you compiled the source rpm, the binaries will be located 
   in <tt>/usr/src/redhat/RPMS/i386/</tt> or something similar.
 
   Simply run the following command for each package
-<verb>
+  <verb>rpm -ivh &lt;location&gt;/&lt;package.i386.rpm&gt;</verb>
-  rpm -ivh <location>/<package.i386.rpm>
+
-</verb>
   -Example-
 <code>
-  rpm -ivh /usr/src/redhat/RPMS/i386/VMailMgr-0.96.5-1.i386.rpm
+  rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-0.96.6-1.i386.rpm
-  rpm -ivh /usr/src/redhat/RPMS/i386/VMailMgr-daemon-0.96.5-1.i386.rpm
+  rpm -ivh /usr/src/redhat/RPMS/i386/VMailMgr-daemon-0.96.6-1.i386.rpm
 </code>
-
+</p>
 <sect2>Install with source
 <p>
-  Since VMailMgr needs the courier-imap sources during its compile to build the 
+  Run the following commands
-  auth lib, and since your using the compiling source, you will need to have kept
-  your courier-imap sources from where you compiled it. If you deleted them, redo
-  the steps up to the make command. 
-<p>
-  Run the following command
 <verb>
   (As non-root user)
   tar zxf <package.tar.gz>
   cd <newly created dir>
-  ./configure --with-courier-imap=<courier-imap sources>
+  ./configure
   make
   (As root)
   make install
@@ -555,12 +509,12 @@
   -Example-
 <code>
   (As non-root user)
-  tar zxf vmailmgr-0.96.5.tar.gz
+  tar zxf vmailmgr-0.96.6.tar.gz
-  cd vmailmgr-0.96.5
+  cd vmailmgr-0.96.6
-  ./configure --with-courier-imap=/home/user1/courier-imap-0.31/
+  ./configure
   make
   (As root)
-  make install
+  make setup check or  make install
 </code>
   That should do it.
 </p>