Nous allons d’écrire ici les étapes à suivre nécessaire à la mise en place d’Alfresco 3.2r de base.
Pour ceux qui ne le saurait pas Alfresco est une solution open-source pour la mise en place d’un ECM (Entreprise Content Management)  ou d’une GED (Gestion Emectronique de Document).
Nous partons du principe que linux est installé correctement.
Nos tests ont été effectués sur une mandriva 2009.1, une ubuntu desktop 9.04 et une ubuntu serveur 9.10

Sommaire

1. Préinstallation
2. Installation d’Alfresco
3. Connexion de la base de données
4. Lancement d’Alfresco
5. Utilisation d’Alfresco

Préinstallation

Les packages suivants sont nécessaires pour le bon fonctionnement d’Alfresco

1. le sdk java de SUN (la dernière fois que j’ai testé openjdk cela n’avait pas fonctionné, il faudra que je recommence des tests).
2. Une base de données mysql (la configuration pour postgresql sera aussi fourni)
3. openoffice.org et surtout n’oublier pas de le lancer au moins une fois pour lui déclarer java (comment ?).
4. ImageMagick, en effet Alfresco se sert de « convert » pour effectuer des transformations automatiques sur les images)
5. swftools, Alfresco utilise « pdf2swf » pour transformer à la volée les fichiers en swf (format flash) pour les visualiser directement au travers du navigateur sans avoir besoin de l’application source.

Normalement l’ensemble de ces applications sont déjà présentes sur votre linux, sinon elles sont disponibles sous formes de packages directement installables.

Installation d’Alfresco

Récupération d’Alfresco sur le serveur de l’éditeur suivre le lien suivant :

http://wiki.alfresco.com/wiki/Download_Community_Edition

Téléchargement d'Alfresco sur le site de l'éditeur

Prendre la version linux (bien évidement), Enregistrer le fichier dans votre espace.

Suivant l’endroit ou vous aller installer Alfresco, vous aurez peut-être besoin d’avoir les droits de l’administrateur (root).

Je vous conseille d’effectuer l’installation en mode console, l’installation graphique échoue trés souvent au moment de la détection d’openoffice.org (même en pratiquant le contournement proposé par Alfresco) et vous êtes obligé de stopper l’installation en cours. Pour effectuer l’installation en mode console, il suffit de faire :

prompt> ./install_alfresco -mode console

et suivre les instructions. Attention la base de donnée ne sera pas initialisée. Celle-ci devra être faite à la main. La procédure sera décrite ci-après.
Après installation il vous faudra configurer 2 fichiers.
A partir du répertoire d’installation (le répertoire ou vous avez déployé Alfresco), nous commencerons par modifier le fichier alfresco.sh

Vous devez renseigner 2 variables

1. ALF_HOME
2. JAVA_HOME

Les informations à renseigner sont en bleu, elles dépendent de votre environnement.

#!/bin/sh
# Start or stop Alfresco server
# Set the following to where Tomcat is installed
ALF_HOME=/home/jjt/Alfresco
cd « $ALF_HOME »
APPSERVER= »${ALF_HOME}/tomcat »
export JAVA_HOME=/usr/lib/jvm/java-6-sun/
# Set any default JVM values
export JAVA_OPTS=’-Xms128m -Xmx512m -XX:MaxPermSize=128m -server’
export JAVA_OPTS= »${JAVA_OPTS} -Dalfresco.home=${ALF_HOME} -Dcom.sun.management.jmxremote »
# Following only needed for Sun JVMs before to 1.5 update 8
export JAVA_OPTS= »${JAVA_OPTS} -XX:CompileCommand=exclude,org/apache/lucene/index/IndexReader$1,doBody -XX:CompileCommand=exclude,org/alfresco/repo/search/impl/lucene/index/IndexInfo$Merger,mergeIndexes -XX:CompileCommand=exclude,org/alfresco/repo/search/impl/lucene/index/IndexInfo$Merger,mergeDeletions »
#
if [ "$1" = "start" ]; then »
${APPSERVER}/bin/startup.sh »
# if [ -r ./virtual_start.sh ]; then
# sh ./virtual_start.sh
# fi
# if [ -r "$ALF_HOME"/start_oo.sh ]; then
# sh « $ALF_HOME »/start_oo.sh
# fi
elif [ "$1" = "stop" ]; then
« ${APPSERVER}/bin/shutdown.sh »
# if [ -r ./virtual_start.sh ]; then
# sh ./virtual_stop.sh
# fi
# if [ -r "$ALF_HOME"/start_oo.sh ]; then
# killall soffice.bin
# fi
fi

Depuis la version 3.2 la configuration globale c’est fortement simplifiée. Le deuxième fichier à configurer se trouve dans le répertoire à partir de la home directory : tomcat/shared/classes

Modifiez le fichier : alfresco-global.properties

Beaucoup d’informations sont déjà renseignées suite à l’installation préalable. Les lignes modifiées sont en bleu

###############################
## Common Alfresco Properties #
###############################
#
# Sample custom content and index data location
#————-
dir.root=./alf_data


