AnsweredAssumed Answered

Foire Aux Questions installation

Question asked by michaelh Employee on Feb 18, 2008
Avant de poser une question dans le forum "installation", lisez bien les quelques lignes qui suivent et qui reprennent les questions les plus fréquemment posées.

La première chose à faire quand ça ne marche pas :
    - Lisez les fichiers de log
    - Lisez les fichiers de log
    - Lisez les fichiers de log
Où trouver les fichiers de log ?

Les fichiers de log sont les fichiers suivants :
- catalina.out dans le cas d'un serveur d'application Tomcat (si vous utilisez un autre serveur d'application, reportez-vous à sa documentation pour connaître ses fichiers de log).
- alfresco.log qui est par défaut à la racine de l'installation.

A noter, le fichier alfresco.log n'apparait pas dans les deux cas suivants :
    - Vous avez utilisé un serveur d'application existant et le déploiement de la "webapp" ne s'est pas fait correctement. Alfresco ne se lance même pas. Vérifiez vôtre installation, ou utilisez un package Alfresco+tomcat pour vos premiers tests. Ce package préconfiguré limite fortement le risque d'erreur.
    - L'utilisateur sous le compte duquel est lancé Alfresco n'a pas le droit d'écrire dans le répertoire d'installation pour créer ce fichier de log. Vérifiez les droits des répertoires.
DÉCHIFFRER LE CONTENU DES LOGS

Nous ne traiterons ici que du fichier alfresco.log.
Assez vite vous apprendrez à aller directement au but, mais il a quelques mots clés à chercher pour se retrouver rapidement dans les logs (qui peuvent être assez verbeux).

Le premier est l'indicateur "caused by". Dans la plupart des cas il vous donne la cause de l'échec du démarrage, ou du problème rencontré.

PROBLÈMES DE DROITS D'ACCÈS

Caused by: java.security.AccessControlException: access denied (java.io.FilePermission alfresco.log write)
ou
Caused by: org.alfresco.error.AlfrescoRuntimeException: Failed to create index directory 
Alfresco n'arrive pas à écrire ou créer son fichier de logs ou les fichiers d'index.
    - Vérifier les droits dans le répertoire d'installation.
PROBLÈMES DE PORTS ET DE PROCESSUS

java.net.BindException: Address already in use
ou
java.net.BindException: Address already in use:8080 
ou
NameAlreadyBoundException: alfresco/jmxrmi [Root exception is java.rmi.AlreadyBoundException: alfresco/jmxrmi]
Un processus occupe les ports dont Alfresco a besoin.
    - Vérifiez qu'un processus n'est pas déjà lancé, qui occuperait ce ou ces ports.
    - Si vous avez déjà lancé Alfresco auparavant, vérifiez qu'il s'est bien arrêté (chercher les processus "java" et les supprimer le cas échéant … en vérifiant qu'un autre logiciel n'en a pas besoin :)
java.net.BindException: Permission denied 
Vous lancez Alfresco avec un utilisateur qui n'a pas le droit d'ouvrir les ports dits "privilégiés" (<1024).
Deux solutions :
    - Lancer Alfresco sous le compte "root" (bof)
    - Appliquer la recette fournie sur le wiki Alfresco
PROBLÈMES DE MEMOIRE

java.lang.OutOfMemoryError: PermGen space 
Pour résumer, le système a besoin de plus de mémoire.
Modifiez la ligne "JAVA_OPTS" du fichier alfresco.bat ou alfresco.sh de la manière suivante.
    -Xms128M -Xmx512M -XX:PermSize=64M -XX:MaxPermSize=128M
PROBLÈME DE BASE DE DONNÉE OU D'ENTREPÔT

Caused by: org.alfresco.repo.search.SearcherException: More than one root node in index: 2
Alfresco a été lancé au moins une fois sur une base HSQLSB (le plus souvent) avant de basculer vers une base de données (MySQL, PostgreSQL, …).
Dans ce cas on se retrouve avec un répertoire "alf_data" (qui stocke les éléments de contenu) qui n'est plus en phase avec le contenu de la base. Le système ne peut pas démarrer.

Pour éviter ce genre d'incohérence, il faut repartir sur des bases saines : supprimer le contenu du répertoire "alf_data", le schéma de la base, et laisser Alfresco recréer l'ensemble au prochain redémarrage.

Caused by: org.hibernate.exception.GenericJDBCException: Cannot open connection
ou
java.lang.IllegalStateException: No user transaction is active
ou
org.alfresco.error.AlfrescoRuntimeException: Failure during rollback 
ou
[org.springframework.web.context.ContextLoader] Context initialization failed
Il s'agit d'un problème de connexion à la base de données.
Vérifiez bien le contenu des fichiers de configuration, ainsi que les droits d'accès à la base et la bonne installation du driver éventuel.

Outcomes