scenari
 

SCENARIserver3.2 Linux

SCENARIserver doit être installé comme une webapp dans un serveur de servlet comme Tomcat.
Cette webapp peut soit partager un serveur de servlets avec d'autres applications, soit être installée dans un serveur dédié.

Création d'un SCENARIserver dédié :

Prérequis

  • Téléchargez les constituants du serveur:
    • Téléchargez la JRE 1.5 de SUN (prendre Linux (self-extracting file))
    • Téléchargez la librairie de manipulation d'images JAI (utilisé par SCENARI pour toutes les manipulations d'images)
    • Téléchargez le serveur de servlet Tomcat
  • Téléchargez les éléments nécessaires à la construction de la webapp SCENARIserver :
  • SCENARIserver doit se connecter à OpenOffice pour plusieurs types de générations or OpenOffice à besoin d'un serveur X pour fonctionner. Bien que dans le cadre de SCENARIserver OpenOffice puisse se connecter au serveur X11 présent par défaut sur la machine (souvent sur le DISPLAY 0) il est conseillé de lancer un serveur X spécifiquement pour OpenOffice. Dans cet exemple nous allons utiliser un serveur xvfb, serveur X virtuelle.
    • Assurez vous d'avoir OpenOffice d'installé, par ailleurs assurez vous que OpenOffice se lance bien sous le login choisi pour SCENARIserver (dans notre exemple SCENARIserver sera lancé en temps que root)
    • Assurez vous d'avoir xvfb d'installé (xvfb est disponible pour la majorité des distributions Linux).

Construction du serveur

Dans cet exemple nous allons installer SCENARIserver dans le dossier /opt qui est l'endroit usuelle pour l'installation d'éléments extérieurs à la distribution Linux.

  1. créez le dossier /opt/SCENARIserver3.2/ 
    [root@kelispost01 ~]# mkdir /opt/SCENARIserver3.2
[root@kelispost01 ~]# cd /opt/SCENARIserver3.2
[root@kelispost01 SCENARIserver3.2]#
  2. installez la JRE de SUN dans /opt/SCENARIserver3.2/jre 
    [root@kelispost01 SCENARIserver3.2]# cp /home/sam/downloads/jre-1_5_0_10-linux-i586.bin .
[root@kelispost01 SCENARIserver3.2]# chmod u+x jre-1_5_0_10-linux-i586.bin 
[root@kelispost01 SCENARIserver3.2]# ./jre-1_5_0_10-linux-i586.bin 
Sun Microsystems, Inc.  Binary Code License Agreement
...
Done.
[root@kelispost01 SCENARIserver3.2]# mv jre1.5.0_10/ jre
[root@kelispost01 SCENARIserver3.2]# rm -f jre-1_5_0_10-linux-i586.bin
  3. installez la librairie JAI dans la JRE (dans /opt/SCENARIserver3.2/jre) 
    [root@kelispost01 SCENARIserver3.2]# cd jre
[root@kelispost01 jre]# cp /home/sam/downloads/jai-1_1_3-lib-linux-i586-jre.bin .
[root@kelispost01 jre]# chmod u+x jai-1_1_3-lib-linux-i586-jre.bin 
[root@kelispost01 jre]# ./jai-1_1_3-lib-linux-i586-jre.bin 
Sun Microsystems, Inc.
...
Done.
[root@kelispost01 jre]# rm -f jai-1_1_3-lib-linux-i586-jre.bin
  4. décompressez Tomcat dans /opt/SCENARIserver3.2/tomcat 
    [root@kelispost01 jre]# cd ..
[root@kelispost01 SCENARIserver3.2]# cp /home/sam/downloads/apache-tomcat-6.0.10.zip .
[root@kelispost01 SCENARIserver3.2]# unzip apache-tomcat-6.0.10.zip 
[root@kelispost01 SCENARIserver3.2]# mv apache-tomcat-6.0.10 tomcat
[root@kelispost01 SCENARIserver3.2]# rm -f apache-tomcat-6.0.10.zip
[root@kelispost01 SCENARIserver3.2]# chmod a+x /opt/SCENARIserver3.2/tomcat/bin/*.sh
  5. Intégrez SCENARIserver3.2 dans les scripts de démarrage de Linux pour en faire un service.
    Créez le script de démarrage /etc/init.d/SCENARIserver3.2 avec le contenu précisé ici 
    [root@kelispost01 SCENARIserver3.2]# cd /etc/init.d/
[root@kelispost01 init.d]# nano SCENARIserver3.2
...
[root@kelispost01 init.d]# chmod a+x SCENARIserver3.2
[root@kelispost01 init.d]# chkconfig --add SCENARIserver3.2
  6. Intégrez le serveur X xvfb dans les scripts de démarrage de Linux pour en faire un service.
    Créez le script de démarrage /etc/init.d/xvfb avec le contenu précisé ici 
    [root@kelispost01 init.d]# nano xvfb
