Différences

Ci-dessous, les différences entre deux révisions de la page.

--- sysadmin:install_roundcube [2009/12/05 10:24]
james typo
+++ sysadmin:install_roundcube [2011/04/01 12:15]
james ajout upgrade vers 0.5.1
@@ Ligne 4: / Ligne 4: @@
 ===== Prérequis =====
-L'installation sera effectuée sur une [[http://www.debian.org]] debian stable (lenny a l'heure ou ce tutorial est écrit) disposant d'un serveur web [[http://www.apache.org|apache2]] gérant le [[http://php.net|php]] et assumant que vous avez un serveur [[http://www.mysql.fr|mysql]].
+L'installation sera effectuée sur une [[http://www.debian.org|debian]] stable (lenny a l'heure ou ce tutorial est écrit) disposant d'un serveur web [[http://www.apache.org|apache2]] gérant le [[http://php.net|php]] et assumant que vous avez un serveur [[http://www.mysql.fr|mysql]] installé et fonctionnel.
-  * Téléchargement de roundcube : la derniere version peut etre trouvée ici : http://roundcube.net/download, prendre la version "GPL (dependent)" car nous allons installer les dependances nous meme.
+==== Téléchargement de roundcube ====
+la derniere version peut etre trouvée ici : http://roundcube.net/download, prendre la version "GPL (dependent)" car nous allons installer les dependances nous meme.
-  * Installation des logiciels requis :<code>
+==== Installation des logiciels requis ====
-apt-get install openssl aspell-fr php5-gd php5-mcrypt php5-mcrypt php5-dev libmagic-dev
+<code>
+apt-get install openssl aspell-fr php5-gd php5-mcrypt php5-mcrypt php5-dev libmagic-dev php5-mysql
 # et les librairies PHP PEAR (disponibles sous forme de paquets debian) :
 apt-get install php-auth php-net-smtp php-net-socket php-mail-mime libmagic1 php5-pspell libjs-jquery
@@ Ligne 15: / Ligne 16: @@
 pecl install Fileinfo
 </code>
+Certaines librairies PEAR ne sont pas disponible dans les depots debian officiels, mais ils le sont dans les depots [[http://www.backports.org|backports]] : nous allons donc utiliser ces versions :<code>
+cd /tmp
+wget http://www.backports.org/debian/pool/main/p/php-mdb2/php-mdb2_2.5.0b2-1~bpo50+1_all.deb
+wget http://www.backports.org/debian/pool/main/p/php-mdb2-driver-mysql/php-mdb2-driver-mysql_1.5.0b2-1~bpo50+1_all.deb
+dpkg -i php-mdb2_2.5.0b2-1~bpo50+1_all.deb
+dpkg -i php-mdb2-driver-mysql_1.5.0b2-1~bpo50+1_all.deb
+</code>
+Ajouter dans les fichiers /etc/php5/cli/php.ini et /etc/php5/apache2/php.ini : <code>extension=fileinfo.so</code>
-  * Configuration :
+Un (re)démarrage de apache est nécessaire pour prendre ces changements en compte :<code>
-    * ajouter dans les fichiers /etc/php5/cli/php.ini et /etc/php5/apache2/php.ini : <code>extension=fileinfo.so</code> dans les fichiers /etc/php5/cli/php.ini et /etc/php5/apache2/php.ini
+/etc/init.d/apache2 restart
-    *
+</code>
-====== Installation ======
+===== Installation =====
 ==== decompression de l'archive ====
@@ Ligne 32: / Ligne 41: @@
 ==== configuration du vhost apache  ====
-Créer un fichier /etc/apache2/sites-available/webmail.mondomaine.com) contenant :<code>
+Créer un fichier /etc/apache2/sites-available/webmail.mondomaine.com contenant :<code>
 #######################################
 #   VirtualHost pour le webmail       #
@@ Ligne 62: / Ligne 71: @@
                 php_value memory_limit "25M"
                 php_value file_uploads "10M"
+                php_value date.timezone "Europe/Paris"
         </Directory>
@@ Ligne 89: / Ligne 99: @@
 </Virtualhost>
 </code>
 ==== Paramétrage ====
   * Nous allons paramétrer roundcube en utilisant les standards debian : la configuration se fait dans /etc/roundcube.<code>
@@ Ligne 126: / Ligne 137: @@
 mysql -u roundcube -p roundcubemail < /var/www/webmail.mondomaine.com/SQL/mysql.initial.sql
 </code>
+==== Finalisation de l'installation ====
+  * activer le site :<code>
+a2ensite webmail.mondomaine.com
+/etc/init.d/apache2 restart
+</code>
+  * Aller sur [[https://webmail.mondomaine.com/installer/]] \\ Il ne devrait pas y avoir de "NOT OK" vous empechant d'accéder a l'etape 2 qui va créer effectivement la configuration.
+  * Vous pouvez ensuite vérfifier a l'étape 3 que vous pouvez :
+    * envoyer un email depuis roundcube
+    * vous connecter sur votre serveur imap
+<note important>IL faut maintenant empecher tout acces a l'instalateur :
+  * editer le fichier /etc/roundcube/main.inc.php pour remettre<code>$rcmail_config['enable_installer'] = false;</code>
+  * exécutez la commande suivante pour interdi l'acces aux répertoires :<code>chmod go-rwx /var/www/webmail.mondomaine.com/installer/</code>
+</note>
+  * Editer le fichier /etc/roundcube/main.inc.php pour déclarer votre serveur IMAP, dans notre cas localhost :<code>
+$rcmail_config['default_host'] = 'localhost';</code>
+===== Enjoy =====
+Et voila : maintenant vous devriez avoir un superbe webmail accessible via [[https://webmail.mondomaine.com]] :-)
+====== Mise à jour du webmail roundcube ======
+Pas mal de temps a passé depuis cette installation initiale, et la version 0.5.1 de roundcube est maintenant disponible.
+Entre temps la version stable de debian est passée de lenny a squeeze, le serveur ayant été mis a jour en squeeze, cette mise a jour de roundcube va être effectuée sur cette version
+Les notes de mises a jour sont disponibles [ici|http://trac.roundcube.net/wiki/Howto_Upgrade], voici les commandes que j'ai utilisé :
+===== Recupération et décompression de l'archive =====
+  * récupérer les sources (la encore les dépendances seront installées/mises a jour à la main : on choisit donc la version téléchargeable sans dépendances)
+<code>
+cd /var/www/
+wget http://sourceforge.net/projects/roundcubemail/files/roundcubemail-dependent/0.5.1/roundcubemail-0.5.1-dep.tar.gz/download -O roundcubemail-0.5.1-dep.tar.gz
+tar xvzf roundcubemail-0.5.1-dep.tar.gz
+</code>
+  * réparer les permissions (ou www-data est le groupe de l'utilisateur faisant tourner votre serveur web)
+<code>
+chown root:root -R roundcubemail-0.5.1-dep
+cd roundcubemail-0.5.1-dep
+chgrp www-data logs/ temp/ && chmod g+w logs/ temp/
+</code>
+===== Installation des nouvelles dépendances =====
+Il est conseillé d'installer cette dépendance pour l'internationalisation :<code>
+apt-get install php5-intl</code>
+Il faut ensuite recharger la configuration d'apache :<code>
+/etc/init.d/apache2 reload</code>
+===== Configuration =====
+<code>
+cd /var/www/roundcubemail-0.5.1-dep
+mv config/ config.ORIG
+ln -s /etc/roundcube config
+</code>
+Reporter les nouvelles options de configuration dans les anciens fichiers entre les versions 0.3.1 et la 0.5.1
+  * ces lignes ont été ajoutées dans le fichier db.inc.php :<code>
+$rcmail_config['db_table_contactgroups'] = 'contactgroups';
+$rcmail_config['db_table_contactgroupmembers'] = 'contactgroupmembers';</code>
+  * pour le fichier main.inc.php vimdiff est votre ami (trop de modifications pour tout reporter ici ;p)
+  * ces lignes ont été ajoutées dans le fichier mimetypes.php :<code>
+    'pdf' => 'application/pdf',
+    'ics' => 'text/calendar',
+</code>