Updated docs

This commit is contained in:
gleblanc 2000-05-03 22:08:14 +00:00
parent a8000c0f0c
commit 0eefd2dd9a
2 changed files with 2483 additions and 2417 deletions

View File

@ -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> Mandrake 7.0, Linux 2.2.13, 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.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
</p>
<p>
This manual may be reproduced in whole or in part, without fee, subject
to the following restrictions:
v1.4 (April 23, 2000)
</p>
<p>
<itemize>
<item>The copyright notice above and this permission notice must be preserved
complete on all complete or partial copies
<item>Any translation or derived work must be approved by the author in writing
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.
<item>Updated the Courier-IMAP setup information for new VMailMgr version.
<item>Switched the license to the GNU FDL.
<item>Other minor additions and corrections.
</itemize>
</p>
<sect1>Copyrights and Trademarks
<p>
Exceptions to these rules may be granted for academic purposes: Write to
the author and ask. These restrictions are here to protect us as authors, not
to restrict you as learners and educators. Any source code (aside from the
SGML this document was written in) in this document is placed under the GNU
General Public License, available via anonymous FTP from
<url url="ftp://ftp.gnu.org/GNU/COPYING" name="the GNU archive">.
Copyright (c) Dan Kuykendall.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation
</p>
<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
its compile to build the auth lib, I had to take the following steps.
(please edit to suit your environment)
1) copy the courier-imap-0.31.tar.gz to non-root users home dir
<tt>cp courier-imap-0.31.tar.gz ~user1/ </tt>
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. *
Simply run the following command
<verb>rpm --rebuild &lt;package.src.rpm&gt;</verb>
-Example-
<code>
rpm --rebuild vmailmgr-0.96.6-1.src.rpm
</code>
</p>
<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>
rpm -ivh <location>/<package.i386.rpm>
</verb>
<verb>rpm -ivh &lt;location&gt;/&lt;package.i386.rpm&gt;</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-daemon-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.6-1.i386.rpm
</code>
</p>
<sect2>Install with source
<p>
Since VMailMgr needs the courier-imap sources during its compile to build the
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
Run the following commands
<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
cd vmailmgr-0.96.5
./configure --with-courier-imap=/home/user1/courier-imap-0.31/
tar zxf vmailmgr-0.96.6.tar.gz
cd vmailmgr-0.96.6
./configure
make
(As root)
make install
make setup check or make install
</code>
That should do it.
</p>

File diff suppressed because it is too large Load Diff