/usr/share/doc/HOWTO/fr-html/MMBase.html

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
  PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Petit guide sur l'installation de MMBase sur un système Debian Woody</title><link rel="stylesheet" type="text/css" href="style.css"/><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"/><meta name="description" content="Ce document explique brièvement la mise en place de MMBase sur un système GNU/Linux Debian (Woody) en utilisant autant que possible les paquets inclus dans la distribution."/></head><body><div xml:lang="fr" class="article"><div class="titlepage"><div><div><h2 class="title"><a id="d0e1"/>

  Petit guide sur l'installation de MMBase sur un système Debian Woody

</h2></div><div><h3 class="subtitle"><em>

  Version française du <span xml:lang="en" class="foreignphrase"><em xml:lang="en" class="foreignphrase">MMBase Mini-HOWTO:
  Installation on Debian Woody</em></span>

</em></h3></div><div><div class="author"><h3 class="author"><span class="firstname">Casper Joost</span> <span class="surname">Eyckelhof</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:joost CHEZ dnd POINT utwente POINT nl">joost CHEZ dnd POINT utwente POINT nl</a>&gt;</code></p></div></div></div></div><div><p class="othercredit"><span class="contrib">Adaptation française</span> : <span class="firstname">Simon</span> <span class="surname">Depiets</span></p></div><div><p class="othercredit"><span class="contrib">Relecture de la version française</span> : <span class="firstname">Guillaume</span> <span class="surname">Lelarge</span></p></div><div><p class="othercredit"><span class="contrib">Préparation de la publication de la v.f.</span> : <span class="firstname">Jean-Philippe</span> <span class="surname">Guérard</span></p></div><div><p class="releaseinfo">0.2.fr.1.0</p></div><div><p class="pubdate">2004-12-05</p></div><div><div class="revhistory"><table summary="Historique des versions"><tr><th align="left" valign="top" colspan="3"><strong>Historique des versions</strong></th></tr><tr><td align="left">Version 0.2.fr.1.0</td><td align="left">2004-12-05</td><td align="left">SD, GL, JPG</td></tr><tr><td align="left" colspan="3">Première adaptation française</td></tr><tr><td align="left">Version 0.2</td><td align="left">2002-05-28</td><td align="left">CJE</td></tr><tr><td align="left" colspan="3">

          Mise à jour pour MMBase 1.5, perte du support de l'interface
          apache (<span xml:lang="en" class="emphasis"><em>Updated for MMBase 1.5; lost
          support for apache frontend</em></span>)

      </td></tr><tr><td align="left">Version 0.1</td><td align="left">2001-10-04</td><td align="left">CJE</td></tr><tr><td align="left" colspan="3">

          Version initiale — Installer MMBase 1.4 sur Woody
          — <span xml:lang="en" class="emphasis"><em>Initial version - Installing
          MMBase 1.4; on Woody</em></span>

      </td></tr></table></div></div><div><div class="abstract"><p class="title"><strong>Résumé</strong></p><p>
    
        Ce document explique brièvement la mise en place de MMBase sur
        un système GNU/Linux Debian (Woody) en utilisant autant que
        possible les paquets inclus dans la distribution.
    
    </p></div></div></div><hr/></div><div class="toc"><p><strong>Table des matières</strong></p><dl class="toc"><dt><span class="section"><a href="#d0e98">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e101">1.1. Page web</a></span></dt><dt><span class="section"><a href="#d0e118">1.2. Avertissement</a></span></dt><dt><span class="section"><a href="#d0e127">1.3. Droits d'auteurs</a></span></dt><dt><span class="section"><a href="#d0e135">1.4. Remerciements</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e148">2. Qu'est-ce que MMBase ?</a></span></dt><dt><span class="section"><a href="#d0e194">3. Pré-requis</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e199">3.1. Standard packages</a></span></dt><dt><span class="section"><a href="#java">3.2. Paquets non inclus</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e237">4. Obtenir MMBase et mettre en place certains éléments</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e240">4.1. Obtenir MMBase</a></span></dt><dt><span class="section"><a href="#d0e258">4.2. Obtenir mm.mysql</a></span></dt><dt><span class="section"><a href="#d0e267">4.3. Créer une base de données pour MMBase</a></span></dt><dt><span class="section"><a href="#d0e279">4.4. Sécurisation via Tomcat</a></span></dt><dt><span class="section"><a href="#d0e288">4.5. Copier xml-apis</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e293">5. Fichier de configuration</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e298">5.1. apache</a></span></dt><dt><span class="section"><a href="#d0e311">5.2. MMBase</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e328">6. Obtenir plus d'aide</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="d0e98"/>1. Introduction</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e101"/>1.1. Page web</h3></div></div></div><p>
  
