wiki:SCENARInuxeo
Last modified 3 weeks ago

SCENARInuxeo

SCENARInuxeo est le fruit du  projet ANR C2M.

Introduction

SCENARInuxeo est une intégration visant à intégrer les fonctionnalités de SCENARI dans l'environnement de  GED Nuxeo. Il s'agit d'une solution client serveur comparable au couple SCENARIserver/SCENARIclient. Elle en diffère par des fonctionnalités supplémentaires, spécifiques à la GED : gestion avancée des droits, support des versions, etc...

Démonstration

Cette page présente l'installation et la configuration de SCENARInuxeo. Vous pouvez directement évaluer cette intégration en vous connectant à la version de démonstration, déployée à cette adresse :  http://demo-nuxeo.scenari.eu/nuxeo

Installation

SCENARInuxeo est disponible sous deux formes (Tomcat et JBoss) en version 4.0.111 à cette adresse :  http://demo-nuxeo.scenari.eu/releases/4.0.111/SCENARInuxeo/ . Nous recommandons d'utiliser la distribution Tomcat.

Il s'agit d'une distribution standard de Nuxeo DM 5.4.0.1 augmentée des plugins et des dépendances de SCENARI. L'installation et la configuration sont donc propres à Nuxeo.

Très brièvement, le fichier bin/nuxeo.conf centralise la configuration du serveur tandis que l’exécutable bin/nuxeoctl permet de lancer et d'arrêter le serveur.

Pour de plus amples informations, référez-vous au pages suivantes de la documentation de Nuxeo :

Logiciels requis

Nuxeo et SCENARI requiert des applications et utilitaires tiers pour fonctionner correctement. En voici la liste :

  •  OpenOffice : privilégier la version d'OpenOffice.org plutôt que celle des distributions Linux
  • ImageMagick
  • pdftohtml
  • wpd2text

Ces trois derniers logiciels s'installent sur une Debian ou une Ubuntu par apt-get install imagemagick poppler-utils libwpd-tools

Les clients

L'usage du système requiert soit l'installation d'un client lourd (disponible à  http://demo-nuxeo.scenari.eu/releases/4.0.111/SCENARIclientNuxeo/), soit le navigateur Firefox couplé d'une extension. L'installation de cette dernière sera proposée automatiquement à la première ouverture d'un atelier SCENARI (si le serveur a été configuré dans ce sens : le fichier scenari.properties)

Les wsppacks

Les modèles documentaires doivent être recompilés avec SCENARIbuilder 4.0.111 pour être compatibles avec le serveur. Vous trouverez l'ensemble de la suite logicielle SCENARI et des modèles documentaires déjà compilés dans cette version à cette adresse :  http://demo-nuxeo.scenari.eu/releases/4.0.111 .

Base de données

Nuxeo utilise par défaut une base de donnée embarquée (H2) ne nécessitant pas de configuration mais qui n'est pas recommandé pour un usage en production. Elle suffit néanmoins à des besoins d'évaluation du produit. La base de donnée recommandée par Nuxeo en production est PostgreSQL. Sa configuration est présentée sur cette page :  Configuring PostgreSQL.

Configuration

OpenOffice

L'emplacement d'OpenOffice doit être précisé dans le fichier nuxeo.conf par la propriété jod.office.home. Exemple : jod.office.home=/opt/openoffice.org3

Le fichier scenari.properties

Un fichier scenari.properties permet de configurer les aspects spécifiques à SCENARI, principalement les caractéristiques de l'extension cliente pour Firefox. Il est situé dans le répertoire nxserver/config d'une distribution Tomcat ou dans le répertoire server/default/deploy/nuxeo.ear/config d'une distribution JBoss.

Les propriétés configurables dans ce fichier sont :

  • scenari.rootData={nuxeo.home}/data/scenari : Emplacement des données de SCENARI (obligatoire)
  • scenari.imagemagick.dir=/opt/local/bin : Emplacement d'ImageMagick si non disponible par la variable PATH du système (optionnel)
  • scenari.extension.url=http://demo-nuxeo.scenari.eu/extension/ScenariClientFx%201.0.4.xpi : Emplacement de l'extension cliente (optionnel)
  • scenari.extension.id=scenariclientfx1.0@scenari : Identification de l'extension (obligatoire si scenari.extension.url défini)
  • scenari.extension.minVersion=1.0.4 : Version minimale de l'extension (obligatoire si scenari.extension.url défini)
  • scenari.extension.maxVersion=1.0.4 Version maximale de l'extension (obligatoire si scenari.extension.url défini)

Erreurs et solutions

Erreur au premier démarrage

Si vous rencontrez l'erreur suivante au premier démarrage, arrêtez et redémarrez le système. L'erreur ne se reproduira pas. 

ERROR [XSDLoader] FatalError: java.io.FileNotFoundException: /../nxserver/schemas/core-types.xsd (No such file or directory)
ERROR [TypeService] java.io.FileNotFoundException: /../nxserver/schemas/core-types.xsd (No such file or directory)
java.io.FileNotFoundException: /../nxserver/schemas/core-types.xsd (No such file or directory)
	at com.sun.xml.xsom.impl.parser.NGCCRuntimeEx.parseEntity(NGCCRuntimeEx.java:258)
	...

Installation de l'extension

(Corrigé en 4.0.110)

Si vous utilisez l'extension pour Firefox, vous serez amené à redémarrer plusieurs fois le navigateur lors de l'installation. Il existe un problème à ce niveau : il ne faut pas laisser Firefox redémarrer de lui même. A chaque fois que cela vous sera proposé, annulez puis fermez et redémarrer Firefox manuellement.

Si vous oubliez ce point, l'installation de l'extension vous sera reproposé à l'ouverture d'un atelier. Vous pouvez, à postériori, revenir à un fonctionnement normal en redémarrant manuellement.

Annexes