Un article de AlfrescoWiki.

Sommaire 1 Présentation 2 Pré requis 3 Installation 3.1 Déploiement d'Alfresco 3.2 Création de la base mysql 3.3 le connecteur MySQL Java 3.4 Le répertoire des données 3.5 Configuration 3.5.1 éditer custom-repository 3.5.2 modifier custom-hibernate-dialect.properties 3.5.3 web-client-config-custom.xml 3.5.4 Les options de démarrage 4 Utilisation 4.1 Arrêt / Démarrage 4.2 Accès au serveur 4.3 Fichier de log

[modifier] Présentation

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

   * Alfresco v2.9 
   * FreeBSD 7.0
   * Tomcat 5.5
   * MySQL 5

Le package utilisé est alfresco-community-war-2.9.0B.tar.gz

[modifier] Pré requis

Les principaux ports et packages nécessaire sont :

    * java/diablo-jdk15
    * www/tomcat55
    * databases/mysql50-server
    * databases/mysql-connector-java
    * graphics/ImageMagick

Les ports de :

    * net/samba (pour CIFS)
    * editors/openoffice.org-2 

peuvent aussi être nécessaires mais leur intégration ne sera pas décrite dans ce document.

Ce document ne détaillera pas l'installation des différents ports et package nécessaire. La littérature abonde sur le sujet, notamment ce chapitre du handbook et pour les particularités de java sous FreeBSD, il existe le site du FreeBSD Java™ Project.

Néanmoins pour un installer un port, par exemple le serveur MySQL:

cd /usr/ports/databases/mysql50-server/
sudo make install clean

les serveurs ne se lancent que si l'entrée correspondante est renseignée dans /etc/rc.conf, dans notre cas :

tomcat55_enable="YES"
mysql_enable="YES"

[modifier] Installation

[modifier] Déploiement d'Alfresco

Nota : j'utilise beaucoup sudo, mais toutes les commandes suivantes peuvent au besoin être lancées par root.

Télécharger la dernière version de l'archive Alfresco-community-war sur http://alfresco.org/download.html. Pour ce document il s'agit de alfresco-community-war-2.9.0B.tar.gz.

décompresser l'archive :

tar xvfz alfresco-community-war-2.9.0B.tar.gz -C ~/alfresco/

et déplacer les répertoires dans l'arborescence de Tomcat

sudo mv ~/alfresco/alfresco.war /usr/local/tomcat5.5/webapps
sudo mv ~/alfresco/extensions /usr/local/tomcat5.5/shared/classes/alfresco
sudo mv ~/alfresco/alf_data/ /home/alfresco
sudo mv ~/alfresco/licenses /usr/local/tomcat5.5
sudo mv ~/alfresco/extras /usr/local/tomcat5.5
sudo mv ~/alfresco/endorsed/ /usr/local/tomcat5.5/common

[modifier] Création de la base mysql

sudo mysql -u root -p < /usr/local/tomcat5.5/extras/databases/mysql/db_setup.sql

[modifier] le connecteur MySQL Java

Créer un lien pour le connector Java dans l'arborescence Tomcat

sudo ln -s /usr/local/share/java/classes/mysql-connector-java.jar /usr/local/tomcat5.5/common/lib

[modifier] Le répertoire des données

Pour simplifier mes sauvegardes, je préfère mettre tout ce qui est données dans /home

sudo mkdir /home/alfresco
sudo chown www:www /home/alfresco

[modifier] Configuration

Les fichiers à configurer se trouvent dans "/usr/local/tomcat5.5/shared/classes/alfresco/extension"

cd /usr/local/tomcat5.5/shared/classes/alfresco/extension

[modifier] éditer custom-repository

l'emplacement de nos données

# Sample custom content and index data location
#
dir.root=/home/alfresco
#dir.indexes=

l'utilisateur de la base de données

# Sample database connection properties
#
db.username=alfresco
db.password=alfresco
#db.pool.initial=10
#db.pool.max=100

on n'utilise pas HSQL

#
# HSQL connection
#
#db.driver=org.hsqldb.jdbcDriver
#db.url=jdbc:hsqldb:file:alf_data/hsql_data/alfresco;ifexists=true;shutdown=tru\
e;

mais MySQL

# MySQL connection (This is default and requires mysql-connector-java-5.0.3-bin\
.jar, which ships with the Alfresco server)
#
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://localhost/alfresco

et si on a un serveur de courriels fonctionnels

# Email configuration
#
mail.host=localhost # smtp.mondomaine.tld si le serveur est ailleurs

[modifier] modifier custom-hibernate-dialect.properties

Toujours MySQL à la place de HSQL

#
# HSQL dialect
#
#hibernate.dialect=org.hibernate.dialect.HSQLDialect

#
# MySQL dialect (default)
#
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

[modifier] web-client-config-custom.xml

Pour franciser l'interface, il faut web-client-config-custom.xml

sudo cp web-client-config-custom.xml.sample web-client-config-custom.xml

Si vous ne prévoyez pas d'apprendre le Catalan ou le Breton dans les 15 prochains jours, vous pouvez ne laisser que :

<config evaluator="string-compare" condition="Languages">
      <languages>
         <language locale="fr_FR">French</language>
      </languages>
   </config>

[modifier] Les options de démarrage

ajouter dans /etc/rc.conf

tomcat55_java_opts='-Xms128m -Xmx512m -server'
tomcat55_enable="YES"

[modifier] Utilisation

[modifier] Arrêt / Démarrage

Le serveur est maintenant opérationnel. Pour le lancer

sudo /usr/local/etc/rc.d/tomcat55 start

et l'arrêter

sudo /usr/local/etc/rc.d/tomcat55 stop

[modifier] Accès au serveur

• via l'interface web : http://monserveur.mondomaine.tld:8180/alfresco/

[modifier] Fichier de log

Les logs sont dans /usr/local/tomcat5.5/logs/stdout.log