faq

相当优秀的 UNIX 进程管理工具

FAQ Table of Contents

Intro
Features for vpopmail
  FAQ
0. How can I set one virtual domain to be the primary domain for
   the machine? We don't want to have any /etc/passwd users.
1. How to I pop in to pick up my virtual domain email?
2. How do I forward all mail that doesn't match any pop users or .qmail
3. How do I bounce all mail that doesn't match any pop users or .qmail
4. How do I allow roaming users to use our smtp server without opening
5. What is a sample start script for the pop server?
6. How do hard quota's for users work?
7. I installed qmail in a place other than /var/qmail. How should
8. I want to use a different file name than /etc/tcp.smtp for my
9. How can we use an IP address per domain, so that users don't need
10. Why was the name of the package changed from vchkpw to vpopmail?
11. Logging? Please tell me about logging
12. How do I alias a new virtual domain to a current virtualdomain?
13. How do I post a email to all users of a virtualdomain or a set
    of domains?
14. Is there a mailing list available for vpopmail package?
15. How do I setup vpopmail to talk to mysql?
16. I want to upgrade vpopmail, what do I need to worry about?
17. Will IMAP work with vpopmail?
18. Can I use vpopmail with IMP (www.horde.org/imp)?
19. What is the difference between the --enable-large-site=y or n
20. How do I control the database and table names in mysql
21. Why can't pop authenticate on my slackware installation? 
22. How do I forward all email to a different site?
23. How come, about every hour or so, everything stops working?
24. We are using NFS and sometimes things break! 
25. How to use ssh tunnels with pop?
26. vaddomain fails on my Debian qmail installation
27. How do I log when people authenticate with pop? 
28. How do I compile sqwebmail with vpopmail and mysql?
29. How can I uninstall vpopmail? 
30. I get errors about not finding a .so library, how to fix?
31. What is the relationship between ~vpopmail/etc/open-smtp
~vpopmail/etc/tcp.smtp and ~vpopmail/etc/tcp.smtp.cdb and how do they work with
the smtpserver?
32. I don't want to bounce emails for non existent users. Instead I want
    to delete them, how?
33. Quota usage doesn't decrease after deleting messages with qmail-pop3d!
34. How do I get Courier-IMAP use vpopmail's "roaming users"?
35. How to run vadddomain as non root
36. I want to have vpopmail access mysql as vpopmail and not root. What 
    sql commands to I run? 
37. Is there commerical support available?


Intro
---------------------------------------------------------------

vpopmail is a collection of programs to automate creation and
maintence of non /etc/passwd virutal domain email and pop accounts 
for qmail installations.

Two additional packages support the vpopmail package:

qmailadmin provides a simple web based administration interface 
for pop account maintence, forwards, aliases, mailing lists 
and autoresponders.  http://sourceforge.net/projects/qmailadmin/

Sqwebmail provides a hot mail type web email system which
reads directly from the disks Maildirs, local, NFS or NAS.
and autoresponders.  http://www.inter7.com/sqwebmail/

Features for vpopmail
---------------------------------------------------------------

- uses one uid/gid for all email accounts

  two types of email addresses
  1) for domains in /var/qmail/control/locals the email
     addresses are:  user@any-domain-in-locals-file
     pop authentication user name is: user

     admin programs are: vadduser, vdeluser, vpasswd

        vadduser username optional-command-line-password -a (optional apop)
        vdeluser username 
        vpasswd  username optional-command-line-password -a (optional apop)

  2) for "virtual" domains in /var/qmail/control/virtualdomains
     addresses are of the form user@virtualdomain
     pop authentication user name is: 
	 user%virtualdomain or user@virtualdomain depending on email client

     admin programs are: vadddomain, vdeldomain, vpasswd

        vadddomain virtualdomain optional-command-line-password-for-postmaster 
                   -a (optional apop)
        vdeldomain virtualdomain 
        vadduser username@virtualdomain optional-command-line-password 
            -a (optional apop)
        vdeluser username@virtualdomain optional-command-line-password
            -a (optional apop)
        vpasswd  username@domainname optional-command-line-password 

 NOTE: for all of the above commands that take passwords: If the
       password is not specified,it will prompt the command line
       for it untill two successive entries match.

- automated and complete command line program to add a new 
  virtual domain: 

    admin program: vadddomain virtualdomain optional-postmaster-password 
        -a (for apop)

    This program does the following: 
        updates /var/qmail/control/rcpthosts
        updates /var/qmail/control/virtualdomains
        updates /var/qmail/users/assign
        updates /var/qmail/users/cdb
        runs /var/qmail/bin/qmail-newu

        sends hup signal to qmail-send to accept new domain

