Installation minimale de Nuxeo 5.4.1

Introduction

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).

Pré-requis

Système d'exploitation

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

Java

Un JDK 6 ou supérieur est recommandé.

Base de données

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. Il est possible d'installer nuxeo avec les bases de données suivantes :

• PostgreSQL (version 8.3+)
• MySQL
• MSSQL
• Oracle

Sachez toutefois que Nuxeo recommande l'utilisation de PostgreSQL.

OpenOffice

La présence d'une installation d'OpenOffice 3 peut être nécessaire si vous souhaitez utiliser la prévisualisation de fichiers ou la transformation à la volée en PDF.

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

Configuration de la base de données

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