Je profite de ce nouveau POST pour vous présenter l’installation de cette première mouture en version Beta 1. Il est pour l’instant difficile à Mageia de cacher ces origines. Pour ceux qui connaissent Mandriva, il n’y aura aucun dépaysement. Je m’attendais à un certain choix et partie pris dans le choix des packages, mais pour l’instant cela ne semble pas être une priorité.

L’installation à été effectuée à partir de la version 32bit dans une Virtualbox après download du fichier bittorent : http://mageia.org/fr/downloads/. L’installation est effectuée dans une Virtualbox 4.0.2 sur une Mandriva 2010.2 (ironie du sort …).

Je rappelle à toutes fins utiles que cette version est une version beta mise à disposition pour test.

Installation

En premier choix de la langue d’installation

choix langue

Acceptation de la licence

Licence

Le choix du clavier

clavier

Étape du partitionnement. Par défaut, mageia créer 3 partitions, une pour le système « / », une pour le swap (le double de la mémoire) et pour finir une pour les répertoires personnelles « /home ».

partitionnement

Choix de médias complémentaires. Aucun choix n’a été effectué.

Medias supplémentaires

Choix de votre Desktop. Par défaut c’est KDE qui est proposé (version 4.6.1), sinon vous avez le choix de Gnome (version 2.32) ou « personnalisé ».

Desktop

Lancement de l’installation, les écrans suivants sont les captures de la présentation de mageia. Nous en sommes qu’au début, personnellement je les trouve assez « Bof », de plus pas vraiment dans l’ambiance du graphisme de l’installation et plutôt sans saveur.

Premier visuel pour les Bugs

Deuxième visuel pour le retour des tests

Troisième visuel pour adhérer à la communauté

une fois les packages installés, création de mot de passe de l’administrateur « root » et du premier utilisateur.

mot de passe "root" et premier utilisateur

Préparation du programme d’amorçage

programme d'amorçage

Résumé final de l’installation, avec possibilité d’affiner les paramétrages.

résumé de l'installation

Possibilité de faire une mise à jour finale avant la fin de l’installation. Dans le cas qui nous intéressent cela n’est pas nécessaire.

Écran de Mise à jour

L’installation est terminée, Félicitation …

Fin d'installation, Félicitation

Il ne vous reste plus qu’à redémarrer votre machine ou espace Virtuel.

Première Impression

Pas de grand changement révolutionnaire en comparaison d’une mandriva 2010.x. Comme dit précédemment, beaucoup de packages installés. Il est difficile de voir un choix éditorial et stratégique pour l’instant, si ce n’est le choix par default de KDE (comme la mandriva) et le choix de libreoffice comme toutes les distributions. Mageia se veut généraliste et cela est visible.

Je vous laisse avec quelques captures d’écran.

écran de grub

écran de démarrage

Graphisme sympathique mais caché par l’écran de connexion, dommage …

Écran de connexion

connexion en cours

Interface par défaut de mageia, c’est sobre. J’espère que quelques graphiste se pencherons sur le berceau (ou le chaudron) de mageia pour le rendre plus attractif. Étonnant la position de la poubelle en haut à gauche …

Interface par défaut

Mageia, deviendra-t-elle la nouvelle distribution des geeks, comme l’a été mandriva ?

Nous verrons cela dans les jours qui viennent avec la série de beta et de RC. La sortie finale est prévu pour juin …

Ou comme souvent dans l’open-source : Quand elle sera prête …

Le Multi-tenancy (MT) est une architecture logicielle, où une seule instance du logiciel alfresco s’exécute sur un serveur, tout en mettant à disposition des organisations clientes multiples (les locataires) des instances indépendantes. Le Multi-tenancy s’oppose avec une architecture multi-instance, où des logiciels distincts (ou matériels) sont mis en place pour les organisations de clients différents. Avec une architecture multi-tenancy, l’application est conçu pour partitionner ses données et sa configuration, de sorte que chaque organisation cliente travaille avec une instance de l’application virtuelle personnalisée et indépendante.

Alfresco peut être configuré comme une instance unique dans un environnement multi-client. Cela permet à plusieurs clients indépendants d’être hébergés sur une instance installé sur un serveur. L’instance de base d’Alfresco est alors partitionné logiquement de telle manière qu’elle apparaisse pour chaque client comme instance unique.

Mise en place du Multi-Tenancy

Par défaut, Alfresco supporte une instance unique (ST) pour son environnement. La mise en place du Multi-tenancy sur Alfresco permettra l’exécution d’une instance pour chaque client. Toutes ces instances seront mises à disposition à partir d’un seul serveur Alfresco.

Afin de permettre un environnement multi-tenancy, vous devez renommer les trois fichiers suivants en supprimant l’extension .sample. Les fichiers sont disponible dans le répertoire suivant, $Alfresco_Home/tomcat/shared/classes/alfresco/extension/mt:

• Renommer mt-context.xml.sample en mt-context.xml
• Renommer mt-admin-context.xml.sample en mt-admin-context.xml
• Renommer mt-contentstore-context.xml.sample en mt-contentstore-context.xml

Après modification des trois fichiers redémarrer Alfresco pour initialiser le Multi-Tenancy.