- disk limit hard quota for all users under the single uid/gid
  default is 50Meg per user

- automates opening up smtp relay for roaming users
  works in conjunction with the qmail-smtpd server run under
  tcpserver with the optional -x /etc/relayip.cdb feature

- email delivery is complete and allow for .qmail processing
  per domain and folder spliting per domain/user

  fully supports forwards, aliases, mailing lists, autoresponders
  or any other program which uses the dot-qmail syntax

- handles all email that does not match a pop user or .qmail in these ways:
    a) delivers to a pop account
    b) forwards to another email address
    c) bounces
    customizable in .qmail-default file per domain

- efficent and written in c

- supports /etc/passwd users as well as single uid/gid users

- requires qmail and tcpserver to fully operate all features

- can be used in scripts or programs to automate virtual domains and
  users account management

- tested on redhat 6.0, 5.2 (no shadow, default), solaris 5.7
  should work on other systems too. possible porting issue
  with format of ps command arguments

- simplified installation.
  uses configure ; make ; make install 
  configuration parameters allow for customizing to a sites disk layout
  auto detechs shadow or non shadow authentication per platform

  FAQ
---------------------------------------------------------------

0. How can I set one virtual domain to be the primary domain for
   the machine? We don't want to have any /etc/passwd users.

   configure vpopmail with this option:
       --enable-default-domain=<domain name>

   If you have already configured vpopmail you will need to do it
   again. make distclean ; ./configure < with your options > ; make 
   make install-strip;

   Then you can create the default domain with vadddomain <domain name>

   This will allow users of the primary domain to set thier
   pop user name to <user> instead of <user>%<virtualdomain>
 
1. How do I pop in to pick up my virtual domain email?

   Virtual domain users need to use the following format for thier
   user name when popping in:

        user%virtual_domain_name

   Eudora might require the following syntax
        user%virtual_domain_name@pophost

   Microsoft clients may the following syntax:
        user@virtual_domain   

   If you don't include the %virtual_domain_name, vpopmail will 
   assume it is either a /etc/passwd user or a vpop user in 
   ~vpopmail/users or configured with "default domain".

2. How do I forward all mail that doesn't match any pop users or .qmail
   files for a particular domain?

   Edit the ~vpopmail/domains/virtual_domain/.qmail-default file and 
   change the last parameter to an email address of the form: user@domain

3. How do I bounce all mail that doesn't match any pop users or .qmail
   files for a particular domain?

   Edit the ~vpopmail/domains/virtual_domain/.qmail-default file and 
   change the last parameter to "bounce-no-mailbox" without the quotes.

   For example:
   # more .qmail-default
   | /home/vpopmail/bin/vdelivermail '' bounce-no-mailbox 


4. How do I allow roaming users to use our smtp server without opening
   the machine up to everyone on the internet? 

   Your startup script for the qmail smtp server must use the 
   tcpserver -x file command similar to this startup line. 

    env - PATH="/var/qmail/bin:/usr/local/bin" \
    tcpserver -H -R -x /path/to/vpopmail/etc/tcp.smtp.cdb \
	-c20 -u504 -g503 0 smtp \
    /var/qmail/bin/qmail-smtpd 2>&1 > /dev/null &

