diff --git a/LDP/howto/linuxdoc/VMailMgr-HOWTO.sgml b/LDP/howto/linuxdoc/VMailMgr-HOWTO.sgml new file mode 100644 index 00000000..4320812f --- /dev/null +++ b/LDP/howto/linuxdoc/VMailMgr-HOWTO.sgml @@ -0,0 +1,262 @@ + + + +
+ + VMailMgr HOWTO + + + Bruce Guenter <bruceg@em.ca>, + Dan Kuykendall <dan@kuykendall.org> + + + v1.1, 23 April 2000 + + + This document explains how to setup VMailMgr support pop3 virtual domain + services in conjunction with Qmail. + + + +Introduction +

+ VMailMgr (short for Virtual MAIL ManaGeR) is a package of programs designed to manage + multiple domains of mail addresses and mailboxes on a single host. It co-operates with + qmail for mail delivery and program control. +

+What is VMailMgr and why should I use it? +

+ VMailMgr is:

+ A series of utilities for managing virtual domains which include a password checking interface for qmail which + replaces the usual checkpassword, and an authentication module + for Courier IMAP, that provide access to the virtual mailboxes by one of + three methods: + + IP-based virtual server access (invisible to the POP3 user) + username-based access (username-virtualuser) + hostname-based access (virtualuser@virtual.host or virtualuser:virtual.host) + + + You should use it if:

+ You prefer to have each domain controlled by a seperate username, + allowing the use of system quotas and better security +

+New versions +

+ The newest version of this can be found on my homepage as SGML source, as HTML and as TEXT. + Other versions may be found in different formats at the LDP homepage . + A copy can also be found on the VMailMgr homepage + in its HTML version as well as in the VMailMgr source package as both + SGML source and as HTML. +

+Comments +

+ Comments on this HOWTO should be directed to the VMailMgr mailing list. + To subscribe, send an email to . +

+History +

+ This document was started by Bruce Guenter and reworked by Dan Kuykendall. +

+Version History +

+ Old Version +

+

+ + Created by Bruce, wasn't in SGML HOWTO format. + +

+ v1.0 (April 20, 2000) +

+

+ + Built proper SGML version. + Included the FAQ. + Other minor additions. + +

+

+ v1.1 (April 23, 2000) +

+

+ + Split the FAQ to a seperate file, but included some important info from the FAQ. + Updated the Courier-IMAP support section. + Switched the license to the GNU FDL. + Other minor additions. + +

+Copyrights and Trademarks +

+ Copyright (c) Dan Kuykendall. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.1 + or any later version published by the Free Software Foundation +

+

+ A copy of the license is available at + . +

+Acknowledgements and Thanks +

+ Thanks to Bruce Guenter for VMailMgr and the core of this HOWTO. Thanks to Mike Bell, + who always seems to have the answers to my questions. Finally, thanks to all those on the + mailing list who have helped me, or asked the same + stuff so many times that I had to write this to stop the repeat questions. +

+Installation +Get the files + Visit the VMailMgr website to get the package. +

+ If you get the binary RPMS you will need at least the vmailmgr and vmailmgr-daemon packages. +

+Install with RPMS +Compiling SRC.RPM's +

+ Simply compile the src.rpm file with the `rpm --rebuild` command. + -Example- + + rpm -ivh vmailmgr-0.96.6-1.src.rpm + +Installing RPM's +

+ After compiling the source rpms, the binaries will be located + in `/usr/src/redhat/RPMS/i386/` or something similar. + + Simply run the following command for each package + + rpm -ivh / + + -Example- + + rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-0.96.6-1.i386.rpm + rpm -ivh /usr/src/redhat/RPMS/i386/VMailMgr-daemon-0.96.6-1.i386.rpm + + +Install with source +

+ If you dont ue RPMS you can install from source.

+ Run the following command + + (As non-root user) + tar zxf + cd + ./configure + make + (As root) + make install + + -Example- + + (As non-root user) + tar zxf vmailmgr-0.96.6.tar.gz + cd vmailmgr-0.96.6 + ./configure + make + (As root) + make install + + That should do it. +

+Setup +Setting Up a Virtual Domain +

+ The following steps are necessary to set up a virtual domain with vmailmgr + (assuming vmailmgr has been compiled and installed). As an example, we'll + set up a virtual user `me@mydomain.org`, with aliases of `myself@mydomain.org` + and `myname@mydomain.org`. + + Set up a DNS entry for the domain. I won't cover this here, as it is dependant + on far too many other things. + I will mention that to make IP based virtual domains work a PTR record which matches + an entry in virtualdomains is nessesary, for example, if nslookup 10.56.33.122 returns + mail.mydomain.com, `virtualdomains` needs an entry like `mail.mydomain.com:myuser` +

+ For the example, we'll assume that the mail exchanger for mydomain.org is already set up to point to your computer. + + Set up a base user for the domain. Create a user, with a name of your choosing. + Since the maildirs for all the users in the virtual domain will be stored under + this user's home directory, make sure you set the user up in a partition or disk + that is appropriate for such storage. The tools that you should use to accomplish + this step vary greatly between different systems. For our example, I'll add a user `myuser`. + Configure qmail to recognize the domain. To do this, you need to modify two of + qmail's configuration files in `/var/qmail/control` `rcpthosts` and `virtualdomains`. + + To `rcpthosts` : + add the line `mydomain.org`. + To `virtualdomains` : + add the line `mydomain.org:myuser`. + + If you wish to have mail to `anything.mydomain.org` be delivered in the same way, add the following + + To `rcpthosts` : + add the line `.mydomain.org`. + To `virtualdomains` : + add the line `.mydomain.org:myuser`. + + Configure qmail-popup/qmail-pop3d to use `checkvpw` as the password checker. This step + is dependant on how you have installed qmail. + + Replace `checkpassword` in the command you use to invoke qmail-popup/qmail-pop3d + (either in `/etc/inet.conf` or in a `tcpserver` command) with `checkvpw`. + And/Or at the prompt type: `echo checkvpw > /var/qmail/control/checkpassword` + + Add users or aliases to the domain. Either change user to the user you just created + (for example, type `su - myuser`) or log in (with either telnet or at the console) as + the new user, and use the included programs to add users and aliases. +

+ For our example, we would + + type: `vadduser me` (which prompts for a password) + type: `vaddalias me myself` + and type: `vaddalias me myname` + + + After you have completed all these steps, you will need to kill and restart `qmail-send` to + make it read the new `virtualdomains` table. +

+ If you are using `inetd` to launch `qmail-popup`, `kill -HUP` the `inetd` process as well. +

+Using one IP address for mutiple domains +Logging in as a virtual user? +

+ There are two ways to log in without using multiple IP addresses. +

+ + The first way is to log in as `userSEPvirtual.domain.org`, where `user` is the mailbox name of the virtual user, SEP is one of `@` or + `:` (by default, this is configurable in the `/etc/vmailmgr/' directory), and `virtual.domain.org' is the virtual domain's name, as + listed in `/var/qmail/control/virtualdomains'. + The second way is to use the internal form of the mailbox name -- that is, `baseuser-user', where `user' is the same as above, and + `baseuser' is the username of the managing user. + + Example: `/var/qmail/control/virtualdomains' contains + + testdomain.org:testuser + + User `myuser' exists, and has set up a virtual mailbox with the name `me'. The `separators' variable in `/etc/vmailmgr/' contains + `@:'. This virtual user could log in as `me@mydomain.com', `me:mydomain.cm', or `myuser-me'. +

+Catch all misdirected mail? +

+ In the `vmailmgr/' configuration directory, there is an entry called `default-username'. If mail to a virtual domain does not match any + users or aliases in that domain, it is delivered to the name listed in this configuration item if it exists (which defaults to `+'). To make this deliver + to you, simply type: + + vaddalias me + + +

+Setup VMailMgr IMAP support? +

+ VMailMgr supports Courier-IMAP, but Courier-IMAP does not auto detect VMailMgr. + This means that some minor work is required for making the two work together. + + You must copy `/usr/local/bin/authvmailmgr` to + `/usr/lib/courier-imap/libexec/authlib/authvmailmgr`. + Then modify the `AUTHMODULES` statement in + `/usr/lib/courier-imap/etc/imapd.config` and add `authvmailmgr` as the first + authentication module. + +

+