1 VMailMgr HOWTO |
1 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
2 Bruce Guenter <mailto:bruceg@em.ca>, Dan Kuykendall |
2 ? ] |
3 <mailto:dan@kuykendall.org> |
3 |
4 v1.w, 2000-09-15 |
4 Copyright (C) 1998 Bruce Guenter |
5 |
5 |
6 This document explains how to setup VMailMgr support pop3 virtual |
6 This document explains how to setup VMailMgr support pop3 virtual |
7 domain services in conjunction with Qmail. |
7 domain services in conjunction with Qmail. |
8 ______________________________________________________________________ |
8 |
9 |
9 1. Introduction |
10 Table of Contents |
10 |
11 |
11 VMailMgr (an abbreviation for Virtual Mail Manager) is a package of |
12 |
12 programs designed to manage multiple domains of mail addresses and |
13 1. Introduction |
13 mailboxes on a single host. It co-operates with qmail for mail |
14 |
14 delivery and program control. |
15 1.1 What is VMailMgr and why should I use it? |
15 _________________________________________________________________ |
16 1.2 New versions |
16 |
17 1.3 Comments |
17 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
18 1.4 History |
18 ? ] |
19 1.5 Copyrights and Trademarks |
19 |
20 1.6 Acknowledgements and Thanks |
20 1.1 What is VMailMgr and why should I use it? |
21 |
21 |
22 2. Installation |
22 VMailMgr is a series of utilities for managing virtual domains, |
23 |
23 including: |
24 2.1 Get the files |
24 * a password checking interface for qmail, which replaces the usual |
25 2.2 Install with RPMS |
25 checkpassword, and |
26 2.2.1 Compiling SRC.RPM's |
26 * an authentication module for Courier IMAP |
27 2.2.2 Installing RPM's |
27 |
28 2.3 Install with source |
28 These utilities provide access to the virtual mailboxes by one of |
29 |
29 three methods: |
30 3. Setup |
30 |
31 |
31 * IP-based virtual server access (invisible to the POP3 user) |
32 3.1 Setting Up a Virtual Domain |
32 * username-based access (virtual user logs in as |
33 3.2 Using one IP address for mutiple domains |
33 `username-virtualuser') |
34 3.3 Catching all misdirected mail in a virtual domain |
34 * hostname-based access (virtual user logs in as |
35 3.4 VMailMgr IMAP support |
35 `virtualuser@virtual.host' or `virtualuser:virtual.host') |
36 3.5 Enabling enforcement of virtual user quotas |
36 |
37 3.6 Enabling processing of autoresponses |
37 You should use VMailMgr if you prefer to have each domain controlled |
38 3.7 Web-based interfaces for vmailmgr |
38 by a seperate username, allowing the use of system quotas and better |
39 |
39 security. |
40 |
40 _________________________________________________________________ |
41 ______________________________________________________________________ |
41 |
42 |
42 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
43 11.. IInnttrroodduuccttiioonn |
43 ? ] |
44 |
44 |
45 VMailMgr (short for Virtual MAIL ManaGeR) is a package of programs |
45 1.2 New versions |
46 designed to manage multiple domains of mail addresses and mailboxes on |
46 |
47 a single host. It co-operates with qmail for mail delivery and program |
47 The newest version of this document can be found on the VMailMgr |
48 control. |
48 homepage http://www.vmailmgr.org/ in various formats, including the |
49 |
49 texinfo source and HTML and plaintext versions. |
50 11..11.. WWhhaatt iiss VVMMaaiillMMggrr aanndd wwhhyy sshhoouulldd II uussee iitt?? |
50 _________________________________________________________________ |
51 |
51 |
52 VMailMgr is: |
52 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
53 |
53 ? ] |
54 A series of utilities for managing virtual domains which include a |
54 |
55 password checking interface for qmail which replaces the usual |
55 1.3 Comments |
56 checkpassword, and an authentication module for Courier IMAP, that |
56 |
57 provide access to the virtual mailboxes by one of three methods: |
57 Comments on this HOWTO should be directed to the VMailMgr mailing |
58 |
58 list. To subscribe, send a blank email to |
59 +o IP-based virtual server access (invisible to the POP3 user) |
59 vmailmgr-subscribe@lists.untroubled.org. |
60 |
60 _________________________________________________________________ |
61 +o username-based access (username-virtualuser) |
61 |
62 |
62 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
63 +o hostname-based access (virtualuser@virtual.host or |
63 ? ] |
64 virtualuser:virtual.host) |
64 |
65 |
65 1.4 History |
66 |
66 |
67 You should use it if you prefer to have each domain controlled by a |
67 This document was started by Bruce Guenter and reworked by Dan |
68 seperate username, allowing the use of system quotas and better |
68 Kuykendall, then by Charles Cazabon. |
69 security |
69 _________________________________________________________________ |
70 |
70 |
71 11..22.. NNeeww vveerrssiioonnss |
71 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
72 |
72 ? ] |
73 The newest version of this can be found on the VMailMgr homepage |
73 |
74 <http://www.vmailmgr.org/> in its HTML version as well as in the |
74 1.5 Copyrights and Trademarks |
75 source package SGML source, HTML, and text. Other versions may be |
75 |
76 found in different formats at the LDP homepage |
76 Copyright (C) Dan Kuykendall. |
77 <http://www.linuxdoc.org/>. |
77 |
78 |
78 Permission is granted to copy, distribute and/or modify this document |
79 11..33.. CCoommmmeennttss |
79 under the terms of the GNU Free Documentation License, Version 1.1 or |
80 |
80 any later version published by the Free Software Foundation |
81 Comments on this HOWTO should be directed to the VMailMgr mailing |
81 |
82 list. To subscribe, send an email to vmailmgr-subscribe@lists.em.ca |
82 A copy of the license is available at GNU Free Documentation License. |
83 <mailto:vmailmgr-subscribe@lists.em.ca>. |
83 _________________________________________________________________ |
84 |
84 |
85 11..44.. HHiissttoorryy |
85 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
86 |
86 ? ] |
87 This document was started by Bruce Guenter and reworked by Dan |
87 |
88 Kuykendall. |
88 1.6 Acknowledgements and Thanks |
89 |
89 |
90 11..55.. CCooppyyrriigghhttss aanndd TTrraaddeemmaarrkkss |
90 Thanks to Bruce Guenter for VMailMgr and the core of this HOWTO. |
91 |
91 Thanks to Mike Bell, who always seems to have the answers to my |
92 Copyright (c) Dan Kuykendall. Permission is granted to copy, |
92 questions. Finally, thanks to all those on the |
93 distribute and/or modify this document under the terms of the GNU Free |
93 vmailmgr@lists.untroubled.org mailing list who have helped me, or |
94 Documentation License, Version 1.1 or any later version published by |
94 asked the same stuff so many times that I had to write this to stop |
95 the Free Software Foundation |
95 the repeat questions. |
96 |
96 _________________________________________________________________ |
97 A copy of the license is available at GNU Free Documentation License |
97 |
98 <http://www.gnu.org/copyleft/fdl.txt>. |
98 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
99 |
99 ? ] |
100 11..66.. AAcckknnoowwlleeddggeemmeennttss aanndd TThhaannkkss |
100 |
101 |
101 2. Installation |
102 Thanks to Bruce Guenter for VMailMgr and the core of this HOWTO. |
102 _________________________________________________________________ |
103 Thanks to Mike Bell, who always seems to have the answers to my |
103 |
104 questions. Finally, thanks to all those on the vmailmgr@lists.em.ca |
104 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
105 <mailto:vmailmgr@lists.em.ca> mailing list who have helped me, or |
105 ? ] |
106 asked the same stuff so many times that I had to write this to stop |
106 |
107 the repeat questions. |
107 2.1 Get the files |
108 |
108 |
109 22.. IInnssttaallllaattiioonn |
109 Visit the VMailMgr website http://www.vmailmgr.org/ or one of its |
110 |
110 mirror sites to download the package. There are two primary methods of |
111 22..11.. GGeett tthhee ffiilleess |
111 installing: |
112 |
112 |
113 Visit the VMailMgr website <http://www.vmailmgr.org/> to get the |
113 * from source |
114 package. |
114 * from a binary package -- specifically, an RPM binary package |
115 |
115 |
116 If you get the binary RPMS you will need at least the vmailmgr |
116 If you get the binary RPMS you will need at least the vmailmgr |
117 package. |
117 package. |
118 |
118 _________________________________________________________________ |
119 22..22.. IInnssttaallll wwiitthh RRPPMMSS |
119 |
120 |
120 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
121 22..22..11.. CCoommppiilliinngg SSRRCC..RRPPMM''ss |
121 ? ] |
122 |
122 |
123 Simply compile the src.rpm file with the `rpm --rebuild` command. |
123 2.2 Install with RPMS |
124 -Example- |
124 |
125 |
125 To install from binary RPM packages, you can download the binaries, or |
126 ______________________________________________________________________ |
126 build them from the source RPM package. |
127 rpm -ivh vmailmgr-0.96.9-1.src.rpm |
127 _________________________________________________________________ |
128 ______________________________________________________________________ |
128 |
129 |
129 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
130 |
130 ? ] |
131 |
131 |
132 |
132 2.2.1 Compiling the Source RPM (SRPM) Package |
133 22..22..22.. IInnssttaalllliinngg RRPPMM''ss |
133 |
134 |
134 If you download the binary packages directly, skip to the next step. |
135 After compiling the source rpms, the binaries will be located in |
135 |
136 `/usr/src/redhat/RPMS/i386/` or something similar. |
136 Download the source rpm package (`vmailmgr-VERSION.src.rpm'), and then |
137 |
137 use the rpm tool to build the binary RPM package from it with the `rpm |
138 Simply run the following command for each package |
138 --rebuild' command as follows: |
139 |
139 |
140 rpm -ivh <location>/<package.i386.rpm> |
140 |
141 |
141 rpm --rebuild vmailmgr-1.0.0-1.src.rpm |
142 |
142 _________________________________________________________________ |
143 -Example- |
143 |
144 |
144 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
145 ______________________________________________________________________ |
145 ? ] |
146 rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-0.96.9-1.i386.rpm |
146 |
147 rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-daemon-0.96.9-1.i386.rpm |
147 2.2.2 Installing the Binary RPM packages |
148 ______________________________________________________________________ |
148 |
149 |
149 After compiling the source RPM, the binary RPM packages will be |
150 |
150 located in the appropriate output directory (typically |
151 |
151 `/usr/src/redhat/RPMS/i386/'). |
152 |
152 |
153 |
153 Install each package using the `-i' option of rpm (i.e. `rpm -ivh |
154 22..33.. IInnssttaallll wwiitthh ssoouurrccee |
154 PACKAGE.i386.rpm') as follows: |
155 |
155 |
156 If you dont ue RPMS you can install from source. |
156 |
157 |
157 rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-1.0.0-1.i386.rpm |
158 Run the following command |
158 rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-daemon-1.0.0-1.i386.rpm |
159 |
159 _________________________________________________________________ |
160 (As non-root user) |
160 |
161 tar zxf <package.tar.gz> |
161 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
162 cd <newly created dir> |
162 ? ] |
163 ./configure |
163 |
164 make |
164 2.3 Install from source |
165 (As root) |
165 |
166 make install |
166 If you dont use RPM packages, you can install from source with the |
167 |
167 following commands. First, as a regular, non-root user: |
168 |
168 |
169 -Example- |
169 |
170 |
170 tar xzf `vmailmgr-VERSION.tar.gz' |
171 ______________________________________________________________________ |
171 cd `vmailmgr-VERSION' |
172 (As non-root user) |
172 ./configure |
173 tar zxf vmailmgr-0.96.9.tar.gz |
173 make |
174 cd vmailmgr-0.96.9 |
174 |
175 ./configure |
175 Then, as user `root': |
176 make |
176 |
177 (As root) |
177 |
178 make install |
178 make install |
179 ______________________________________________________________________ |
179 _________________________________________________________________ |
180 |
180 |
181 |
181 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
182 That should do it. |
182 ? ] |
183 |
183 |
184 33.. SSeettuupp |
184 3. Setup |
185 |
185 |
186 In the following setup examples, it is assumed that your binaries are |
186 In the following setup examples, it is assumed that your binaries are |
187 installed in `/usr/bin`, and configuration is in `/etc/vmailmgr`, as |
187 installed in the `/usr/bin]' directory, and configuration files are |
188 is the case if you installed from the RPMs. If you installed from |
188 located in the `/etc/vmailmgr/' directory, as is the case if you |
189 source, configure puts the binaries into `/usr/local/bin` and the |
189 installed from the RPMs. |
190 configuration into `/usr/local/etc/vmailmgr` by default. |
190 |
191 |
191 If you installed from source, configure instead puts the binaries into |
192 33..11.. SSeettttiinngg UUpp aa VViirrttuuaall DDoommaaiinn |
192 `/usr/local/bin/' and the configuration into |
193 |
193 `/usr/local/etc/vmailmgr/' by default. |
194 The following steps are necessary to set up a virtual domain with |
194 _________________________________________________________________ |
195 vmailmgr (assuming vmailmgr has been compiled and installed). As an |
195 |
196 example, we'll set up a virtual user `me@mydomain.org`, with aliases |
196 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
197 of `myself@mydomain.org` and `myname@mydomain.org`. |
197 ? ] |
198 |
198 |
199 1. Set up a DNS entry for the domain. This is not covered here, as it |
199 3.1 Setting Up a Virtual Domain |
200 is dependant on far too many other things. I will mention that to |
200 |
201 make IP based virtual domains work a PTR record which matches an |
201 The following steps are necessary to set up a virtual domain with |
202 entry in virtualdomains is nessesary, for example, if nslookup |
202 vmailmgr (assuming vmailmgr has been compiled and installed). As an |
203 10.56.33.122 returns mail.mydomain.com, `virtualdomains` needs an |
203 example, we'll set up a virtual user `me@mydomain.org', with aliases |
204 entry like `mail.mydomain.com:myuser' For the example, we'll assume |
204 of `myself@mydomain.org' and `myname@mydomain.org'. |
205 that the mail exchanger for mydomain.org is already set up to point |
205 |
206 to your computer. |
206 1. Set up a DNS entry for the domain. This is not covered here, as it |
207 |
207 is dependant on far too many other things. I will mention that to |
208 2. Set up a base user for the domain. Create a user, with a name of |
208 make IP based virtual domains work a `PTR' record which matches an |
209 your choosing. Since the maildirs for all the users in the virtual |
209 entry in virtualdomains is nessesary, for example, if nslookup |
210 domain will be stored under this user's home directory, make sure |
210 10.56.33.122 returns `mail.mydomain.com', `control/virtualdomains' |
211 you set the user up in a partition or disk that is appropriate for |
211 needs an entry like `mail.mydomain.com:myuser'. |
212 such storage. The tools that you should use to accomplish this step |
212 For the example, we'll assume that the mail exchanger for |
213 vary greatly between different systems. For our example, I'll add a |
213 `mydomain.org' is already set up to point to your computer. |
214 user `myuser`. |
214 2. Set up a base user for the domain. Create a user, with a name of |
215 |
215 your choosing. Since the maildirs for all the users in the virtual |
216 3. Configure qmail to recognize the domain. To do this, you need to |
216 domain will be stored under this user's home directory, make sure |
217 modify two of qmail's configuration files in `/var/qmail/control` |
217 you set the user up in a partition or disk that is appropriate for |
218 `rcpthosts` and `virtualdomains`. |
218 such storage. The tools that you should use to accomplish this |
219 |
219 step vary greatly between different systems. For our example, I'll |
220 +o To `rcpthosts` : add the line `mydomain.org`. |
220 add a user `myuser'. |
221 |
221 3. Configure qmail to recognize the domain. To do this, you need to |
222 +o To `virtualdomains` : add the line `mydomain.org:myuser`. |
222 modify two of qmail's configuration files in `/var/qmail/control': |
223 |
223 `rcpthosts' and `virtualdomains'. |
224 If you wish to have mail to `anything.mydomain.org` be delivered in |
224 + To `rcpthosts', add the line `mydomain.org'. |
225 the same way, add the following |
225 + To `virtualdomains', add the line `mydomain.org:myuser'. |
226 |
226 If you wish to have mail to `anything.mydomain.org' be delivered |
227 +o To `rcpthosts` : add the line `.mydomain.org`. |
227 in the same way: |
228 |
228 + To `rcpthosts', add the line `.mydomain.org'. |
229 +o To `virtualdomains` : add the line `.mydomain.org:myuser`. |
229 + To `virtualdomains', add the line `.mydomain.org:myuser'. |
230 |
230 4. Configure qmail-popup/qmail-pop3d to use checkvpw as the password |
231 4. Configure qmail-popup/qmail-pop3d to use `checkvpw` as the password |
231 checker. This step is dependant on how you have installed qmail. |
232 checker. This step is dependant on how you have installed qmail. |
232 + Replace checkpassword in the command you use to invoke |
233 |
233 qmail-popup/qmail-pop3d (either in `/etc/inet.conf' or in a |
234 +o Replace `checkpassword` in the command you use to invoke qmail- |
234 tcpserver command) with checkvpw. |
235 popup/qmail-pop3d (either in `/etc/inet.conf` or in a `tcpserver` |
235 + And/Or at the prompt type `echo checkvpw > |
236 command) with `checkvpw`. |
236 `/var/qmail/control/checkpassword''. |
237 |
237 5. Set up the vmailmgr files: |
238 +o And/Or at the prompt type: `echo checkvpw > |
238 + Either change user to the user you just created (for example, |
239 /var/qmail/control/checkpassword` |
239 type `su - myuser') or log in (with either telnet or at the |
240 |
240 console) as the new user. |
241 5. Set up the vmailmgr files: |
241 + Set up the base vmailmgr files by running vsetup. |
242 |
242 + Use the included programs to add users and aliases. For our |
243 +o Either change user to the user you just created (for example, type |
243 example, we would type the following commands: |
244 `su - myuser`) or log in (with either telnet or at the console) as |
244 |
245 the new user. |
245 |
246 |
246 vadduser me |
247 +o Set up the base vmailmgr files by running `vsetup`. |
247 vaddalias myself me |
248 |
248 vaddalias myname me |
249 +o Use the included programs to add users and aliases. For our |
249 |
250 example, we would type the following commands: |
250 After you have completed all these steps, you will need to kill and |
251 |
251 restart qmail-send to make it read the new `virtualdomains' control |
252 vadduser me |
252 file. |
253 vaddalias myself me |
253 |
254 vaddalias myname me |
254 If you are using inetd to launch qmail-popup, `kill -HUP' the inetd |
255 |
255 process as well. |
256 |
256 _________________________________________________________________ |
257 |
257 |
258 After you have completed all these steps, you will need to kill and |
258 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
259 restart `qmail-send` to make it read the new `virtualdomains` table. |
259 ? ] |
260 |
260 |
261 If you are using `inetd` to launch `qmail-popup`, `kill -HUP` the |
261 3.2 Using one IP address for mutiple domains |
262 `inetd` process as well. |
262 |
263 |
263 There are two ways to log in without using multiple IP addresses. |
264 |
264 |
265 33..22.. UUssiinngg oonnee IIPP aaddddrreessss ffoorr mmuuttiippllee ddoommaaiinnss |
265 1. The first way is to log in as `userSEPvirtual.domain.org', where |
266 |
266 `user' is the mailbox name of the virtual user, SEP is one of `@' |
267 There are two ways to log in without using multiple IP addresses. |
267 or `:' (by default; this is configurable in the `/etc/vmailmgr/' |
268 |
268 directory), and `virtual.domain.org' is the virtual domain's name, |
269 |
269 as listed in `/var/qmail/control/virtualdomains'. |
270 1. The first way is to log in as `userSEPvirtual.domain.org`, where |
270 2. The second way is to use the internal form of the mailbox name -- |
271 `user` is the mailbox name of the virtual user, SEP is one of `@` |
271 that is, `baseuser-user', where `user' is the same as above, and |
272 or `:` (by default, this is configurable in the `/etc/vmailmgr/' |
272 `baseuser' is the username of the managing user. |
273 directory), and `virtual.domain.org' is the virtual domain's name, |
273 |
274 as listed in `/var/qmail/control/virtualdomains'. |
274 For example, if `/var/qmail/control/virtualdomains' contains |
275 |
275 `mydomain.com:myuser' and user `myuser' exists and has set up a |
276 2. The second way is to use the internal form of the mailbox name -- |
276 virtual mailbox with the name `me', and the `separators' configuration |
277 that is, `baseuser-user', where `user' is the same as above, and |
277 file `/etc/vmailmgr/' contains `@', this virtual user could log in as |
278 `baseuser' is the username of the managing user. |
278 `me@mydomain.com', `me:mydomain.com', or `myuser-me'. |
279 |
279 _________________________________________________________________ |
280 Example: `/var/qmail/control/virtualdomains' contains |
280 |
281 |
281 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
282 testdomain.org:testuser |
282 ? ] |
283 |
283 |
284 |
284 3.3 Catching all misdirected mail in a virtual domain |
285 User `myuser' exists, and has set up a virtual mailbox with the name |
285 |
286 `me'. The `separators' variable in `/etc/vmailmgr/' contains `@:'. |
286 In the vmailmgr configuration directory, there is a file called |
287 This virtual user could log in as `me@mydomain.com', `me:mydomain.cm', |
287 `default-username'. If mail to a virtual domain does not match any |
288 or `myuser-me'. |
288 users or aliases in that domain, it is delivered to the name listed in |
289 |
289 this configuration item if it exists (which defaults to `+'). To make |
290 |
290 this deliver to you, simply type `vaddalias + me'. |
291 |
291 _________________________________________________________________ |
292 33..33.. CCaattcchhiinngg aallll mmiissddiirreecctteedd mmaaiill iinn aa vviirrttuuaall ddoommaaiinn |
292 |
293 |
293 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
294 In the `vmailmgr/' configuration directory, there is an entry called |
294 ? ] |
295 `default-username'. If mail to a virtual domain does not match any |
295 |
296 users or aliases in that domain, it is delivered to the name listed in |
296 3.4 VMailMgr IMAP support |
297 this configuration item if it exists (which defaults to `+'). To make |
297 |
298 this deliver to you, simply type: |
298 VMailMgr supports Courier-IMAP, but Courier-IMAP does not come with an |
299 |
299 authentication module for VMailMgr. This means that some minor work is |
300 vaddalias + me |
300 required for making the two work together. |
301 |
301 |
302 |
302 The steps are: |
303 |
303 |
304 33..44.. VVMMaaiillMMggrr IIMMAAPP ssuuppppoorrtt |
304 * Copy `/usr/bin/authvmailmgr' to |
305 |
305 `/usr/lib/courier-imap/libexec/authlib/authvmailmgr'. |
306 VMailMgr supports Courier-IMAP, but Courier-IMAP does not come with an |
306 * Modify the AUTHMODULES statement in |
307 authentication module for VMailMgr. This means that some minor work |
307 `/usr/lib/courier-imap/etc/imapd.config' and add `authvmailmgr' as |
308 is required for making the two work together. |
308 the first authentication module. |
309 |
309 _________________________________________________________________ |
310 +o You must copy `/usr/bin/authvmailmgr` to `/usr/lib/courier- |
310 |
311 imap/libexec/authlib/authvmailmgr`. |
311 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
312 |
312 ? ] |
313 +o Then modify the `AUTHMODULES` statement in `/usr/lib/courier- |
313 |
314 imap/etc/imapd.config` and add `authvmailmgr` as the first |
314 3.5 Enabling enforcement of virtual user quotas |
315 authentication module. |
315 |
316 |
316 VMailMgr supports per-virtual-user quotas, but not out of the box, as |
317 33..55.. EEnnaabblliinngg eennffoorrcceemmeenntt ooff vviirrttuuaall uusseerr qquuoottaass |
317 it is not needed by the majority of users, and requires an extra |
318 |
318 program to be run on each delivery. |
319 VMailMgr supports per-virtual-user quotas, but not out of the box, as |
319 |
320 it is not needed by the majority of users, and requires an extra |
320 To configure quota support, create the file |
321 program to be run on each delivery. To configure quota support, |
321 `/etc/vmailmgr/vdeliver-predeliver', containing the following: |
322 create the file `/etc/vmailmgr/vdeliver-predeliver`, containing the |
322 |
323 following: |
323 |
324 |
324 #!/bin/sh |
325 #!/bin/sh |
325 /usr/bin/vcheckquota |
326 /usr/bin/vcheckquota |
326 |
327 |
327 This is executed as a shell script, so you will need to make it |
328 |
328 executable by running the command `chmod +x |
329 This is executed as a shell script, so you will need to make it exe- |
329 /etc/vmailmgr/vdeliver-predeliver'. |
330 cutable by running the following command: |
330 _________________________________________________________________ |
331 chmod +x /etc/vmailmgr/vdeliver-predeliver |
331 |
332 |
332 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
333 |
333 ? ] |
334 |
334 |
335 33..66.. EEnnaabblliinngg pprroocceessssiinngg ooff aauuttoorreessppoonnsseess |
335 3.6 Enabling processing of autoresponses |
336 |
336 |
337 Download and install the qmail-autoresponder package, found at |
337 Download and install the qmail-autoresponder package, found at |
338 <http://em.ca/~bruceg/qmail-autoresponder/>. As with the above |
338 http://untroubled.org/qmail-autoresponder/. |
339 section, create a shell script `/etc/vmailmgr/vdeliver-postdeliver`, |
339 |
340 containing the following: |
340 As with the above section, create a shell script |
341 |
341 `/etc/vmailmgr/vdeliver-postdeliver', containing the following: |
342 #!/bin/sh |
342 |
343 if test -s $MAILDIR/autoresponse/message.txt |
343 |
344 then |
344 #!/bin/sh |
345 qmail-autoresponder $MAILDIR/autoresponse/message.txt $MAILDIR/autoresponse |
345 if test -s $MAILDIR/autoresponse/message.txt ; then |
346 fi |
346 qmail-autoresponder $MAILDIR/autoresponse/message.txt $MAILDIR/autoresponse |
347 |
347 fi |
348 |
348 _________________________________________________________________ |
349 |
349 |
350 33..77.. WWeebb--bbaasseedd iinntteerrffaacceess ffoorr vvmmaaiillmmggrr |
350 [ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [ |
351 |
351 ? ] |
352 There are currently a few working solutions to administrate your |
352 |
353 vmailmgr system via a web interface. Only requirement is that the |
353 3.7 Web-based interfaces for vmailmgr |
354 vmailmgrd daemon is running, and that you have a webserver on your |
354 |
355 system. |
355 There are currently a few working solutions to administrate your |
356 |
356 vmailmgr system via a web interface. Only requirement is that the |
357 1. For Python fans, there is vpyadmin by Bruce Guenter. The files can |
357 vmailmgrd daemon is running, and that you have a webserver on your |
358 be downloaded at <http://em.ca/~bruceg/vpyadmin/>, and the |
358 system. |
359 development code is online at <http://bruce- |
359 |
360 guenter.dyndns.org/cgi-bin/vpyadmin/> (sample.org / samplevm). |
360 * For Python fans, there is vpyadmin by Bruce Guenter. The files can |
361 |
361 be downloaded at http://untroubled.org/vpyadmin/, and the |
362 2. And if you like PHP, you can use oMail-admin by Olivier Mller: it |
362 development code is online at |
363 fully supports all vmailmgr functions, and speaks englich, french, |
363 http://bruce-guenter.dyndns.org/cgi-bin/vpyadmin/ (sample.org / |
364 italian, spanish, german and russian. Project homepage: |
364 samplevm). |
365 <http://omail.omnis.ch>. Online demo: |
365 * And if you like PHP, you can use oMail-admin by Olivier Müller: it |
366 <http://admin.omnis.ch/omail/> (test.com / test). |
366 fully supports all vmailmgr functions, and speaks englich, french, |
367 |
367 italian, spanish, german and russian. Project homepage: |
368 3. And there are also C-based CGI scripts in the cgi directory of the |
368 http://omail.omnis.ch. Online demo: http://admin.omnis.ch/omail/ |
369 vmailmgr distribution. |
369 (test.com / test). |
370 |
370 * And there are also C-based CGI scripts in the `cgi' subdirectory |
371 |
371 of the vmailmgr distribution. |
372 |
372 _________________________________________________________________ |
373 |
373 |
374 |
374 [Top] [Contents] [Index] [ ? ] |
375 |
375 |
376 |
376 Table of Contents |
377 |
377 |
378 |
378 1. Introduction |
379 |
379 |
380 |
380 1.1 What is VMailMgr and why should I use it? |
381 |
381 1.2 New versions |
382 |
382 1.3 Comments |
383 |
383 1.4 History |
384 |
384 1.5 Copyrights and Trademarks |
385 |
385 1.6 Acknowledgements and Thanks |
386 |
386 |
387 |
387 2. Installation |
388 |
388 2.1 Get the files |
389 |
389 2.2 Install with RPMS |
390 |
390 |
391 |
391 2.2.1 Compiling the Source RPM (SRPM) Package |
392 |
392 2.2.2 Installing the Binary RPM packages |
393 |
393 |
394 |
394 2.3 Install from source |
395 |
395 3. Setup |
396 |
396 3.1 Setting Up a Virtual Domain |
|
397 3.2 Using one IP address for mutiple domains |
|
398 3.3 Catching all misdirected mail in a virtual domain |
|
399 3.4 VMailMgr IMAP support |
|
400 3.5 Enabling enforcement of virtual user quotas |
|
401 3.6 Enabling processing of autoresponses |
|
402 3.7 Web-based interfaces for vmailmgr |
|
403 _________________________________________________________________ |
|
404 |
|
405 [Top] [Contents] [Index] [ ? ] |
|
406 |
|
407 Short Table of Contents |
|
408 |
|
409 1. Introduction |
|
410 2. Installation |
|
411 3. Setup |
|
412 _________________________________________________________________ |
|
413 |
|
414 [Top] [Contents] [Index] [ ? ] |
|
415 |
|
416 About this document |
|
417 |
|
418 This document was generated by Bruce.Guenter.dyndns.org on December, |
|
419 29 2004 using texi2html |
|
420 |
|
421 The buttons in the navigation panels have the following meaning: |
|
422 |
|
423 Button Name Go to From 1.2.3 go to |
|
424 [ < ] Back previous section in reading order 1.2.2 |
|
425 [ > ] Forward next section in reading order 1.2.4 |
|
426 [ << ] FastBack previous or up-and-previous section 1.1 |
|
427 [ Up ] Up up section 1.2 |
|
428 [ >> ] FastForward next or up-and-next section 1.3 |
|
429 [Top] Top cover (top) of document |
|
430 [Contents] Contents table of contents |
|
431 [Index] Index concept index |
|
432 [ ? ] About this page |
|
433 |
|
434 where the Example assumes that the current position is at |
|
435 Subsubsection One-Two-Three of a document of the following structure: |
|
436 * 1. Section One |
|
437 |
|
438 * 1.1 Subsection One-One |
|
439 |
|
440 * ... |
|
441 |
|
442 1.2 Subsection One-Two |
|
443 * 1.2.1 Subsubsection One-Two-One |
|
444 * 1.2.2 Subsubsection One-Two-Two |
|
445 * 1.2.3 Subsubsection One-Two-Three <== Current Position |
|
446 * 1.2.4 Subsubsection One-Two-Four |
|
447 |
|
448 1.3 Subsection One-Three |
|
449 * ... |
|
450 |
|
451 1.4 Subsection One-Four |
|
452 _________________________________________________________________ |
|
453 |
|
454 This document was generated by Bruce.Guenter.dyndns.org on December, |
|
455 29 2004 using texi2html |