Modifications entre les versions 1 et 4 (s'étendant sur 3 versions)
Version 1 à la date du 2008-12-17 18:51:47
Taille: 3936
Commentaire:
Version 4 à la date du 2008-12-27 13:00:32
Taille: 7026
Commentaire:
Texte supprimé. Texte ajouté.
Ligne 1: Ligne 1:
== Installation / Configuration ==
Ajouter le dépot etch-backports:
{{{
web:/# echo -e "\ndeb http://www.backports.org/debian etch-backports main contrib non-free\n" >> /etc/apt/sources.list
web:/# wget -O - http://backports.org/debian/archive.key | apt-key add -
## page was renamed from Roundcube
## Merci et bravo Nacer, c'est cool ! J'ai tripoté ta page, mais tu sais que c'est uniquement parce que j'aime faire ch**r les bons copains ;)


!RoundCube ([[http://roundcube.net/|site officiel]]) est un webmail moderne, simple à utiliser (tendance ''gmail'') et à installer. Il n'a pas toutes les possibilités d'IMP, mais cela en simplifie l'utilisation et il suffit à la très grande majorité des utilisateurs.

C'est un logiciel disponible en version béta depuis de longs mois. Néanmoins nous l'utilisons depuis longtemps avec succès dans divers campus numérique de l'AUF. C'est donc actuellement le logiciel de webmail conseillé.


= Installation et configuration =

Tout d'abord, si vous êtes sur Debian Etch, ajouter le dépôt [[http://backports.org/dokuwiki/doku.php?id=instructions|etch-backports]] :
  {{{
web:~# echo "deb http://www.backports.org/debian etch-backports main" >> /etc/apt/sources.list
web:~# aptitude update && aptitude install debian-backports-keyring
Ligne 7: Ligne 17:
Installer roundcube
{{{
aptitude install roundcube-core roundcube-mysql mysql-client

Puis i
nstaller !RoundCube :
  {{{
web:~$ aptitude install roundcube-mysql roundcube
Ligne 11: Ligne 22:
 * ''' je sais pas à quoi sert le paquet roundcube'''
=== Configuration de l'accès à la BD par roundcube ===
Moi j'utilise un serveur mysql qui ne réside pas sur le même serveur que l'install de roundcube. De plus, j'utilise pas le processus de configuration proposé à l'install.
 * créer la base de données (pour cela utiliser le script /usr/share/dbconfig-common/data/roundcube/install/mysql à copier sur le serveur mysql):
{{{
web:/# scp /usr/share/dbconfig-common/data/roundcube/install/mysql root@mysql:/root/roundcube.sql

Note : si vous n'avez pas encore installé Apache 2 et PHP 5, l'installation de !RoundCube va le faire automatique par le jeu des dépendances entre paquets. Cependant, pour mieux contrôler le processus, il est préférable d'installer d'abord Apache 2 puis PHP 5 et éventuellement de les configurer avant de lancer l'installation de !RoundCube.

Note 2 : si vous installez uniquement le paquet "roundcube", cela va installer une version de !RoundCube qui utilisera une base locale SQLite. Pour un petit webmail pas hyper consulté (du genre 50 consultations simultanées, ce qui est je pense le cas de 100% des sites AUF), à mon avis c'est suffisant. De plus la base de données SQLite est un simple fichier que vous pourrez facilement migrer, sauvegarder, etc... -- ThomasNoël <<DateTime(2008-12-18T23:57:33Z)>>

== Accès à la base de données MySQL par roundcube ==

Note : moi (NacerAdamouSaidou) j'utilise un serveur MySQL qui ne réside pas sur le même serveur que l'install de !RoundCube. De plus, je n'utilise pas le processus de configuration proposé à l'installation.
 
 * créer la base de données (pour cela utiliser le script `/usr/share/dbconfig-common/data/roundcube/install/mysql` à copier sur le serveur MySQL) :
 {{{
webmail:~$ scp /usr/share/dbconfig-common/data/roundcube/install/mysql root@mysql:roundcube.sql
Ligne 18: Ligne 35:
et sur le serveur mysql:
{{{
mysql:/root# ls
 * ensuite, sur le serveur MySQL :
 {{{
mysql:~# ls
Ligne 22: Ligne 39:
mysql:/root# mysql -p mysql:~# mysql -p
Ligne 26: Ligne 43:
> grant all privileges on roundcube.* to 'leuser'@'%' identified by 'lepass' > grant all privileges on roundcube.* to 'roundcube'@'%' identified by 'mot-de-passe'
Ligne 29: Ligne 46:
de retour sur le serveur hébergeant roundcube, on configure l'accès à la bd qui vient d'être créée:
{{{
web:/# cat /etc/roundcube/debian-db.php
 * puis, de retour sur le serveur hébergeant !RoundCube, on configure l'accès à la base de données MySQL qui vient d'être créée :
 {{{
web:~# cat /etc/roundcube/debian-db.php
Ligne 33: Ligne 50:
$dbuser='leuser';
$dbpass='lepass';
$dbuser='roundcube';
$dbpass='mot-de-passe';
Ligne 42: Ligne 59:
Ensuite on configure le fichier principal de configuration (et oui!) de l'appli. Je (nacer) ne mets ici qque les variables que j'ai changé chez moi:
{{{
// je sais pas pourquoi, mais chez moi, ca marche pas si je mets cette variable à FALSE

== Configuration générale ==

Enfin on configure le fichier principal de configuration (et oui!) de l'appli. Je (NacerAdamouSaidou) ne mets ici que les variables que j'ai changé à Yaoundé 1 :

 {{{
// création automatique d'un utilisateur dans la base MySQL si l'authentification IMAP a fonctionné
Ligne 48: Ligne 69:
// nous reviendrons sur ce paramètre plus tard // Retirer ce paramètre dans le cas d'un DoveCot avec authentification PAM (voir ci-dessous)
Ligne 50: Ligne 71:
$rcmail_config['mail_domain'] = '.cm.refer.org'; $rcmail_config['mail_domain'] = 'cm.refer.org';
Ligne 59: Ligne 80:
// si vous n'avez qu'un domaine désservit, renseigner ce paramètre // si vous n'avez qu'un domaine, renseigner ce paramètre (domaines de mail ??? Nacer, tu n'en a pas deux : @cm.auf.org et @cm.refer.org .. ?)
Ligne 62: Ligne 83:
== Problèmes rencontrés ==
''' Impossible de m'authentifier. Sur le serveur de mail, le fichier /var/log/auth.log affichait le message suivant:
''Dec 15 09:30:18 mail dovecot-auth: (pam_unix) authentication failure; logname= uid=0 euid=0 tty=dovecot ruser= rhost=192.168.10.102'' '''
Ligne 66: Ligne 84:
= Problèmes rencontrés =
Ligne 67: Ligne 86:
''A mon avis, comme tu as mis "username_domain = cm.refer.org", ça fait planter parce que le login envoyé à dovecot est du style
"login@cm.refer.org".
Or je crois que sur dovecot on n'a activé que "login" tout court. Il faudrait activer la possibilité de faire du
"login@cm.refer.org" dans dovecot (je ne sais pas faire). '' (explicaton de Thomas Noel)
 * Après l'installation de Roundcube, toute tentative de connexion au webmail renvoie une page blanche.
 . ''A Yaoundé 1, ce problème était dû au fait que php-mysql n'était pas installé.''
Ligne 72: Ligne 89:
 * Impossible de m'authentifier. Sur le serveur de mail, le fichier /var/log/auth.log affichait le message suivant :
  . `Dec 15 09:30:18 mail dovecot-auth: (pam_unix) authentication failure; logname= uid=0 euid=0 tty=dovecot ruser= rhost=192.168.10.102`
 . ''A mon avis, comme tu as mis "username_domain = cm.refer.org", ça fait planter parce que le login envoyé à dovecot est du style "login@cm.refer.org". Or je crois que sur dovecot on n'a activé que "login" tout court (dovecot passe par pam_unix uniquement, et donc ne supporte pas autre chose que les login Unix). Il faudrait activer la possibilité de faire du "login@cm.refer.org" dans dovecot (je ne sais pas faire). -- ThomasNoël <<DateTime(2008-12-18T23:57:33Z)>>''
 . ''Conclusion:'' j'ai change username_domain='cm.refer.org' en username_domain=''. Je verrai la possibilité de gérer les login@domain plus tard.
Ligne 73: Ligne 94:
''' Impossible de s'authentifier si on utilise l'adresse http://webmail.cm.auf.org. Aucune erreur dans les logs, et tout laisse à croire que l'authentification s'effectue normalement. Mais après chaque tentative, la page de connexion se réaffiche. [Testé sur firefox uniquement] si on vide le cache, la page indique alors que le navigateur n'accepte pas les cookies.'''  * Impossible de s'authentifier si on utilise l'adresse http://webmail.cm.auf.org. Aucune erreur dans les logs, et tout laisse à croire que l'authentification s'effectue normalement. Mais après chaque tentative, la page de connexion se réaffiche. [Testé sur firefox uniquement] si on vide le cache, la page indique alors que le navigateur n'accepte pas les cookies.
 . '' Le paramètre session_domain était renseigné à ".cm.refer.org" et pas à ".cm.auf.org". Pour résoudre ce souci, j'ai laissé rcmail_config['session_domain'] non renseigné. A ce propos, j'ai (nacer) également pu constaté que si la variable session.auto_start de /etc/php5/apache2/php.ini est activée, le phénomène décrit ici se produit aussi.''
 . ''Conclusion:'' laisser session_domain non renseigné si l'on veut accéder au webmail via plusieurs adresse (webmail.cm.{auf,refer}.org chez moi).
Ligne 75: Ligne 98:

'' Le paramètre session_domain était renseigné à ".cm.refer.org" et pas à ".cm.auf.org". Pour résoudre ce souci, j'ai laissé rcmail_config['session_domain'] non renseigné.
A ce propos, j'ai (nacer) également pu constaté que si la variable session.auto_start de /etc/php5/apache2/php.ini est activée, le phénomène décrit ici se produit aussi.''
 * Impossible d'envoyer un mail à partir du webmail. Chaque fois qu'on compose un mail et qu'on l'envoie à partir du webmail, celui-ci réponds par un message "l'envoie du message a échoué".
 . '' vérifier que l'envoie d'un mail à partir du serveur hébergeant le webmail avec la commande mail en ligne de commande se fait bien. Si c'est pas le cas, réglé ce problème. Chez moi, c'est pas encore fait, donc j'utilise les fonctions de php pour l'envoie des messages (on fait ca en commentant la ligne contenant la variable $rcmail_config['smtp_server'], tel qu'indiqué par le commentaire associé dans le fichier de configuration de Roundcube). ''

RoundCube (site officiel) est un webmail moderne, simple à utiliser (tendance gmail) et à installer. Il n'a pas toutes les possibilités d'IMP, mais cela en simplifie l'utilisation et il suffit à la très grande majorité des utilisateurs.

C'est un logiciel disponible en version béta depuis de longs mois. Néanmoins nous l'utilisons depuis longtemps avec succès dans divers campus numérique de l'AUF. C'est donc actuellement le logiciel de webmail conseillé.

Installation et configuration

Tout d'abord, si vous êtes sur Debian Etch, ajouter le dépôt etch-backports :

  • web:~# echo "deb http://www.backports.org/debian etch-backports main" >> /etc/apt/sources.list
    web:~# aptitude update && aptitude install debian-backports-keyring

Puis installer RoundCube :

  • web:~$ aptitude install roundcube-mysql roundcube

Note : si vous n'avez pas encore installé Apache 2 et PHP 5, l'installation de RoundCube va le faire automatique par le jeu des dépendances entre paquets. Cependant, pour mieux contrôler le processus, il est préférable d'installer d'abord Apache 2 puis PHP 5 et éventuellement de les configurer avant de lancer l'installation de RoundCube.

Note 2 : si vous installez uniquement le paquet "roundcube", cela va installer une version de RoundCube qui utilisera une base locale SQLite. Pour un petit webmail pas hyper consulté (du genre 50 consultations simultanées, ce qui est je pense le cas de 100% des sites AUF), à mon avis c'est suffisant. De plus la base de données SQLite est un simple fichier que vous pourrez facilement migrer, sauvegarder, etc... -- ThomasNoël 2008-12-18 23:57:33

Accès à la base de données MySQL par roundcube

Note : moi (NacerAdamouSaidou) j'utilise un serveur MySQL qui ne réside pas sur le même serveur que l'install de RoundCube. De plus, je n'utilise pas le processus de configuration proposé à l'installation.

  • créer la base de données (pour cela utiliser le script /usr/share/dbconfig-common/data/roundcube/install/mysql à copier sur le serveur MySQL) :

    webmail:~$ scp /usr/share/dbconfig-common/data/roundcube/install/mysql root@mysql:roundcube.sql
  • ensuite, sur le serveur MySQL :
    mysql:~# ls
    roundcube.sql
    mysql:~# mysql -p
    > create database roundcube;
    > use roundcube
    > source roundcube.sql
    > grant all privileges on roundcube.* to 'roundcube'@'%' identified by 'mot-de-passe'
    > exit
  • puis, de retour sur le serveur hébergeant RoundCube, on configure l'accès à la base de données MySQL qui vient d'être créée :

    web:~# cat /etc/roundcube/debian-db.php
    ...
    $dbuser='roundcube';
    $dbpass='mot-de-passe';
    $basepath='';
    $dbname='roundcube';
    $dbserver='mysql.cm.auf.org';
    $dbport='3306';
    $dbtype='mysql';
    ...

Configuration générale

Enfin on configure le fichier principal de configuration (et oui!) de l'appli. Je (NacerAdamouSaidou) ne mets ici que les variables que j'ai changé à Yaoundé 1 :

  • // création automatique d'un utilisateur dans la base MySQL si l'authentification IMAP a fonctionné
    $rcmail_config['auto_create_user'] = TRUE;
    // si le port 993 sur le serveur de mail est disponible chez vous
    $rcmail_config['default_host'] = 'ssl://mail.cm.refer.org:993';
    // Retirer ce paramètre dans le cas d'un DoveCot avec authentification PAM (voir ci-dessous)
    ///$rcmail_config['username_domain'] = '';
    $rcmail_config['mail_domain'] = 'cm.refer.org';
    // à adapter chez vous
    $rcmail_config['smtp_server'] = 'ssl://smtp.cm.refer.org';
    $rcmail_config['smtp_port'] = 587;
    $rcmail_config['smtp_user'] = '%u';
    $rcmail_config['smtp_pass'] = '%p';
    // regarder dans /etc/dovecot/dovecot.conf le mecanisme d'authentification activé.
    $rcmail_config['smtp_auth_type'] = 'PLAIN';
    $rcmail_config['smtp_helo_host'] = 'smtp.cm.refer.org';
    // si vous n'avez qu'un domaine, renseigner ce paramètre (domaines de mail ??? Nacer, tu n'en a pas deux : @cm.auf.org et @cm.refer.org .. ?)
    $rcmail_config['session_domain'] = '';

Problèmes rencontrés

  • Après l'installation de Roundcube, toute tentative de connexion au webmail renvoie une page blanche.
  • A Yaoundé 1, ce problème était dû au fait que php-mysql n'était pas installé.

  • Impossible de m'authentifier. Sur le serveur de mail, le fichier /var/log/auth.log affichait le message suivant :
    • Dec 15 09:30:18 mail dovecot-auth: (pam_unix) authentication failure; logname= uid=0 euid=0 tty=dovecot ruser= rhost=192.168.10.102

  • A mon avis, comme tu as mis "username_domain = cm.refer.org", ça fait planter parce que le login envoyé à dovecot est du style "login@cm.refer.org". Or je crois que sur dovecot on n'a activé que "login" tout court (dovecot passe par pam_unix uniquement, et donc ne supporte pas autre chose que les login Unix). Il faudrait activer la possibilité de faire du "login@cm.refer.org" dans dovecot (je ne sais pas faire). -- ThomasNoël 2008-12-18 23:57:33

  • Conclusion: j'ai change username_domain='cm.refer.org' en username_domain=. Je verrai la possibilité de gérer les login@domain plus tard.

  • Impossible de s'authentifier si on utilise l'adresse http://webmail.cm.auf.org. Aucune erreur dans les logs, et tout laisse à croire que l'authentification s'effectue normalement. Mais après chaque tentative, la page de connexion se réaffiche. [Testé sur firefox uniquement] si on vide le cache, la page indique alors que le navigateur n'accepte pas les cookies.

  • Le paramètre session_domain était renseigné à ".cm.refer.org" et pas à ".cm.auf.org". Pour résoudre ce souci, j'ai laissé rcmail_config['session_domain'] non renseigné. A ce propos, j'ai (nacer) également pu constaté que si la variable session.auto_start de /etc/php5/apache2/php.ini est activée, le phénomène décrit ici se produit aussi.

  • Conclusion: laisser session_domain non renseigné si l'on veut accéder au webmail via plusieurs adresse (webmail.cm.{auf,refer}.org chez moi).

  • Impossible d'envoyer un mail à partir du webmail. Chaque fois qu'on compose un mail et qu'on l'envoie à partir du webmail, celui-ci réponds par un message "l'envoie du message a échoué".
  • vérifier que l'envoie d'un mail à partir du serveur hébergeant le webmail avec la commande mail en ligne de commande se fait bien. Si c'est pas le cas, réglé ce problème. Chez moi, c'est pas encore fait, donc j'utilise les fonctions de php pour l'envoie des messages (on fait ca en commentant la ligne contenant la variable $rcmail_config['smtp_server'], tel qu'indiqué par le commentaire associé dans le fichier de configuration de Roundcube).

RoundCube (dernière édition le 2008-12-29 11:49:41 par NacerAdamouSaidou)