Installer un webmail avec Horde, IMP et Turba sur une Redhat 7.2 Release 1 OVH
Guide a appliquer UNIQUEMENT sur des machines REDHAT.
Vous pouvez commander cette installation auprés du service d'infogérance de OVH
Introduction
Chaque serveur dédié est livré avec un webmail minimaliste : SqWebMail
?. Cet outil se présente sous la forme d'un script CGI et permet d'envoyer et de recevoir du courrier directement sur votre serveur dédié. Vous trouverez plus d'informations dans ce guide :
PresentationSqwebmail.
Horde est un framework écrit en PHP qui permet la mise en place d'un webmail plus esthétique que SqWebMail
? et surtout disposant de plus de fonctionnalités. Son architecture permet d'ajouter des fonctionnalités par module et de modifier les paramètres à la volée, sans recompiler ni relancer quoi que ce soit. Dans ce guide, nous aborderons l'installation et la configuration de Horde sur lequel nous allons greffer les modules IMP (consultation et envoi de courrier) et Turba (gestion des carnets d'adresses). Le courrier est consulté via le serveur IMAP du serveur dédié, les paramètres sont enregistrés dans une base de données MySQL.
Configuration requis
Pour faire fonctionner cette solution, vous aurez besoin des outils suivants en état de fonctionnement:
- PHP
- PEAR
- MySQL
- Serveur IMAP
- Serveur SMTP
- votre pass root MySQL
- un compte email installer sur le serveur qui va servir comme administrateur.
Tout ceci est installé par défaut sur nos serveurs dédiés à la livraison. Sauf cas particulier, vous devriez donc pouvoir débuter la mise en place de cette solution sans configuration supplémentaire.
PEAR
Il faut tout d'abord mettre à jour pear:
Il faut ensuite valider les questions que pear va poser avec entrée. Il faut que l'installation se termine avec:
The 'pear' command is now at your service at /home/ovh/src/soft/bin/pear
Etant donner que le pear se trouve maintenant dans /home/ovh/src on va faire un lien symbolique pour utiliser la commande pear sans donner tout le path:
ln -s /home/ovh/src/soft/bin/pear /usr/local/bin/pear
Il faut aussi relancer apache pour que la modification du path dans php.ini soit visible.
Horde dispose d'un test.php ( qui va vous indiquer les modules pear qui sont nécessaire pour le bon fonctionnement du webmail. Vous pouvez les installer ainsi:
pear install Mail_Mime Log Date Auth_SASL HTTP_Request File Services_Weather Cache DB Mail Net_SMTP
Horde, IMP, Turba
Nous allons récupérer le code source de Horde et le décompresser.
Maintenant on peut tout d'abord vérifier si tout est ok:
http://ns.votreserveur.ovh.net/horde/test.php
Les options doivent être pour la plus part vert et orange. Il ne doit y avoir aucune des options en rouge.
Tout va bien? On va commencer la configuration.
Création de la base MySQL
Cette étape va créer la base de données MySQL qui sera utilisée pour stocker les préférences des utilisateurs. Nous allons pour cela utiliser le script fourni avec Horde.
pico /home/ovh/www/horde/scripts/sql/create.mysql.sql
Changez le PASSWORD "horde" par celui de votre choix (pass de connection à la base de donnée qui sera créée par le script) Préparez votre pass root SQL et faites la commande suivante pour générer la base :
cat /home/ovh/www/horde/scripts/sql/create.mysql.sql | mysql -p
Lors du prompt qui va demander le mot de pass, tappez le pass root MySQL.
Créez un fichier /root/.hordepwd ou vous mettez le mot de pass pour la base de données horde dedans. Donc celui du fichier create.mysql.sql. Ceci servira plus tard quand on doit mettre un horde déjà installer à jour.
Configuration de horde
Allez sur
http://ns*****.ovh.net/horde/ puis sur Administration -> setup et cliquez sur horde.
Note : je me connecte en anglais. Suivant votre navigateur, les onglets peuvent avoir été traduits
Dans l'onglet DATABASE, mettez les paramètres de la base de horde :
serveur : localhost
login : horde
mot de passe : (celui que vous avez mis dans le fichier .sql)
base : horde
Dans l'onglet PREFERENCE SYSTEM : il faut cliquer sur SQL database.
Dans preference driver indiquez horde_prefs comme nom de la table qui gère les préférences
Pour finir, cliquez sur "generate horde configuration"
Installation de IMP
La décompression, installation et configuration:
cd /home/ovh/www/horde
tar -xvzf /home/ovh/src/soft/imp-h3-4.1.3.tar.gz
mv imp-h3-4.1.3 imp
cd imp/config
for i in *.dist; do cp $i `basename $i .dist`; done
chown -R ovh:ovh /home/ovh/www/horde/imp/
chmod 777 /home/ovh/www/horde/imp/config
Il faut éditer le fichier servers.php
pico servers.php
Dans le bloc de configuration "$servers
'imap'" : mettez les paramètres suivants :
$servers
'imap' = array(
'name' => 'IMAP Server',
'server' => 'localhost',
'hordeauth' => false,
'protocol' => 'imap',
'port' => 143,
'folders' => 'INBOX.',
'namespace' => '',
'maildomain' => '',
'smtphost' => 'localhost',
'smtpport' => 25,
'realm' => '',
'preferred' => '',
'dotfiles' => false,
'hierarchies' => array()
);
Installation de Turba
La décompression, installation et configuration:
cd /home/ovh/www/horde
tar -xvzf /home/ovh/src/soft/turba-h3-2.1.3.tar.gz
mv turba-h3-2.1.3 turba
cd turba/config
for i in *.dist; do cp $i `basename $i .dist`; done
chown -R ovh:ovh /home/ovh/www/horde/turba/
chmod 777 /home/ovh/www/horde/turba/config
On va installer la base de données à l'aide du script.
Donnez comme avant déjà votre pass root MySQL.
cat /home/ovh/www/horde/turba/scripts/sql/turba_objects.mysql.sql | mysql -p horde
Configuration de IMP et Turba
Allez sur
http://ns*****.ovh.net/horde/ et dans sur le onglet Administration -> setup puis cliquez sur imp. Dans l'onglet EXTERNAL UTILITIES AND MENU, cliquez sur turba dans le menu déroulant en bas.
Cliquez sur generate mail configuration ensuite allez dans Administration -> setup et cliquez sur turba,
puis sur imp dans le menu déroulant et enfin sur "generate address book configuration"
Compte Admin
Ce compte sera celui qui aura les droits de l' administrateur sur horde.
Allez sur
http://ns*****.ovh.net/horde/ puis dans Administration -> setup et cliquez sur horde.
Dans l'onglet AUTHENTICATION remplacez Administrator par
votrecompte@installersurleserveur.com.
Dans le menu déroulant sélectionnez "Let a horde application handle authentication"
puis en-dessous sélectionnez IMP, cliquez sur "generate horde configuration"
Normalement vous devez avoir une
Fatal Error juste après validation.
Il faut alors vous déconnecter de horde et vous connecter avec le compte que vous avez nommé administrateur.
C'est terminée, votre horde est prêt a usage.
Virtual Host
Vous pouvez maintenant créer un VirtualHost dans votre httpd.conf.
Ainsi a chaque fois quand vous voulez ajouter un autre domaine sur le webmail, vous pouvez le faire en ajoutant simplement un ServerAlias.
Un exemple:
<VirtualHost votre.ip.de.dedie>
ServerAdmin votreemail@ici.com
DocumentRoot /home/ovh/www/horde
User ovh
Group users
ServerName webmail.votredomaine.com
ServerAlias webmail.votredomaine1.com
ServerAlias webmail.votredomaine2.com
CustomLog logs/webmail_domaine-access_log combined
Liens
Le site officiel de Horde :
http://www.horde.org.
Installer Horde IMP sur une Redhat 7.3 (en anglais) :
http://willert.dk/geek/imp32-rh73.html.