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.51win32.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-x86no_ssl.msi) o PHP 5.3.3 (http://windows.php.net/downloads/releases/php-5.3.3-Win32-VC9x86.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 Attention : Lorsque lassistant arrive ltape du choix du type de base de donnes, slectionner MySQL, 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 puis Cliquer sur Next

2 Configuration de base de hMailServer : (moins de 10 min)

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 3.1 Installation de PHP : Lancer lexcution du fichier dinstallation php-5.3.3-Win32-VC9-x86.msi. 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 SQL Login SQL Password Database name Host MySQL Root ******* Webmail 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.