Accueil

FAQ

Vous trouverez ici les questions les plus fréquemment posées sur les listes de discussions. Si vous pensez qu'une question pourrait être ajoutée, n'hésite pas à la proposer.

Présentation

  • Pour toutes questions relatives à la présentation de Cyberdocs, consulter cette page.

Installation 

Premiers pas...

Module de publication 

Module de conversion et gestion 

Autres

Réponses

Sur quels systèmes fonctionne Cyberdocs ?

Les différents modules de la plate-forme Cyberdocs ont été conçus de manière à être le plus portables possibles. Toutefois, ils font appel à des technologies différentes, d'où une certaine variation dans les spécifications des systèmes où on peut installer chaque module. Consultation la documentation pour plus d'information.

Comment récupérer les sources ?

Vous trouverez comment télécharger les sources sur la page de téléchargement. Il est fortement recommandé de prendre la dernière version des sources en SVN.

Est-il préférable de télécharger les sources en SVN ?

Il est fortement recommandé d'utiliser la dernière version des sources en SVN, afin de bénéficier des dernières corrections.

A l'installation, j'obtiens l'erreur : Error: JAVA_HOME is not defined correctly

Vous devez définir la variable d'environnement JAVA_HOME, contenant le chemin d'installation de la JVM.

Par exemple : export JAVA_HOME=/usr/jdk1.6.0  ou set JAVA_HOME=C:\Program Files\Java\jdk1.5.0_08

A l'installation, j'obtiens des erreurs sur des fichiers inexistants alors que je les vois.

Vérifiez qu'il n'y ait pas d'espace ou de caractères spéciaux dans les nom de répertoires contenant les sources de cyberdocs.

J'obtiens une erreur similaire à :  BUILD FAILED : file:build.xml:181: OpenOffice.org1.0.3\program\classes not found.

Le répertoire d'OpenOffice spécifié dans le fichier pcd.properties est erroné ou la version d'OpenOffice n'est pas complète ou compatible. Certaines versions préinstallées avec les distributions Linux ne contiennent pas toutes les classes nécessaires à Cyberdocs. Téléchargez OpenOffice depuis le site officiel .

J'obtiens une erreur similaire à : BUILD FAILED : file:build.xml:619: Could not create tomcat\webapps\sdx\WEB-INF\sdx\applications\theses

ou

Après lancement du script installation-web.sh, l'application web n'est toujours pas visible dans SDX.

Le chemin d'accès à SDX spécifié dans le fichier pcd.properties (dossier.installation.consultation) est erroné. Corrigez-le et vérifiez que des fichiers n'ont pas été copiés dans un mauvais répertoire.

Après lancement du script installation-web.sh, l'application est visible dans SDX mais elle n'est pas déployée.

Vérifier le nom de l'application dans pcd.properties et la configuration pour l'accès aux bases de données dans votre fichier application.xconf (en particulier si vous avez modifié le contenu par défaut). Vous pouvez également consulter les logs dans le répertoire tomcat/webapps/sdx/WEB-INF/logs/.

Lorsque je tente d'accéder à une page de l'application de diffusion, j'obtiens l'erreur : java.lang.ClassNotFoundException: org.apache.cocoon.transformation.CachingCIncludeTransformer.

Vous avez oublié de renseigner les valeurs de cocoon.class.cinclude et cocoon.class.wildcard dans le fichier pcd.properties, en fonction de votre version de SDX (2.2 ou 2.3).

