Installation de DM
L'utilisation d'Alfresco n'a pas été très poussé dans le cadre des différents travaux. Des informations bien plus pertinentes sont disponibles sur le blog suivante http://charles.torda.net/
Sommaire
Pré requis
Cet article présente le déploiement de l'application DM de Alfresco. Au préalable, la base de données doit avoir été créée.
Alfresco sous Tomcat
Publication sous Apache
Configuration
La configuration de l'instance Alfresco s'effectue à travers le fichier alfresco-global.properties
devant se situer dans le classpath du serveur. Un fichier exemple est fourni à l'emplacement /web-server/shared/classes/alfresco-global.properties.sample
dans le package communautaire. Dans le cadre de cette installation, des répertoires particuliers pour Alfresco ont été ajouté au classpath de Tomcat:
cd web-server/shared/classes sudo cp alfresco-global.properties.sample /var/lib/tomcat6/shared/alfresco/classes/alfresco-global.properties sudo chown tomcat6:tomcat6 /var/lib/tomcat6/shared/alfresco/classes/alfresco-global.properties sudo chmod o-r /var/lib/tomcat6/shared/alfresco/classes/alfresco-global.properties
Le propriétaire et les permissions du fichier sont modifiés afin de s'assurer que seul le compte exécutant le serveur Tomcat soit habilité à lire le fichier.
Emplacement des contenus
L'emplacement des contenus est spécifié à travers la configuration dir.root
. La modification suivante est apportée:
#
# Sample custom content and index data location
#
#dir.root=/srv/alfresco/alf_data
dir.root=/srv/alfresco/alf_data
L'emplacement exemple est assez pertinent pour une installation sur un serveur Ubuntu. Les répertoires sont alors créés avec une limitation d'accès:
cd /srv sudo mkdir /srv/alfreso sudo mkdir /srv/alfreso/alf_data sudo chown -R tomcat6:tomcat6 /srv/alfresco sudo chmod -R o-rx /srv/alfresco
Logger
Il est possible d'ajouter des configurations spécifique des loggers. Par défaut le fichier log4j.properties
se situe dans le répertoire WEB-INF/classes
de la webapp.
Or le contenu du fichier WEB-INF/classes/alfresco/core-services-context.xml
définis des extensions de configurations de logger ainsi:
<!--
http://wiki.alfresco.com/wiki/Developing_an_Alfresco_Module#log4j.properties
-->
<bean id="log4JHierarchyInit" class="org.alfresco.repo.admin.Log4JHierarchyInit" init-method="init">
<property name="extraLog4jUrls">
<list>
<!-- NOTE: value entries are listed from lowest precedence to highest. -->
<!-- Installed AMP modules -->
<value>classpath*:alfresco/module/*/log4j.properties</value>
<!-- Enterprise extensions -->
<value>classpath*:alfresco/enterprise/*-log4j.properties</value>
<!-- Other installed extensions -->
<value>classpath*:alfresco/extension/*-log4j.properties</value>
<!-- private developer overrides -->
<value>classpath*:alfresco/extension/dev-log4j.properties</value>
</list>
</property>
</bean>
Nous pouvons donc constater plusieurs possibilités pour compléter la configuration log4j. Dans le cadre de cette installation, la troisième solution est mise en place, à savoir l'ajout d'un fichier dans le répertoire alfresco/extension
disponible dans le classpath. Suite au modification faite sur l'environnement Tomcat, nous pouvons donc placer un fichier, copie du standard, à l'emplacement: ${catalina.home}/shared/alfresco/classes/alfresco/extension
. Le fichier ext-log4j.properties
est créé par copie du fichier standard. A noter que le nom doit finir par -log4j.properties
, d'où l'ajout de ext
en préfixe.
L'emplacement de la log est modifié pour diriger les message dans le répertoire /var/log/tomcat6/alfresco.log
:
###### File appender definition #######
log4j.appender.File=org.apache.log4j.DailyRollingFileAppender
log4j.appender.File.File=/var/log/tomcat6/alfresco.log
log4j.appender.File.Append=true
log4j.appender.File.DatePattern='.'yyyy-MM-dd
log4j.appender.File.layout=org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern=%d{ABSOLUTE} %-5p [%c] %m%n
Voir la description de la mise en place de logger au sein de module: http://wiki.alfresco.com/wiki/Developing_an_Alfresco_Module#log4j.properties
Configuration librairies externes
Alfreso utilise OpenOffice pour générer des renditions pdf, ImageMagik pour la conversion d'image ainsi que pdf2swf pour convertir les pdf en fichier flash. Il faut spécifier les emplacements des produits afin de les utiliser. Pour une distribution Ubuntu, l'installation de pdf2swf s'effectue en installant le package swftools
:
sudo apt-get install swftools
Les modifications apportées permettent de spécifier les emplacements des exécutables:
#
# External locations
#-------------
#ooo.exe=soffice
ooo.exe=/usr/bin/soffice
#ooo.enabled=false
#jodconverter.officeHome=./OpenOffice.org
#jodconverter.portNumbers=8101
#jodconverter.enabled=true
#img.root=./ImageMagick
img.exe=/usr/bin/convert
#swf.exe=./bin/pdf2swf
swf.exe=/usr/bin/pdf2swf