Vous trouverez la plus récente version française de ce document à
l'adresse : <a class="ulink" href="http://www.traduc.org/docs/howto/lecture/MMBase.html" target="_top">http://www.traduc.org/docs/howto/lecture/MMBase.html</a>.
              
</p><p>

Si vous avez obtenu ce document depuis un site miroir contenant des 
Guides pratiques ou un CD-ROM, vous devriez vérifier sur <a class="ulink" href="http://www.dnd.utwente.nl/~joost/mmbase-mini/MMBase-Mini-HOWTO.html" target="_top">la
page web du Petit guide de MMBase (en anglais)</a> pour voir si
une nouvelle version est parue.

</p><p>

Ce document ne couvre qu'une toute petite portion de l'installation de
MMBase. Pour la documentation officielle, visitez la <a class="ulink" href="http://www.mmbase.org" target="_top">Page web de MMBase</a>.

</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e118"/>1.2. Avertissement</h3></div></div></div><p>

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

</p><p>

Tous les noms déposés sont propriétés de leurs détenteurs respectifs à
moins d'une indication spécifique du contraire. L'utilisation d'un terme
dans ce document ne peut être vue comme affectant la validité d'un nom
déposé.

</p><p>

Ceci est mon premier guide pratique, ma première expérience avec
linuxdoc et je ne suis pas non plus un expert de MMBase. J'essaie juste
de partager mes solutions aux problèmes que j'ai rencontré en installant
MMBase sur une système Debian.

</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e127"/>1.3. Droits d'auteurs</h3></div></div></div><p>

Copyright © 2001-2002 Casper Joost Eyckelhof, Tous droits réservés.
Ceci est une documentation livre, vous pouvez la redistribuer et/ou la
modifier sous les termes de la version 2 ou ultérieure de la <a class="ulink" href="http://www.gnu.org/copyleft/gpl.html" target="_top">GNU General Public
License</a>.

</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e135"/>1.4. Remerciements</h3></div></div></div><p>

Je voudrais remercier un bon nombre de personnes pour m'avoir aidé lors
de mon installation. Même si je ne connais pas leurs noms, leurs
pseudonymes irc sont : <span class="emphasis"><em>keesj, jdg, flax, scb2</em></span>. 
J'espère qu'ils me pardonneront de ne pas avoir cherché leurs vrais
noms.

</p><p>

Je voudrais aussi remercier mon employeur, l'<span class="emphasis"><em>Université de
Twente</em></span> pour m'avoir autorisé à écrire ce document durant mes
heures de travail.

</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="d0e148"/>2. Qu'est-ce que MMBase ?</h2></div></div></div><p>

Sur leur site Web, les auteurs disent que :

</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>

MMBase est un système de publication opensource. MMBase peut être
utilisé pour créer de gros sites web pouvant être maintenus facilement.

</p></li><li class="listitem"><p>

MMBase sépare le contenu de la présentation, pour que l'information
puisse être réutilisée facilement.

</p></li><li class="listitem"><p>

MMBase est unique car il crée un objet qui est la représentation de vos
centres d'intérêts dans le monde <span class="quote">« <span class="quote">réel</span> »</span>.

</p></li></ul></div><p>

Dans ce document, je décrirais comment faire fonctionner MMBase sur un
système Debian Woody en utilisant au possible les packages inclus dans
la distribution. Même si il est très 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 données.

</p><p>

Après quelques jours d'utilisation de ma propre installation, j'ai pensé
que je pourrais aider les autres en décrivant 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 :)

</p><p>

La version de MMBase utilisée est la 1.5. Bien sur tout peut être
différent d'une version à l'autre.

</p><p>

MMBase peut fonctionner avec différents serveurs, bases de données,
lanceurs de servlets et Environnements Java. Les
programmes/packages/versions que j'ai choisi sont :