#
# Sample database connection properties
#————-
db.name=alfresco
db.username=alfresco
db.password=alfresco
db.host=localhost
db.port=3306

#
# External locations
# Cette partie permet de renseigner les applications tierces permettant les transformations automatiques de type .doc en .pdf ou tiff en jpeg …
#————-
ooo.exe=/usr/bin/soffice
img.root=/usr
swf.exe=/usr/bin/pdf2swf
#

# MySQL connection
#————-
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://${db.host}:${db.port}/${db.name}
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

#
# Index Recovery Mode
#————-
#index.recovery.mode=Auto

#
# Outbound Email Configuration
# Cette partie permet de renseigner Alfresco pour lui permettre d’envoyer des mails aux utilisateurs
#————-
mail.host=votre serveur smtp
mail.port=25
mail.username=nom d’utilisateurmail.password=mot de passe
mail.encoding=UTF-8
mail.from.default=alfresco@alfresco.org
mail.smtp.auth=false
#

# Alfresco Email Service and Email Server

#————-
# Enable/Disable the inbound email service.  The service could be used by processes other than
# the Email Server (e.g. direct RMI access) so this flag is independent of the Email Service.
#————-
#email.inbound.enabled=true

# Email Server properties
#————-
#email.server.enabled=true
#email.server.port=25
#email.server.domain=alfresco.com
#email.inbound.unknownUser=anonymous

# A comma separated list of email REGEX patterns of allowed senders.
# If there are any values in the list then all sender email addresses
# must match. For example:
#   .*@alfresco.com, .*@alfresco.org
# Allow anyone:
#————-
#email.server.allowed.senders=.*

#
# To configure external authentication subsystems see:
# http://wiki.alfresco.com/wiki/Alfresco_Authentication_Subsystems
#————-
#authentication.chain=alfrescoNtlm1:alfrescoNtlm

#
# IMAP
# Cette partie permet de transformer votre alfresco en serveur IMAP et de vous connectez sur alfresco au travers de votre messagerie.
#————-
imap.server.enabled=true
imap.server.port=8143 (ou 143)
imap.server.host=Adresse IP de votre serveur alfresco

Connexion de la base de données

Mysql

Par défaut, Alfresco depuis la version 3.2 est paramétré pour fonctionner avec Mysql. Il est uniquement nécessaire de créer une base « Alfresco » avec l’utilisateur Alfresco et le mot de passe Alfresco. Un script d’initialisation est fourni pour la création de la base, de l’utilsateur et du mot de passe.

Le script se situe dans le répertoire (à partir de votre Home Alfresco) :

extras/databases/mysql

dans ce répertoire taper la commande :

prompt> mysql-u root -p < db_setup.sql

Demande du mot de passe root

Si tout c’est bien passé, la base est initialisée.

Postgresql

La mise en place de Postgresql sera Développée dans un prochain Post.

Lancement d’Alfresco

Au niveau du répertoire d’Alfresco saisir la commande suivante :

prompt> ./alfresco.sh start

Vous pouvez suivre les informations de log en ouvrant une nouvelle console et dans le repertoire d’alfresco, saisir la commande suivante :

prompt> tail -f tomcat/log/catalina.out

La commande tail permet d’afficher la fin du fichier de log, l’option -f permet de réactualiser l’affichage à chaque ligne de message. Cela vous permet de suivre tout les messages envoyé par défaut par Alfresco lors de la phase de lancement de l’application.

Si tout ce passe bien les derniers messages sont les suivants :

INFO: D�marrage de Coyote HTTP/1.1 sur http-808
01 nov. 2009 22:29:17 org.apache.catalina.startup.Catalina start
INFO: Server startup in 302506 ms

Utilisation d’Alfresco

Pour utiliser Alfresco, lancer votre navigateur internet et sasir l’adresse suivante :

http://localhost:8080/alfresco

ou

http://adresseIPduserveur:8080/alfresco

et vous obtenez la page suivante :

Page d'accueil en connexion invité (guest)

Vous êtes connecté sur la page de l’invité (guest).

Vous pouvez vous déconnecter en cliquant sur le coin en haut à droite (login (guest)), ce qui vous déconnecte et vous permet d’accéder à la page de login.

page de login

Pour accéder à l’administrateur, taper :

User Name : admin
password : amin
cliquer sur le bouton « login« 

Vous êtes maintenant sur la page d’accueil de l’administrateur.

Page d'accueil de l'administrateur

A partir de cette page vous pourrez commencer à travailler sur Alfresco. Je vous conseille de commencer par créer un utilisateur afin de ne pas travailler sur le compte d’administration.

Dans les prochains post, nous verrons comment créer un utilisateur et des groupes. Bonnes découvertes.

N’oublier pas qu’aujourd’hui, les technologies de la gestion documentaire et de la gestion de contenu ne sont pas disponibles uniquement pour les Grands Comptes  et les  Sociétés du CAC 40.

N’hésitez pas à nous contacter pour toutes informations.