...
[root@kelispost01 init.d]# chmod a+x xvfb
[root@kelispost01 init.d]# chkconfig --add xvfb

Construction de la webapp SCENARIserver3.2

  1. créez un dossier temporaire /tmp/scservinstall 
    [root@kelispost01 init.d]# mkdir /tmp/scservinstall
[root@kelispost01 init.d]# cd /tmp/scservinstall
[root@kelispost01 scservinstall]#
  2. décompressez ANT dans /tmp/scservinstall/ant 
    [root@kelispost01 scservinstall]# cp /home/sam/downloads/apache-ant-1.6.5-bin.zip .
[root@kelispost01 scservinstall]# unzip apache-ant-1.6.5-bin.zip 
[root@kelispost01 scservinstall]# mv apache-ant-1.6.5 ant
[root@kelispost01 scservinstall]# rm -f apache-ant-1.6.5-bin.zip
  3. décompressez SCENARIserver3.2 dans /tmp/scservinstall/setup 
    [root@kelispost01 scservinstall]# mkdir setup
[root@kelispost01 scservinstall]# cd setup/
[root@kelispost01 setup]# cp /home/sam/downloads/SCENARIserver_3.2.3beta_lin.tar.gz .
[root@kelispost01 setup]# tar xzf SCENARIserver_3.2.3beta_lin.tar.gz
  4. éditez le fichier build.property et paramétrez le comme suis: 
    [root@kelispost01 setup]# nano build.property 
...

    # SCserver - fichier de configuration de la WebAPP
server.webapp.name=SCENARIserver3.2
server.work.path=/var/opt/SCENARIserver3.2
server.url=http://192.168.2.101:8080

# Configuration des applications tierces
server.appExt.ttm.path=/var/opt/SCENARIserver3.2/nativlib/ttm
server.appExt.webeq.key.path=/var/opt/SCENARIserver3.2/nativlib/.webeqrc-35
server.appExt.lame.path=/var/opt/SCENARIserver3.2/nativlib/lame
    en remplaçant server.url=http://192.168.2.101:8080 par les données relatives à votre machine
  5. posez les variables d'environnement ANT_HOME et JAVA_HOME 
    [root@kelispost01 setup]# export ANT_HOME=/tmp/scservinstall/ant
[root@kelispost01 setup]# export JAVA_HOME=/opt/SCENARIserver3.2/jre/bin
  6. exécutez le script de génération de la webapp: 
    [root@kelispost01 setup]# ./buiWebApp.sh 
Compilation, scserver
...
BUILD SUCCESSFUL
Total time: 1 second
    Vous allez obtenir un fichier SCENARIserver3.2.war qu'il faut maintenant déployer dans Tomcat.

Déploiement de la webapp SCENARIserver

  1. Copier/coller le contenu du répertoire /tmp/scservinstall/setup/libext vers /opt/SCENARIserver3.2/tomcat/lib (pour une version de Tomcat inférieure à 6 vers /opt/SCENARIserver3.2/tomcat/common/lib) 
    [root@kelispost01 setup]# cp libext/* /opt/SCENARIserver3.2/tomcat/lib
  2. Copier/coller le contenu du répertoire /tmp/scservinstall/setup/libendorsed vers /opt/SCENARIserver3.2/tomcat/endorsed (pour une version de Tomcat inférieure à 6 vers /opt/SCENARIserver3.2/tomcat/common/endorsed) 
    [root@kelispost01 setup]# mkdir /opt/SCENARIserver3.2/tomcat/endorsed
[root@kelispost01 setup]# cp libendorsed/* /opt/SCENARIserver3.2/tomcat/endorsed
  3. Créez le dossier de travail de la webapp SCENARIserver (spécifié dans le fichier build.property, server.work.path), dans notre exemple celui-ci sera /var/opt/SCENARIserver3.2 
    [root@kelispost01 setup]# mkdir -p /var/opt/SCENARIserver3.2
  4. copier/coller le contenu du répertoire /tmp/scservinstall/setup/data dans le dossier /var/opt/SCENARIserver3.2 
    [root@kelispost01 setup]# cp -R /tmp/scservinstall/setup/data/* /var/opt/SCENARIserver3.2
  5. déplacez le dossier contenant les librairies natives /var/opt/SCENARIserver3.2/nativlib vers le dossier d'installation du serveur /opt/SCENARIserver3.2 
    [root@kelispost01 setup]# mv /var/opt/SCENARIserver3.2/nativlib /opt/SCENARIserver3.2
  6. assurez-vous que les librairies natives sont bien exécutables : 
    [root@kelispost01 setup]# chmod a+x /opt/SCENARIserver3.2/nativlib/*
  7. changez éventuellement le mot de passe admin : dans le fichier /var/opt/SCENARIserver3.2/users/ac/admin/acdef.xml
  8. Copier/coller le fichier /tmp/scservinstall/setup/SCENARIserver3.2.war vers /opt/SCENARIserver3.2/tomcat/webapps/ 
    [root@kelispost01 setup]# cp SCENARIserver3.2.war /opt/SCENARIserver3.2/tomcat/webapps/