</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>MySQL-Server (3.23.49-8)</p></li><li class="listitem"><p>Tomcat4 (4.0.3-3)</p></li><li class="listitem"><p>j2sdk1.3 (1.3.1-1) (Java)</p></li><li class="listitem"><p>imagemagick (4:5.4.4.5-1)</p></li></ul></div><p>

Attention : Les numéros de version sont ceux disponibles dans la
distribution Woody au moment de l'écriture. Excepté pour Java qui vient
d'ailleurs. Voir <a class="link" href="#java" title="3.2. Paquets non inclus">Paquets non inclus"</a>.

</p><p>

Quelques autres options pour les bases de données et les serveurs Web
sont décrites dans les notes d'installation de MMBase 1.5

</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="d0e194"/>3. Pré-requis</h2></div></div></div><p>

Vous aurez besoin d'une installation Debian Woody incluant apt et vous
devrez vous assurer que vous possédez les packages suivants installés et
fonctionnant correctement.

</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e199"/>3.1. Standard packages</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>tomcat4</p></li><li class="listitem"><p>mysql-server</p></li><li class="listitem"><p>imagemagick</p></li></ul></div><p>

Si ces packages ne sont pas installés, vous pouvez le faire en saisissant

</p><pre class="screen">
apt-get install foo
</pre><p>

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

</p><p>

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

</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="java"/>3.2. Paquets non inclus</h3></div></div></div><p>

Au moment où j'écris ce document, Woody ne contient que java 1.1, mais
pour MMBase, la v1.2 au minimum est nécessaire. J'ai installé les
packages depuis Blackdown. Une liste des miroirs Blackdown est
disponible sur <a class="ulink" href="http://www.blackdown.org/java-linux/mirrors.html" target="_top">http://www.blackdown.org/java-linux/mirrors.html</a>.
  
</p><p>

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

</p><pre class="screen">
deb ftp://ftp.nluug.nl/pub/os/Linux/java/jdk/debian woody non-free
</pre><p>

Après cela vous pouvez simplement saisir

</p><pre class="screen">
apt-get install j2sdk1.3
</pre><p>

Note : même si il doit être possible d'avoir plus d'un
Environnement Java installé, je ne vous le recommande pas sauf si c'est
absolument nécessaire.

</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="d0e237"/>4. Obtenir MMBase et mettre en place certains éléments</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e240"/>4.1. Obtenir MMBase</h3></div></div></div><p>

