====== ispCP 1.0.3-1 (On Debian) Installation du Webmail RoundCube (version 0.3.1) ======

Ce tutoriel s'adresse aux administrateurs qui souhaitent remplacer le webmail par défaut d'ispCP par le webmail RounCube.

===== I. Installation des paquets requis =====

<code># aptitude update
# aptitude install php5-dev php5-sqlite sqlite libmagic-dev aspell aspell-fr</code>

===== II. Installation de Fileinfo via pecl: =====

==== a. Installation : ====

<code># pecl install Fileinfo</code>

==== b. Activation : ====

<code>cat <<EOF > /etc/php5/cgi/conf.d/fileinfo.ini
extension=fileinfo.so
EOF</code>

===== III. Sauvegarde de l'ancien Webmail (SquirrelMail): =====

<code># cd /var/www/ispcp/gui/tools
# mv webmail webmail-squirrmail</code>

===== IV. Téléchargement de l'archive source de Roundcube et décompression: =====

<code># wget -c http://downloads.sourceforge.net/project/roundcubemail/roundcubemail/0.3.1/roundcubemail-0.3.1.tar.gz?use_mirror=freefr
# tar xzf roundcubemail-0.3.1.tar.gz
# mv roundcubemail-0.3.1 webmail</code>

===== V. Création du répertoire pour la base de données SQLite: =====

<code># cd /var/www/ispcp/gui/tools/webmail/
# mkdir data</code>

===== VI. Modification du script de gestion des permissions d'ispCP: =====

Editez le fichier **/var/www/ispcp/engine/setup/set-gui-permissions.sh** et en dessous de cette ligne:

<code>recursive_set_permissions "$ROOT_DIR/gui/tools/webmail/data" \
       $PANEL_USER $APACHE_GROUP 0750 0640</code>

ajoutez celles-ci:

<code>recursive_set_permissions "$ROOT_DIR/gui/tools/webmail/logs" \
        $PANEL_USER $APACHE_GROUP 0750 0640
recursive_set_permissions "$ROOT_DIR/gui/tools/webmail/temp" \
        $PANEL_USER $APACHE_GROUP 0750 0640</code>

Après modification et enregistrement, exécutez le script comme suite:

<code># sh /var/www/ispcp/engine/setup/set-gui-permissions.sh</code>

===== VII. Modification du fichier php.ini du frontend: =====

Editez le fichier **/var/www/fcgi/master/php5/php.ini** et remplacez la ligne suivante:

<code>;date.timezone =</code>

par celle-ci:

<code>date.timezone = UTC</code>

===== VIII. Redémarrage du serveur Apache2: =====

Redémarrez votre serveur apache pour que les changements soient pris en compte :

<code># /etc/init.d/apache2 restart</code>

===== IV. Création de la base SQLite pour Roundcube: =====
Exécutez la commande suivante pour créer la base de données SQLite:
<code># cd /var/www/ispcp/gui/tools/webmail/
# sqlite -init SQL/sqlite.initial.sql data/sqlite.db
Loading resources from SQL/sqlite.initial.sql
SQLite version 2.8.17
Enter ".help" for instructions
sqlite> .exit</code>

===== X. Installation en ligne =====

Rendez-vous à l'adresse http://your_panel.tld/webmail/installer

==== A. Première étape (Vérification de l'environnement) ====

Vérifiez juste que toutes les librairies requises sont présentes et que les paramètres de configuration PHP sont corrects. Ici, seul postgreSQL devrait être non disponible.

==== B. Deuxième étape (création des fichiers de configuration) ====

Veuillez simplement suivre les indications suivantes:

=== -- General configuration ===

  * **product_name :** ispCP Omega
  * **temp_dir :** /temp
  * **ip_check :** Comme vous voulez
  * **des_key :** Par défaut
  * **enable_caching :** Coché
  * **enable_spellcheck (enable_spellcheck) :** Coché
  * **spellcheck_engine :** google
  * **identities_level :** Comme vous voulez.

=== -- Logging & Debugging ===

  * **debug_level :** Log errors
  * **log_driver :** file
  * **log_dir :** logs/
  * **syslog_id :** roundcube
  * **syslog_facility :** Par défaut

=== -- Database setup ===

  * **Database type :** SQLite
  * **Database server (omit for sqlite) :** Valeur vide
  * **Database name (use absolute path and filename for sqlite) :** /var/www/ispcp/gui/tools/webmail/data/sqlite.db
  * **Database user name (needs write permissions)(omit for sqlite) :** Valeur vide
  * **Database password (omit for sqlite) :** Valeur vide

=== -- IMAP Settings ===

  * **The IMAP host(s) chosen to perform the log-in :** localhost
  * **default_port :** 143
  * **username_domain :** Valeur vide
  * **auto_create_user :** Coché
  * **sent_mbox :** Par défaut
  * **trash_mbox :** Par défaut
  * **drafts_mbox :** Par défaut
  * **junk_mbox :** Par défaut

=== -- SMTP Settings ===

  * **smtp_server :** localhost
  * **smtp_port :** 25
  * **smtp_user/smtp_pass :** Valeur vide pour les deux champs
  * **Use the current IMAP username and password for SMTP authentication :** Coché
  * **smtp_log :** Coché

=== -- Display settings & user pref ===

  * **language :** fr_FR
  * **skin :** Par défaut
  * **pagesize :** 100
  * **prefer_html :** Coché
  * **preview_panel :** Par défaut
  * **htmleditor :** Par défaut
  * **draft_autosave :** Par défaut
  * **mdn_requests :** Par défaut
  * **mime_param_folding :** Par défaut
  * **How to encode attachment long/non-ascii names :** Par défaut

Après ceci, cliquez sur le bouton **CREATE CONFIG** pour générer les deux fichiers de configuration **main.inc.php** et **db.inc.php**. Ceci étant fait, créez les deux fichiers avec leur contenu respectif dans le répertoire **/var/www/ispcp/gui/tools/webmail/config**.

Ensuite, éditez manuellement le fichier **/var/www/ispcp/gui/tools/webmail/config/main.inc.php** et paramétrez le nom d'hôte pour le processus //HELO/EHLO//. Il doit s'agir de l'adresse de votre serveur SMTP. Exemple:

<code>$rcmail_config['smtp_helo_host'] = 'mail.domain.tld';</code>

Quand vous avez terminé, exécutez à nouveau le script de gestion des permissions d'ispCP :

<code># sh /var/www/ispcp/engine/setup/set-gui-permissions.sh</code>

Ceci étant fait, vous pouvez cliquer sur le bouton **CONTINUE** afin de passer à la troisième et dernière étape.

==== C. Troisième étape (Vérification): ====

Cette étape vous permet de vérifier que tous est bien en place. Ici, aucune erreur ne doit être soulevée par l'installateur. Vous pouvez aussi tester la connexion IMAP et SMTP avec vos identifiants de messagerie ispCP habituels.

**Fin de l'installation.**

**Note:** Pensez à supprimer le répertoire "//installer//" après installation.