doc/HOWTO.txt
changeset 2 b3afb9f1e801
parent 0 6f7a81934006
equal deleted inserted replaced
1:30113bfbe723 2:b3afb9f1e801
     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