407 lines
7.4 KiB
HTML
407 lines
7.4 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Putting it all together</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
|
|
"><LINK
|
|
REL="HOME"
|
|
TITLE="Qmail VMailMgr and Courier-Imap HOWTO"
|
|
HREF="index.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="Component installation"
|
|
HREF="x137.html"></HEAD
|
|
><BODY
|
|
CLASS="SECT1"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
SUMMARY="Header navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>Qmail VMailMgr and Courier-Imap HOWTO</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="x137.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
></TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
> </TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="SECT1"
|
|
><H1
|
|
CLASS="SECT1"
|
|
><A
|
|
NAME="AEN380">3. Putting it all together</H1
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN382">3.1. Basic Qmail config</H2
|
|
><P
|
|
>You will need to add your domains to the /var/qmail/control/virtualdomains
|
|
file in the following format as is normal with qmail and VMailMgr.
|
|
domain1.com:user1
|
|
For more detailed setup and config documentation visit the Qmail website
|
|
<A
|
|
HREF="http://www.qmail.org"
|
|
TARGET="_top"
|
|
>http://www.qmail.org</A
|
|
> and the VMailMgr website <A
|
|
HREF="http://www.vmailmgr.org"
|
|
TARGET="_top"
|
|
>http://www.vmailmgr.org</A
|
|
></P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN387">3.2. Tell Qmail to use VMailMgr for authentication</H2
|
|
><P
|
|
>By default qmail uses checkpassword for authentication, to tell Qmail
|
|
to use VMailMgr for authentication type the following command:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
> echo checkvpw > /var/qmail/control/checkpassword</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN391">3.3. Setup Courier-imap for VMailMgr</H2
|
|
><P
|
|
>Copy the VMailMgr auth libs to courier's directory.
|
|
If you installed from RPM, then the vmailmgr-courier-imap RPM will have done this for you.
|
|
Otherwise use this command:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
> cp /usr/bin/authvmailmgr /usr/lib/courier-imap/libexec/authlib/</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
><P
|
|
>Edit <TT
|
|
CLASS="LITERAL"
|
|
>/usr/lib/courier-imap/etc/imapd</TT
|
|
>
|
|
and add authvmailmgr as the only entry in AUTHMODULES</P
|
|
><P
|
|
>For more detailed setup and config documentation visit the Courier-imap
|
|
website <A
|
|
HREF="http://www.inter7.com/courierimap/"
|
|
TARGET="_top"
|
|
>http://www.inter7.com/courierimap/</A
|
|
></P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN399">3.4. Setup virtual domain with VMailMgr</H2
|
|
><P
|
|
>With the user account that will be managing the domain go to their home dir
|
|
and type:
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
> vsetup</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
><P
|
|
>This will setup the users home dir with the necessary structure to handle
|
|
incoming email. You will probably want to create a email account by typing</P
|
|
><P
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
> vadduser emailuser</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
><P
|
|
>For more detailed setup and config documentation visit the VMailMgr website <A
|
|
HREF="http://www.vmailmgr.org"
|
|
TARGET="_top"
|
|
>http://www.vmailmgr.org</A
|
|
></P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN408">3.5. Starting the daemons</H2
|
|
><P
|
|
> Starting the Qmail daemon. Qmail installs itself to autostart by some mysterious (to me) way.
|
|
If you like init scripts you can get Larry Doolittle's (<A
|
|
HREF="ldoolitta@ajlab.org"
|
|
TARGET="_top"
|
|
>ldoolitta@ajlab.org</A
|
|
>)
|
|
init.d script at <A
|
|
HREF="http://qmail.area.com/init.d-script"
|
|
TARGET="_top"
|
|
>http://qmail.area.com/init.d-script</A
|
|
>
|
|
If you have the Larry's init.d script just do this.
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
> /etc/rc.d/init.d/qmail start</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
><P
|
|
>Start VMailMgr daemon
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
> /etc/rc.d/init.d/vmailmgrd start</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
><P
|
|
>Start Courier-imap damon
|
|
<TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
> /etc/rc.d/init.d/courier-imap start</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN418">3.6. Some considerations left</H2
|
|
><P
|
|
>Qmail and the Maildirs may cause some email apps that run locally to
|
|
not work. Visit the Qmail website <A
|
|
HREF="http://www.qmail.org"
|
|
TARGET="_top"
|
|
>http://www.qmail.org</A
|
|
> for details
|
|
on email apps that have been patched to work with Maildirs.</P
|
|
><P
|
|
>Courier-imap is not as widely used as Cyrus or UWash imap servers.
|
|
As such, you may suffer from minor incompatibilities. Courier-imap is
|
|
extremely well written, and tries to comply with the imap definition
|
|
even if it means some imap clients wont work well. For details visit
|
|
the Courier-imap website <A
|
|
HREF="http://www.inter7.com/courierimap/"
|
|
TARGET="_top"
|
|
>http://www.inter7.com/courierimap/</A
|
|
>.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN424">3.7. Mail clients</H2
|
|
><P
|
|
>With the solution you should now have setup you will need to know that user accounts will be user@domain.com
|
|
Netscape does not like this, so for netscape use user:domain.com</P
|
|
><P
|
|
>I would like to suggest that you also checkout phpGroupWare at <A
|
|
HREF="http://www.phpgroupware.org"
|
|
TARGET="_top"
|
|
>http://www.phpgroupware.org</A
|
|
>.
|
|
I have built in support for vmailmgr into it already and it can give you an end result of a full Groupware solution to fend of MS Exchange/Outlook or Lotus Domino.</P
|
|
><P
|
|
>If you decide to use a web based mail client, you will probably want to adjust courier-imaps MAXPERIP setting. By default it is 4, which is a bit low.
|
|
Bump it up to something more sensible, like 10 - 50. Otherwise our webmail users will have problems connecting. This setting is in <TT
|
|
CLASS="LITERAL"
|
|
>/usr/lib/courier-imap/etc/imapd</TT
|
|
>.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN431">3.8. Known bugs</H2
|
|
><P
|
|
>None yet.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN434">3.9. The final word</H2
|
|
><P
|
|
>Im tired, and wonder if anyone will ever use this, but I'm happy its done.
|
|
I'm sure if you have read this far your tired too. Well, all I can hope is
|
|
that you have Qmail, VMailMgr and Courier-imap working. If so, Enjoy!
|
|
If not, bummer!</P
|
|
><P
|
|
>O.K. readers, you're done for today. Feel free to send me your
|
|
feedback, eternal gratitude, flowers, ecash, cars, oil sources etc.</P
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
SUMMARY="Footer navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="x137.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="H"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
> </TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>Component installation</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
> </TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |