  Petit guide sur l'installation de MMBase sur un systme Debian Woody

  Version franaise du MMBase Mini-HOWTO: Installation on Debian Woody

  Casper Joost Eyckelhof

   <joost CHEZ dnd POINT utwente POINT nl>

   Adaptation franaise: Simon Depiets

   Relecture de la version franaise: Guillaume Lelarge

   Prparation de la publication de la v.f.: Jean-Philippe Gurard

   0.2.fr.1.0

   2004-12-05

   +----------------------------------------------------------------+
   | Historique des versions                                        |
   |----------------------------------------------------------------|
   | Version 0.2.fr.1.0        | 2004-12-05      | SD, GL, JPG      |
   |----------------------------------------------------------------|
   | Premire adaptation franaise                                  |
   |----------------------------------------------------------------|
   | Version 0.2               | 2002-05-28      | CJE              |
   |----------------------------------------------------------------|
   | Mise  jour pour MMBase 1.5, perte du support de l'interface   |
   | apache (Updated for MMBase 1.5; lost support for apache        |
   | frontend)                                                      |
   |----------------------------------------------------------------|
   | Version 0.1               | 2001-10-04      | CJE              |
   |----------------------------------------------------------------|
   | Version initiale -- Installer MMBase 1.4 sur Woody -- Initial  |
   | version - Installing MMBase 1.4; on Woody                      |
   +----------------------------------------------------------------+

   Rsum

   Ce document explique brivement la mise en place de MMBase sur un
   systme GNU/Linux Debian (Woody) en utilisant autant que possible
   les paquets inclus dans la distribution.

   -------------------------------------------------------------------

   Table des matires

   1. Introduction

                1.1. Page web

                1.2. Avertissement

                1.3. Droits d'auteurs

                1.4. Remerciements

   2. Qu'est-ce que MMBase ?

   3. Pr-requis

                3.1. Standard packages

                3.2. Paquets non inclus

   4. Obtenir MMBase et mettre en place certains lments

                4.1. Obtenir MMBase

                4.2. Obtenir mm.mysql

                4.3. Crer une base de donnes pour MMBase

                4.4. Scurisation via Tomcat

                4.5. Copier xml-apis

   5. Fichier de configuration

                5.1. apache

                5.2. MMBase

   6. Obtenir plus d'aide

1. Introduction

  1.1. Page web

   Vous trouverez la plus rcente version franaise de ce document 
   l'adresse : http://www.traduc.org/docs/howto/lecture/MMBase.html
   [http://www.traduc.org/docs/howto/lecture/MMBase.html].

   Si vous avez obtenu ce document depuis un site miroir contenant
   des Guides pratiques ou un CD-ROM, vous devriez vrifier sur la
   page web du Petit guide de MMBase (en anglais)
   [http://www.dnd.utwente.nl/~joost/mmbase-mini/MMBase-Mini-HOWTO.html]
   pour voir si une nouvelle version est parue.

   Ce document ne couvre qu'une toute petite portion de
   l'installation de MMBase. Pour la documentation officielle,
   visitez la Page web de MMBase [http://www.mmbase.org].

  1.2. Avertissement

   Nous ne pouvons accepter aucune responsabilit quant au contenu de
   ces documents. Vous utilisez  vos risques et prils les concepts,
   exemples et autres informations contenues dans ce document.

   Tous les noms dposs sont proprits de leurs dtenteurs
   respectifs  moins d'une indication spcifique du contraire.
   L'utilisation d'un terme dans ce document ne peut tre vue comme
   affectant la validit d'un nom dpos.

   Ceci est mon premier guide pratique, ma premire exprience avec
   linuxdoc et je ne suis pas non plus un expert de MMBase. J'essaie
   juste de partager mes solutions aux problmes que j'ai rencontr
   en installant MMBase sur une systme Debian.

  1.3. Droits d'auteurs

   Copyright  2001-2002 Casper Joost Eyckelhof, Tous droits
   rservs. Ceci est une documentation livre, vous pouvez la
   redistribuer et/ou la modifier sous les termes de la version 2 ou
   ultrieure de la GNU General Public License
   [http://www.gnu.org/copyleft/gpl.html].

  1.4. Remerciements

   Je voudrais remercier un bon nombre de personnes pour m'avoir aid
   lors de mon installation. Mme si je ne connais pas leurs noms,
   leurs pseudonymes irc sont : keesj, jdg, flax, scb2. J'espre
   qu'ils me pardonneront de ne pas avoir cherch leurs vrais noms.

   Je voudrais aussi remercier mon employeur, l'Universit de Twente
   pour m'avoir autoris  crire ce document durant mes heures de
   travail.

2. Qu'est-ce que MMBase ?

   Sur leur site Web, les auteurs disent que :

     o MMBase est un systme de publication opensource. MMBase peut
       tre utilis pour crer de gros sites web pouvant tre
       maintenus facilement.

     o MMBase spare le contenu de la prsentation, pour que
       l'information puisse tre rutilise facilement.

     o MMBase est unique car il cre un objet qui est la
       reprsentation de vos centres d'intrts dans le monde
        rel .

   Dans ce document, je dcrirais comment faire fonctionner MMBase
   sur un systme Debian Woody en utilisant au possible les packages
   inclus dans la distribution. Mme si il est trs facile de lancer
   MMBase avec ses outils d'installation automatique, vous aurez  la
   fin leur version de serveur web, lanceur de servlets et base de
   donnes.

   Aprs quelques jours d'utilisation de ma propre installation, j'ai
   pens que je pourrais aider les autres en dcrivant les choix que
   j'ai fait pour que  marche. Je ne dis pas que c'est le seul
   moyen, ou le meilleur ! Mais   march pour moi :)

   La version de MMBase utilise est la 1.5. Bien sur tout peut tre
   diffrent d'une version  l'autre.

   MMBase peut fonctionner avec diffrents serveurs, bases de
   donnes, lanceurs de servlets et Environnements Java. Les
   programmes/packages/versions que j'ai choisi sont :

     o MySQL-Server (3.23.49-8)

     o Tomcat4 (4.0.3-3)

     o j2sdk1.3 (1.3.1-1) (Java)

     o imagemagick (4:5.4.4.5-1)

   Attention : Les numros de version sont ceux disponibles dans la
   distribution Woody au moment de l'criture. Except pour Java qui
   vient d'ailleurs. Voir Paquets non inclus".

   Quelques autres options pour les bases de donnes et les serveurs
   Web sont dcrites dans les notes d'installation de MMBase 1.5

3. Pr-requis

   Vous aurez besoin d'une installation Debian Woody incluant apt et
   vous devrez vous assurer que vous possdez les packages suivants
   installs et fonctionnant correctement.

  3.1. Standard packages

     o tomcat4

     o mysql-server

     o imagemagick

   Si ces packages ne sont pas installs, vous pouvez le faire en
   saisissant

 apt-get install foo

   o foo est l'un des noms ci-dessus.

   Note : naturellement, vous aurez aussi besoin des dpendances,
   mais apt prendra soin de cela automatiquement.

  3.2. Paquets non inclus

   Au moment o j'cris ce document, Woody ne contient que java 1.1,
   mais pour MMBase, la v1.2 au minimum est ncessaire. J'ai install
   les packages depuis Blackdown. Une liste des miroirs Blackdown est
   disponible sur http://www.blackdown.org/java-linux/mirrors.html
   [http://www.blackdown.org/java-linux/mirrors.html].

   J'ai ajout ce qui suit  mon fichier /etc/apt/sources.list , mais
   le chemin peut tre diffrent selon le miroir :

 deb ftp://ftp.nluug.nl/pub/os/Linux/java/jdk/debian woody non-free

   Aprs cela vous pouvez simplement saisir

 apt-get install j2sdk1.3

   Note : mme si il doit tre possible d'avoir plus d'un
   Environnement Java install, je ne vous le recommande pas sauf si
   c'est absolument ncessaire.

4. Obtenir MMBase et mettre en place certains lments

  4.1. Obtenir MMBase

   Maintenant que vous avez tous les packages installs et
   fonctionnant (vous avez suivi les instruction dans la section
   prcdente n'est-ce pas ?), obtenez une copie de MMBase de
   version 1.4.

   Tlchargez MMBase depuis
   http://www.mmbase.org/releases/mmbase-1.5.zip
   [http://www.mmbase.org/releases/mmbase-1.5.zip] avec un navigateur
   ou plus facilement avec :

 wget http://www.mmbase.org/releases/mmbase-1.5.zip

   Depuis sa version 1.5, MMBase peut tre utilis comme application
   web dans Tomcat. Je recommande donc de dcompresser le package
   dans un rpertoire temporaire et de copier le dossier
   mmbase-webapp/ dans /var/lib/tomcat4/webapps/. Si MMBase et votre
   seule (ou principale) application dans Tomcat, vous pouvez aussi
   l'installer avec les droits super-utilisateur depuis
   mmbase-webapp/ vers /var/lib/tomcat4/webapps/ROOT/.

   Dans ce document, j'estime que MMBase est dcompress dans
   /var/lib/tomcat4/webapps/mmbase-webapp/

  4.2. Obtenir mm.mysql

   Vous aurez aussi besoin de mysql.jar (pilote JDBC pour MySQL) qui
   peut tre tlcharg depuis http://mmmysql.sourceforge.net/
   [http://mmmysql.sourceforge.net/].

   Assurez-vous d'avoir le fichier jar binaire, ce qui signifie que
   vous pourrez avoir  dcompresser le package complet tout d'abord,
   puis  localiser le fichier mm.mysql-2.0.14-bin.jar (la version
   2.0.14 est la plus rcente au moment ou j'cris ce guide). Mettez
   le fichier dans
   /var/lib/tomcat4/webapps/mmbase-webapp/WEB-INF/lib/.

  4.3. Crer une base de donnes pour MMBase

   MMbase a besoin d'une base de donnes et d'un utilisateur ayant
   tous les droits sur cette base de donnes. Cet utilisateur semble
   avoir besoin des droits via l'hte local et le vrai nom d'hte. Ce
   n'est pas trs clair pour moi.

   Lancez les commandes suivantes  l'invite de MySQL. J'ai choisi
   une base de donnes appele MMBase, un utilisateur appel
   mmbaseuser et un mot de passe  secret .

 CREATE DATABASE MMBase
 USE MMBase
 GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP ON MMBase.* TO mmbaseuser@'%' IDENTIFIED BY 'secret';
 GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP ON MMBase.* TO mmbaseuser@localhost IDENTIFIED BY 'secret'
 GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP ON MMBase.* TO mmbaseuser@realhostname IDENTIFIED BY 'secret'
 flush privileges;

  4.4. Scurisation via Tomcat

   L'agent de scurisation java de Tomcat peut interfrer avec
   MMBase. Je n'ai pas trouv la configuration pour lancer MMBase
   avec cet agent de scurit actif. Pour le moment, j'ai dsactiv
   l'agent de scurit, ce que vous ne devriez jamais faire. (Gros
   avertissement !)

   Dans /etc/default/tomcat4 changez la ligne scurit en :

 TOMCAT4_SECURITY="no"

  4.5. Copier xml-apis

   Pour une raison inconnue, Tomcat veut trouver le fichier
   WEB-INF/lib/xml-apis.jar galement dans
   /usr/share/tomcat/common/lib/xml-apis.jar, vous aurez donc  le
   copier.

5. Fichier de configuration

   Il y a quelques fichiers de configuration qui ont besoin d'tre
   cres ou ajusts.

  5.1. apache

   Dans mon installation, j'ai cr un hte virtuel pour s'occuper de
   toutes les requtes MMBase. Mais il n'est pas trs difficile
   d'inclure MMBase dans votre arborescence web normale.

   Ce fut pour ma dernire installation (Guide version 0.1, couvrant
   MMBase 1.4).

   En utilisant la dernire version de Tomcat et Apache, j'ai eu des
   problmes pour faire fonctionner les deux ensembles. Ds que
   j'aurais trouv comment utiliser libapache-mod-webapp ou
   libapache-mod-jk avec tomcat4, je mettrais  jour ce Guide.

   Une des solutions possibles est de compiler mod-webapp vous-mmes,
   car la version fournie dans Debian ne semble pas tre la version
   standard. Mais cela dpasse la porte et l'intention de ce Guide.

   Cela signifie aussi que par dfaut, MMBase fonctionnera sur le
   port 8180 (directement depuis le serveur Tomcat. Vous pouvez
   changer ce port dans /etc/tomcat4/server.xml

  5.2. MMBase

   Bien que beaucoup de choses doivent tre configures sur MMBase
   lui-mme, j'ai ajout quelques lments  ce petit Guide.

   L'accs  la base de donnes doit tre configur dans
   WEB-INF/config/modules/jdbc.xml :

 <property name="url">jdbc:mysql://$HOST:$PORT/$DBM?user=mmbaseuser&password=secret<//property>
 <property name="user">url<//property>
 <property name="password">url<//property>
 <property name="database">MMBase<//property>
 <property name="driver">org.gjt.mm.mysql.Driver<//property>

   Il y a de plus une ligne  changer pour faire fonctionner la
   connexion  mysql. Dans WEB-INF/config/modules/mmbaseroot.xml
   Assurez-vous d'avoir cette option :

 <property name="database">mysql<//property>

   Le compilateur d'images contient un chemin  convertir qui n'est
   pas conforme Debian. Changez WEB-INF/config/builders/images.xml
   comme cela

 <properties>
   <property name="ImageConvert.ConverterCommand">bin/convert</property>
   <property name="ImageConvert.ConverterRoot">/usr/</property>
   <property name="ImageConvertClass">org.mmbase.module.builders.ConvertImageMagick</property>
 </properties>

6. Obtenir plus d'aide

   Il y a plusieurs sources pour obtenir plus d'aide sur la plupart
   des sujets traits dans ce petit Guide. Tous les packages ont leur
   propre documentation. Certains liens qui m'ont vraiment aid sont
   lists ci-dessous :

     o pour Apache : http://httpd.apache.org/docs/
       [http://httpd.apache.org/docs/] ;

     o pour Tomcat :
       http://jakarta.apache.org/tomcat/tomcat-4.0-doc/index.html
       [http://jakarta.apache.org/tomcat/tomcat-4.0-doc/index.html] ;

     o pour MMBase : cliquez sur Documentation dans
       http://www.mmbase.org/ [http://www.mmbase.org/] ;

     o pour Java : http://java.sun.com/ [http://java.sun.com/] ;

   Une autre grande source d'aide est le canal #mmbase sur ircnet,
   normalement vous y trouverez quelques dveloppeurs.