Vous êtes maintenant prêt pour tester votre nouveau serveur :

  1. démarrez le service xvfb : 
    [root@kelispost01 setup]# /etc/init.d/xvfb start
Starting Virtual Frame Buffer X Server (Xvfb) as local display :1.0
  2. démarrez le service SCENARIserver avec la commande /etc/init.d/SCENARIserver start 
    [root@kelispost01 setup]# /etc/init.d/SCENARIserver3.2 start
Starting SCENARIserver3.2 service:  Using CATALINA_BASE:   /opt/SCENARIserver3.2/tomcat
Using CATALINA_HOME:   /opt/SCENARIserver3.2/tomcat
Using CATALINA_TMPDIR: /opt/SCENARIserver3.2/tomcat/temp
Using JRE_HOME:       /opt/SCENARIserver3.2/jre
                                                           [  OK  ]
  3. testez la connection à la webapp dans un navigateur en tapant l'URL http://127.0.0.1:8080/SCENARIserver3.2/s/chain/u/ping et en vous identifiant comme admin.
  4. Utilisation : Dans SCENARIchain ou SCENARIclient ajoutez un serveur distant d'adresse http://192.168.2.101:8080/SCENARIserver3.2 par exemple (selon la config définie dans build.property).

Procédure d'installation sur un serveur Tomcat existant :

  • Télécharger SCENARIserver
  • Installer openoffice.org 2.x.x), vérifier qu'il s'exécute correctement
  • Ajoutez la ligne suivante dans votre script de démarrage tomcat : "export OOO_DISABLE_RECOVERY=1" (pour éviter que les générations ne soit bloquées par des boites de dialogues de récupérations de fichier, comme expliqué dans : http://wiki.services.openoffice.org/wiki/Environment_Variables)
  • Décompresser le tarball
  • Construction de la web APP
    • Assurez-vous qu'une JVM 1.5 de SUN et que ant sont correctement installés sur la machine. Les variables d'environnement suivantes doivent être définies : ANT_HOME, JAVA_HOME, JAVA_OPTS -Xmx1500M -Xms1500M -verbose:gc ;
    • Assurez-vous que les extensions ant suivantes sont installées : nodeps et regpex. (package ant-optional pour ubuntu).
    • Il est trés fortement conseillé d'installer JAI dans cette JVM : https://jai.dev.java.net/binary-builds.html;
    • Paramétrer le fichier build.property (en particuler l'adresse du serveur et le path du dossier nativelib - applications tierces);
    • exécuter le script de gérération de la WEB APP: "buiWebApp.sh"
  • Déploiement
    • Assurez vous de de la présence de Tomcat 5.5+ et d'une JVM1.5;
    • Installez un serveur X, et exécutez le, ou lancez le a partir des scripts de démarrage de la machine : Xvfb, disponible dans la pluspart des distributions, marche très bien. Voir ici pour le mettre en service
      (attention, si vous utilisez un Login Manager, ca ne marchera pas, mais vous pouvez en lancer un 2eme par exemple avec la commande "Xorg :1" pour utiliser le DISPLAY no 1, par défaut c'est 0)
    • Assurez vous que dans le script de démarrage de tomcat contiennent positionne la variable d'environnement DISPLAY (voir ci dessus : servicetomcat)
    • Installer la WebAPP dans Tomcat;
    • Copier/coller le contenu du répertoire "libext" dans le répertoire "lib" de Tomcat (pour toute version de Tomcat inférieure à 6 le dossier lib se trouve dans un dossier "common" à la racine de Tomcat);
    • Copier/coller le contenu du répertoire "data" dans le réperoire spécifié dans la properties "server.work.path" (changer éventuellement le password admin : dans users/ac/admin/acdef.xml);
    • Relancer Tomcat;
    • Tester le ping : http://127.0.0.1:8080/SCENARIserver3/s/chain/u/ping; (admin/test)
  • Utilisation

Add-ons WebEQ et TTM (uniquement sur SCENARIserver 3.2)

Si besoin, installer les applications tierces WebEQ et TTM en accord avec le paramétrage de build.property (chemins d'installation)

  • Editeur WebEQ (MML)
    • Installer webEQ sur le server;
    • Copier le répertoire WebEQ\3.7\classes dans webAppSCserver\applets\classes (selon la config définie dans build.property);
    • copier le fichier de license webEQ à partir de du dossier racine de l'utilisateur qui à installé WebEQ (<racine utilisateur>/.webeqrc-35) vers le dossier ${server.appExt.webeq.key.path} défini dans build.property;
  • TTM
    • Installer TTM sur le server;
    • copier le binaire ttm (<racine utilisateur>/bin/ttm sous linux) vers le dossier ${server.appExt.ttm.path} défini dans build.property;

Compléments :