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

  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

    <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

      yum install libgnomevfs-2.so.0

      cd  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

         #

         # openoffice This shell script takes care of starting and stopping

         # openoffice server.

         #


          # See how we were called.

          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