scenari
 

SCENARIserver3.4 Linux

SCENARIserver has to be installed as a webapplication in a servlet server like Tomcat, either as a dedicated server to Scenari either into an already tomcat server.

Attention !

This page only apply to branch 3.3 and 3.4 of the SCENARIserver installation.

Create a dedicated SCENARIserver

Requirements

  • Download the following components:
    • Download JRE 1.5 from SUN (chooseLinux (self-extracting file))
    • Download the image manipulating library JAI
  • Recommanded for 3.4 : install ImageMagick for higher image quality in published documents (You should install it from your distribution package, i.e.: apt-get imagemagick...).
    • Download the servlet server Tomcat
  • Download the required Scenari components to build the webapp :
  • SCENARIserver has to connect to openoffice.org, which require an Xorg server. Although you can connect to any possibly already running Xorg server, it's recommanded to use the Xvfb virtual framebuffer server.
    • Ensure that OpenOffice.org is correctly installed and can be run with your user account (root in this tutorial).
    • Install Xvfb (from your distribution packages).

Preparing the install

In this example, we will choose the path /opt/SCENARIserver3.4/ as the SCENARIserver location.

  1. create the folder /opt/SCENARIserver3.4/ 
    [root@kelispost01 ~]# mkdir /opt/SCENARIserver3.4
[root@kelispost01 ~]# cd /opt/SCENARIserver3.4
[root@kelispost01 SCENARIserver3.4]#
  2. install the sun JRE in /opt/SCENARIserver3.4/jre 
    [root@kelispost01 SCENARIserver3.4]# cp /home/sam/downloads/jre-1_5_0_10-linux-i586.bin .
[root@kelispost01 SCENARIserver3.4]# chmod u+x jre-1_5_0_10-linux-i586.bin 
[root@kelispost01 SCENARIserver3.4]# ./jre-1_5_0_10-linux-i586.bin 
Sun Microsystems, Inc.  Binary Code License Agreement
...
Done.
[root@kelispost01 SCENARIserver3.4]# mv jre1.5.0_10/ jre
[root@kelispost01 SCENARIserver3.4]# rm -f jre-1_5_0_10-linux-i586.bin
  3. install the JAI library in the JRE (in /opt/SCENARIserver3.4/jre) 
    [root@kelispost01 SCENARIserver3.4]# 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. extract Tomcat in /opt/SCENARIserver3.4/tomcat 
    [root@kelispost01 jre]# cd ..
[root@kelispost01 SCENARIserver3.4]# cp /home/sam/downloads/apache-tomcat-6.0.10.zip .
[root@kelispost01 SCENARIserver3.4]# unzip apache-tomcat-6.0.10.zip 
[root@kelispost01 SCENARIserver3.4]# mv apache-tomcat-6.0.10 tomcat
[root@kelispost01 SCENARIserver3.4]# rm -f apache-tomcat-6.0.10.zip
[root@kelispost01 SCENARIserver3.4]# chmod a+x /opt/SCENARIserver3.4/tomcat/bin/*.sh
  5. Integrate SCENARIserver3.4 in the linux startup scripts to run it as a system service (use the recommended content). 
    [root@kelispost01 SCENARIserver3.4]# cd /etc/init.d/
