Les programmes SCENARI sous linux

Configuration minimum

• Processeur 1 Ghz, 512 Mo de RAM (variable en fonction de l'utilisation, 1Go recommandé pour SCENARIbuilder)
• Environ 120 mo d'espace disque par programme (plus de la place en fonction de chaque modèle documentaire)
• OpenOffice 2.0 pour les modèles avec générateurs OpenDocument Text
• Navigateur web avec plug-in Flash 9 pour consulter les générations sur les modèles avec une publication de type "slideshow"
• glibc 2.4 minimum (souvent présent dans toutes les distributions linux >=2007, pour vérifier : "ls /lib/libc*.so" et comparer le numéro de version)

Distributions Ubuntu et Debian : source de package "apt-get"

Après une petite manipulation pour utiliser une source de packages du serveur scenari-platform.org, l'installation et la mise à jour des programmes Scenari se résume à une ligne de commande.

procédure :

• éditez le fichier /etc/apt/sources.list
• rajoutez a la fin la ligne :

  deb http://scenari-platform.org/deb nom_de_distrib main
  

(remplacez nom_de_distrib par jaunty, intrepid, hardy, gutsy, sid, squeeze ou lenny qui sont les seules versions supportées)

(si vous voulez utiliser les nightly, ajoutez "nightly" a la fin de la ligne)

• apt-get update

A partir d'ici, vous pouvez utiliser un outil de de gestion des packages en mode graphique si c'est dans votre habitude, les packages SCENARI devraient y figurer, dans le cas contraire, lisez la suite de la procédure pour le faire en mode ligne de commande.

Pour afficher la liste des package fournis par scenari-platform.org :

• apt-cache search scenari-platform.org
• apt-get install nom_du_programme

Lors de l'ajout des packages vous allez rencontrer un warning sur la clé PGP, vous pouvez soit l'ignorer, soit importer la clé en tant qu'user :

gpg --keyserver subkeys.pgp.net --recv 57137EFADFD726C0
gpg --export --armor 57137EFADFD726C0 | sudo apt-key add -

Exemple

Cette procédure complète vous permet d'installer SCENARIchain et SCENARIbuilder avec ubuntu 7.10 (gutsy) : sudo -s echo "deb http://scenari-platform.org/deb gutsy main" >> /etc/apt/sources.list apt-get update apt-get install scenaribuilder3.5 apt-get install scenarichain3.5 Procédure complète pour installer une SCENARIapp précise (comme opale3.0, opalesup3.0, opaleclient3.0, opalesupclient3.0...) : sudo -s echo "deb http://scenari-platform.org/deb gutsy main" >> /etc/apt/sources.list apt-get update apt-get install <nom_de_la_scenariapp> Remplacez <nom_de_la_scenariapp> par le nom de package de la SCENARIapp qui vous aura été indiqué.

Debian : le cas de "lame"

Sous Debian le package lame n'est pas disponible dans les dépots officiels. SCENARI utilise lame pour toute manipulation audio pour produire des mp3s (Générateurs Flash webradio par exemple).

Il est cependant possible d'installer lame sous debian en ajoutant le dépôt debial-unofficial aux sources apt.

Remplacement de OpenOffice Debian par OpenOffice standard (proposé par OpenOffice.org)

Attention !
Les versions 2.4 et 2.4.1 de OpenOffice proposés par Debian/Ubuntu introduisent un bug qui les rendent impropre à être utilisé avec SCENARI. UPDATE : Dans Ubuntu intrepid il semble que ce bug soit corrigé. En effet ces versions plantent lorsqu'une application tierce essaye de les piloter programmatiquement.

Il est possible d'éviter ce plantage en lançant systématiquement une application OpenOffice et de lui faire exécuter une macro (correcteur orthographique par exemple), AVANT qu'une application SCENARI tente d'utiliser OpenOffice.
Cependant, la meilleure solution pour éviter cette procédure pour le moins artisanale, est de remplacer la version de OpenOffice proposé par la distribution (Debian/Ubuntu) par la version officielle proposé par OpenOffice.org.

La procédure de remplacement pour Ubuntu Hardy (8.04) est disponible ici. Cette procédure est valable pour Intrepid et Jaunty.

Des tests (TRÈS unitaires l'openoffice 3.0 de jaunty) de Samuel avait fait apparaître que l'openoffice 3 fourni avec jaunty semble fonctionner correctement avec Opale 3.1 Cependant Samuel indique que jusqu'à preuve du contraire, la version d'OpenOffice d'Ubuntu 9.04 peut être utilisé dans un contexte de prise en main et de tests de SCENARI (ou d'un modèle comme Opale). Part-contre dans un contexte d'usage professionnel d'une publication papier issue d'une chaine SCENARI, il préconise toujours le remplacement de OpenOffice debian (ou tout autre distrib) par la version proposé en téléchargement sur le site openoffice.org. Remarque : Il est tout a fait possible d'installer OpenOffice 2.4.x et 3.x sur la même machine si vous devez absolument utiliser Opale 3.0. (source : http://scenari-platform.org/forum/viewtopic.php?t=1815).

Désinstallation

apt-get remove <nom_de_la_senariapp>

Si vous voulez aussi désinstaller toutes les librairies utilisé par les programmes Scenari ou les SCENARIapps (si vous n'avez plus rien en rapport avec Scenari sur votre PC), vous pouvez retirer aussi les packages "libscenarisrv3.4" et "libscenarixul3.4".

Après désinstallation, vous pouvez si vous le souhaitez :

• supprimer le répertoire de configuration de toutes les applications scenari : ~/.scenari
• supprimer le répertoire contenant tous les documents que vous avez écrit : ~/nom_du_programme

Autres distributions : installation automatique "sci"

SCI est un script qui automatise le téléchargement et l'installation des applications (SCENARI builder, chain & client). Dans le cas de SCENARIbuilder, il peut également télécharger et installer les différents builderpack existant.

Vous pouvez télécharger ce script à cette adresse : http://scenari-platform.org/svn/sci/trunk/sci.sh

aide "./sci.sh -h" :

Linux SCENARI application installer & setup (version v1.9.0)

sci.sh downloads and installs requested SCENARI applications from the
scenari-platform website.
Usage: sci.sh [-n] {scbd|scch|sccl|sckt|scmd} [-cd{u|r}fas]

By default sci.sh will attempt to install applications system-wide and as such
requires the current user to be a sudo user that has root access
to /opt and /usr. Should this not be the case, either use the -u option to
perform a local user installation or the -r option to perform a system-wide
installation using the su command requiring the root password.

OPTIONS:
Installation type (optional):
  -n       Nightly build: sci.sh will install the latest nightly build of the
           application that you request. If this switch is not present sci.sh
           will install the latest stable version.

Application name (required):
  scbd     Download and install SCENARIbuilder, you should at least install the
           modeling builderpack by adding the -m option (see below).
  scch     Download and install SCENARIchain.
  sccl     Download and install SCENARIclient.
  sckt     Download SCENARIkit to the current directory.
  scmd     Download and install modeling builderpacks into an existing
           SCENARIbuilder installation. you must provide at least one of the
           folowing options: -m, -a, -s (ADVANCED).

Installation options (optional)
  -c       Clean download and install: delete any previously attempted downloads
  -d       Download only, do not install.
           before starting the download & install process.
  -f       'force' mode: the installer does not interact with the user, all
           default choices are used. If the application is already installed
           it will be replaced. This is basically equivalent to pressing
           return for each question the the installer normally asks the user.
  -u       Local user installation: sci.sh will install the application in the
           current user's home directory.
  -r       System-wide installation using the su command requiring the root
           password. This option should be used if you are not a sudo user but
           have root access though the su command.

SCENARIbuilder specific options (optional)
  -m       Download and install the modeling extension builderpack
  -a       Download and install the modeling assessment extension builderpack
  -s       Download and install the modeling sound extension builderpack

NOTES:
Even when a system-wide installation is required sci.sh must be run as a
normal user. This is because although SCENARI binaries can be installed for all
users, SCENARIbuilder builderpacks MUST be installed in the user's profile.

Copyright (c) 2007-2009 samuel.monsarrat@kelis.fr

exemple pour installer une "nightly" SCENARIbuilder pour tous les utilisateurs, et le pack modeling pour l'utilisateur courant :

• Si l'utilisateur courrant est un "sudoer" (ex: comme tout user "administrateur" sous Ubuntu):

  $ wget http://data.dokiel.fr/~sam/sci/sci.sh
  $ chmod +x sci.sh
  $ ./sci.sh -n scbd -m
  

• Si l'utilisateur courrant n'est pas un "sudoer" (ex: Fedora ne configure pas sudo par défaut):

  $ wget http://data.dokiel.fr/~sam/sci/sci.sh
  $ chmod +x sci.sh
  $ ./sci.sh -n scbd -rm
  

  L'option -r indique à sci.sh d'utiliser la commande su -c pour lancer le script d'installation en tant que root. Dans ce cas vous devez fournir le mot de passe root.

Intégration avec d'autres windowmanagers que Gnome

KDE - Konqueror

Attention !
Si vous utilisez KDE, il est possible que l'action "révéler la dernière génération" ou tout autre supposée ouvrir le gestionnaire de fichiers de votre système d'exploitation ne produisent aucun résultat.

David Rivron propose des scripts qui permettent de résoudre ce problème :

• attachment:kfmclientexec
• attachment:update-sc-network-protocols.sh

Placez les 2 scripts dans /usr/local/bin, rendez les exécutable et après chaque nouvelle installation d'un programme Scenari, lancez :

update-sc-network-protocols.sh /chemin/du/repertoire/du/programme/scenari

Xfce - Thunar

• Placez vous dans votre application Scenari: CTRL SHIFT K sur 3.4, et CTRL SHIFT O à partir de 3.5. Cela vous ouvre la fenêtre des préférences de l'application.
• Faites clic-droit dans la liste => chaines de caractère (ou "string" selon que vous avez l'interface en français ou en anglais), et tapez: network.protocol-handler.app.file.
• Puis rentrez ce que retourne la commande which thunar.
• Fermez la fenêtre de préférences.

Pour ScenariBuilder, il faut effectuer cette opération dans les deux environnements: Test et Builder.

Installation manuelle

Voici la démarche à suivre :

• Téléchargez l'installeur de l'application SCENARI voulu depuis :
  • SCENARIbuilder
  • SCENARIchain
  • SCENARIclient

• Décompresser cet archive, par ex:

  $ tar xzf SCENARIclient_3.6.011_lin.tgz
  

ceci vous donne cinq fichiers:

install.sh
license.txt
LISEZMOI.txt
README.txt
SCENARIclient.tar.gz

• Lisez le fichier LISEZMOI.txt

• Les programmes SCENARI peuvent être installés soit en tant que root au quel cas ils seront installés pour tous les utilisateurs, soit en tant que simple utilisateur, au quel cas ils seront installés dans le profil courant.

Suivant votre choix de déploiement exécutez install.sh :

• soit en tant que root (administrateur) à partir du dossier dans lequel se trouve ce script:

  # ./install.sh
  

• soit en tant que simple utilisateur à partir du dossier dans lequel se trouve ce script:

  $ ./install.sh
  

Suivez les étapes de l'installation, un fichier de log est créé dans /tmp qui contient les actions effectuées et aussi les erreurs éventuelles.

• pour SCENARIbuilder, installez au moins l'extension modeling de la version correspondante. L'extension modeling contient toutes les primitives de base indispensable a toute tache de conception de modèles. Les extensions sont installé uniquement "par user", même si vous effectuez cette installation en tant que root.

Voila! Mais...... Vous pourriez être victime d'un problème :

Impossibilité de trouver l'exécutable OpenOffice.org

Si sur votre distribution linux vous avez un message d'alerte durant l'installation et/ou des messages d'erreurs lors de la génération qui font état d'une impossibilité de trouver OpenOffice, et que malgré tout OpenOffice est bien installé, déclarez la variable d'environnement UNO_PATH avec le chemin d'accès vers votre installation de OOo.

Ex (pour UBUNTU 5.10 avec Open Office 2.0.1):

$ export UNO_PATH=/usr/lib/openoffice2/program/

Ceci permettra aux applications SCENARI de trouver OpenOffice.org.

Attention !

SCENARI se base en premier lieu sur la commande locate soffice.bin pour trouver votre installation locale de OpenOffice. Si vous avez plusieurs dossiers contenant des installations de OpenOffice visibles par la commade locate il est possible que SCEANRI essaye de démarrer une version non compatible de OpenOffice. Un exemple notoire de ce problème : Vous avez un PC en double boot Windows - Linux et la commande locate soffice.bin retourne la version Windows de OpenOffice en premier. Dans ce cas vous devez ajouter la commande suivante à vos scripts de démarrage (par exemple à la fin du fichier ~/.bashrc): export UNO_PATH=/chemin/vers/votre/installation/OpenOffice La variable d'environnement UNO_PATH prends précédente sur la recherche par la commande locate.