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 |