Documentation:Guide d'installation Tomcat-Mysql sous Linux Debian

Un article de AlfrescoWiki.

Sommaire

[modifier] Présentation

Le but de ce document est de décrire une procédure pour installer Alfresco sur un serveur Linux Debian. Les versions utilisées dans ce document :

  • Alfresco v2.0 (ce guide devrait fonctionner avec les versions community et enterprise)
  • Debian 4.0 Etch
  • MySQL 5

Nous utiliserons le package alfresco-enterprise-tomcat-2.0.1.tar.gz.

[modifier] Installation

A affiner et à adapter pour d'autres distributions, ou d'autres systèmes d'exploitation (créer dans ce cas une page dédié)

Alfresco est une application J2EE. Il est fourni avec Tomcat déjà configuré, ce qui va nous simplifier l'installation.

[modifier] Java

  • Télécharger la dernière version du jdk 5.0 (Update 12 au moment de la rédaction de l'article) à l'adresse suivante : http://java.sun.com/j2se/1.5.0/download.jsp
  • Choisir le fichier suivant : jdk-1_5_0_12-linux-i586.bin
  • Copier l'archive dans /opt
  • Rendre le fichier exécutable : 
# chmod +x jdk-1_5_0_12-linux-i586.bin
  • Exécuter le fichier : 
# ./jdk-1_5_0_12-linux-i586.bin
  • Créer un lien symbolique, ce qui va nous simplifier les choses. Si on change de version de Java, il suffira de mettre à jour le lien vers la nouvelle version : 
# ln -s jdk1.5.0_12 java
  • Définir une variable d'environnement (factultatif) : 
# export JAVA_HOME=/opt/java

[modifier] Alfresco

  • décompresser l'archive dans /opt : 
# mkdir /opt/alfresco-enterprise-tomcat-2.0.1
# cd /opt/alfresco-enterprise-tomcat-2.0.1
# tar -xzvf ../alfresco-enterprise-tomcat-2.0.1.tar.gz
  • Créer un lien symbolique : 
# cd /opt
# ln -s alfresco-enterprise-tomcat-2.0.1 alfresco
  • suivre les instructions du fichier README.TXT (ce qui est fait dans la suite du document, mais ca peut pas faire de mal d'y jeter un petit coup d'oeil)

[modifier] MySQL

Il faut au minimum la version 5 de MySQL pour faire fonctionner Alfresco. Etch nous fournit la version 5.0.32, donc on est bon.

  • installation de MySQL : 
# apt-get install mysql-server
  • création de la base en utilisant un script fournit par Alfresco : 
# mysql -u root -p < /opt/alfresco/extras/databases/mysql/db_setup.sql

Ce script va créer une nouvelle base de données alfresco et un utilisateur alfresco avec le mot de passe alfresco.

[modifier] OpenOffice.org

OpenOffice.org est utilisé par Alfresco pour la conversion et l'indexation de documents. Etch nous fournit un OpenOffice.org en version 2.0.4, ce qui est le strict minimum pour Alfresco (ne pas utiliser une version 1.x !).

Nous avons également besoin d'un serveur X pour faire tourner OpenOffice.org, sinon il refuse de démarrer. Nous utiliserons Xvfb qui est un serveur X virtuel.

  • installer tout ça : 
# apt-get install openoffice.org xvfb x-window-system-core x-window-system

Si des questions sont posées pendant l'installation de ces paquets, utiliser toujours la réponse par défaut.

  • supprimer des services inutiles du démarrage : 
# update-rc.d -f xdm remove
# update-rc.d -f xfs remove

[modifier] ImageMagick

  • installer le paquet : 
# apt-get install imagemagick

[modifier] Configuration

[modifier] Scripts de démarrage

[modifier] alfresco.sh

  • éditer le script alfresco.sh
  • redéfinir la variable APPSERVER : 
APPSERVER=/opt/alfresco-enterprise-tomcat-2.0.1
  • définir les variables LANG et JAVA_HOME : 
export LANG=fr_FR.UTF-8
export JAVA_HOME=/opt/java
  • redéfinir la quantité de mémoire alloué à Tomcat (en fonction de la quantité de RAM sur le serveur) : 
export JAVA_OPTS='-Xms512m -Xmx1024m -server'

[modifier] start_oo.sh

  • créer le script start_oo.sh avec le contenu suivant : 
#!/bin/sh
# ---------------------------------------------------------------------------
# Start script for the OpenOffice transform service
# ---------------------------------------------------------------------------

echo "Starting OpenOffice service..."

Xvfb :1 -screen 0 800x600x16 -fbdir /usr/src > /dev/null 2>&1 &
export DISPLAY=:1
/usr/bin/soffice "-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager" -nologo -headless -nofirststartwizard &

[modifier] MySQL

  • se rendre dans le dossier /opt/alfresco/tomcat/shared/classes/alfresco/extension
  • renommer le fichier custom-db-and-data-context.xml en custom-db-and-datacontext.xml.orig
  • renommer le fichier custom-repository-context.xml.sample en custom-repositorycontext.xml
  • créer le fichier custom-repository.properties avec le contenu suivant : 
###############################

## Common Alfresco Properties #

###############################


# database configuration (MySQL)
db.username=alfresco
db.password=alfresco
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://localhost/alfresco

[modifier] SMTP

Définition d'un serveur SMTP pour l'envoie de mails.

  • éditer le fichier custom-repository.properties et ajouter les lignes suivantes : 
#
# Email configuration
#

mail.host=smtp.mondomaine.tld

[modifier] Utilisation

[modifier] Démarrage / Arret

Pour démarrer ou arreter Alfresco, il est obligatoire de se trouver dans le dossier d'installation (/opt/alfresco dans notre cas).

  • démarrer Alfresco : 
./alfresco.sh start
  • arrêter Alfresco : 
./alfresco.sh stop

[modifier] Accéder à Alfresco

  • via CIFS : \\monserver_a\Alfresco

[modifier] Fichier de log

Le fichier de log de Tomcat est : /opt/alfresco/tomcat/logs/catalina.out.

Récupérée de « http://wiki.alfresco.com/fr/index.php/Documentation:Guide_d%27installation_Tomcat-Mysql_sous_Linux_Debian »