Recherche
Rappel
Esup-ECM correspond à un packaging de Nuxeo permettant de faciliter son installation et sa configuration par rapport aux besoins ressentis dans le projet Esup-ECM. Aussi, installer Esup-ECM correspond bel et bien à installer Nuxeo (Esup-ECM donne des orientations dans les possibilités de configurations offertes par Nuxeo).
Les chapitres abordés dans la documentation d'installation sont:
Nuxeo est prévu pour être installé sur une machine unix (Par exemple Linux).
Note
Une installation Windows est possible mais certains scripts ne fonctionneront pas sur cette plateforme.
On s'attend à trouver sur la machine un JDK en version 5 ou 6.
Nuxeo fonctionne avec un serveur d'applications JBOSS (livré avec le package ESUP-ECM). Nous recommandons de créer un utilisateur dédié (par exemple jboss) qui sera utilisé pour faire faire tourner JBOSS.
Attention
L'utilisateur jboss doit avoir un JAVA_HOME, pointant vers un JDK, positionné dans son .basrc. Exemple:
export JAVA_HOME=/opt/jdk1.5.0
On s'attend également à ce que ant soit présent sur la machine.
Nuxeo nécessite une base de données transactionnelle avec un mécanisme de sauvegarde en ligne. Il est conseillé d'utiliser un serveur permettant de sauvegarder/restaurer les données de façon incrémentale. Pour cette raison, cette version de ESUP-ECM est préconfigurés pour PostgreSQL.
Avec Nuxeo 5.1.6 (utilisé dans EsupEcm jusqu'à la version 0.3.1 d'Esup-Ecm), la version 8.3 n'était pas encore officiellement supportée par Nuxeo, on conseillait alors l'utilisation d'un serveur postgreSQL en version 8.1 ou 8.2.
A partir de la version 5.2 de Nuxeo (0.4 pour Esup-Ecm), il faut désormais priviligier une base de données 8.3.4+.
Mêle si Nuxeo recommande/privilégie l'utilisation de PostgreSQL, Nuxeo fonctionne aussi avec mysql . Dans ce cas, il est nécessaire d'utiliser le service de gestion des transactions InnoDB.
Vérifiez la présence de la ligne suivante dans my.cnf : default-storage_engine = innodb
Nous recommandons de créer deux bases :
Pour mysql, le script sql de création des bases pourrait ressembler à :
Pour PostgreSQL (depuis Nuxeo 5.2), en plus de créer la Base, il vous faut également sur la base de données qui contiendra le repository (nuxeo_storage ici) exécuter cette requête :create user nuxeo;
set password for 'nuxeo'@'%' = password('XXXXX');
create database `nuxeo` default character set utf8 collate utf8_general_ci;
grant all privileges on nuxeo.* to 'nuxeo'@'%';
create database `nuxeo_storage` default character set utf8 collate utf8_general_ci;
grant all privileges on nuxeo_storage.* to 'nuxeo'@'%';
Sans cela, vous obtenez quelque chose comme :create language plpgsql;
Pour vous aider à persuader vos chefs ou collaborateurs de ne pas utiliser MySQL avec Nuxeo
Reportez vous à la documentation suivante: FAQ > Des raisons pour éviter d'utiliser MySQL avec Nuxeo
L'utilisation du serveur Open Office est recommandée . Ce serveur (et son patch nuxeo) transforme à la volée les documents (de tout format) en format pdf.
Son installation est détaillée dans cette page.
note
Si vous utilisez un serveur proxy il faut :
<settings> <proxies> <proxy> <active>true</active> <protocol>http</protocol> <host>proxy-host.domain.org</host> <port>1234</port> <nonProxyHosts>*.univ.fr|localhost</nonProxyHosts> </proxy> </proxies> </settings>
Paramètre |
Description |
Exemple |
---|---|---|
nuxeo.dir.parent |
Répertoire où sera déployé l'application |
/opt/nuxeo |
nuxeo.url |
URL utilisé pour les interactions avec CAS lors de différentes actions (login, logout). Le port correspond à tomcat.port.http si tomcat est utilisé directement. En cas d'utilisation d'un frontal apache, le port à utiliser ici est celui du frontal. |
|
jboss.bind.address |
Interface réseau sur laquelle le serveur JBOSS écoute (0.0.0.0 pour écouter sur toutes les interfaces) Voir plus bas section "Interfaces réseau" |
147.127.96.21 |
jboss.console.log |
Fichier de trace de la console jboss. Il se trouve par défaut sous <nuxeo.dir.parent>/nuxeo-5.1.6.GA/server/default/log |
/var/log/nuxeo-console.log |
jboss.server.log |
Fichier de trace du serveur jboss. Il se trouve par défaut sous <nuxeo.dir.parent>/nuxeo-5.1.6.GA/server/default/log |
/var/log/nuxeo.log |
db.type |
Le type de la base de données utilisée . |
MySQL |
db.user |
Nom de l'utilisateur pouvant lire et écrire dans les bases de données |
|
db.password |
Mot de passe conrespondant à l'utilisateur défini par db.user |
e-%truc! |
db.driver |
Nom de la classe java du driver JDBC |
com.mysql.jdbc.Driver |
db.schema |
Nom du schéma |
mysql |
db.url |
Chaîne de connexion à la base de données nuxeo |
jdbc:mysql://localhost/nuxeo |
db.mysql.jena.url |
Particularité mysql : le paramètre relaxAutoCommit=true permet d'éviter les messages d'erreur lors des transactions quand autocommit=true |
jdbc:mysql://localhost/nuxeo?relaxAutoCommit=true |
db.mysql.compass.url |
Particularité mysql : idem paramètre précédent avec en plus emulateLocators=true permettant à compass de supporter les BLOBS |
jdbc:mysql://localhost/nuxeo?relaxAutoCommit=true&emulateLocators=true |
db.sql.server |
Serveur de la base de données sql-storage |
localhost |
db.sql.port |
Port de base de données sql-storage |
3306 si base mysql |
db.sql.db |
Nom de la base de données sql-storage |
nuxeo_storage |
db.sql.user |
Utilisateur de la base de données sql-storage (si rep.type=sql) |
|
db.sql.password |
Mot de passe correspondant à l'utilisateur de la base de données sql-storage (si rep.type=sql) |
|
jdk.home |
Chemin d'accès au JDK |
/opt/jdk1.5.0 |
jboss.user |
Nom de l'utilisateur qui lancera le serveur d'application jboss |
jboss |
tomcat.port.http |
port HTTP utilisé par le tomcat embarqué par jboss pour répondre aux requêtes HTTP |
8080 |
tomcat.port.jk |
port AJP utilisé par le tomcat embarqué par jboss pour répondre aux requêtes AJP (utilisé dans le cas de l'utilisation d'un frontal apache) |
9554 |
cas.url |
URL d'accès au serveur CAS de l'établissement |
|
ldap.url |
URL d'accès au serveur LDAP de référence |
ldap://ldap.univ.fr:389 |
ldap.user.searchBaseDn |
Base DN utilisé lors des recherches d'utilisateurs dans le LDAP |
ou=people,dc=univ,dc=fr |
ldap.user.firstName |
Attribut LDAP contenant le nom des l'utilisateurs |
givenName |
ldap.user.lastName |
Attribut LDAP contenant le nom complert à afficher pour les l'utilisateurs |
sn |
ldap.user.company |
Attribut LDAP contenant l'organisme de rattachement des utilisateurs |
supannOrganisme |
ldap.user.email |
Attribut LDAP contenant l'adresse électronique des utilisateurs |
|
ldap.user.defaultAdministratorId |
UID de l'administrateur de la plateforme |
|
ldap.group.searchBaseDn |
Base DN utilisé lors des recherches de groupes dans le LDAP |
ou=groups,dc=univ,dc=fr |
local.logo.path |
Nom complet du logo de l'établissement |
|
local.banner.background.path |
Nom complet de l'image de fond de la bannière supérieure |
|
openoffice.home |
Répertoire d'installtion du serveur Open Office |
/opt/openoffice |
openoffice.port |
Port d'écoute du serveur Open Office |
8100 |
Le serveur se lance grâce au script run.sh et s'arrête avec shutdown.sh, tous deux présents dans le répertoire d'installation (nuxeo.dir.parent/ du build.properties).
Ces scripts sont appelés par la commande jbossctl
Démarrage :
sh <nuxeo.dir.parent>/nuxeo-ep-5.2.0-RC1/bin/jbossctl start &
Arrêt :
sh <nuxeo.dir.parent>/nuxeo-ep-5.2.0-RC1/bin/jbossctl stop &
La valeur par défaut 0.0.0.0 du paramètre jboss.bind.address décrit plus haut, permet d'écouter sur toutes les interfaces.
Pour restreindre l'écoute à une interface précise, il faut préciser l'IP à utiliser. Si Nuxeo est derrière un frontal Apache, il faut s'assurer que l'IP indiquée corresponde à celle du VirtualHost.
En l'absence de valeur pour ce paramètre, le serveur n'écoutera que sur le loop back (127.0.0.1).
Les logs du serveur sont par défaut générés dans <nuxeo.dir.parent>/nuxeo-ep-<nuxeo-version>/server/default/log/server.log
Cet emplacement est modifiable par le paramètre jboss.server.logdécrit plus haut.
On peut modifier la façon dont vont être générés les logs par le fichier <nuxeo.dir.parent>/nuxeo-ep-<nuxeo-version>/server/default/conf/jboss-log4j.xml
Vous pouvez installer le serveur Open Office en vous reportant à cette page.