Création d’un « espace client » (Tenant)

L’utilisateur administrateur par défaut « admin » d’Alfresco peut être considéré comme le super utilisateur des « espaces clients ». Tous les clients peuvent être administrés par l’utilisateur « admin » à partir de la console d’administration des « espaces clients ».

Pour accéder à la console d’administration des « espaces clients », vous devez vous connectez à l’interface explorer d’Alfresco en utilisant le compte « admin ».

L’URL pour accéder à la console d’administration des « espaces clients » se trouve à l’adresse suivante :

http://<nomduserveur> :<port>/alfresco/faces/jsp/admin/tenantadmin-console.jsp

Voir la capture d’écran suivante :

Illustration 1: Capture de la fenêtre d’administration des « Espaces Clients »

Pour créer un « espaces clients » à partir de la console d’administration des « espaces clients » à titre d’exemple, saisir la commande suivante :

create apie.com password /usr/tenant/apie

Dans cet exemple, apie.com est le domaine du nouvel « espace client », password est le mot de passe de l’administrateur de l’« espace client » et apie est le nom de l’« espace client ».

Maintenant, admin@apie.com est le compte administrateur de l’« espace client » apie.com.

Utilisation d’un « espace client »

Suite à la création de notre nouvel « espace client » apie.com notre Alfresco contient maintenant 2 « espaces Clients » :

1. Le premier espace par défaut
2. Le deuxième apie.com

Connecter vous à l’explorer d’Alfresco avec le compte administrateur admin@apie.com et son mot de passe password, vous accédez à la page d’accueil du nouvel « espace client » de apie.com, voir la capture suivante :

Illustration 2: page d’accès à « Company home » de l »espace client » apie.com

La gestion des utilisateurs, des espaces, la sécurité, les scripts, les règles métier et les recherches sont spécifiques à l’« espace client » apie.com.

L’administrateur (admin@apie.com) peut créer les utilisateurs, qui auront un accès local à ce site « espace client ». Les utilisateurs créés pour cet « espace client » doivent se connecter avec le nom de domaine apie.com. Par exemple, si l’ID utilisateur est user1, alors l’utilisateur doit se connecter avec le login user1@apie.com.

De même, les dossiers et les contenus créés ne pourront être consultés et recherchés uniquement par les utilisateurs de l’« espace client ».

Le comportement vis à vis des « espaces clients » est identique pour l’ensemble des interfaces tels que : CIFS, FTP, WebDAV. Quelques soient l’interfaces la connexion via un compte id@apie.com aura accès uniquement à l’« espace client » apie.com.

Voir la capture d’écran ci-dessous d’une connexion webdav :

Illustration 3: Connexion webdav sur l’espace client apie.com

Gestion des « espaces clients »

En tant que super administrateur, vous pouvez activer ou désactiver les « espaces clients », de même, vous pouvez exporter ou importer les données des « espaces clients », vous pouvez effectuer d’autres tâches administratives, telles que changer le mot de passe administrateur de l’« espace client », gérer les utilisateurs, les groupes ou les sous-groupes.

Le tableau suivant liste plusieurs commandes importantes qui sont utiliser pour la gestion des « espaces clients ».

Exportation et importation des données d’un « espace client »

Dans le cadre d’une activité de maintenance, vous pouriez avoir besoin de faire une exportation de données spécifiques d’un « espace client ».

Par exemple, la commande suivante exécutée à partir de la console d’administration des « espace client » pour exporter la totalité de l’« espace client » apie.com dans le répertoire /opt/ sera

export apie.com /opt/

Vous noterez que les fichiers générés lors de l’exportation sont tous préfixé avec le domaine de l’« espace client ».

• apie.com_models.acp
• apie.com_spaces.acp
• apie.com_spaces_archive.acp
• apie.com_system.acp
• apie.com_users.acp
• apie.com_versions2.acp

De façon identique, vous pouvez recréer un « espace client » par importation des fichiers à partir d’une source donnée.

La syntaxe pour l’importation sera la suivante :

import apie.com /opt/exportdir/

Remarques sur le multi-tenant

La liste suivante sont les technologies qui ne sont aujourd’hui par supportées / implémentées / testées dans la mise en place d’un « espace client » (multi-tenant).

• WCM / Web Studio
• LDAP, NTLM and authentication methods other than « alfresco »
• Inbound Email
• Content Replication
• IMAP
• SPP / VTI (SharePoint Protocol)

Le CIFS est à valider.

Test du multi-tenant

Les tests du multi-tenant ont été effectués sur une machine linux mandriva 201.1 avec Alfresco Community version 3.3g (installation de base) et une base de donnée Postgresql version 8.4.4.

Compatibilité Share

Le multi-tenancy gère aussi bien l’interface Alfresco DM que l’interface SHARE.

Des tests fonctionnels sous SHARE sont nécessaires pour une complète validation fonctionnelle.

Références

Ce document se base sur la documentation anglaise du wiki d’Alfresco et du livre en anglais « Alfresco3 ECM Implementation » disponibles au Édition PackT Publishing, ainsi que des différents tests effectués à partir d’Alfresco Community version 3.3g.

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.