diff options
author | Mike Frysinger <vapier@gentoo.org> | 2004-02-12 19:26:59 +0000 |
---|---|---|
committer | Mike Frysinger <vapier@gentoo.org> | 2004-02-12 19:26:59 +0000 |
commit | d9edb2c9c2dc45c518b148a130c5d29a7eb7f1d4 (patch) | |
tree | f2140d1939e562019cadd4e3e06530b9d1b65efa | |
parent | Sync 1.82 (diff) | |
download | gentoo-d9edb2c9c2dc45c518b148a130c5d29a7eb7f1d4.tar.gz gentoo-d9edb2c9c2dc45c518b148a130c5d29a7eb7f1d4.tar.bz2 gentoo-d9edb2c9c2dc45c518b148a130c5d29a7eb7f1d4.zip |
Add a section about debugging qmail dns information.
Add a small note about the recommended version of courier-imap.
Warn about possible vpopmail/mysql permission problems.
Add qmHandle to the list of addons.
-rw-r--r-- | xml/htdocs/doc/en/qmail-howto.xml | 73 |
1 files changed, 70 insertions, 3 deletions
diff --git a/xml/htdocs/doc/en/qmail-howto.xml b/xml/htdocs/doc/en/qmail-howto.xml index 7e43493996..fdaf6787af 100644 --- a/xml/htdocs/doc/en/qmail-howto.xml +++ b/xml/htdocs/doc/en/qmail-howto.xml @@ -1,12 +1,12 @@ <?xml version = '1.0' encoding = 'UTF-8'?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/qmail-howto.xml,v 1.5 2004/02/07 16:54:31 vapier Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/qmail-howto.xml,v 1.6 2004/02/12 19:26:59 vapier Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/qmail-howto.xml"> <title>qmail/vpopmail Virtual Mail Hosting System Guide</title> -<author title="Author" > +<author title="Author"> <mail link="vapier@gentoo.org">Mike Frysinger</mail> </author> @@ -152,6 +152,48 @@ And that's all! Now you have a mail system that will handle mail for your local machine and the system daemons/users who utilize it. </p> +<warn> +If you don't receive any mail or you see weird errors in the log files +(check <path>/var/log/qmail/</path>) involving 'localhost.localhost', +then that means your domain/dns information is not setup properly. By +default, qmail utilizes the output of <c>hostname --fqdn</c>. If, on +your machine, this returns 'localhost', then check your +<path>/etc/hostname</path>, <path>/etc/hosts</path>, and your dns to +make sure everything is correct. Once you have, edit the configuration +files in <path>/var/qmail/control/</path>. Use the example setups that +follow if you need some more help. +</warn> + +<pre caption="Example /var/qmail/control/ files for a 2nd level domain"> +# <i>hostname --fqdn</i> +wh0rd.org +# <i>cat me</i> +wh0rd.org +# <i>cat defaultdomain</i> +wh0rd.org +# <i>cat plusdomain</i> +wh0rd.org +# <i>cat locals</i> +wh0rd.org +# <i>cat rcpthosts</i> +wh0rd.org +</pre> + +<pre caption="Example /var/qmail/control/ files for a 3rd level domain"> +# <i>hostname --fqdn</i> +mail.wh0rd.org +# <i>cat me</i> +mail.wh0rd.org +# <i>cat defaultdomain</i> +wh0rd.org +# <i>cat plusdomain</i> +wh0rd.org +# <i>cat locals</i> +mail.wh0rd.org +# <i>cat rcpthosts</i> +mail.wh0rd.org +</pre> + </body> </chapter> @@ -195,6 +237,11 @@ EOF</i> # <i>chmod 4711 /var/vpopmail/bin/vchkpw</i> </pre> +<warn> +If you experience permission problems with mysql/vpopmail, you may want to +try restarting mysql. Just run <c>/etc/init.d/mysql restart</c>. +</warn> + <p> At this point in time, vpopmail is ready to roll. In this guide, we will be providing virtual hosting for the domain 'wh0rd.org'. This means we need to @@ -234,6 +281,12 @@ You must emerge courier-imap after vpopmail. That way the authvchkpw module will be built. </impo> +<impo> +This guide is designed around net-mail/courier-imap-2.1.2-r1 or later. Will +it work with earlier versions? Maybe. Should you upgrade? Yes, if you want +to be sure this guide will work. +</impo> + <p> Now for the common post-install configuration steps. These steps are only needed if you wish to run SSL encrypted communications (which you should !). @@ -433,7 +486,7 @@ through the config directories and tweak each to your heart's content. <p> The first package I would suggest you look into is <uri -link="http://www.inter7.com/qmailadmin.html">qmailadmin</uri>. It's a web based +link="http://www.inter7.com/qmailadmin.html">qmailadmin</uri>. It's a web based interface for managing virtual domains. Simply <c>emerge net-mail/qmailadmin</c> and then point your webbrowser to <uri>http://localhost/cgi-bin/qmailadmin</uri> in order to use it. Makes life @@ -443,6 +496,20 @@ a lot easier. </body> </section> <section> +<title>qmHandle</title> +<body> + +<p> +If you run into problems with qmail queues and have a hard time debugging the +situation, you may want to look into <uri +link="http://qmhandle.sourceforge.net/">qmHandle</uri>. It's a simple perl +program which allows you to view and manage the qmail message queue. Again, +all you need to do is <c>emerge net-mail/qmhandle</c>. +</p> + +</body> +</section> +<section> <title>horde add ons</title> <body> |