<!doctype linuxdoc system>
<linuxdoc>
<!-- LinuxDoc file was created by hand by <Dan Kuykendall> Wed April 23 -->
<article>
<titlepag>
<title>
VMailMgr HOWTO
</title>
<author><name>
Bruce Guenter &lt;bruceg@em.ca&gt;,
Dan Kuykendall &lt;dan@kuykendall.org&gt;,<newline>
Vertaald door: Ellen Bokhorst &lt;bokkie@nl.linux.org&gt;
</name></author>

<date>v1.1, 23 april 2000</date>

<abstract>
In dit document wordt uitgelegd hoe ondersteuning voor VMailMgr pop3 virtuele
domein services in combinatie met Qmail in te stellen.
</abstract>
</titlepag>
<toc>

<sect><heading>Introductie</heading>
<p>
VMailMgr (afkorting van Virtuele MAIL ManaGeR) is een pakket met programma's
ontworpen om meerdere domeinen mailadressen en mailboxen op een enkele host
te beheren. Het werkt samen met qmail voor het bezorgen van de mail en
beheer van het programma.
</p>


<sect1><heading>Wat is VMailMgr en waarom zou ik het gebruiken?</heading>
<p>VMailMgr is:</p>
<p>
Een serie utility's voor het beheren van virtuele domeinen inclusief een 
wachtwoordcontrole interface voor qmail welke het gebruikelijke 
checkpassword vervangt, en een authenticatie module voor
Courier IMAP, dat voorziet in toegang tot de virtuele mailboxen middels
&eacute;&eacute;n van de drie volgende methoden:
<itemize>
<item> 
Op IP gebaseerde virtuele servertoegang (onzichtbaar voor de POP3 gebruiker) 
</item>
<item> toegang gebaseerd op de gebruikersnaam (gebruikersnaam-virtuele
gebruiker) </item>
<item> Op de hostnaam gebaseerde toegang (virtuelegebruiker@virtuele.host of virtuelegebruiker:virtuele.host) 
</item>
</itemize>
</p>

<p>
Je zou het kunnen gebruiken als:
</p>
<p>
Je er de voorkeur aangeeft ieder domein via een aparte gebruikersnaam te
beheren, wat je de mogelijkheid geeft gebruik te maken van systeemquota's
wat tevens veiliger is.
</p>
</sect1>

<sect1><heading>Nieuwe versies</heading>
<p>
De nieuwste versie van dit document is te vinden op mijn homepage <url url="http://www.clearrivertech.com/linux/HOWTO">
als SGML source, als HTML en als TEKST.
Andere versies in verschillende formaten zijn te vinden bij de LDP homepage <url url="http://www.linuxdoc.org/">.
Een kopie is ook te vinden op de VMailMgr homepage <url url="http://em.ca/~bruceg/vmailmgr/"> 
als een HTML-versie als ook in het VMailMgr source package in zowel
SGML-sourceformaat als HTML.
</p>
</sect1>

<sect1><heading>Opmerkingen</heading>
<p>
Opmerkingen over deze HOWTO kunnen worden doorgestuurd naar de
VMailMgr mailinglist.
Stuur voor een aanmelding op deze lijst een email naar <url url="mailto:vmailmgr@lists.em.ca"
name="vmailmgr@lists.em.ca">.
</p>
</sect1>

<sect1><heading>Historie</heading>
<p>
Aan dit document werd begonnen door Bruce Guenter en het werd
omgewerkt door Dan Kuykendall.
</p>
</sect1>

<sect1><heading>Versie historie</heading>
<p>
Oude versie
</p>
<p>
<itemize>
<item>Gecre&euml;erd door Bruce, stond niet in het SGML-formaat.
</item>
</itemize>
</p>
<p>
v1.0 (20 april 2000)
</p>
<p>
<itemize>
<item>Nette SGML-versie samengesteld.</item>
<item>De FAQ opgenomen.</item>
<item>Andere kleine aanvullingen.</item>
</itemize>
</p>
<p>
v1.1 (23 april 2000)
</p>
<p>
<itemize>
<item>De FAQ in een apart bestand geplaatst, maar wat belangrijke info
vanuit de FAQ ingesloten.</item>
<item>De sectie Courier-IMAP ondersteuning bijgewerkt.</item>
<item>Overgeschakeld naar de GNU FDL licentie.</item>
<item>Andere kleine aanvullingen.</item>
</itemize>
</p>
</sect1>

<sect1><heading>Copyrights en handelsmerken</heading>
<p>
Copyright (c)  Dan Kuykendall.
Het is toegestaan dit document onder voorwaarden van de GNU Free
Documentatie Licentie, versie 1.1 of enige latere versie gepubliceerd
door de Free Software Foundation te kopi&euml;ren en/of aan te passen.
</p>
<p>
Een kopie van deze licentie is beschikbaar vanaf
<url url="http://www.gnu.org/copyleft/fdl.txt" name="GNU Free Documentation License">.
</p>
</sect1>

<sect1><heading>Erkenningen en dankbetuigingen</heading>
<p>
Met dank aan Bruce Guenter voor VMailMgr en de kern van deze HOWTO.  Met dank
aan Mike Bell, die altijd de antwoorden op mijn vragen schijnt te hebben. Als
laatste, dank aan allen op de
<url url="mailto:vmailmgr@lists.em.ca" name="vmailmgr@lists.em.ca">
mailinglist die me hebben geholpen of zovaak hetzelfde vroegen dat ik
ik dit moest schrijven om de steeds weer terugkomende vragen te stoppen.
</p>
</sect1>
</sect>

<sect><heading>Installatie</heading>
<sect1><heading>Haal de bestanden op</heading>
<p>
Breng een bezoek aan de VMailMgr website 
<url url="http://em.ca/~bruceg/vmailmgr/">
voor het ophalen van het package.
</p>
<p>
Als je de binaire RPM's ophaalt, heb je op z'n minst de packages
vmailmgr en vmailmgr-daemon nodig.
</p>
</sect1>

<sect1><heading>Installatie met RPM'S</heading>
<sect2><heading>Compileren van de SRC.RPM's</heading>
<p>
Compileer eenvoudigweg het src.rpm bestand  met de
opdracht `<tt>rpm --rebuild</tt>`.
-Voorbeeld-
<code>
rpm -ivh vmailmgr-0.96.6-1.src.rpm
</code>
</p>
</sect2>

<sect2><heading>Installatie van de RPM's</heading>
<p>
Na het compileren van de source rpm's, zijn de binary's te vinden in
`<tt>/usr/src/redhat/RPMS/i386/</tt>` of ergens daaromtrent.

Start gewoon voor ieder package de volgende opdracht op:
<verb>
rpm -ivh <locatie>/<package.i386.rpm>
</verb>
-Voorbeeld-
<code>
rpm -ivh /usr/src/redhat/RPMS/i386/vmailmgr-0.96.6-1.i386.rpm
rpm -ivh /usr/src/redhat/RPMS/i386/VMailMgr-daemon-0.96.6-1.i386.rpm
</code>
</p>
</sect2>
</sect1>

<sect1><heading>Installeren vanuit de source</heading>
<p>
Als je geen gebruik van RPM's wilt maken, kun je het vanuit de source
installeren.
Geef de volgende opdrachten:
<verb>
(Als niet-root gebruiker)
tar zxf &lt;package.tar.gz&gt;
cd &lt;nieuw aangemaakt dir&gt;
./configure
make
(Als root)
make install
</verb>
-Voorbeeld-
<code>
(Als niet-root gebruiker)
tar zxf vmailmgr-0.96.6.tar.gz
cd vmailmgr-0.96.6
./configure
make
(Als root)
make install
</code>
Daarmee zou het moeten lukken.
</p>
</sect1>
</sect>


<sect><heading>Setup</heading>
<sect1><heading>Instellen van een Virtueel domein</heading>
<p>
De volgende stappen zijn nodig voor het met vmailmgr instellen van een
virtueel domein (ervan uitgaande dat vmailmgr is gecompileerd en
ge&iuml;nstalleerd). Als voorbeeld zullen we een virtuele gebruiker
`<tt>ik@mijndomain.org</tt>` instellen, met de aliassen `<tt>mijzelf@mijndomain.org</tt>` 
en `<tt>mijnnaam@mijndomein.org</tt>`. 

<enum>
<item>Zet een DNS entry op voor het domein. Ik zal dat hierin niet behandelen
aangezien dat van veel te veel dingen afhangt. Wat ik wel aan kan geven is
dat een PTR record dat overeenkomt met een entry in virtualdomains nodig is
om een op IP gebaseerd virtueel domein te laten werken. Als nslookup
bijvoorbeeld 10.56.33.122 <tt>mail.mijndomein.com</tt> retourneert, dan is er 
in <tt>virtualdomains</tt> een entry nodig als
`<tt>mail.mijndomein.com:mijngebruiker</tt>`
Als voorbeeld, gaan we ervan uit dat de mail exchanger voor
mijndomein.org reeds zo is ingesteld dat het naar je computer verwijst.
</item>

<item>
Stel een basisgebruiker in voor het domein. Maak een gebruiker
aan met een naam naar keuze. Aangezien de maildirs voor alle
gebruikers in het virtuele domein onder de homedirectory van
deze gebruiker zal worden opgeslagen, moet je ervoor zorgen
dat deze partitie of disk geschikt is voor een dergelijke opslag.
De tools die je hiervoor kunt gebruiken, vari&euml;ren nogal per
systeem. Ik zal omwille van ons voorbeeld een gebruiker `<tt>mijngebruiker</tt>'
toevoegen.</item>

<item>Configureer qmail zo dat het 't domein herkent. 
Hiervoor moet je twee van qmail's configuratiebestanden in
<tt>/var/qmail/control</tt> aanpassen:` `<tt>rcpthosts</tt>` en 
`<tt>virtualdomains</tt>`. </item>

<item>Voeg aan `<tt>rcpthosts</tt>` 
de regel `<tt>mijndomein.org</tt>` toe. </item>

<item>Voeg aan `<tt>virtualdomains</tt>` 
de regel `<tt>mijndomein.org:mijngebruiker</tt>` toe.</item>
</enum>

Als je wilt dat mail aan `<tt>watdanook.mijndomein.org</tt>`
op dezelfde manier wordt bezorgd, voeg je de volgende gegevens toe:

<itemize>
<item>Aan `<tt>rcpthosts</tt>` :
de regel `<tt>.mijndomein.org</tt>`. </item>

<item>Aan `<tt>virtualdomains</tt>` :
de regel `<tt>.mijndomein.org:mijngebruiker</tt>`.</item>

<item>Configureer qmail-popup/qmail-pop3d zo dat het gebruik maakt 
van `<tt>checkvpw</tt>`  voor de wachtwoordcontrole. Deze stap
is afhankelijk van hoe je qmail installeerde.</item>

<item>Vervang `<tt>checkpassword</tt>` in de door jouw gebruikte opdracht
om qmail-popup/qmail-pop3d aan te roepen
(of in `<tt>/etc/inet.conf</tt>` of in een `<tt>tcpserver</tt>` opdracht)
door `<tt>checkvpw</tt>`.</item>

<item>En/of achter de prompt typ je: 
`<tt>echo checkvpw > /var/qmail/control/checkpassword</tt>`</item>

<item>Voeg gebruikers of aliassen aan het domein toe. Wijzig user in
de gebruiker die je zojuist hebt aangemaakt 
(typ bijvoorbeeld `<tt>su - myuser</tt>`) of log in (met telnet of
onder de console) als de nieuwe gebruiker, en gebruik de ingesloten
programma's om gebruikers en aliassen toe te voegen.
Voor ons voorbeeld:

<enum>
<item>typ: `<tt>vadduser me</tt>` (welke vraagt om een wachtwoord)</item>
<item>typ: `<tt>vaddalias me mijzelf</tt>`</item>
<item>en typ: `<tt>vaddalias me mijnnaam</tt>`</item>
</enum>
</item>
</itemize>

Nadat je met deze stappen klaar bent, zal je 
`&lt;qmail-send&gt;` moeten killen en herstarten om ervoor te zorgen
dat het de nieuwe `<tt>virtualdomains</tt>` tabel inleest.
 Als je `<tt>inetd</tt>` gebruikt om `<tt>qmail-popup</tt>` op te starten,
 `<tt>kill -HUP</tt>` het `<tt>inetd</tt>` proces dan ook. 
</p>
</sect1>

<sect1><heading>Gebruik van &eacute;&eacute;n IP-adres voor meerdere domeinen
</heading>
<sect2><heading>Inloggen als een virtuele gebruiker?</heading>
<p>
Er zijn twee manieren om zonder gebruik van meerdere IP-adressen in te
loggen.
</p>

<p>
<enum>
<item>De eerste manier is als `<tt>userSEPvirtual.domein.org</tt>` in te loggen,
waar `<tt>user</tt>` de naam is van de mailbox van de virtuele gebruiker,
SEP staat voor `<tt>@</tt>` of `<tt>:</tt>` (dit is de standaardwaarde, 
en is te configureren in de directory) `<tt>/etc/vmailmgr/</tt>'), en 
`<tt>virtual.domein.org</tt>' is de naam van het virtuele domein, zoals
opgesomd in `<tt>/var/qmail/control/virtualdomains</tt>'. 
</item>

<item>De tweede manier is de interne vorm van de mailbox naam te gebruiken,
dat wil zeggen, `<tt>baseuser-user</tt>', waar `<tt>user</tt>' dezelfde naam
is als hierboven, en `<tt>baseuser</tt>' de gebruikersnaam is van de
beherende gebruiker.
</item>
</enum>

Voorbeeld: `<tt>/var/qmail/control/virtualdomains</tt>' bevat 
<verb>
testdomein.org:testuser
</verb>
Gebruiker `<tt>mijngebruiker</tt>' komt voor, en daarvoor is een virtuele
mailbox ingesteld met de naam `<tt>me</tt>'. De `<tt>scheidingsteken</tt>' 
variabele in `<tt>/etc/vmailmgr/</tt>' bevat
`<tt>@:</tt>'. Deze virtuele gebruiker zou in kunnen loggen als
`<tt>me@mijndomein.com</tt>', `<tt>me:mijndomein.cm</tt>', of
`<tt>mijngebruiker-me</tt>'. 
</p>
</sect2>
</sect1>


<sect1><heading>Alle onjuist verstuurde mail opvangen?</heading>
<p>
In de `<tt>vmailmgr/</tt>' configuratiedirectory, komt een entry voor
genaamd `<tt>default-username</tt>'. Als mail naar een virtueel domein
niet overeenkomt met &eacute;&eacute;n van de gebruikers of aliassen in
dat domein, wordt het bezorgd bij degene waarvan de naam is opgegeven in
dit configuratie-item als het bestaat (standaard naar
`<tt>+</tt>'). Om te zorgen dat het bij jou bezorgd wordt, typ je gewoon:
<verb>
vaddalias me +
</verb>
</p>
</sect1>

<sect1><heading>Setup VMailMgr IMAP ondersteuning?</heading>
<p>
VMailMgr ondersteunt Courier-IMAP, maar Courier-IMAP detecteert VMailMgr
niet automatisch. Dit betekent dat er nog wat werk verzet moet worden om
die twee samen te laten werken.

<itemize>
<item>Je moet `<tt>/usr/local/bin/authvmailmgr</tt>` naar
`<tt>/usr/lib/courier-imap/libexec/authlib/authvmailmgr</tt>`
kopi&euml;ren.</item>

<item>Vervolgens het statement `<tt>AUTHMODULES</tt>` aanpassen in
`<tt>/usr/lib/courier-imap/etc/imapd.config</tt>` en
`<tt>authvmailmgr</tt>` als de eerste authenticatie module
toevoegen.</item>
</itemize>

</p>
</sect1>
</sect>
</article>
</linuxdoc>