Gentoo Archives: gentoo-doc-cvs

From: swift <swift@××××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: virt-mail-howto.xml
Date: Mon, 23 Jul 2007 15:44:48
Message-Id: E1ID05T-0002OZ-1u@stork.gentoo.org
1 swift 07/07/23 15:44:43
2
3 Modified: virt-mail-howto.xml
4 Log:
5 Small updates to virt-mail-howto
6
7 Revision Changes Path
8 1.57 xml/htdocs/doc/en/virt-mail-howto.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml?rev=1.57&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml?rev=1.57&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml?r1=1.56&r2=1.57
13
14 Index: virt-mail-howto.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml,v
17 retrieving revision 1.56
18 retrieving revision 1.57
19 diff -u -r1.56 -r1.57
20 --- virt-mail-howto.xml 20 Jul 2007 09:09:04 -0000 1.56
21 +++ virt-mail-howto.xml 23 Jul 2007 15:44:42 -0000 1.57
22 @@ -1,5 +1,5 @@
23 <?xml version='1.0' encoding='UTF-8'?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml,v 1.56 2007/07/20 09:09:04 nightmorph Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml,v 1.57 2007/07/23 15:44:42 swift Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 <guide link="/doc/en/virt-mail-howto.xml">
29 @@ -26,28 +26,8 @@
30 postfix, mysql, courier-imap, and cyrus-sasl.
31 </abstract>
32
33 -<version>1.4</version>
34 -<date>2007-07-20</date>
35 -
36 -<!--
37 -Contents
38 -
39 -I. Introduction
40 -II. Postfix Basics
41 -III. Courier-imap
42 -IV. Cyrus-sasl
43 -V. SSL Certificates for Postfix and Apache
44 -VI. Adding SSL and SASL support to Postfix
45 -VII. MySQL
46 -VIII. Apache and phpMyAdmin
47 -IX. The vmail user
48 -X. Configuring MySQL Authentication and vhosts
49 -XI. Squirrelmail
50 -XII. Mailman
51 -XIII. Content Filtering and Anti-Virus
52 -XIV. Wrap Up
53 -XV. Troubleshooting
54 --->
55 +<version>1.5</version>
56 +<date>2007-07-23</date>
57
58 <chapter>
59 <title>Introduction</title>
60 @@ -384,6 +364,9 @@
61
62 <p>
63 Now we're going to verify that the config's we added were picked up by postfix.
64 +For this we are going to use <c>telnet</c> (provided by for instance
65 +<c>net-misc/netkit-telnetd</c>) although you can also use <c>nc</c> (provided by
66 +<c>net-analyzer/netcat</c>):
67 </p>
68
69 <pre caption="Verifying sasl and tls support">
70 @@ -421,6 +404,42 @@
71 </chapter>
72
73 <chapter>
74 +<title>The vmail user</title>
75 +<section>
76 +<body>
77 +
78 +<p>
79 +Before we set up our virtual mailhosting environment, we create a functional
80 +user under which the virtual mailboxes will be hosted. For clarity's sake we
81 +will call this <e>vmail</e>:
82 +</p>
83 +
84 +<pre caption="Adding the vmail user">
85 +# <i>adduser -d /home/vmail -s /bin/false -m vmail</i>
86 +</pre>
87 +
88 +<p>
89 +So now you've set up the vmail account. You can create multiple accounts if you
90 +want (to keep some structure in your set of virtual mail accounts). The user id,
91 +group id and home dirs are referenced in the MySQL tables.
92 +</p>
93 +
94 +<p>
95 +Next to the user account we also need to create the location where the mailboxes
96 +will reside:
97 +</p>
98 +
99 +<pre caption="Creating mailboxes">
100 +# <i>mkdir /home/vmail/virt-domain.com/foo</i>
101 +# <i>chown -R vmail:vmail /home/vmail/virt-domain.com</i>
102 +# <i>maildirmake /home/vmail/virt-domain.com/foo/.maildir</i>
103 +</pre>
104 +
105 +</body>
106 +</section>
107 +</chapter>
108 +
109 +<chapter>
110 <title>MySQL</title>
111 <section>
112 <body>
113 @@ -485,8 +504,8 @@
114 <comment>(Line wrapped for clarity.)</comment>
115 id email clear name uid gid homedir \
116 maildir quota postfix
117 -10 foo@××××××××.org $password realname virtid virtid /home/vmail \
118 - /home/vmail/virt-bar.org/foo/.maildir/ y
119 +10 foo@×××××××××××.com $password realname virtid virtid /home/vmail \
120 + /home/vmail/virt-domain.com/foo/.maildir/ y
121 13 foo@×××.com $password realname localid localid /home/foo \
122 /home/foo/.maildir/ y
123 </pre>
124 @@ -497,14 +516,14 @@
125 </p>
126
127 <pre caption="transport table sample">
128 -id domain destination
129 -1 bar.com local:
130 -2 virt-bar.org virtual:
131 +id domain destination
132 +1 bar.com local:
133 +2 virt-domain.com virtual:
134 </pre>
135
136 <pre caption="virtual table sample">
137 -id email destination
138 -3 root@××××××××.org other@×××××.address
139 +id email destination
140 +3 root@×××××××××××.com other@×××××.address
141 </pre>
142
143 </body>
144 @@ -621,30 +640,6 @@
145 </chapter>
146
147 <chapter>
148 -<title>The vmail user</title>
149 -<section>
150 -<body>
151 -
152 -<p>
153 -At this point you may be wondering what user and directory to use for virtual
154 -mail users, and rightly so. Let's set that up.
155 -</p>
156 -
157 -<pre caption="Adding the vmail user">
158 -# <i>adduser -d /home/vmail -s /bin/false -m vmail</i>
159 -</pre>
160 -
161 -<p>
162 -So now you've set up the vmail account. You can create multiple accounts if you
163 -want (to keep some structure in your set of virtual mail accounts). The user id,
164 -group id and home dirs are referenced in the MySQL tables.
165 -</p>
166 -
167 -</body>
168 -</section>
169 -</chapter>
170 -
171 -<chapter>
172 <title>Configuring MySQL Authentication and vhosts</title>
173 <section>
174 <body>
175 @@ -741,7 +736,7 @@
176
177 <pre caption="/etc/postfix/mysql-virtual-maps.cf">
178 # <i>nano -w /etc/postfix/mysql-virtual-maps.cf</i>
179 -#myql-virtual-maps.cf
180 +# mysql-virtual-maps.cf
181
182 user = mailsql
183 password = $password
184 @@ -796,7 +791,7 @@
185 virtual_transport = virtual
186 <comment>(The domains listed by the mydestination should not be listed in
187 the virtual_mailbox_domains parameter)</comment>
188 -virtual_mailbox_domains = virt-bar.com, $other-virtual-domain.com
189 +virtual_mailbox_domains = virt-domain.com, $other-virtual-domain.com
190
191 virtual_minimum_uid = 1000
192 <comment>(Substitute $vmail-gid with the GID of the vmail group)</comment>
193 @@ -908,11 +903,11 @@
194
195 # <i>su mailman</i>
196 # <i>cd ~</i>
197 -# <i>./bin/newlist test</i>
198 +# <i>./bin/newlist --urlhost='www.virt-domain.com' --emailhost='virt-domain.com' test</i>
199 Enter the email of the person running the list: <i>your@×××××.address</i>
200 Initial test password:
201 Hit enter to continue with test owner notification...
202 -<comment>(Virtual domain lists may be specified with
203 +<comment>(Virtual domain lists may also be specified with
204 list@××××××.com style list names.)</comment>
205 # <i>./bin/genaliases</i>
206 <comment>(Now that your aliases have been generated,
207 @@ -921,16 +916,16 @@
208 # <i>nano -w data/aliases</i>
209 # STANZA START: test
210 # CREATED:
211 -test: "|/var/mailman/mail/mailman post test"
212 -test-admin: "|/var/mailman/mail/mailman admin test"
213 -test-bounces: "|/var/mailman/mail/mailman bounces test"
214 -test-confirm: "|/var/mailman/mail/mailman confirm test"
215 -test-join: "|/var/mailman/mail/mailman join test"
216 -test-leave: "|/var/mailman/mail/mailman leave test"
217 -test-owner: "|/var/mailman/mail/mailman owner test"
218 -test-request: "|/var/mailman/mail/mailman request test"
219 -test-subscribe: "|/var/mailman/mail/mailman subscribe test"
220 -test-unsubscribe: "|/var/mailman/mail/mailman unsubscribe test"
221 +test: "|/usr/local/mailman/mail/mailman post test"
222 +test-admin: "|/usr/local/mailman/mail/mailman admin test"
223 +test-bounces: "|/usr/local/mailman/mail/mailman bounces test"
224 +test-confirm: "|/usr/local/mailman/mail/mailman confirm test"
225 +test-join: "|/usr/local/mailman/mail/mailman join test"
226 +test-leave: "|/usr/local/mailman/mail/mailman leave test"
227 +test-owner: "|/usr/local/mailman/mail/mailman owner test"
228 +test-request: "|/usr/local/mailman/mail/mailman request test"
229 +test-subscribe: "|/usr/local/mailman/mail/mailman subscribe test"
230 +test-unsubscribe: "|/usr/local/mailman/mail/mailman unsubscribe test"
231 # STANZA END: test
232
233 <comment>(Create the required mailman list)</comment>
234
235
236
237 --
238 gentoo-doc-cvs@g.o mailing list