swift 07/07/23 15:44:43 Modified: virt-mail-howto.xml Log: Small updates to virt-mail-howto
Revision Changes Path 1.57 xml/htdocs/doc/en/virt-mail-howto.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml?rev=1.57&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml?rev=1.57&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml?r1=1.56&r2=1.57 Index: virt-mail-howto.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml,v retrieving revision 1.56 retrieving revision 1.57 diff -u -r1.56 -r1.57 --- virt-mail-howto.xml 20 Jul 2007 09:09:04 -0000 1.56 +++ virt-mail-howto.xml 23 Jul 2007 15:44:42 -0000 1.57 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='UTF-8'?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml,v 1.56 2007/07/20 09:09:04 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml,v 1.57 2007/07/23 15:44:42 swift Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/virt-mail-howto.xml"> @@ -26,28 +26,8 @@ postfix, mysql, courier-imap, and cyrus-sasl. </abstract> -<version>1.4</version> -<date>2007-07-20</date> - -<!-- -Contents - -I. Introduction -II. Postfix Basics -III. Courier-imap -IV. Cyrus-sasl -V. SSL Certificates for Postfix and Apache -VI. Adding SSL and SASL support to Postfix -VII. MySQL -VIII. Apache and phpMyAdmin -IX. The vmail user -X. Configuring MySQL Authentication and vhosts -XI. Squirrelmail -XII. Mailman -XIII. Content Filtering and Anti-Virus -XIV. Wrap Up -XV. Troubleshooting ---> +<version>1.5</version> +<date>2007-07-23</date> <chapter> <title>Introduction</title> @@ -384,6 +364,9 @@ <p> Now we're going to verify that the config's we added were picked up by postfix. +For this we are going to use <c>telnet</c> (provided by for instance +<c>net-misc/netkit-telnetd</c>) although you can also use <c>nc</c> (provided by +<c>net-analyzer/netcat</c>): </p> <pre caption="Verifying sasl and tls support"> @@ -421,6 +404,42 @@ </chapter> <chapter> +<title>The vmail user</title> +<section> +<body> + +<p> +Before we set up our virtual mailhosting environment, we create a functional +user under which the virtual mailboxes will be hosted. For clarity's sake we +will call this <e>vmail</e>: +</p> + +<pre caption="Adding the vmail user"> +# <i>adduser -d /home/vmail -s /bin/false -m vmail</i> +</pre> + +<p> +So now you've set up the vmail account. You can create multiple accounts if you +want (to keep some structure in your set of virtual mail accounts). The user id, +group id and home dirs are referenced in the MySQL tables. +</p> + +<p> +Next to the user account we also need to create the location where the mailboxes +will reside: +</p> + +<pre caption="Creating mailboxes"> +# <i>mkdir /home/vmail/virt-domain.com/foo</i> +# <i>chown -R vmail:vmail /home/vmail/virt-domain.com</i> +# <i>maildirmake /home/vmail/virt-domain.com/foo/.maildir</i> +</pre> + +</body> +</section> +</chapter> + +<chapter> <title>MySQL</title> <section> <body> @@ -485,8 +504,8 @@ <comment>(Line wrapped for clarity.)</comment> id email clear name uid gid homedir \ maildir quota postfix -10 [EMAIL PROTECTED] $password realname virtid virtid /home/vmail \ - /home/vmail/virt-bar.org/foo/.maildir/ y +10 [EMAIL PROTECTED] $password realname virtid virtid /home/vmail \ + /home/vmail/virt-domain.com/foo/.maildir/ y 13 [EMAIL PROTECTED] $password realname localid localid /home/foo \ /home/foo/.maildir/ y </pre> @@ -497,14 +516,14 @@ </p> <pre caption="transport table sample"> -id domain destination -1 bar.com local: -2 virt-bar.org virtual: +id domain destination +1 bar.com local: +2 virt-domain.com virtual: </pre> <pre caption="virtual table sample"> -id email destination -3 [EMAIL PROTECTED] [EMAIL PROTECTED] +id email destination +3 [EMAIL PROTECTED] [EMAIL PROTECTED] </pre> </body> @@ -621,30 +640,6 @@ </chapter> <chapter> -<title>The vmail user</title> -<section> -<body> - -<p> -At this point you may be wondering what user and directory to use for virtual -mail users, and rightly so. Let's set that up. -</p> - -<pre caption="Adding the vmail user"> -# <i>adduser -d /home/vmail -s /bin/false -m vmail</i> -</pre> - -<p> -So now you've set up the vmail account. You can create multiple accounts if you -want (to keep some structure in your set of virtual mail accounts). The user id, -group id and home dirs are referenced in the MySQL tables. -</p> - -</body> -</section> -</chapter> - -<chapter> <title>Configuring MySQL Authentication and vhosts</title> <section> <body> @@ -741,7 +736,7 @@ <pre caption="/etc/postfix/mysql-virtual-maps.cf"> # <i>nano -w /etc/postfix/mysql-virtual-maps.cf</i> -#myql-virtual-maps.cf +# mysql-virtual-maps.cf user = mailsql password = $password @@ -796,7 +791,7 @@ virtual_transport = virtual <comment>(The domains listed by the mydestination should not be listed in the virtual_mailbox_domains parameter)</comment> -virtual_mailbox_domains = virt-bar.com, $other-virtual-domain.com +virtual_mailbox_domains = virt-domain.com, $other-virtual-domain.com virtual_minimum_uid = 1000 <comment>(Substitute $vmail-gid with the GID of the vmail group)</comment> @@ -908,11 +903,11 @@ # <i>su mailman</i> # <i>cd ~</i> -# <i>./bin/newlist test</i> +# <i>./bin/newlist --urlhost='www.virt-domain.com' --emailhost='virt-domain.com' test</i> Enter the email of the person running the list: <i>[EMAIL PROTECTED]</i> Initial test password: Hit enter to continue with test owner notification... -<comment>(Virtual domain lists may be specified with +<comment>(Virtual domain lists may also be specified with [EMAIL PROTECTED] style list names.)</comment> # <i>./bin/genaliases</i> <comment>(Now that your aliases have been generated, @@ -921,16 +916,16 @@ # <i>nano -w data/aliases</i> # STANZA START: test # CREATED: -test: "|/var/mailman/mail/mailman post test" -test-admin: "|/var/mailman/mail/mailman admin test" -test-bounces: "|/var/mailman/mail/mailman bounces test" -test-confirm: "|/var/mailman/mail/mailman confirm test" -test-join: "|/var/mailman/mail/mailman join test" -test-leave: "|/var/mailman/mail/mailman leave test" -test-owner: "|/var/mailman/mail/mailman owner test" -test-request: "|/var/mailman/mail/mailman request test" -test-subscribe: "|/var/mailman/mail/mailman subscribe test" -test-unsubscribe: "|/var/mailman/mail/mailman unsubscribe test" +test: "|/usr/local/mailman/mail/mailman post test" +test-admin: "|/usr/local/mailman/mail/mailman admin test" +test-bounces: "|/usr/local/mailman/mail/mailman bounces test" +test-confirm: "|/usr/local/mailman/mail/mailman confirm test" +test-join: "|/usr/local/mailman/mail/mailman join test" +test-leave: "|/usr/local/mailman/mail/mailman leave test" +test-owner: "|/usr/local/mailman/mail/mailman owner test" +test-request: "|/usr/local/mailman/mail/mailman request test" +test-subscribe: "|/usr/local/mailman/mail/mailman subscribe test" +test-unsubscribe: "|/usr/local/mailman/mail/mailman unsubscribe test" # STANZA END: test <comment>(Create the required mailman list)</comment> -- [EMAIL PROTECTED] mailing list