Maintenant que vous avez tous les packages installés et fonctionnant
(vous <span class="emphasis"><em>avez</em></span> suivi les instruction dans la section
précédente n'est-ce pas ?), obtenez une copie de MMBase de 
version 1.4.

</p><p>

Téléchargez MMBase depuis <a class="ulink" href="http://www.mmbase.org/releases/mmbase-1.5.zip" target="_top">http://www.mmbase.org/releases/mmbase-1.5.zip</a> avec un navigateur
ou plus facilement avec :

</p><pre class="screen">
wget http://www.mmbase.org/releases/mmbase-1.5.zip
</pre><p>

Depuis sa version 1.5, MMBase peut être utilisé comme application web
dans Tomcat. Je recommande donc de décompresser le package dans un
répertoire 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/.

</p><p>

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

</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e258"/>4.2. Obtenir mm.mysql</h3></div></div></div><p>

Vous aurez aussi besoin de mysql.jar (pilote JDBC pour MySQL) qui peut
être téléchargé depuis <a class="ulink" href="http://mmmysql.sourceforge.net/" target="_top">http://mmmysql.sourceforge.net/</a>. 

</p><p>

Assurez-vous d'avoir le fichier jar binaire, ce qui signifie que vous
pourrez avoir à décompresser 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 récente au moment ou j'écris ce guide). Mettez le fichier dans
/var/lib/tomcat4/webapps/mmbase-webapp/WEB-INF/lib/.

</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e267"/>4.3. Créer une base de données pour MMBase</h3></div></div></div><p>

MMbase a besoin d'une base de données et d'un utilisateur ayant tous les
droits sur cette base de données. Cet utilisateur semble avoir besoin
des droits via l'hôte local et le vrai nom d'hôte. Ce n'est pas très
clair pour moi.

</p><p>

Lancez les commandes suivantes à l'invite de MySQL. J'ai choisi une base
de données appelée MMBase, un utilisateur appelé mmbaseuser et un mot de
passe <span class="quote">« <span class="quote">secret</span> »</span>.

</p><pre class="screen">
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;
</pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e279"/>4.4. Sécurisation via Tomcat</h3></div></div></div><p>

L'agent de sécurisation java de Tomcat peut interférer avec MMBase. Je
n'ai pas trouvé la configuration pour lancer MMBase avec cet agent de
sécurité actif. Pour le moment, j'ai désactivé l'agent de sécurité, ce
que vous ne devriez jamais faire. (Gros avertissement !)

</p><p>

Dans /etc/default/tomcat4 changez la ligne sécurité en :

</p><pre class="programlisting">
TOMCAT4_SECURITY="no"
</pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e288"/>4.5. Copier xml-apis</h3></div></div></div><p>

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.

</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="d0e293"/>5. Fichier de configuration</h2></div></div></div><p>

Il y a quelques fichiers de configuration qui ont besoin d'être crées ou
ajustés.

</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e298"/>5.1. apache</h3></div></div></div><p>

Dans mon installation, j'ai créé un hôte virtuel pour s'occuper de
toutes les requêtes MMBase. Mais il n'est pas très difficile d'inclure
MMBase dans votre arborescence web normale.

</p><p>

Ce fut pour ma dernière installation (Guide version 0.1, couvrant
MMBase 1.4).

</p><p>

En utilisant la dernière version de Tomcat et Apache, j'ai eu des
problèmes pour faire fonctionner les deux ensembles. Dès que j'aurais
trouvé comment utiliser libapache-mod-webapp ou libapache-mod-jk avec
tomcat4, je mettrais à jour ce Guide.

</p><p>

Une des solutions possibles est de compiler mod-webapp vous-mêmes, car
la version fournie dans Debian ne semble pas être la version standard.
Mais cela dépasse la portée et l'intention de ce Guide.

</p><p>

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

</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="d0e311"/>5.2. MMBase</h3></div></div></div><p>

Bien que beaucoup de choses doivent être configurées sur MMBase
lui-même, j'ai ajouté quelques éléments à ce petit Guide.

</p><p>

L'accès à la base de données doit être configuré dans
WEB-INF/config/modules/jdbc.xml :

</p><pre class="programlisting">
&lt;property name="url"&gt;jdbc:mysql://$HOST:$PORT/$DBM?user=mmbaseuser&amp;password=secret&lt;//property&gt;
&lt;property name="user"&gt;url&lt;//property&gt;
&lt;property name="password"&gt;url&lt;//property&gt;
&lt;property name="database"&gt;MMBase&lt;//property&gt;
&lt;property name="driver"&gt;org.gjt.mm.mysql.Driver&lt;//property&gt;
</pre><p>

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 :

</p><pre class="programlisting">
&lt;property name="database"&gt;mysql&lt;//property&gt;
</pre><p>

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

</p><pre class="programlisting">
&lt;properties&gt;
  &lt;property name="ImageConvert.ConverterCommand"&gt;bin/convert&lt;/property&gt;
  &lt;property name="ImageConvert.ConverterRoot"&gt;/usr/&lt;/property&gt;
  &lt;property name="ImageConvertClass"&gt;org.mmbase.module.builders.ConvertImageMagick&lt;/property&gt;
&lt;/properties&gt;
</pre></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="d0e328"/>6. Obtenir plus d'aide</h2></div></div></div><p>

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

</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>

pour Apache : <a class="ulink" href="http://httpd.apache.org/docs/" target="_top">http://httpd.apache.org/docs/</a> ;

</p></li><li class="listitem"><p>

pour Tomcat : <a class="ulink" href="http://jakarta.apache.org/tomcat/tomcat-4.0-doc/index.html" target="_top">http://jakarta.apache.org/tomcat/tomcat-4.0-doc/index.html</a> ;

</p></li><li class="listitem"><p>

pour MMBase : cliquez sur Documentation dans <a class="ulink" href="http://www.mmbase.org/" target="_top">http://www.mmbase.org/</a> ;

</p></li><li class="listitem"><p>

pour Java : <a class="ulink" href="http://java.sun.com/" target="_top">http://java.sun.com/</a> ;

</p></li></ul></div><p>

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

</p></div></div></body></html>
doc-linux-fr-html 2013.01-2 / usr / share / doc / HOWTO / fr-html / MMBase.html
