public inbox for gentoo-doc-cvs@lists.gentoo.org
 help / color / mirror / Atom feed
From: swift <swift@stork.gentoo.org>
To: gentoo-doc-cvs@lists.gentoo.org
Subject: [gentoo-doc-cvs] cvs commit: virt-mail-howto.xml
Date: Mon, 23 Jul 2007 15:44:43 +0000	[thread overview]
Message-ID: <E1ID05T-0002OZ-1u@stork.gentoo.org> (raw)

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 foo@virt-bar.org $password realname virtid  virtid  /home/vmail \
-	/home/vmail/virt-bar.org/foo/.maildir/        y
+10 foo@virt-domain.com $password realname virtid  virtid  /home/vmail \
+	/home/vmail/virt-domain.com/foo/.maildir/        y
 13 foo@bar.com      $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   root@virt-bar.org other@email.address
+id   email               destination
+3   root@virt-domain.com other@email.address
 </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>your@email.address</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
 list@domain.com 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>



-- 
gentoo-doc-cvs@gentoo.org mailing list



             reply	other threads:[~2007-07-23 15:44 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2007-07-23 15:44 swift [this message]
  -- strict thread matches above, loose matches on Subject: below --
2008-05-21 19:39 [gentoo-doc-cvs] cvs commit: virt-mail-howto.xml Sven Vermeulen
2007-07-20  9:09 Josh Saddler
2007-07-16  2:31 Josh Saddler
2006-09-04  8:49 Josh Saddler
2006-07-04  0:21 Lukasz Damentko
2006-06-18 22:09 Josh Saddler
2006-04-09  7:42 Shyam Mani
2006-03-13 19:39 Josh Saddler
2006-01-08  1:10 Marcelo Goes
2005-12-16  7:43 Shyam Mani
2005-12-02 14:49 Xavier Neys

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=E1ID05T-0002OZ-1u@stork.gentoo.org \
    --to=swift@stork.gentoo.org \
    --cc=docs-team@lists.gentoo.org \
    --cc=gentoo-doc-cvs@lists.gentoo.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox