Mercurial Mercurial > vmailmgr / comparison
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/HOWTO.html
changeset 2 b3afb9f1e801
parent 0 6f7a81934006
equal deleted inserted replaced
1:30113bfbe723 2:b3afb9f1e801 
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
 
       
     2 <HTML>
 
     1 <HTML>
 
       
     2 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
       
     3 <!-- Created on December, 29  2004 by texi2html 1.64 -->
 
       
     4 <!-- 
       
     5 Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
 
       
     6             Karl Berry  <karl@freefriends.org>
 
       
     7             Olaf Bachmann <obachman@mathematik.uni-kl.de>
 
       
     8             and many others.
 
       
     9 Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
 
       
    10 Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
 
       
    11  
       
    12 -->
 
     3 <HEAD>
 
    13 <HEAD>
 
     4  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
 
    14 <TITLE>VMailMgr HOWTO: </TITLE>
 
     5  <TITLE>  VMailMgr HOWTO</TITLE>
 
    15 
     6 
    16 <META NAME="description" CONTENT="VMailMgr HOWTO: ">
 
       
    17 <META NAME="keywords" CONTENT="VMailMgr HOWTO: ">
 
       
    18 <META NAME="resource-type" CONTENT="document">
 
       
    19 <META NAME="distribution" CONTENT="global">
 
       
    20 <META NAME="Generator" CONTENT="texi2html 1.64">
 
     7 
    21 
     8 </HEAD>
 
    22 </HEAD>
 
     9 <BODY>
 
    23 
    10 <H1>  VMailMgr HOWTO</H1>
 
    24 <BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
 
    11 
    25 
    12 <H2>Bruce Guenter 
    26 <A NAME="SEC1"></A>
 
    13 <A HREF="mailto:bruceg@em.ca">mailto:bruceg@em.ca</A>,
 
    27 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
    14   Dan Kuykendall 
    28 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> &lt; </A>]</TD>
 
    15 <A HREF="mailto:dan@kuykendall.org">mailto:dan@kuykendall.org</A></H2>  v1.w, 2000-09-15
 
    29 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC2"> &gt; </A>]</TD>
 
    16 <P><HR>
 
    30 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
    17 <EM>  This document explains how to setup VMailMgr support pop3 virtual domain   services in conjunction with Qmail.</EM>
 
    31 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
    18 <HR>
 
    32 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
    19 <H2><A NAME="s1">1. Introduction</A></H2>
 
    33 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
    20 
    34 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
    21 <P>VMailMgr (short for Virtual MAIL ManaGeR) is a package of programs
 
    35 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
    36 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
    37 </TR></TABLE>
 
       
    38 <P>
 
       
    39 
       
    40 Copyright (C) 1998 Bruce Guenter
 
       
    41 </P><P>
 
       
    42 
       
    43 This document explains how to setup VMailMgr support pop3 virtual domain 
       
    44 services in conjunction with Qmail.
 
       
    45 </P><P>
 
       
    46 
       
    47 <H1> 1. Introduction </H1>
 
       
    48 <!--docid::SEC1::-->
 
       
    49 <P>
 
       
    50 
       
    51 VMailMgr (an abbreviation for Virtual Mail Manager) is a package of programs
 
    22 designed to manage multiple domains of mail addresses and mailboxes
 
    52 designed to manage multiple domains of mail addresses and mailboxes
 
    23 on a single host. It co-operates with qmail for mail delivery and
 
    53 on a single host.  It co-operates with qmail for mail delivery and
 
    24 program control.
 
    54 program control.
 
    25 <H2>1.1 What is VMailMgr and why should I use it?</H2>
 
    55 </P><P>
 
    26 
    56 
    27 <P>VMailMgr is:
 
    57 <HR SIZE="6">
 
    28 <P> A series of utilities for managing virtual domains
 
    58 <A NAME="SEC2"></A>
 
    29 which include a password checking interface for qmail which replaces
 
    59 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
    30 the usual checkpassword, and an authentication module for Courier
 
    60 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> &lt; </A>]</TD>
 
    31 IMAP, that provide access to the virtual mailboxes by one of three
 
    61 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC3"> &gt; </A>]</TD>
 
       
    62 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
    63 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
    64 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
    65 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
    66 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
    67 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
    68 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
    69 </TR></TABLE>
 
       
    70 <H2> 1.1 What is VMailMgr and why should I use it? </H2>
 
       
    71 <!--docid::SEC2::-->
 
       
    72 <P>
 
       
    73 
       
    74 VMailMgr is a series of utilities for managing virtual domains, including:
 
       
    75 <UL>
 
       
    76 <LI>
 
       
    77 a password checking interface for qmail, which replaces the usual
 
       
    78 checkpassword, and
 
       
    79 <LI>
 
       
    80 an authentication module for Courier IMAP
 
       
    81 </UL>
 
       
    82 <P>
 
       
    83 
       
    84 These utilities provide access to the virtual mailboxes by one of three
 
    32 methods:
 
    85 methods:
 
    33 <UL>
 
    86 </P><P>
 
    34 <LI> IP-based virtual server access (invisible to the POP3 user)</LI>
 
    87 
    35 <LI> username-based access (username-virtualuser)</LI>
 
    88 <UL>
 
    36 <LI> hostname-based access (virtualuser@virtual.host or
 
    89 <LI>
 
    37 virtualuser:virtual.host)</LI>
 
    90 IP-based virtual server access (invisible to the POP3 user)
 
    38 </UL>
 
    91 <LI>
 
    39 <P>You should use it if you prefer to have each domain controlled by a
 
    92 username-based access (virtual user logs in as <SAMP>`username-virtualuser'</SAMP>)
 
       
    93 <LI>
 
       
    94 hostname-based access (virtual user logs in as <SAMP>`virtualuser@virtual.host'</SAMP>
 
       
    95 or <SAMP>`virtualuser:virtual.host'</SAMP>)
 
       
    96 </UL>
 
       
    97 <P>
 
       
    98 
       
    99 You should use VMailMgr if you prefer to have each domain controlled by a
 
    40 seperate username, allowing the use of system quotas and better
 
   100 seperate username, allowing the use of system quotas and better
 
    41 security
 
   101 security.
 
    42 <H2>1.2 New versions </H2>
 
   102 </P><P>
 
    43 
   103 
    44 <P>The newest version of this can be found on the VMailMgr homepage
 
   104 <HR SIZE="6">
 
    45 <A HREF="http://www.vmailmgr.org/">http://www.vmailmgr.org/</A> in its HTML version as well as
 
   105 <A NAME="SEC3"></A>
 
    46 in the source package SGML source, HTML, and text.  Other versions
 
   106 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
    47 may be found in different formats at the LDP homepage 
   107 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC2"> &lt; </A>]</TD>
 
    48 <A HREF="http://www.linuxdoc.org/">http://www.linuxdoc.org/</A>.
 
   108 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC4"> &gt; </A>]</TD>
 
    49 <H2>1.3 Comments </H2>
 
   109 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
    50 
   110 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
    51 <P>Comments on this HOWTO should be directed to the VMailMgr mailing
 
   111 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
    52 list.  To subscribe, send an email to 
   112 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
    53 <A HREF="mailto:vmailmgr-subscribe@lists.em.ca">vmailmgr-subscribe@lists.em.ca</A>.
 
   113 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
    54 <H2>1.4 History </H2>
 
   114 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
    55 
   115 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
    56 <P>This document was started by Bruce Guenter and reworked by Dan
 
   116 </TR></TABLE>
 
    57 Kuykendall.
 
   117 <H2> 1.2 New versions </H2>
 
    58 <H2>1.5 Copyrights and Trademarks </H2>
 
   118 <!--docid::SEC3::-->
 
    59 
   119 <P>
 
    60 <P>Copyright (c)  Dan Kuykendall.
 
   120 
       
   121 The newest version of this document can be found on the VMailMgr homepage
 
       
   122 <A HREF="http://www.vmailmgr.org/">http://www.vmailmgr.org/</A> in various formats, including the
 
       
   123 texinfo source and HTML and plaintext versions.
 
       
   124 </P><P>
 
       
   125 
       
   126 <HR SIZE="6">
 
       
   127 <A NAME="SEC4"></A>
 
       
   128 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   129 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC3"> &lt; </A>]</TD>
 
       
   130 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC5"> &gt; </A>]</TD>
 
       
   131 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   132 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   133 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   134 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   135 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   136 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   137 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   138 </TR></TABLE>
 
       
   139 <H2> 1.3 Comments </H2>
 
       
   140 <!--docid::SEC4::-->
 
       
   141 <P>
 
       
   142 
       
   143 Comments on this HOWTO should be directed to the VMailMgr mailing
 
       
   144 list.  To subscribe, send a blank email to
 
       
   145 <A HREF="mailto:vmailmgr-subscribe@lists.untroubled.org">vmailmgr-subscribe@lists.untroubled.org</A>.
 
       
   146 </P><P>
 
       
   147 
       
   148 <HR SIZE="6">
 
       
   149 <A NAME="SEC5"></A>
 
       
   150 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   151 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC4"> &lt; </A>]</TD>
 
       
   152 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC6"> &gt; </A>]</TD>
 
       
   153 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   154 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   155 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   156 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   157 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   158 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   159 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   160 </TR></TABLE>
 
       
   161 <H2> 1.4 History </H2>
 
       
   162 <!--docid::SEC5::-->
 
       
   163 <P>
 
       
   164 
       
   165 This document was started by Bruce Guenter and reworked by Dan
 
       
   166 Kuykendall, then by Charles Cazabon.
 
       
   167 </P><P>
 
       
   168 
       
   169 <HR SIZE="6">
 
       
   170 <A NAME="SEC6"></A>
 
       
   171 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   172 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC5"> &lt; </A>]</TD>
 
       
   173 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC7"> &gt; </A>]</TD>
 
       
   174 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   175 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   176 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   177 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   178 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   179 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   180 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   181 </TR></TABLE>
 
       
   182 <H2> 1.5 Copyrights and Trademarks </H2>
 
       
   183 <!--docid::SEC6::-->
 
       
   184 <P>
 
       
   185 
       
   186 Copyright (C) Dan Kuykendall.
 
       
   187 </P><P>
 
       
   188 
    61 Permission is granted to copy, distribute and/or modify this document
 
   189 Permission is granted to copy, distribute and/or modify this document
 
    62 under the terms of the GNU Free Documentation License, Version 1.1
 
   190 under the terms of the GNU Free Documentation License, Version 1.1
 
    63 or any later version published by the Free Software Foundation
 
   191 or any later version published by the Free Software Foundation
 
    64 <P>A copy of the license is available at 
   192 </P><P>
 
    65 <A HREF="http://www.gnu.org/copyleft/fdl.txt">GNU Free   Documentation License</A>.
 
   193 
    66 <H2>1.6 Acknowledgements and Thanks </H2>
 
   194 A copy of the license is available at 
    67 
   195 <A HREF="http://www.gnu.org/copyleft/fdl.txt">GNU Free Documentation License</A>.
 
    68 <P>Thanks to Bruce Guenter for VMailMgr and the core of this
 
   196 </P><P>
 
    69 HOWTO. Thanks to Mike Bell, who always seems to have the answers to
 
   197 
       
   198 <HR SIZE="6">
 
       
   199 <A NAME="SEC7"></A>
 
       
   200 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   201 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC6"> &lt; </A>]</TD>
 
       
   202 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC8"> &gt; </A>]</TD>
 
       
   203 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   204 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   205 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   206 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   207 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   208 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   209 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   210 </TR></TABLE>
 
       
   211 <H2> 1.6 Acknowledgements and Thanks </H2>
 
       
   212 <!--docid::SEC7::-->
 
       
   213 <P>
 
       
   214 
       
   215 Thanks to Bruce Guenter for VMailMgr and the core of this
 
       
   216 HOWTO.  Thanks to Mike Bell, who always seems to have the answers to
 
    70 my questions. Finally, thanks to all those on the 
   217 my questions. Finally, thanks to all those on the 
    71 <A HREF="mailto:vmailmgr@lists.em.ca">vmailmgr@lists.em.ca</A>
 
   218 <A HREF="mailto:vmailmgr@lists.untroubled.org">vmailmgr@lists.untroubled.org</A>
 
    72 mailing list who have helped me, or asked the same stuff so many
 
   219 mailing list who have helped me, or asked the same stuff so many
 
    73 times that I had to write this to stop the repeat questions.
 
   220 times that I had to write this to stop the repeat questions.
 
    74 <H2><A NAME="s2">2. Installation</A></H2>
 
   221 </P><P>
 
    75 
   222 
    76 <H2>2.1 Get the files</H2>
 
   223 <HR SIZE="6">
 
    77 
   224 <A NAME="SEC8"></A>
 
    78 <P>Visit the VMailMgr website 
   225 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
    79 <A HREF="http://www.vmailmgr.org/">http://www.vmailmgr.org/</A> to
 
   226 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC7"> &lt; </A>]</TD>
 
    80 get the package.
 
   227 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC9"> &gt; </A>]</TD>
 
    81 <P>If you get the binary RPMS you will need at least the vmailmgr package.
 
   228 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
    82 <H2>2.2 Install with RPMS</H2>
 
   229 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
    83 
   230 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
    84 <H3>Compiling SRC.RPM's</H3>
 
   231 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
    85 
   232 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
    86 <P>Simply compile the src.rpm file with the `<CODE>rpm --rebuild</CODE>` command.
 
   233 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
    87 -Example-
 
   234 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
    88 <HR>
 
   235 </TR></TABLE>
 
    89 <PRE>
 
   236 <H1> 2. Installation </H1>
 
    90   rpm -ivh vmailmgr-0.96.9-1.src.rpm
 
   237 <!--docid::SEC8::-->
 
    91 </PRE>
 
   238 <P>
 
    92 <HR>
 
   239 
    93 <H3>Installing RPM's</H3>
 
   240 <HR SIZE="6">
 
    94 
   241 <A NAME="SEC9"></A>
 
    95 <P>After compiling the source rpms, the binaries will be located 
   242 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
    96 in `<CODE>/usr/src/redhat/RPMS/i386/</CODE>` or something similar.
 
   243 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC8"> &lt; </A>]</TD>
 
    97 <P>Simply run the following command for each package
 
   244 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC10"> &gt; </A>]</TD>
 
    98 <PRE>
 
   245 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
    99   rpm -ivh &lt;location>/&lt;package.i386.rpm>
 
   246 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
   100 </PRE>
 
   247 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
   101 
   248 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
   102 -Example-
 
   249 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
   103 <HR>
 
   250 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
   104 <PRE>
 
   251 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
   105   rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-0.96.9-1.i386.rpm
 
   252 </TR></TABLE>
 
   106   rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-daemon-0.96.9-1.i386.rpm
 
   253 <H2> 2.1 Get the files </H2>
 
   107 </PRE>
 
   254 <!--docid::SEC9::-->
 
   108 <HR>
 
   255 <P>
 
   109 <P>
 
   256 
   110 <P>
 
   257 Visit the VMailMgr website <A HREF="http://www.vmailmgr.org/">http://www.vmailmgr.org/</A> or one of its
 
   111 <H2>2.3 Install with source</H2>
 
   258 mirror sites to download the package.  There are two primary methods of
 
   112 
   259 installing:
 
   113 <P>If you dont ue RPMS you can install from source.
 
   260 </P><P>
 
   114 <P>Run the following command
 
   261 
   115 <PRE>
 
   262 <UL>
 
   116   (As non-root user)
 
   263 <LI>
 
   117   tar zxf &lt;package.tar.gz>
 
   264 from source
 
   118   cd &lt;newly created dir>
 
   265 <P>
 
   119   ./configure
 
   266 
   120   make
 
   267 <LI>
 
   121   (As root)
 
   268 from a binary package -- specifically, an <CODE>RPM</CODE> binary package
 
   122   make install
 
   269 <P>
 
   123 </PRE>
 
   270 
   124 
   271 </UL>
 
   125 -Example-
 
   272 <P>
 
   126 <HR>
 
   273 
   127 <PRE>
 
   274 If you get the binary RPMS you will need at least the vmailmgr package.
 
   128   (As non-root user)
 
   275 </P><P>
 
   129   tar zxf vmailmgr-0.96.9.tar.gz
 
   276 
   130   cd vmailmgr-0.96.9
 
   277 <HR SIZE="6">
 
   131   ./configure
 
   278 <A NAME="SEC10"></A>
 
   132   make
 
   279 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
   133   (As root)
 
   280 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC9"> &lt; </A>]</TD>
 
   134   make install
 
   281 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC11"> &gt; </A>]</TD>
 
   135 </PRE>
 
   282 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
   136 <HR>
 
   283 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
   137 
   284 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
   138 That should do it.
 
   285 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
   139 <H2><A NAME="s3">3. Setup</A></H2>
 
   286 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
   140 
   287 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
   141 <P>In the following setup examples, it is assumed that your binaries
 
   288 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
   142 are installed in `<CODE>/usr/bin</CODE>`, and configuration is in
 
   289 </TR></TABLE>
 
   143 `<CODE>/etc/vmailmgr</CODE>`, as is the case if you installed from the
 
   290 <H2> 2.2 Install with RPMS </H2>
 
   144 RPMs.
 
   291 <!--docid::SEC10::-->
 
   145 If you installed from source, configure puts the binaries into
 
   292 <P>
 
   146 `<CODE>/usr/local/bin</CODE>` and the configuration into
 
   293 
   147 `<CODE>/usr/local/etc/vmailmgr</CODE>` by default.
 
   294 To install from binary <CODE>RPM</CODE> packages, you can download the binaries,
 
   148 <H2>3.1 Setting Up a Virtual Domain</H2>
 
   295 or build them from the source RPM package.
 
   149 
   296 </P><P>
 
   150 <P>The following steps are necessary to set up a virtual domain with
 
   297 
       
   298 <HR SIZE="6">
 
       
   299 <A NAME="SEC11"></A>
 
       
   300 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   301 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC10"> &lt; </A>]</TD>
 
       
   302 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC12"> &gt; </A>]</TD>
 
       
   303 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   304 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   305 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   306 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   307 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   308 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   309 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   310 </TR></TABLE>
 
       
   311 <H3> 2.2.1 Compiling the Source RPM (SRPM) Package </H3>
 
       
   312 <!--docid::SEC11::-->
 
       
   313 <P>
 
       
   314 
       
   315 If you download the binary packages directly, skip to the next step.
 
       
   316 </P><P>
 
       
   317 
       
   318 Download the source rpm package (<SAMP>`vmailmgr-<VAR>VERSION</VAR>.src.rpm'</SAMP>),
 
       
   319 and then use the <CODE>rpm</CODE> tool to build the binary RPM package from it
 
       
   320 with the <SAMP>`rpm --rebuild'</SAMP> command as follows:
 
       
   321 </P><P>
 
       
   322 
       
   323 <TABLE><tr><td>&nbsp;</td><td class=example><pre>rpm --rebuild vmailmgr-1.0.0-1.src.rpm
 
       
   324 </pre></td></tr></table></P><P>
 
       
   325 
       
   326 <HR SIZE="6">
 
       
   327 <A NAME="SEC12"></A>
 
       
   328 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   329 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC11"> &lt; </A>]</TD>
 
       
   330 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC13"> &gt; </A>]</TD>
 
       
   331 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   332 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   333 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   334 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   335 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   336 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   337 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   338 </TR></TABLE>
 
       
   339 <H3> 2.2.2 Installing the Binary RPM packages </H3>
 
       
   340 <!--docid::SEC12::-->
 
       
   341 <P>
 
       
   342 
       
   343 After compiling the source RPM, the binary RPM packages will be located 
       
   344 in the appropriate output directory (typically 
       
   345 <TT>`/usr/src/redhat/RPMS/i386/'</TT>).
 
       
   346 </P><P>
 
       
   347 
       
   348 Install each package using the <SAMP>`-i'</SAMP> option of <CODE>rpm</CODE> (i.e. 
       
   349 <SAMP>`rpm -ivh <VAR>PACKAGE</VAR>.i386.rpm'</SAMP>) as follows:
 
       
   350 </P><P>
 
       
   351 
       
   352 <TABLE><tr><td>&nbsp;</td><td class=example><pre>rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-1.0.0-1.i386.rpm
 
       
   353 rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-daemon-1.0.0-1.i386.rpm
 
       
   354 </pre></td></tr></table></P><P>
 
       
   355 
       
   356 <HR SIZE="6">
 
       
   357 <A NAME="SEC13"></A>
 
       
   358 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   359 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC12"> &lt; </A>]</TD>
 
       
   360 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC14"> &gt; </A>]</TD>
 
       
   361 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   362 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   363 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   364 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   365 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   366 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   367 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   368 </TR></TABLE>
 
       
   369 <H2> 2.3 Install from source </H2>
 
       
   370 <!--docid::SEC13::-->
 
       
   371 <P>
 
       
   372 
       
   373 If you dont use RPM packages, you can install from source with the following 
       
   374 commands. First, as a regular, non-root user:
 
       
   375 </P><P>
 
       
   376 
       
   377 <TABLE><tr><td>&nbsp;</td><td class=example><pre>tar xzf <TT>`vmailmgr-<VAR>VERSION</VAR>.tar.gz'</TT>
 
       
   378 cd <TT>`vmailmgr-<VAR>VERSION</VAR>'</TT>
 
       
   379 ./configure
 
       
   380 make
 
       
   381 </pre></td></tr></table></P><P>
 
       
   382 
       
   383 Then, as user <SAMP>`root'</SAMP>:
 
       
   384 </P><P>
 
       
   385 
       
   386 <TABLE><tr><td>&nbsp;</td><td class=example><pre>make install
 
       
   387 </pre></td></tr></table></P><P>
 
       
   388 
       
   389 <HR SIZE="6">
 
       
   390 <A NAME="SEC14"></A>
 
       
   391 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   392 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC13"> &lt; </A>]</TD>
 
       
   393 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC15"> &gt; </A>]</TD>
 
       
   394 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   395 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   396 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   397 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   398 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   399 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   400 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   401 </TR></TABLE>
 
       
   402 <H1> 3. Setup </H1>
 
       
   403 <!--docid::SEC14::-->
 
       
   404 <P>
 
       
   405 
       
   406 In the following setup examples, it is assumed that your binaries are installed 
       
   407 in the <TT>`/usr/bin]'</TT> directory, and configuration files are located in the 
       
   408 <TT>`/etc/vmailmgr/'</TT> directory, as is the case if you installed from the RPMs.
 
       
   409 </P><P>
 
       
   410 
       
   411 If you installed from source, configure instead puts the binaries into
 
       
   412 <TT>`/usr/local/bin/'</TT> and the configuration into
 
       
   413 <TT>`/usr/local/etc/vmailmgr/'</TT> by default.
 
       
   414 </P><P>
 
       
   415 
       
   416 <HR SIZE="6">
 
       
   417 <A NAME="SEC15"></A>
 
       
   418 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   419 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC14"> &lt; </A>]</TD>
 
       
   420 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC16"> &gt; </A>]</TD>
 
       
   421 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   422 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   423 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   424 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   425 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   426 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   427 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   428 </TR></TABLE>
 
       
   429 <H2> 3.1 Setting Up a Virtual Domain </H2>
 
       
   430 <!--docid::SEC15::-->
 
       
   431 <P>
 
       
   432 
       
   433 The following steps are necessary to set up a virtual domain with
 
   151 vmailmgr (assuming vmailmgr has been compiled and installed). As an
 
   434 vmailmgr (assuming vmailmgr has been compiled and installed). As an
 
   152 example, we'll set up a virtual user `<CODE>me@mydomain.org</CODE>`,
 
   435 example, we'll set up a virtual user <SAMP>`me@mydomain.org'</SAMP>,
 
   153 with aliases of `<CODE>myself@mydomain.org</CODE>` and
 
   436 with aliases of <SAMP>`myself@mydomain.org'</SAMP> and
 
   154 `<CODE>myname@mydomain.org</CODE>`.
 
   437 <SAMP>`myname@mydomain.org'</SAMP>.
 
       
   438 </P><P>
 
       
   439 
   155 <OL>
 
   440 <OL>
 
   156 <LI>Set up a DNS entry for the domain. This is not covered here, as it
 
   441 <LI>
 
       
   442 Set up a DNS entry for the domain. This is not covered here, as it
 
   157 is dependant on far too many other things.  I will mention that to
 
   443 is dependant on far too many other things.  I will mention that to
 
   158 make IP based virtual domains work a PTR record which matches an
 
   444 make IP based virtual domains work a <SAMP>`PTR'</SAMP> record which matches an
 
   159 entry in virtualdomains is nessesary, for example, if nslookup
 
   445 entry in virtualdomains is nessesary, for example, if nslookup
 
   160 10.56.33.122 returns <CODE>mail.mydomain.com</CODE>,
 
   446 10.56.33.122 returns <SAMP>`mail.mydomain.com'</SAMP>,
 
   161 `<CODE>virtualdomains</CODE>` needs an entry like
 
   447 <TT>`control/virtualdomains'</TT> needs an entry like
 
   162 `<CODE>mail.mydomain.com:myuser</CODE>'
 
   448 <SAMP>`mail.mydomain.com:myuser'</SAMP>.
 
       
   449 <P>
 
       
   450 
   163 For the example, we'll assume that the mail exchanger for
 
   451 For the example, we'll assume that the mail exchanger for
 
   164 mydomain.org is already set up to point to your computer.</LI>
 
   452 <SAMP>`mydomain.org'</SAMP> is already set up to point to your computer.
 
   165 <LI>Set up a base user for the domain. Create a user, with a name of
 
   453 </P><P>
 
       
   454 
       
   455 <LI>
 
       
   456 Set up a base user for the domain.  Create a user, with a name of
 
   166 your choosing.  Since the maildirs for all the users in the
 
   457 your choosing.  Since the maildirs for all the users in the
 
   167 virtual domain will be stored under this user's home directory,
 
   458 virtual domain will be stored under this user's home directory,
 
   168 make sure you set the user up in a partition or disk that is
 
   459 make sure you set the user up in a partition or disk that is
 
   169 appropriate for such storage. The tools that you should use to
 
   460 appropriate for such storage. The tools that you should use to
 
   170 accomplish this step vary greatly between different systems. For
 
   461 accomplish this step vary greatly between different systems. For
 
   171 our example, I'll add a user `<CODE>myuser</CODE>`.</LI>
 
   462 our example, I'll add a user <SAMP>`myuser'</SAMP>.
 
   172 <LI>Configure qmail to recognize the domain. To do this, you need to
 
   463 <P>
 
       
   464 
       
   465 <LI>
 
       
   466 Configure qmail to recognize the domain. To do this, you need to
 
   173 modify two of qmail's configuration files in
 
   467 modify two of qmail's configuration files in
 
   174 `<CODE>/var/qmail/control</CODE>` `<CODE>rcpthosts</CODE>` and
 
   468 <TT>`/var/qmail/control'</TT>: <TT>`rcpthosts'</TT> and <TT>`virtualdomains'</TT>.
 
   175 `<CODE>virtualdomains</CODE>`.
 
   469 <UL>
 
   176 <UL>
 
   470 <LI>
 
   177 <LI>To `<CODE>rcpthosts</CODE>` :
 
   471 To <TT>`rcpthosts'</TT>, add the line <SAMP>`mydomain.org'</SAMP>. 
   178 add the line `<CODE>mydomain.org</CODE>`. </LI>
 
   472 <LI>
 
   179 <LI>To `<CODE>virtualdomains</CODE>` :
 
   473 To <TT>`virtualdomains'</TT>, add the line <SAMP>`mydomain.org:myuser'</SAMP>.
 
   180 add the line `<CODE>mydomain.org:myuser</CODE>`.</LI>
 
   474 </UL>
 
   181 </UL>
 
   475 <P>
 
   182 
   476 
   183 If you wish to have mail to `<CODE>anything.mydomain.org</CODE>`
 
   477 If you wish to have mail to <SAMP>`anything.mydomain.org'</SAMP>
 
   184 be delivered in the same way, add the following
 
   478 be delivered in the same way:
 
   185 <UL>
 
   479 <UL>
 
   186 <LI>To `<CODE>rcpthosts</CODE>` :
 
   480 <LI>
 
   187 add the line `<CODE>.mydomain.org</CODE>`. </LI>
 
   481 To <TT>`rcpthosts'</TT>, add the line <SAMP>`.mydomain.org'</SAMP>. 
   188 <LI>To `<CODE>virtualdomains</CODE>` :
 
   482 <LI>
 
   189 add the line `<CODE>.mydomain.org:myuser</CODE>`.</LI>
 
   483 To <TT>`virtualdomains'</TT>, add the line <SAMP>`.mydomain.org:myuser'</SAMP>.
 
   190 </UL>
 
   484 </UL>
 
   191 </LI>
 
   485 <P>
 
   192 <LI>Configure qmail-popup/qmail-pop3d to use `<CODE>checkvpw</CODE>` as
 
   486 
   193 the password checker. This step is dependant on how you have
 
   487 <LI>
 
   194 installed qmail.
 
   488 Configure <CODE>qmail-popup</CODE>/<CODE>qmail-pop3d</CODE> to use <CODE>checkvpw</CODE> as the 
   195 <UL>
 
   489 password checker.  This step is dependant on how you have installed qmail.
 
   196 <LI>Replace `<CODE>checkpassword</CODE>` in the command you use to
 
   490 <UL>
 
   197 invoke qmail-popup/qmail-pop3d (either in
 
   491 <LI>
 
   198 `<CODE>/etc/inet.conf</CODE>` or in a `<CODE>tcpserver</CODE>`
 
   492 Replace <CODE>checkpassword</CODE> in the command you use to
 
   199 command) with `<CODE>checkvpw</CODE>`.</LI>
 
   493 invoke <CODE>qmail-popup</CODE>/<CODE>qmail-pop3d</CODE> (either in
 
   200 <LI>And/Or at the prompt type: `<CODE>echo checkvpw >
 
   494 <TT>`/etc/inet.conf'</TT> or in a <CODE>tcpserver</CODE>
 
   201 /var/qmail/control/checkpassword</CODE>`</LI>
 
   495 command) with <CODE>checkvpw</CODE>.
 
   202 </UL>
 
   496 <LI>
 
   203 </LI>
 
   497 And/Or at the prompt type <SAMP>`echo checkvpw &#62; <TT>`/var/qmail/control/checkpassword'</TT>'</SAMP>.
 
   204 <LI>Set up the vmailmgr files:
 
   498 </UL>
 
   205 <UL>
 
   499 <P>
 
   206 <LI>Either change user to the user you just created (for example,
 
   500 
   207 type `<CODE>su - myuser</CODE>`) or log in (with either telnet or
 
   501 <LI>
 
   208 at the console) as the new user.</LI>
 
   502 Set up the vmailmgr files:
 
   209 <LI>Set up the base vmailmgr files by running `<CODE>vsetup</CODE>`.</LI>
 
   503 <UL>
 
   210 <LI>Use the included programs to add users and aliases.
 
   504 <LI>
 
       
   505 Either change user to the user you just created (for example,
 
       
   506 type <SAMP>`su - myuser'</SAMP>) or log in (with either telnet or
 
       
   507 at the console) as the new user.
 
       
   508 <LI>
 
       
   509 Set up the base vmailmgr files by running <CODE>vsetup</CODE>.
 
       
   510 <LI>
 
       
   511 Use the included programs to add users and aliases.
 
   211 For our example, we would type the following commands:
 
   512 For our example, we would type the following commands:
 
   212 <PRE>
 
   513 <P>
 
   213   vadduser me
 
   514 
   214   vaddalias myself me
 
   515 <TABLE><tr><td>&nbsp;</td><td class=example><pre>vadduser me
 
   215   vaddalias myname me
 
   516 vaddalias myself me
 
   216 </PRE>
 
   517 vaddalias myname me
 
   217 </LI>
 
   518 </pre></td></tr></table></P><P>
 
   218 </UL>
 
   519 
   219 </LI>
 
   520 </UL>
 
       
   521      
   220 </OL>
 
   522 </OL>
 
       
   523 <P>
 
   221 
   524 
   222 After you have completed all these steps, you will need to kill and
 
   525 After you have completed all these steps, you will need to kill and
 
   223 restart `<CODE>qmail-send</CODE>` to make it read the new
 
   526 restart <CODE>qmail-send</CODE> to make it read the new
 
   224 `<CODE>virtualdomains</CODE>` table.
 
   527 <TT>`virtualdomains'</TT> control file.
 
   225 <P>If you are using `<CODE>inetd</CODE>` to launch `<CODE>qmail-popup</CODE>`,
 
   528 </P><P>
 
   226 `<CODE>kill -HUP</CODE>` the `<CODE>inetd</CODE>` process as well.
 
   529 
   227 <H2>3.2 Using one IP address for mutiple domains</H2>
 
   530 If you are using <CODE>inetd</CODE> to launch <CODE>qmail-popup</CODE>,
 
   228 
   531 <SAMP>`kill -HUP'</SAMP> the <CODE>inetd</CODE> process as well.
 
   229 <P>There are two ways to log in without using multiple IP addresses. 
   532 </P><P>
 
   230 <P>
 
   533 
       
   534 <HR SIZE="6">
 
       
   535 <A NAME="SEC16"></A>
 
       
   536 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   537 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC15"> &lt; </A>]</TD>
 
       
   538 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC17"> &gt; </A>]</TD>
 
       
   539 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   540 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   541 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   542 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   543 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   544 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   545 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   546 </TR></TABLE>
 
       
   547 <H2> 3.2 Using one IP address for mutiple domains </H2>
 
       
   548 <!--docid::SEC16::-->
 
       
   549 <P>
 
       
   550 
       
   551 There are two ways to log in without using multiple IP addresses. 
       
   552 </P><P>
 
       
   553 
   231 <OL>
 
   554 <OL>
 
   232 <LI>The first way is to log in as
 
   555 <LI>
 
   233 `<CODE>userSEPvirtual.domain.org</CODE>`, where `<CODE>user</CODE>` is the
 
   556 The first way is to log in as
 
   234 mailbox name of the virtual user, SEP is one of `<CODE>@</CODE>` or
 
   557 <SAMP>`user<VAR>SEP</VAR>virtual.domain.org'</SAMP>, where <SAMP>`user'</SAMP> is the
 
   235 `<CODE>:</CODE>` (by default, this is configurable in the
 
   558 mailbox name of the virtual user, <VAR>SEP</VAR> is one of <SAMP>`@'</SAMP> or
 
   236 `<CODE>/etc/vmailmgr/</CODE>' directory), and
 
   559 <SAMP>`:'</SAMP> (by default; this is configurable in the
 
   237 `<CODE>virtual.domain.org</CODE>' is the virtual domain's name, as
 
   560 <TT>`/etc/vmailmgr/'</TT> directory), and
 
   238 listed in `<CODE>/var/qmail/control/virtualdomains</CODE>'.</LI>
 
   561 <SAMP>`virtual.domain.org'</SAMP> is the virtual domain's name, as
 
   239 <LI>The second way is to use the internal form of the mailbox name --
 
   562 listed in <TT>`/var/qmail/control/virtualdomains'</TT>.
 
   240 that is, `<CODE>baseuser-user</CODE>', where `<CODE>user</CODE>' is the
 
   563 <P>
 
   241 same as above, and `<CODE>baseuser</CODE>' is the username of the
 
   564 
   242 managing user.</LI>
 
   565 <LI>
 
       
   566 The second way is to use the internal form of the mailbox name --
 
       
   567 that is, <SAMP>`baseuser-user'</SAMP>, where <SAMP>`user'</SAMP> is the
 
       
   568 same as above, and <SAMP>`baseuser'</SAMP> is the username of the
 
       
   569 managing user.
 
       
   570 <P>
 
       
   571 
   243 </OL>
 
   572 </OL>
 
   244 
   573 <P>
 
   245 Example: `<CODE>/var/qmail/control/virtualdomains</CODE>' contains 
   574 
   246 <PRE>
 
   575 For example, if <TT>`/var/qmail/control/virtualdomains'</TT> contains 
   247   testdomain.org:testuser
 
   576 <SAMP>`mydomain.com:myuser'</SAMP> and user <SAMP>`myuser'</SAMP> exists and has
 
   248 </PRE>
 
   577 set up a virtual mailbox with the name <SAMP>`me'</SAMP>, and the
 
   249 
   578 <TT>`separators'</TT> configuration file <TT>`/etc/vmailmgr/'</TT> contains <SAMP>`@'</SAMP>,
 
   250 User `<CODE>myuser</CODE>' exists, and has set up a virtual mailbox with
 
   579 this virtual user could log in as <SAMP>`me@mydomain.com'</SAMP>,
 
   251 the name `<CODE>me</CODE>'. The `<CODE>separators</CODE>' variable in
 
   580 <SAMP>`me:mydomain.com'</SAMP>, or <SAMP>`myuser-me'</SAMP>.
 
   252 `<CODE>/etc/vmailmgr/</CODE>' contains `<CODE>@:</CODE>'. This virtual user
 
   581 </P><P>
 
   253 could log in as `<CODE>me@mydomain.com</CODE>',
 
   582 
   254 `<CODE>me:mydomain.cm</CODE>', or `<CODE>myuser-me</CODE>'.
 
   583 <HR SIZE="6">
 
   255 <P>
 
   584 <A NAME="SEC17"></A>
 
   256 <P>
 
   585 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
   257 <H2>3.3 Catching all misdirected mail in a virtual domain</H2>
 
   586 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC16"> &lt; </A>]</TD>
 
   258 
   587 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC18"> &gt; </A>]</TD>
 
   259 <P>In the `<CODE>vmailmgr/</CODE>' configuration directory, there is an
 
   588 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
   260 entry called `<CODE>default-username</CODE>'. If mail to a virtual
 
   589 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   590 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   591 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   592 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   593 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   594 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   595 </TR></TABLE>
 
       
   596 <H2> 3.3 Catching all misdirected mail in a virtual domain </H2>
 
       
   597 <!--docid::SEC17::-->
 
       
   598 <P>
 
       
   599 
       
   600 In the <CODE>vmailmgr</CODE> configuration directory, there is a
 
       
   601 file called <TT>`default-username'</TT>. If mail to a virtual
 
   261 domain does not match any users or aliases in that domain, it is
 
   602 domain does not match any users or aliases in that domain, it is
 
   262 delivered to the name listed in this configuration item if it exists
 
   603 delivered to the name listed in this configuration item if it exists
 
   263 (which defaults to `<CODE>+</CODE>'). To make this deliver to you,
 
   604 (which defaults to <SAMP>`+'</SAMP>). To make this deliver to you,
 
   264 simply type:
 
   605 simply type <SAMP>`vaddalias + me'</SAMP>.
 
   265 <PRE>
 
   606 </P><P>
 
   266   vaddalias + me
 
   607 
   267 </PRE>
 
   608 <HR SIZE="6">
 
   268 <H2>3.4 VMailMgr IMAP support</H2>
 
   609 <A NAME="SEC18"></A>
 
   269 
   610 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
   270 <P>VMailMgr supports Courier-IMAP, but Courier-IMAP does not come with
 
   611 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC17"> &lt; </A>]</TD>
 
       
   612 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC19"> &gt; </A>]</TD>
 
       
   613 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   614 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   615 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   616 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   617 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   618 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   619 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   620 </TR></TABLE>
 
       
   621 <H2> 3.4 VMailMgr IMAP support </H2>
 
       
   622 <!--docid::SEC18::-->
 
       
   623 <P>
 
       
   624 
       
   625 VMailMgr supports Courier-IMAP, but Courier-IMAP does not come with
 
   271 an authentication module for VMailMgr.  This means that some minor
 
   626 an authentication module for VMailMgr.  This means that some minor
 
   272 work is required for making the two work together.
 
   627 work is required for making the two work together.
 
   273 <UL>
 
   628 </P><P>
 
   274 <LI>You must copy `<CODE>/usr/bin/authvmailmgr</CODE>` to
 
   629 
   275 `<CODE>/usr/lib/courier-imap/libexec/authlib/authvmailmgr</CODE>`.</LI>
 
   630 The steps are:
 
   276 <LI>Then modify the `<CODE>AUTHMODULES</CODE>` statement in
 
   631 </P><P>
 
   277 `<CODE>/usr/lib/courier-imap/etc/imapd.config</CODE>` and add
 
   632 
   278 `<CODE>authvmailmgr</CODE>` as the first authentication module.</LI>
 
   633 <UL>
 
   279 </UL>
 
   634 <LI>
 
   280 <H2>3.5 Enabling enforcement of virtual user quotas</H2>
 
   635 Copy <TT>`/usr/bin/authvmailmgr'</TT> to
 
   281 
   636 <TT>`/usr/lib/courier-imap/libexec/authlib/authvmailmgr'</TT>.
 
   282 <P>VMailMgr supports per-virtual-user quotas, but not out of the box,
 
   637 <P>
 
       
   638 
       
   639 <LI>
 
       
   640 Modify the <CODE>AUTHMODULES</CODE> statement in
 
       
   641 <TT>`/usr/lib/courier-imap/etc/imapd.config'</TT> and add
 
       
   642 <SAMP>`authvmailmgr'</SAMP> as the first authentication module.
 
       
   643 </UL>
 
       
   644 <P>
 
       
   645 
       
   646 <HR SIZE="6">
 
       
   647 <A NAME="SEC19"></A>
 
       
   648 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   649 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC18"> &lt; </A>]</TD>
 
       
   650 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC20"> &gt; </A>]</TD>
 
       
   651 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   652 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   653 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   654 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   655 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   656 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   657 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   658 </TR></TABLE>
 
       
   659 <H2> 3.5 Enabling enforcement of virtual user quotas </H2>
 
       
   660 <!--docid::SEC19::-->
 
       
   661 <P>
 
       
   662 
       
   663 VMailMgr supports per-virtual-user quotas, but not out of the box,
 
   283 as it is not needed by the majority of users, and requires an extra
 
   664 as it is not needed by the majority of users, and requires an extra
 
   284 program to be run on each delivery.
 
   665 program to be run on each delivery.
 
       
   666 </P><P>
 
       
   667 
   285 To configure quota support, create the file
 
   668 To configure quota support, create the file
 
   286 `<CODE>/etc/vmailmgr/vdeliver-predeliver</CODE>`, containing
 
   669 <TT>`/etc/vmailmgr/vdeliver-predeliver'</TT>, containing
 
   287 the following:
 
   670 the following:
 
   288 <PRE>
 
   671 </P><P>
 
   289   #!/bin/sh
 
   672 
   290   /usr/bin/vcheckquota
 
   673 <TABLE><tr><td>&nbsp;</td><td class=example><pre>#!/bin/sh
 
   291 </PRE>
 
   674 /usr/bin/vcheckquota
 
       
   675 </pre></td></tr></table></P><P>
 
   292 
   676 
   293 This is executed as a shell script, so you will need to make it
 
   677 This is executed as a shell script, so you will need to make it
 
   294 executable by running the following command:
 
   678 executable by running the command <SAMP>`chmod +x /etc/vmailmgr/vdeliver-predeliver'</SAMP>.
 
   295 <PRE>
 
   679 </P><P>
 
   296   chmod +x /etc/vmailmgr/vdeliver-predeliver
 
   680 
   297 </PRE>
 
   681 <HR SIZE="6">
 
   298 <H2>3.6 Enabling processing of autoresponses</H2>
 
   682 <A NAME="SEC20"></A>
 
   299 
   683 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
   300 <P>Download and install the qmail-autoresponder package, found at
 
   684 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC19"> &lt; </A>]</TD>
 
   301 <A HREF="http://em.ca/~bruceg/qmail-autoresponder/">http://em.ca/~bruceg/qmail-autoresponder/</A>.
 
   685 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC21"> &gt; </A>]</TD>
 
       
   686 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   687 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   688 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   689 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   690 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   691 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   692 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   693 </TR></TABLE>
 
       
   694 <H2> 3.6 Enabling processing of autoresponses </H2>
 
       
   695 <!--docid::SEC20::-->
 
       
   696 <P>
 
       
   697 
       
   698 Download and install the qmail-autoresponder package, found at
 
       
   699 <A HREF="http://untroubled.org/qmail-autoresponder/">http://untroubled.org/qmail-autoresponder/</A>.
 
       
   700 </P><P>
 
       
   701 
   302 As with the above section, create a shell script
 
   702 As with the above section, create a shell script
 
   303 `<CODE>/etc/vmailmgr/vdeliver-postdeliver</CODE>`, containing the
 
   703 <TT>`/etc/vmailmgr/vdeliver-postdeliver'</TT>, containing the following:
 
   304 following:
 
   704 </P><P>
 
   305 <PRE>
 
   705 
   306   #!/bin/sh
 
   706 <TABLE><tr><td>&nbsp;</td><td class=example><pre>#!/bin/sh
 
   307   if test -s $MAILDIR/autoresponse/message.txt
 
   707 if test -s $MAILDIR/autoresponse/message.txt ; then
 
   308   then
 
   708   qmail-autoresponder $MAILDIR/autoresponse/message.txt $MAILDIR/autoresponse
 
   309     qmail-autoresponder $MAILDIR/autoresponse/message.txt $MAILDIR/autoresponse
 
   709 fi
 
   310   fi
 
   710 </pre></td></tr></table></P><P>
 
   311 </PRE>
 
   711 
   312 <H2>3.7 Web-based interfaces for vmailmgr</H2>
 
   712 <HR SIZE="6">
 
   313 
   713 <A NAME="SEC21"></A>
 
   314 <P>There are currently a few working solutions to administrate
 
   714 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   715 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC20"> &lt; </A>]</TD>
 
       
   716 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt; ]</TD>
 
       
   717 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
 
       
   718 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1"> Up </A>]</TD>
 
       
   719 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
 
       
   720 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   721 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   722 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   723 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   724 </TR></TABLE>
 
       
   725 <H2> 3.7 Web-based interfaces for vmailmgr </H2>
 
       
   726 <!--docid::SEC21::-->
 
       
   727 <P>
 
       
   728 
       
   729 There are currently a few working solutions to administrate
 
   315 your vmailmgr system via a web interface. Only requirement is
 
   730 your vmailmgr system via a web interface. Only requirement is
 
   316 that the vmailmgrd daemon is running, and that you have
 
   731 that the vmailmgrd daemon is running, and that you have
 
   317 a webserver on your system.
 
   732 a webserver on your system.
 
   318 <OL>
 
   733 </P><P>
 
   319 <LI>For Python fans, there is vpyadmin by Bruce Guenter. The files can
 
   734 
   320 be downloaded at 
   735 <UL>
 
   321 <A HREF="http://em.ca/~bruceg/vpyadmin/">http://em.ca/~bruceg/vpyadmin/</A>, and
 
   736 <LI>
 
       
   737 For Python fans, there is vpyadmin by Bruce Guenter. The files can
 
       
   738 be downloaded at <A HREF="http://untroubled.org/vpyadmin/">http://untroubled.org/vpyadmin/</A>, and
 
   322 the development code is online at 
   739 the development code is online at 
   323 <A HREF="http://bruce-guenter.dyndns.org/cgi-bin/vpyadmin/">http://bruce-guenter.dyndns.org/cgi-bin/vpyadmin/</A>
 
   740 <A HREF="http://bruce-guenter.dyndns.org/cgi-bin/vpyadmin/">http://bruce-guenter.dyndns.org/cgi-bin/vpyadmin/</A>
 
   324 (sample.org / samplevm).</LI>
 
   741 (sample.org / samplevm).
 
   325 <LI>And if you like PHP, you can use oMail-admin by Olivier Müller:
 
   742 <P>
 
       
   743 
       
   744 <LI>
 
       
   745 And if you like PHP, you can use oMail-admin by Olivier Müller:
 
   326 it fully supports all vmailmgr functions, and speaks englich,
 
   746 it fully supports all vmailmgr functions, and speaks englich,
 
   327 french, italian, spanish, german and russian. Project homepage:
 
   747 french, italian, spanish, german and russian. Project homepage:
 
   328 <A HREF="http://omail.omnis.ch">http://omail.omnis.ch</A>. Online demo:
 
   748 <A HREF="http://omail.omnis.ch">http://omail.omnis.ch</A>. Online demo:
 
   329 <A HREF="http://admin.omnis.ch/omail/">http://admin.omnis.ch/omail/</A> (test.com / test).</LI>
 
   749 <A HREF="http://admin.omnis.ch/omail/">http://admin.omnis.ch/omail/</A> (test.com / test).
 
   330 <LI>And there are also C-based CGI scripts in the <CODE>cgi</CODE>
 
   750 <P>
 
   331 directory of the vmailmgr distribution.</LI>
 
   751 
   332 </OL>
 
   752 <LI>
 
       
   753 And there are also C-based CGI scripts in the <TT>`cgi'</TT>
 
       
   754 subdirectory of the vmailmgr distribution.
 
       
   755 <P>
 
       
   756 
       
   757 </UL>
 
       
   758 <P>
 
       
   759 
       
   760 <HR SIZE="6">
 
       
   761 <A NAME="SEC_Contents"></A>
 
       
   762 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   763 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   764 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   765 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   766 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   767 </TR></TABLE>
 
       
   768 <H1>Table of Contents</H1>
 
       
   769 <UL>
 
       
   770 <A NAME="TOC1" HREF="HOWTO.html#SEC1">1. Introduction</A>
 
       
   771 <BR>
 
       
   772 <UL>
 
       
   773 <A NAME="TOC2" HREF="HOWTO.html#SEC2">1.1 What is VMailMgr and why should I use it?</A>
 
       
   774 <BR>
 
       
   775 <A NAME="TOC3" HREF="HOWTO.html#SEC3">1.2 New versions</A>
 
       
   776 <BR>
 
       
   777 <A NAME="TOC4" HREF="HOWTO.html#SEC4">1.3 Comments</A>
 
       
   778 <BR>
 
       
   779 <A NAME="TOC5" HREF="HOWTO.html#SEC5">1.4 History</A>
 
       
   780 <BR>
 
       
   781 <A NAME="TOC6" HREF="HOWTO.html#SEC6">1.5 Copyrights and Trademarks</A>
 
       
   782 <BR>
 
       
   783 <A NAME="TOC7" HREF="HOWTO.html#SEC7">1.6 Acknowledgements and Thanks</A>
 
       
   784 <BR>
 
       
   785 </UL>
 
       
   786 <A NAME="TOC8" HREF="HOWTO.html#SEC8">2. Installation</A>
 
       
   787 <BR>
 
       
   788 <UL>
 
       
   789 <A NAME="TOC9" HREF="HOWTO.html#SEC9">2.1 Get the files</A>
 
       
   790 <BR>
 
       
   791 <A NAME="TOC10" HREF="HOWTO.html#SEC10">2.2 Install with RPMS</A>
 
       
   792 <BR>
 
       
   793 <UL>
 
       
   794 <A NAME="TOC11" HREF="HOWTO.html#SEC11">2.2.1 Compiling the Source RPM (SRPM) Package</A>
 
       
   795 <BR>
 
       
   796 <A NAME="TOC12" HREF="HOWTO.html#SEC12">2.2.2 Installing the Binary RPM packages</A>
 
       
   797 <BR>
 
       
   798 </UL>
 
       
   799 <A NAME="TOC13" HREF="HOWTO.html#SEC13">2.3 Install from source</A>
 
       
   800 <BR>
 
       
   801 </UL>
 
       
   802 <A NAME="TOC14" HREF="HOWTO.html#SEC14">3. Setup</A>
 
       
   803 <BR>
 
       
   804 <UL>
 
       
   805 <A NAME="TOC15" HREF="HOWTO.html#SEC15">3.1 Setting Up a Virtual Domain</A>
 
       
   806 <BR>
 
       
   807 <A NAME="TOC16" HREF="HOWTO.html#SEC16">3.2 Using one IP address for mutiple domains</A>
 
       
   808 <BR>
 
       
   809 <A NAME="TOC17" HREF="HOWTO.html#SEC17">3.3 Catching all misdirected mail in a virtual domain</A>
 
       
   810 <BR>
 
       
   811 <A NAME="TOC18" HREF="HOWTO.html#SEC18">3.4 VMailMgr IMAP support</A>
 
       
   812 <BR>
 
       
   813 <A NAME="TOC19" HREF="HOWTO.html#SEC19">3.5 Enabling enforcement of virtual user quotas</A>
 
       
   814 <BR>
 
       
   815 <A NAME="TOC20" HREF="HOWTO.html#SEC20">3.6 Enabling processing of autoresponses</A>
 
       
   816 <BR>
 
       
   817 <A NAME="TOC21" HREF="HOWTO.html#SEC21">3.7 Web-based interfaces for vmailmgr</A>
 
       
   818 <BR>
 
       
   819 </UL>
 
       
   820 </UL>
 
       
   821 <HR SIZE=1>
 
       
   822 <A NAME="SEC_OVERVIEW"></A>
 
       
   823 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   824 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   825 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   826 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   827 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   828 </TR></TABLE>
 
       
   829 <H1>Short Table of Contents</H1>
 
       
   830 <BLOCKQUOTE>
 
       
   831 <A NAME="TOC1" HREF="HOWTO.html#SEC1">1. Introduction</A>
 
       
   832 <BR>
 
       
   833 <A NAME="TOC8" HREF="HOWTO.html#SEC8">2. Installation</A>
 
       
   834 <BR>
 
       
   835 <A NAME="TOC14" HREF="HOWTO.html#SEC14">3. Setup</A>
 
       
   836 <BR>
 
       
   837 
       
   838 </BLOCKQUOTE>
 
       
   839 <HR SIZE=1>
 
       
   840 <A NAME="SEC_About"></A>
 
       
   841 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
 
       
   842 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC1">Top</A>]</TD>
 
       
   843 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_Contents">Contents</A>]</TD>
 
       
   844 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
 
       
   845 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="HOWTO.html#SEC_About"> ? </A>]</TD>
 
       
   846 </TR></TABLE>
 
       
   847 <H1>About this document</H1>
 
       
   848 This document was generated by <I>Bruce.Guenter.dyndns.org</I> on <I>December, 29  2004</I>
 
       
   849 using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
 
       
   850 "><I>texi2html</I></A>
 
       
   851 <P></P>  
       
   852 The buttons in the navigation panels have the following meaning:
 
       
   853 <P></P>
 
       
   854 <table border = "1">
 
       
   855 <TR>
 
       
   856 <TH> Button </TH>
 
       
   857 <TH> Name </TH>
 
       
   858 <TH> Go to </TH>
 
       
   859 <TH> From 1.2.3 go to</TH>
 
       
   860 </TR>
 
       
   861 <TR>
 
       
   862 <TD ALIGN="CENTER">
 
       
   863  [ &lt; ] </TD>
 
       
   864 <TD ALIGN="CENTER">
 
       
   865 Back
 
       
   866 </TD>
 
       
   867 <TD>
 
       
   868 previous section in reading order
 
       
   869 </TD>
 
       
   870 <TD>
 
       
   871 1.2.2
 
       
   872 </TD>
 
       
   873 </TR>
 
       
   874 <TR>
 
       
   875 <TD ALIGN="CENTER">
 
       
   876  [ &gt; ] </TD>
 
       
   877 <TD ALIGN="CENTER">
 
       
   878 Forward
 
       
   879 </TD>
 
       
   880 <TD>
 
       
   881 next section in reading order
 
       
   882 </TD>
 
       
   883 <TD>
 
       
   884 1.2.4
 
       
   885 </TD>
 
       
   886 </TR>
 
       
   887 <TR>
 
       
   888 <TD ALIGN="CENTER">
 
       
   889  [ &lt;&lt; ] </TD>
 
       
   890 <TD ALIGN="CENTER">
 
       
   891 FastBack
 
       
   892 </TD>
 
       
   893 <TD>
 
       
   894 previous or up-and-previous section 
       
   895 </TD>
 
       
   896 <TD>
 
       
   897 1.1
 
       
   898 </TD>
 
       
   899 </TR>
 
       
   900 <TR>
 
       
   901 <TD ALIGN="CENTER">
 
       
   902  [ Up ] </TD>
 
       
   903 <TD ALIGN="CENTER">
 
       
   904 Up
 
       
   905 </TD>
 
       
   906 <TD>
 
       
   907 up section
 
       
   908 </TD>
 
       
   909 <TD>
 
       
   910 1.2
 
       
   911 </TD>
 
       
   912 </TR>
 
       
   913 <TR>
 
       
   914 <TD ALIGN="CENTER">
 
       
   915  [ &gt;&gt; ] </TD>
 
       
   916 <TD ALIGN="CENTER">
 
       
   917 FastForward
 
       
   918 </TD>
 
       
   919 <TD>
 
       
   920 next or up-and-next section
 
       
   921 </TD>
 
       
   922 <TD>
 
       
   923 1.3
 
       
   924 </TD>
 
       
   925 </TR>
 
       
   926 <TR>
 
       
   927 <TD ALIGN="CENTER">
 
       
   928  [Top] </TD>
 
       
   929 <TD ALIGN="CENTER">
 
       
   930 Top
 
       
   931 </TD>
 
       
   932 <TD>
 
       
   933 cover (top) of document
 
       
   934 </TD>
 
       
   935 <TD>
 
       
   936  &nbsp; 
       
   937 </TD>
 
       
   938 </TR>
 
       
   939 <TR>
 
       
   940 <TD ALIGN="CENTER">
 
       
   941  [Contents] </TD>
 
       
   942 <TD ALIGN="CENTER">
 
       
   943 Contents
 
       
   944 </TD>
 
       
   945 <TD>
 
       
   946 table of contents
 
       
   947 </TD>
 
       
   948 <TD>
 
       
   949  &nbsp; 
       
   950 </TD>
 
       
   951 </TR>
 
       
   952 <TR>
 
       
   953 <TD ALIGN="CENTER">
 
       
   954  [Index] </TD>
 
       
   955 <TD ALIGN="CENTER">
 
       
   956 Index
 
       
   957 </TD>
 
       
   958 <TD>
 
       
   959 concept index
 
       
   960 </TD>
 
       
   961 <TD>
 
       
   962  &nbsp; 
       
   963 </TD>
 
       
   964 </TR>
 
       
   965 <TR>
 
       
   966 <TD ALIGN="CENTER">
 
       
   967  [ ? ] </TD>
 
       
   968 <TD ALIGN="CENTER">
 
       
   969 About
 
       
   970 </TD>
 
       
   971 <TD>
 
       
   972 this page
 
       
   973 </TD>
 
       
   974 <TD>
 
       
   975  &nbsp; 
       
   976 </TD>
 
       
   977 </TR>
 
       
   978 </TABLE>
 
       
   979 <P></P>
 
       
   980 where the <STRONG> Example </STRONG> assumes that the current position 
       
   981 is at <STRONG> Subsubsection One-Two-Three </STRONG> of a document of 
       
   982 the following structure:
 
       
   983 <UL>
 
       
   984 <LI> 1. Section One  </LI>
 
       
   985 <UL>
 
       
   986 <LI>1.1 Subsection One-One</LI>
 
       
   987 <UL>
 
       
   988 <LI> ... </LI>
 
       
   989 </UL>
 
       
   990 <LI>1.2 Subsection One-Two</LI>
 
       
   991 <UL>
 
       
   992 <LI>1.2.1 Subsubsection One-Two-One
 
       
   993 </LI><LI>1.2.2 Subsubsection One-Two-Two
 
       
   994 </LI><LI>1.2.3 Subsubsection One-Two-Three &nbsp; &nbsp; <STRONG>
 
       
   995 &lt;== Current Position </STRONG>
 
       
   996 </LI><LI>1.2.4 Subsubsection One-Two-Four
 
       
   997 </LI></UL>
 
       
   998 <LI>1.3 Subsection One-Three</LI>
 
       
   999 <UL>
 
       
  1000 <LI> ... </LI>
 
       
  1001 </UL>
 
       
  1002 <LI>1.4 Subsection One-Four</LI>
 
       
  1003 </UL>
 
       
  1004 </UL>
 
       
  1005 
       
  1006 <HR SIZE=1>
 
       
  1007 <BR>  
       
  1008 <FONT SIZE="-1">
 
       
  1009 This document was generated
 
       
  1010 by <I>Bruce.Guenter.dyndns.org</I> on <I>December, 29  2004</I>
 
       
  1011 using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
 
       
  1012 "><I>texi2html</I></A>
 
       
  1013 
   333 </BODY>
 
  1014 </BODY>
 
   334 </HTML>
 
  1015 </HTML>
vmailmgr