Here are our qmail /etc/passwd entries
alias:x:503:503::/var/qmail/alias:/bin/bash
qmaild:x:504:503::/var/qmail:/bin/bash
qmaill:x:505:503::/var/qmail:/bin/bash
qmailp:x:506:503::/var/qmail:/bin/bash
qmailq:x:507:504::/var/qmail:/bin/bash
qmailr:x:508:504::/var/qmail:/bin/bash
qmails:x:509:504::/var/qmail:/bin/bash

    modify the -u503 and -g503 to match your systems 
    qmaild user id and group id

   Configure vpopmail with an additional option --enable-roaming-users=y

   Then edit the /path/to/vpopmail/etc/tcp.smtp file and put in lines for all
   static IP's that you will always want to allow relay access to.
   For example:

    127.0.0.:allow,RELAYCLIENT=""
    10.1.1.:allow,RELAYCLIENT=""

   The above lines will allow the localhost and all machines on the 10.1.1 C
   class to relay thru.

   You should always put in the 127.0.0 and the IP of the machine 
   vpopmail is running on and any aliased IPs.

   Then run the following command
   /path/to/vpopmail/bin/clearopensmtp

   Then, every time someone pops in and authenticates, the follow happens:

        1) vpopmail asks for an exclusive lock on the 
		   ~vpopmail/etc/open-smtp.lock file
        2) it will wait for the lock, once it gets it, it will continue
        3) it adds the pop users IP into ~vpopmail/etc/open-smtp file with a 
           time stamp. If the IP already exsists, it updates the timestamp.
        4) it runs tcprules to regenerate the /etc/tcp.smtp.cdb file
        5) releases lock and new IP becomes available to the next 
           smtp invocation.

    At this point, the smtp server configured above will allow that
    IP to relay for 1 hour (default).

    You should setup cron to run the following:
        40 * * * * /home/vpopmail/bin/clearopensmtp 
    Change /home/vpopmail to be your vpopmails home dir.

    clearopenstmp will ask for a lock, clear out any roaming IP's 
    whos timestamps are over 1 hour old since last pop authentication.
    merges the two files vpopmail does above and run tcprules. 
    Thus closing off relay for those aged IPs.


    I think it's pretty cool :)

5. What is a sample start script for the pop server?

    env - PATH="/var/qmail/bin:/usr/local/bin" \
    tcpserver 0 pop-3 /var/qmail/bin/qmail-popup orbital.inter7.com \
    /home/vpopmail/bin/vchkpw /var/qmail/bin/qmail-pop3d Maildir &

6. How do hard quota's for users work?

    When mail is delivered to a virtual domain, vdelivermail
    will deliver it to the pop users directory. vdelivermail
    will enter the users Maildir and add up the sizes of all 
    the files in these directories. If the size is greater
    than the HARD_QUOTA limit. The email is bounced back to
    the sender.

    Use the default_quota and default_maxmsgcount options in
    ~vpopmail/etc/vlimits.default or the .qmailadmin-limits
    file for the domain to change the default quota for new
    users.  The program vmoduser can be used to update quotas
    for existing accounts.  Please read README.quotas for more
    information on maildirquotas and syntax information.

7. I installed qmail in a place other than /var/qmail. How should
   I configure vpopmail for it?

   ./configure --enable-qmaildir=qmail-install-path

8. I want to use a different file name than /etc/tcp.smtp for my
   static IPs for perment relay.

   ./configure --enable-tcpserver-file=smtp-relay-file

9. How can we use an IP address per domain, so that users don't need
   to authenticate with user%domain or user@domain, 
   they just want to use "user"?

   ./configure --enable-ip-alias-domains=y

   Then run vipmap -a IP domain for each IP you want to link to a domain.

10. Why was the name of the package changed from vchkpw to vpopmail?

    Because no one could pronounce vchkpw and vpopmail is more descriptive.
    V for virtual, pop for pop server, mail for mail!

11. Logging? Please tell me about logging

    ./configure --enable-logging= 
        y means log all successful and unsucessful attemps and fatal errors
        n means don't log anything
        e means only log errors and fatal errors
        p means include passwords in errors
        v means log everything, including passwords in errors


    By default we set it up to only log errors and fatal errors.

12. How do I alias a new virtual domain to a current virtualdomain?

    vaddaliasdomain new_domain old_domain

13. How do I post a email to all users of a virtualdomain or a set
    of domains?

    use the new vpopbull program:

    vpopbull -f email_file vdomain vdomain ...

    To see all the available options run vpopmail with no options.
    It will print out a complete list.

14. Is there a mailing list available for vpopmail users?

    Yes. Send a message to [e-mail]

15. How do I setup vpopmail to talk to mysql?
    Read the README.mysql file.

16. I want to upgrade vpopmail, what do I need to worry about?
    Two things happen on an upgrade. The programs, library and
	include files get over written and the permissions get fixed. 
	None of the users or domain get touched. So to upgrade:
    1) download new vpopmail software
    2) ./configure with your options
    3) make
    4) make install-strip
    5) upgrade completed.

    If you want to backup the programs, libraries and include files
	then back up ~vpopmail/bin, ~vpopmail/include and ~vpopmail/lib

17. Will IMAP work with vpopmail?

Yes. Here's a quick way to get up and running with Courier-IMAP
   using both authpam (/etc/passwd) and vchkpw for auth:

a) Download the Courier-IMAP available at Inter 7's Courier-IMAP
    site.

b) Configure it (as a NON-root user) with the following option: