INTRODUCTION :

Ce document dcrit linstallation de la solution de messagerie Open Source hMailServer. En terme

daccs client, hMailServer fournit de base le support des protocoles SMTP, POP3 et IMPA4. Laccs
webmail (via HTTP) nest pas fourni par dfaut mais comme nous allons le voir, il est trs simple de
greffer une solution de ce type notre installation. Pour ce lab, jai choisis AfterLogic Webmail Lite
version PHP (tlchargeable gratuitement sur http://www.afterlogic.com/download/webmail-lite).

Note : la finalit de ce document nest pas de passer en revue la totalit des fonctionnalits et
paramtres du produit mais juste de russir une installation basique et fonctionnelle.

Prrequis :

hmailServer sinstalle sur pratiquement toutes les versions de Windows (XP, Windows 7, Windows
2003 Server ou Windows Server 2008). Pour viter de rencontrer des problmes, je vous conseille
quand mme de faire linstallation sur un systme Windows 2003 ou 2008.

Ce lab a t ralis sur Windows Server 2008 Server SP2 Standard Ed. Le stockage des messages
seffectue dans une base de donnes : vous pouvez au choix utiliser une base de donnes Lite
intgre ou alors choisir une base de donnes MySQL, PostgresSQL ou SQL Server.

Linstallation du module Webmail ncessite galement quelques prrequis, savoir :

MySQL
Apache
PHP

Pour ce lab, vous aurez donc besoin de :

La dernire version sur le site www.hmailserver.com. Pour ma part, il sagit de la version

5.3.3 Build 1879.
Pour le stockage des messages et le Webmail, MySQL 5.1 (mysql-essential-5.1.51-
win32.msi disponible sur http://dev.mysql.com/downloads/mysql/)
Pour la partie Webmail :
o Apache 2.2.16 ou 2.2.17 pour Windows (disponible sur
http://apache.mirrors.tds.net//httpd/binaries/win32/httpd-2.2.17-win32-x86-
no_ssl.msi)
o PHP 5.3.3 (http://windows.php.net/downloads/releases/php-5.3.3-Win32-VC9-
x86.msi)

Remarque : Si vous navez pas lintention (ou le besoin) dinstaller la partie Webmail, oubliez
linstallation de MySQL et optez plutt pour la base intgre.
INSTALLATION :

1 Installation de MySQL : (moins de 10 min)

Lancer lexcution du fichier dinstallation mysql-essential-5.1.50-win32.msi.
2 - Installation de hMailServer : (moins de 15 min)
Lancer lexcution du fichier hMailServer-5.3.3-B1879.exe
Le compte root est le compte dadministration utilis par MySQL. Saisissez le mot de passe que vous
avez entr durant linstallation MySQL.

Attention : Copier le fichier libmySQL.dll depuis le rpertoire C:\Program Files\MySQL\MySQL Server

5.1\bin\ vers le rpertoire C:\Program Files\hMailServer\bin. Cliquer sur Next
Dfinir le mot de passe de ladministrateur hmailServer.
Cliquez sur Connect

Bienvenue dans la console dadministration de hMailServer.

Cliquez sur le bouton Add Domain pour dfinir votre domaine de messagerie : labmail.com
dans notre exemple.

Cliquer sur le bouton Save .

Pour linstant, inutile de nous attarder sur les autres paramtres.

Nous allons prsent pouvoir crer un ou plusieurs comptes utilisateurs pour nos tests.
Trs bien, prsent nous allons faire un peu de configuration :

1 - tout dabord nous allons dsactiver la fonctionnalit AUTO-BAN : Settings\Advanced\Auto-ban

2 Configurer le serveur pour accepter les adresses IP de votre rseau : Settings\Advanced\IP
Ranges.

Cliquez sur le bouton Add pour ajouter une plage dadresse :

Attention ! le champ Priority doit avoir une valeur suprieure celle dfinie dans la plage par
defaut Internet

A prsent, votre serveur de messagerie SMTP/POP3/IMAP4 est fonctionnelle. Vous pouvez le tester
en utilisant le client POP3 de votre choix : Outlook, OutlookExpress, ThunderBird,

Configuration du client : Dans mon cas, il sagit dun client Outlook 2007 configur en POP

Faites des tests denvoi/rception pour vous assurer que tout fonctionne correctement.
3 Installation du Webmail (moins de 15 min)
3.1 Installation dapache :

Commencons par installer le service Apache sur le serveur. (attention, IIS doit tre dsactiv sil est
dj install)

Lancer lexcution du fichier dinstallation : httpd-2.2.16-win32-x86-no_ssl.msi

Connectez vous avec votre navigateur sur http://localhost pour vous assurez quApache est
correctement install et fonctionnel.

Remarque :

En cas de problme, souvenez vous que le service Apache peut ne pas dmarrer si un service
accapare dj le port 80. Cest le cas par exemple du logiciel Skype !

3.1 Installation de PHP :

Lancer lexcution du fichier dinstallation php-5.3.3-Win32-VC9-x86.msi.

Laisser les paramtres par dfaut.
3.3 Installation de AfterLogic Webmail Lite:

Dcompresser le fichier afterlogic_webmail_php.zip dans le rpertoire c:\webmail (ou le rpertoire

de votre choix)

Arrter le service Apache et ouvrir le fichier de configuration httpd.conf dans un diteur de texte.

La directive DocumentRoot indique le rpertoire par dfaut utilis par Apache.

Par dfaut, sa valeur est :

DocumentRoot "C:/Program Files/Apache Software Foundation/Apache2.2/htdocs"

Nous allons remplacer cette valeur par le rpertoire Webmail :

DocumentRoot "C:/webmail/webmail"

De mme, remplacer la directive suivante :

<Directory "C:/Program Files/Apache Software Foundation/Apache2.2/htdocs">

Par

<Directory "C:/webmail/webmail">

Et pour finir, remplacer :

<IfModule dir_module>

DirectoryIndex index.html
</IfModule>

Par

<IfModule dir_module>

DirectoryIndex index.php index.html

</IfModule>

Remarque !!

Si vous ralisez ce lab sous Windows 7 ou Windows Vista attendez vous des problmes. Par
exemple, le systme ne vous laisse pas modifier directement le fichier httpd.conf directement. Pour
contourner le problme, faites une copie du fichier dans un rpertoire c:\test par exemple, modifiez
c:\test\httpd.conf puis copiez le nouveau dans le rpertoire Apache.

A prsent, redmarrez le service Apache et ouvrez le site http://localhost dans votre navigateur

Vous devriez prsent avoir une page ressemblant celle-ci :

Ca commence prendre forme mais encore un peu de patience, linstallation nest pas tout fait
termine.

Connectez vous prsent ladresse http://localhost/adminpanel/install.htm et cliquez sur le lien

Run the Installer .
Le service effectue une srie de test afin de sassurer que les prrequis sont installs et fonctionnels.

Cliquez sur Next .

Acceptez les termes dutilisation du produit en cliquant sur le bouton I Agree

Nous allons prsent paramtrer laccs la base de donnes (MySQL) utilise par le webmail pour y
stocker ses donnes.

Type de base de donnes MySQL

SQL Login Root
SQL Password *******
Database name Webmail
Host 127.0.0.1

Cliquez prsent sur le bouton Create

Si la cration se passe correctement, le message Database created successfully

Assurez vous que la case Create Database tables est coche et cliquez sur le bouton Next
La cration des tables sest droule normalement, prsent vous devez dfinir le mot de passe de
ladministrateur Webmail :

Username : mailadm

Password : *******

Prcisez le nom ou ladresse IP de votre serveur (127.0.0.1) et effectuez un test pour vous assurer
que la communication POP3, SMTP et IMAP4 est oprationnelle.
Linstallation est prsent termine. Supprimer ou renommer les fichiers install.* pour viter de
relancer accidentellement lassistant de configuration.

Connectez vous http://localhost/adminpanel

Je vous laisse dcouvrir les options de configuration de linterface webmail.