Pré-requis

ESUP-ECM est prévu pour être installé sur une machine unix (Par exemple Linux).

On s'attend à trouver sur la machine un JDK en version 5 (La version 6 n'est pas encore officiellement supportée par nuxeo).

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.

On s'attend également à ce que ant et maven soient présents sur la machine. De plus, maven doit être présent dans le path (exemple, si besoin, de positionnement du path : export PATH=$PATH:/opt/apache-ant-1.7/bin:/opt/apache-maven-2.0.9/bin)

De même, ESUP-ECM 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. La version 8.3 n'étant pas encore officiellement supportée par nuxeo nous vous demandons d'avoir accès un serveur postgreSQL en version 8.1 ou 8.2.

ESUP-ECM 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 :

• Une base pour la gestion du repository des documents : nuxeo_storage
• Une base pour tous les autres besoins (indexation,recherche,gestion des relations,...)  de la solution : nuxeo

 Pour mysql, le script sql de création des bases pourrait ressembler à :

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'@'%';

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.

Installation

Résumé

• Télécharger esup-ecm-<version>.zip depuis le site du projet
• Décompresser le fichier dans un répertoire de travail
• Copier le fichier build-example.properties en build.properties
• Adapter le contenu du fichier build.properties. Cf. paragraphe suivant pour plus d'informations.
• Positionner JAVA_HOME (ex : export JAVA_HOME=/opt/jdk1.5.0)
• Lancer la commande ant deploy

  Remarque
  title note
  Si vous utilisez un serveur proxy il faut : Pour ANT : Définir les variables d'environnements  export ANT_OPTS="-Dhttp.proxyHost=proxy-host.domain.org -Dhttp.proxyPort=1234" pour les téléchargements initiaux. Pour NAVEN : Editer le fichier .m2/settings.xml contenu dans votre home_dir Bloc de code <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>

• Créer l'utilisateur défini par la valeur de jboss.user
• Attribuer les droits d'exécution aux shells sous <nuxeo.dir.parent>/nuxeo-ep-5.1.6.GA/bin
• Lancer le serveur par sh <nuxeo.dir.parent>/nuxeo-ep-5.1.6.GA/bin/jbossctl start &
• Tester http://<nomServeur>:<portHttpToncat>/nuxeo

Paramètres du build.properties

Installation du serveur Open Office

Consultez la page de référence à ce sujet : http://doc.nuxeo.org/5.1/books/nuxeo-book/html/admin-openoffice.html

Installation du serveur X virtuel

   Récupérer et installer un paquet Xvbf
   par exemple, sur RedHat :  yum install XFree86-Xvfb-4.3.0-69.EL.x86_64.rpm

Installation OpenOffice 2.4

    Il est conseillé d'installer la version 2 de openOffice.

    Consultez le guide d'installation officiel : http://fr.openoffice.org/Documentation/Guides/SETUP_GUIDE_FR08_1.pdf

Par exemple, sur un serveur RedHat :

  
  cd /tmp
  wget http://openoffice.cict.fr/stable/2.4.2/OOo_2.4.2_LinuxIntel_install_en-US.tar.gz_
  tar -zxvf OOo_2.4.2_LinuxIntel_install_en-US.tar.gz
  cd OOH680_m18_native_packed-1_en-US.9364/RPMS/
  rpm -ivh *.rpm

 Configuration de OpenOffice pour Nuxeo

     Deux extensions Nuxeo permettent de configurer OpenOffice en mode serveur de façon permanente.

  cd <path/to/esup-ecm>/esup-ecm-0.3
  svn co http://svn.nuxeo.org/nuxeo/tools/ooo-package/linux nxOOo
  cd nxOOo
  cp patch/bootstraprc <path/to/openoffice>/program/   
  <path/to/openoffice>/program/unopkg add --shared patch/nxSkipInstallWizard.oxt (permet d'utiliser OO tout de suite après l'installation)
  <path/to/openoffice>/program/unopkg add --shared patch/nxOOoAutoListen.oxt     (permet de faire fonctionner OO en mode écoute de façon permanente)

Lancement/Arret de OOo en mode serveur

       Voici un exemple de script shell appelé  nxopenoffice :                 

 
         #!/bin/sh
         #
         # chkconfig: 345 97 1
         # description: this shell script takes care of starting and stopping
         # openoffice server.

          case "$1" in

            start)
              echo "Starting openoffice: "
              Xvfb :8100 2>/dev/null &
             sleep 5
             /opt/openoffice.org2.4/program/soffice.bin -headless "-accept=socket,host=localhost,port=8100;urp;StarOffice.Service" 2>/dev/null &
             echo
           ;;

          stop)
             ps -aef|grep "program/soffice.bin" | grep -v grep|cut -c10-15 >/var/run/ooo.pid
            val=`head /var/run/ooo.pid`
             if [ -n $val ]
              then
                 kill $val 2>/dev/null && echo "Shutting down openoffice: " $val
              fi
             ps -aef|grep "Xvfb" | grep -v grep|cut -c10-15 >/var/run/xvfb.pid
             val=`head /var/run/xvfb.pid`
            if [ -n $val ]
               then
                kill $val 2>/dev/null && echo "Shutting down virtual xterm: " $val
           fi   
           echo
          ;;

          restart)
             $0 stop
             $0 start
          ;;

          status)
            echo "Servers listening on port 8100 :"
            netstat -na | grep :8100 | wc -l
            netstat -na | grep :8100
            echo "openoffice processes :"
            ps -aef | grep -i program/soffice | grep -v grep
            echo "X processes :"
            ps -ef | grep -i xvfb | grep -v grep
        ;;

      *)
          echo "Usage: nxopenoffice [start|stop|restart|status]\n"
          exit 1

      esac

     exit 0

      Note : ne pas oublier de positionner JAVA_HOME