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

Version française du MMBase Mini-HOWTO: Installation on Debian Woody

Simon Depiets

Adaptation française

Guillaume Lelarge

Relecture de la version française

Jean-Philippe Guérard

Préparation de la publication de la v.f.

0.2.fr.1.0

2004-12-05

Historique des versions
Version 0.2.fr.1.02004-12-05SD, GL, JPG
Première adaptation française
Version 0.22002-05-28CJE
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.12001-10-04CJE
Version initiale — Installer MMBase 1.4 sur Woody — Initial version - Installing MMBase 1.4; on Woody

Résumé

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.


Table des matières

Introduction
Page web
Avertissement
Droits d'auteurs
Remerciements
Qu'est-ce que MMBase ?
Pré-requis
Standard packages
Paquets non inclus
Obtenir MMBase et mettre en place certains éléments
Obtenir MMBase
Obtenir mm.mysql
Créer une base de données pour MMBase
Sécurisation via Tomcat
Copier xml-apis
Fichier de configuration
apache
MMBase
Obtenir plus d'aide

Vous trouverez la plus récente version française de ce document à l'adresse : 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 vérifier sur la page web du Petit guide de MMBase (en anglais) 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.

Sur leur site Web, les auteurs disent que :

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.

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 :)

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

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 :

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 Paquets non inclus".

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

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.

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 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 différent selon le miroir :

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

Après cela vous pouvez simplement saisir

apt-get install j2sdk1.3

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.

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

Téléchargez MMBase depuis 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 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/.

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

Vous aurez aussi besoin de mysql.jar (pilote JDBC pour MySQL) qui peut être téléchargé depuis http://mmmysql.sourceforge.net/.

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/.

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

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 :

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