Lorsque je tente d'accéder à une page de l'application de diffusion, j'obtiens l'erreur : java.io.FileNotFoundException: C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps\sdx\pcd\pcd\conf\logicsheets\xsp-pcd.xsl (Le chemin d'accès spécifié est introuvable)

Vous n'avez pas renseigné correctement la valeur de sdx.logicsheet.path dans le fichier pcd.properties, en fonction de votre version de SDX (2.2 ou 2.3).

Lorsque je tente d'accéder à une page de l'application de diffusion, j'obtiens l'erreur : org.apache.avalon.framework.configuration.ConfigurationException: Element 'component-configurations' is not allowed at file:/C:/Program%20Files/Apache%20Group/Tomcat%204.1/webapps/sdx/pcd/sitemap.xmap:365:33

Le fichier src/web/sitemap.xmap contient des éléments uniquement compatibles avec la version 2.3 de SDX (version recommandée). Cependant, si vous désirez utiliser la version 2.2, commenter les lignes <map:component-configurations> dans src\web\sitemap.xmap.

Certaines parties ou images du bandeau sont manquantes dans les pages de consultation d'un document.

Avez-vous lancé le script d'installation copie-institution.sh/bat ?

Si oui, vérifiez que tous les fichiers ont été copiés lors de l'installation.

Pensez à recharger explicitement chacun des cadres dans votre navigateur : clique droit -> ce cadre -> Touche Shift +  Actualiser le cade. Vous pouvez également vider le cache.

Lors d'une recherche ou de l'indexation d'un document, SDX me retourne une exception java out of memory, que faire ?

Vous pouvez augmenter la mémoire autorisée pour la JVM. Par exemple, pour tomcat, vous pouvez ajouter (ou modifier) en haut du fichier tomcat/bin/catalinat.sh :

export JAVA_OPTS="-Xms256m -Xmx2048m" 

Relancez Tomcat. 

Je modifie les fichiers xsl ou xml dans le répertoire webapps/sdx/monappli/xsl et les modifications ne sont pas visibles en ligne.

Par défaut, les modifications sur les xsl ne sont pris en compte que lorsque les dates de modification des fichiers xsl du répertoire sdx/monappli/habillage/xsl ont été changées. Les dates de modification des fichiers situés dans le répertoire xsl à la base de l'application sdx ne sont pas pris en compte.

Pour contourner ce problème, vous pouvez :

  • Relancez Tomcat (ou votre moteur de servlets). Pour gagner du temps, il est conseillé d'utiliser le Manager Tomcat ou l'extension Tomcat avec l'IDE Eclipse.
  • Modifiez les fichiers depuis les sources et relancer installation-web.sh/bat qui s'occupe de changer les dates de modification. Certains éditeurs de texte permettent de créer des raccourcis vers des commandes sh ou dos.

Je ne sais pas comment changer le mot de passe admin ou créer un compte utilisateur pour le module de publication.

Vous devez utiliser l'application web d'administration de SDX située à cette adresse : http://votre_serveur[:8080]/sdx/sdx/admin/index.xsp.

En cliquant sur "Administrer" pour le serveur SDX, vous modifiez la configuration globale de SDX, qui vous permet d'administrer toutes les applications. Le login par défaut est "admin" sans mot de passe. Il est donc fortement conseillé de le changer.

En cliquant sur "Administrer" pour une application en particulier, vous modifiez uniquement la configuration de l'application en question. 

Par défaut, il existe un compte "admin" sans mot de passe, appartenant au groupe admins. 

Peut-on effectuer des sauvegardes de la base de documents ?

Oui. Voici quelques exemples :

  • Avec la sauvegarde du système : si vous utilisez une base de données fichiers, attention à ne pas indexer un document pendant la sauvegarde... il est même recommander de stopper votre moteur de servlets, en passant votre site en maintenance pendant quelques minutes.
  • En demandant à SDX de créer un fichier de sauvegarde (réimportation non testée) via l'interface d'administration : bouton "explorer" puis "sauvegarder". Cette opération peut être très longue. Les fichiers de sauvegarde sont placés automatiquement dans le répertoire webapps/sdx/monappli/conf/backup. Les fichiers pouvant être volumineux, ne pas les conserver indéfiniment.

J'ai une page blanche lorsque je vais sur la page index du module de gestion.

 Ce problème peut avoir des causes multiples :

  • Vérifiez que votre version de php est bien supérieure ou égale à 4.3 pour linux et 5.0 pour Windows. Dans tous les cas, nous conseillons la version 5 ou supérieure. Pour connaître votre version de php, vous pouvez taper : php --version dans un terminal.
  • Une erreur d'exécution peut être masquée à cause de la configuration de php. Dans php.ini, vérifiez que display_errors = On le temps de l'installation. Ceci devrait vous permettre de voir les erreurs et de détecter les problèmes. Vous pourrez certainement trouver une solution dans les autres questions de cette FAQ.
  • S'il n'y aucune erreur, vérifiez les logs d'apache et les droits d'accès au répertoire php et data, comme indiqué dans la documentation.
  • Vérifier la configuration d'apache, pour les scripts PHP. Vérifier qu'aucune fonction essentielle ne manque pas 

J'ai des warning php lorsque je vais sur la page index du module de gestion.

La version actuelle du module de gestion nécessite de désactiver l'affichage des warning. Dans tous les cas, pour un serveur de production, il est préférable de ne pas afficher les erreurs. Si vous souhaitez uniquement désactiver les warning, modifier php.ini de la façon suivante :

error_reporting  =  E_ALL & ~E_NOTICE & ~E_STRICT

J'ai l'erreur utf8_encode unknown function sur la page index du module de gestion.

Il faut installer le module PHP-XML : vous pouvez l'installer en tapant apt-get install php-xml ou yum install php-xml avec la Fedora.

La page de php.net concernant ce module  : http://fr.php.net/manual/fr/ref.xml.php

Je n'arrive pas à m'authentifier la première fois dans le module de gestion.

Par défaut, le login est root, sans mot de passe. La première opération à effectuer sera donc de mettre un mot de passe.

Si malgré cela, vous n'arrivez pas à vous authentifier, vérifiez que :

  • Les cookies ne soient pas été bloqués par votre navigateur.
  • Les fichiers des répertoires data et production soient accessible en écriture. 
  • Les pages php puissent écrire des fichiers de sessions dans le répertoire temporaire du système : il ne doit pas y avoir de restriction, notamment par SELinux.

J'ai une erreur can't write ... quand je tente de créer une institution, un utilisateur, un espace de document ou de lancer une conversion.

 Vous devez attribuer les droits en écriture aux fichiers des répertoires data et production.

J'ai une page blanche ou une erreur lorsque je télécharge un fichier dans un espace de document.

ou

Je n'arrive pas à envoyer certains fichiers dans le module de gestion.

Vérifiez dans php.ini que file_uploads = On. De plus, selon la taille maximun des fichiers que vous souhaitez envoyer par l'interface de gestion, réglez également les paramètres suivants :

Par exemple, pour 500Mo de fichiers au maximun, ajoutez 50Mo pour post_max_size et 100Mo pour memory_limit :

upload_max_filesize = 500M

post_max_size = 550M

memory_limit = 600M

Après toute modification de php.ini, vous devez relancer votre serveur web.

J'ai un message "Le fichier de document devrait posséder l'extension .sxw ..." quand je télécharge un document.

Ce message est "normal" : pour des raisons de gestion de processus, il est préférable de ne pas avoir à utiliser OpenOffice lors de la conversation. Le plus simple est d'enregistrer votre fichier DOC avec OpenOffice en SXW sur votre poste de travail et d'utiliser le fichier SXW pour la conversion.

Si vous désirez tout de même convertir directement des fichiers DOC, il sera nécessaire d'installer correctement OpenOffice comme indiquer dans la documentation. Notez que dans ce cas, une seule conversion est possible en simultanée, OpenOffice ne permettant pas d'enregistrer simultanément des fichiers.

Lorsque je clique sur "Traitement complet" rien ne se passe.

La plupart du temps, il s'agit d'une erreur dans le chemin d'accès au binaire de php (dossier.installation.php) dans pcd.properties. Pour connaître son emplacement, vous pouvez utiliser la commande "which php". Si le fichier porte un nom différent, créez un lien vers celui-ci, nommé "php".

Lorsque je clique sur "Traitement complet", j'obtiens une page blanche au bout de 30sec d'attente ou un "temps d'attente dépassé".

Trois erreurs de configuration peuvent causer ce problème :

  • Votre version de php est trop ancienne. Le module de gestion nécessite php version >= 4.3 pour Linux et php version >= 5.0 pour Windows.
  • Le répertoire "production" n'est pas accessible en écriture pour les pages php (utilisateur de votre serveur web).
  • PHP est installé en CGI : pour des raisons de gestion de processus, le module de gestion ne peut fonctionner qu'avec PHP installé en tant que module. Reportez-vous à la documentation de PHP (www.php.net) et de votre serveur web.

Dans la page de résultat du traitement, j'ai uniquement le message : JAVA_HOME not defined correctly...

Vous avez omis d'ajouter la variable d'environnement JAVA_HOME à votre système ou à votre fichier httpd.conf. 

Par exemple : SetEnv JAVA_HOME /usr/jdk1.6.0 (attention aux espaces)  

Pensez relancer votre serveur web après modification de la configuration.

Dans la page de résultat du traitement, j'ai un message "file not found" suivi d'une erreur fatale.

Le nom du fichier document à convertir contient sûrement des espaces ou des caractères spéciaux. Supprimez le fichier et renommez-le. Choisissez toujours des noms de fichiers simples. Par exemple : nomauteur_prenom.sxw.

Lors d'une conversion, j'ai une erreur similaire à : java.lang.InternalError: Can't connect to X11 window server using ':5' as the value of the DISPLAY variable.

La plupart du temps, il s'agit simplement d'une mauvaise configuration dans le fichier pcd.properties. Vérifiez que les paramètres dossier.installation.xvfb et CD_DISPLAY soient correctes.

Pour connaître le chemin d'accès à Xvfb, vous pouvez utiliser la commande which Xvfb. Si Xvfb n'est pas installé, téléchargez le package pour votre distribution. a noter que si aucun serveur X n'est installé sur votre machine, vous ne pouvez pas utiliser Cyberdocs.

Pour CD_DISPLAY, il s'agit de la valeur attribuée à la variable d'environnement DISPLAY : il faut donc utiliser une valeur qui n'est jamais utilisée par une autre application. Si vous désirez des informations sur le fonctionnement d'un serveur X, consulter la documentation de Xorg . La plupart du temps, un valeur à :5 ne pose pas de problème.

Dans la page de resultat du traitement, j'ai une exception java out of memory pour certains documents, que faire ?

Vous pouvez augmenter la mémoire autorisée pour la JVM. Vous avez la possibilité de le faire de façon global pour votre système (voir la doc de votre JVM) ou spécifiquement pour Cyberdocs en modifiant le fichier "ant.bat" et en modifiant le paramètre -Xmx500m.

POUR LES FICHIERS PDF : 

Il s'agit d'un problème non résolu : pour les documents très gros, les fichiers PDF d'impression ne se génèrent pas complètement.

Une solution est de créer vous-même les PDF, par exemple depuis la version HTML ou XHTML. A noter qu'il vous faudra créer un fichier PDF par partie de niveau 1 du document et un fichier PDF complet. Le plus simple est d'observer comment sont créés les fichiers PDF sur un document correctement converti.

Ce problème est provoqué par le convertisseur XML vers PDF utilisé (FOP). Une solution de remplacement est en cours d'étude. 

Un problème important est survenu pendant une conversion et elle est toujours indiquée comme "en cours" alors que ce n'est plus cas.

Editez le fichier batch.dat situé dans le répertoire php/data. Recherchez l'identifiant du document et supprimez la ligne correspondante. Enregistrez le fichier.

ATTENTION : respectez le format du fichier et ne rajoutez pas de ligne "vide". 

J'ai perdu le mot de passe administrateur du module de gestion, comment le réinitialiser ?

Editez le fichier config.dat situé dans le répertoire php/data. Recherchez l'identifiant de l'utilisateur et supprimez l'empreinte du mot de passe (un grand code entre deux ":"). Le ligne doit ressembler à :  "cdadm:root::admin".

J'ai une erreur non listée ici et aucun message d'erreur pour me guider, que faire ?

Si l'erreur concerne le module de publication, la première étape consiste à consulter les fichiers de logs de SDX qui se trouvent dans le répertoire webapps\sdx\WEB-INF\logs. Vous pouvez également consulter ceux de votre moteur de servlets.

D'une façon générale, vous pouvez demander de l'aide sur les listes de discussions. Prenez le temps de consulter les archives, votre question a très certainement déjà été posée. Enfin, si vous rencontrez un problème auquel vous avez trouvé une solution, n'hésitez à le signaler sur la liste, il pourrait intéresser d'autres utilisateurs et être ajouté à cette page.