[root@kelispost01 init.d]# nano SCENARIserver3.4
...
[root@kelispost01 init.d]# chmod a+x SCENARIserver3.4
[root@kelispost01 init.d]# chkconfig --add SCENARIserver3.4
  6. Integrate Xvfb server in the linux startup scripts to run it as a system service (use the recommended content). 
    [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.4

  1. create the temporary directory/tmp/scservinstall 
    [root@kelispost01 init.d]# mkdir /tmp/scservinstall
[root@kelispost01 init.d]# cd /tmp/scservinstall
[root@kelispost01 scservinstall]#
  2. extract SCENARIserver3.4 in /tmp/scservinstall/setup 
    [root@kelispost01 scservinstall]# mkdir setup
[root@kelispost01 scservinstall]# cd setup/
[root@kelispost01 setup]# cp /home/sam/downloads/SCENARIserver_3.4.0_lin.tar.gz .
[root@kelispost01 setup]# tar xzf SCENARIserver_3.4.0_lin.tar.gz
  3. Edit the file build.property and set it up as bellow: 
    [root@kelispost01 setup]# nano build.property 
...

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

# Configuration des applications tierces -> 3rd party application configuration
server.appExt.lame.path=/var/opt/SCENARIserver3.4/nativlib/lame
server.appExt.sox.path=/var/opt/SCENARIserver3.4/nativlib/sox
server.appExt.soxmix.path=/var/opt/SCENARIserver3.4/nativlib/soxmix
    remplace server.url=http://192.168.2.101:8080 with the URL matching your server setup
  1. set the JAVA_HOME environment variable 
    [root@kelispost01 setup]# export JAVA_HOME=/opt/SCENARIserver3.4/jre
  2. Run the webapp build script: 
    [root@kelispost01 setup]# ./buiWebApp.sh 
Compilation, scserver
...
BUILD SUCCESSFUL
Total time: 1 second
    You obtain a SCENARIserver3.4.war that you now have to deploy in Tomcat.

Deploying the SCENARIserver webapplication

  1. Copy the /tmp/scservinstall/setup/libext content into /opt/SCENARIserver3.4/tomcat/lib (and for a tomcat version < 6, to /opt/SCENARIserver3.2/tomcat/common/lib) 
    [root@kelispost01 setup]# cp libext/* /opt/SCENARIserver3.4/tomcat/lib
  2. Create the workpath for the SCENARIserver webapp (as defined in build.property, server.work.path), in our example it's /var/opt/SCENARIserver3.4 
    [root@kelispost01 setup]# mkdir -p /var/opt/SCENARIserver3.4
  3. copy /tmp/scservinstall/setup/data into /var/opt/SCENARIserver3.4 
    [root@kelispost01 setup]# cp -R /tmp/scservinstall/setup/data/* /var/opt/SCENARIserver3.4
  4. move /var/opt/SCENARIserver3.4/nativlib into the installed directory of the SCENARIserver /opt/SCENARIserver3.4 
    [root@kelispost01 setup]# mv /var/opt/SCENARIserver3.4/nativlib /opt/SCENARIserver3.4
  5. ensure that the native libraries are executables : 
    [root@kelispost01 setup]# chmod a+x /opt/SCENARIserver3.4/nativlib/*
  6. change the admin password for the SCENARIserver : edit the file /var/opt/SCENARIserver3.4/users/ac/admin/acdef.xml
  7. copy the file /tmp/scservinstall/setup/SCENARIserver3.4.war into /opt/SCENARIserver3.4/tomcat/webapps/ 
    [root@kelispost01 setup]# cp SCENARIserver3.4.war /opt/SCENARIserver3.4/tomcat/webapps/

You are now ready to test your server:

  1. start the Xvfb service: 
    [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.4 start
Starting SCENARIserver3.4 service:  Using CATALINA_BASE:   /opt/SCENARIserver3.4/tomcat
Using CATALINA_HOME:   /opt/SCENARIserver3.4/tomcat
Using CATALINA_TMPDIR: /opt/SCENARIserver3.4/tomcat/temp
Using JRE_HOME:       /opt/SCENARIserver3.4/jre
                                                           [  OK  ]
  3. Check that you can connect to your SCENARIserver with the debug URL : http://127.0.0.1:8080/SCENARIserver3.4/s/chain/u/ping , use your admin login on the SCENARIserver
  4. Usage: with SCENARIchain or SCENARIclient, add a remote server like http://192.168.2.101:8080/SCENARIserver3.4 (depends on the URL defined in build.property).

Attention !

Passwords are not encrypted, you should ensure that nobody can have access to the password file on the filesystem and advice your users to avoid re-using their password on the SCENARIserver for any other purpose.

Method to install SCENARIserver on an already existing tomcat server

(not translated)

  • 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 : JAVA_HOME, JAVA_OPTS -Xmx1500M -Xms1500M -verbose:gc ;
    • 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

Additional informations

(not translated)