Installation minimale de Nuxeo 5.4.1

Cette page décrit les opérations minimales pour faire fonctionner nuxeo 5.4.1.

Pour une configuration plus poussée (intégration de CAS ou Shibboleth, personnalisation ... se référer aux pages explicatives concernées).

1. Pré-requis :

- Système d'exploitation Unix (Linux) conseillé mais il reste néanmoins possible d'installer Nuxeo sous Windows.

- JDK 6 installé

- Serveur de bases de données installé. Types supportés par Nuxeo : Postgresql (conseillé), Mysql, MSSQL et Oracle.

- OpenOffice 3 installé (uniquement si vous souhaitez utiliser la prévisualisation de fichiers ou la transformation à la volée en PDF).

2. Récupération de la release de nuxeo :

wget http://community.nuxeo.com/static/releases/nuxeo-5.4.1/nuxeo-dm-5.4.1-tomcat.zip
unzip nuxeo-dm-5.4.1-tomcat.zip

3. Configuration de la base de données :

3.1 Configuration Postgres :

Nuxeo supporte Postgres à partir de la version 8.3.

Quelques modifications à apporter au fichier postgresql.conf :

A indiquer de façon obligatoire à partir de la version 8.4 de postgres sinon déclenche des exceptions dans nuxeo (javax.transaction.HeuristicMixedEception)

max_prepared_transactions = 64

Dans un cadre de production, les paramètres ci-dessous peuvent améliorer les performances :

shared_buffers = 1GB
effective_cache_size = 2GB
work_mem = 32MB
maintenance_work_mem = 128MB
wal_buffers = 8MB
random_page_cost = 2

Se reporter à la documentation de Nuxeo pour plus de détails

Créer ensuite la base de données :

su - postgrespsql template1
CREATE FUNCTION pg_catalog.text(integer) RETURNS text STRICT IMMUTABLE LANGUAGE SQL AS 'SELECT textin(int4out($1));';
CREATE CAST (integer AS text) WITH FUNCTION pg_catalog.text(integer) AS IMPLICIT;
COMMENT ON FUNCTION pg_catalog.text(integer) IS 'convert integer to text';
CREATE FUNCTION pg_catalog.text(bigint) RETURNS text STRICT IMMUTABLE LANGUAGE SQL AS 'SELECT textin(int8out($1));';
CREATE CAST (bigint AS text) WITH FUNCTION pg_catalog.text(bigint) AS IMPLICIT;
COMMENT ON FUNCTION pg_catalog.text(bigint) IS 'convert bigint to text';
CREATE LANGUAGE 'plpgsql';
CREATE USER nuxeo WITH PASSWORD '123456';
CREATE DATABASE nuxeo ENCODING 'UTF8' OWNER nuxeo;

4. Configuration du template

Depuis la Version 5.3.2, Nuxeo utilise la notion de templates ainsi qu'un fichier nuxeo.conf pour faciliter et regrouper les options de configuration.

Vous trouverez plus de détails sur la façon d'utiliser les templates ainsi que sur les options disponibles dans nuxeo.conf dans la page de documentation dédiée.

Pour une configuration minimale, renseigner simplement le fichier nuxeo.conf (sous ?nuxeo-dm-5.4.1-tomcat/bin) avec les paramètres de votre base de données et choisissez le template correspondant à cette dernière :

nuxeo.db.name=nuxeo
nuxeo.db.user=nuxeo
nuxeo.db.password=123456
nuxeo.db.host=127.0.0.1
nuxeo.db.port=5432
nuxeo.templates=postgresql

Vous pouvez maintenant démarrer Nuxeo (nuxeo-dm-5.4.1-tomcat/bin/nuxeoctl start).

NB : il existe également un wizard qui vous permet de renseigner via une interface graphique les paramètres de connexion à la base de données, ce wizard se lance automatiquement si vous démarrez directement nuxeo sans avoir modifié le fichier nuxeo.conf. Dans le cadre d'une configuration avancée de nuxeo, il reste néanmoins conseillé de ne pas utiliser le wizard et de s'appuyer sur les templates, notamment le tempalte custom.

5. Configuration avancée

- Utilisation de l'authentification CAS et d'une annuaire LDAP : se référer à cette page

- Utilisation de l'authentification Shibboleth : se référer à cette page

- Personnaliser Nuxeo : se référer à cette page