Nuxeo - Installation avancée

Prérequis

Installation

Cette installation présuppose l'installation de ESUP-ECM 1.0 ou Nuxeo DM 5.2.

La documentation d'installation d'ESUP-ECM se trouve ici.

Préparation

Avant de procéder à la configuration, il est nécessaire de copier le fichier init-build.properties en build.properties:

cp init-build.properties build.properties

Configuration

Les différents paramètres à configurer dans le fichier build.properties sont :

jboss.dir

Chemin vers le serveur JBOSS de Nuxeo. Par exemple: 

jboss.dir=/usr/local/ori/esup-ecm/nuxeo-dm-5.2.0

nuxeo.url

Ceci représente l'URL publique du serveur Nuxeo. Il est préférable ici de mettre l'URL du frontal Apache. En effet, c'est cette URL qui sera utilisée dans le référencement des fiches de métadonnées. Exemple:

nuxeo.url=http://ori-oai.mon_etablissement.fr/nuxeo

workflow.ws.url

Ce paramètre correspond à l'URL du web service exposé par le module ori-oai-workflow. Elle doit être du genre:

workflow.ws.url=http://localhost:8181/ori-oai-workflow/xfire/OriWorkflowService

Lors d'un référencement, l'utilisateur devra saisir des métadonnées dans la pop-up de ori-oai-md-editor.
Pour que cette pop-up puisse se fermer automatiquement, il est nécessaire que les 2 modules ori-oai-nuxeo et ori-oai-md-editor soient accessibles via le même nom d'hôte.
Ceci peut s'avérer compliqué par défaut dans le cas où on à une installation du genre:

Dans ce cas, la solution est de configurer votre serveur Apache pour que le module ori-oai-md-editor puisse aussi être appelé par l'hôte stockage.mon-univ.fr
Dans ce cas, les 2 URL suivantes correspondent à la même entité :

Le module ori-oai-md-editor est donc accessible par 2 URL différentes.

En revanche, par défaut, ori-oai-nuxeo a connaissance de la première URL qui est dans notre exemple http://orioai.mon-univ.fr/ori-oai-md-editor.
Il faut donc établir une correspondance et informer ori-oai-nuxeo via les paramètres mdEditor.from.url et mdEditor.to.url.

mdEditor.from.url

Correspond à l'URL définie par défaut pour le module ori-oai-md-editor.
Dans notre exemple, on aura:

mdEditor.from.url=http://orioai.mon-univ.fr/ori-oai-md-editor

mdEditor.to.url

Correspond à l'URL du ori-oai-md-editor avec le même nom d'hôte que ori-oai-nuxeo.
Dans le cas où le nom d'hôte de ori-oai-nuxeo et ori-oai-md-editor sont identiques pas défaut, ce paramètre doit rester vide.

Dans les autres cas, vous pouvez aussi laisser ce paramètre vide, la seule incidence sera que la pop-up de ori-oai-md-editor ne se fermera pas automatiquement au moment où l'utilisateur enregistrera sa fiche de métadonnées.
Dans notre exemple, on aura:

mdEditor.to.url=http://stockage.mon-univ.fr/ori-oai-md-editor

Déploiement

A cette étape, il ne reste plus qu'à déployer le module via la commande :

ant all

Module complémentaire: esup-webengine-versions

Si vous utilisez un Nuxeo DM sans passer par ESUP-ECM, il est nécessaire d'installer le composant esup-webengine-versions. Vous pouvez vous reportez à cette documentation pour plus de détails.
Ce composant permet de visualiser des versions de documents stockés dans nuxeo. L'URL des documents qui est remplie automatiquement dans la fiche de métadonnées n'est compréhensible que si ce module est installé.

Dans le cas où vous avez installé ESUP-ECM, cette étape n'est pas nécessaire: esup-webengine-versions est inclus dans ESUP-ECM.

  • No labels