Skip to Content

Installation de SCENARIserver sur Debian Wheezy

lun, 09/03/2015 - 18:04 — Dlareg

SCENARI est une suite d'applications avancées d'édition. SCENARI est sous licence libre et rentre dans la catégorie des chaînes éditoriales.

SCENARIserver est un serveur permettant permettant l'accès en édition à plusieurs utilisateurs.

À la différence de SCENARIserverLite, SCENARIserver utilise une base de donnée pour stocker l'information. L'usage d'une base de données permet d'adjoindre des fonctionnalités collaboratives avancées aux fonctions éditoriales, facilitant l'organisation de la production. SCENARIserver s'appuie sur un serveur Tomcat. L'ajout de la librairie SCENARIbatch permet également d'exécuter des tâches automatisées sur le serveur (lancement automatique de générations par exemple).

Pour essayer et tester SCENARI vous pouvez simplement utiliser SCENARIchain sur votre ordinateur (voir plus bas). Le présent guide est destiné à une installation déportée sur un serveur pour un usage multi-utilisateur.

http://scenari-platform.org/projects/scenari/fr/pres/co/versionsStables.html

Pré-requis

  • Debian Wheezy installée
  • réseau correctement configuré

Mise à jour du serveur Debian

En super utilisateur :

# apt-get update
# apt-get upgrade

Ajout d'un dépôt pour Scenari

# echo "deb http://scenari-platform.org/deb wheezy main" > /etc/apt/sources.list.d/scenari.list

Ajouter la clé de signature des paquets

# wget -O- http://scenari-platform.org/deb/scenari.asc | sudo apt-key add -

Mettre à jour la liste des paquets disponibles

# apt-get update

Installer SCENARIserver

# apt-get install scenariserver4.0-tomcat7

200 Mo environ

Un message de fin d'installation fait apparaître 2 warning :

  • désactivé la sécurité sur Tomcat
  • allouer plus de RAM pour Tomcat 500Mb mini

Édition du fichier de configuration de Tomcat

# vim /etc/default/tomcat7

Décommenter la ligne TOMCAT7_SECURITY=no
Changer la valeur de la RAM allouée à Tomcat à la ligne JAVA_OPTS=

Pour mettre 500 Mb de RAM :

JAVA_OPTS="-Djava.awt.headless=true -Xmx500m -XX:+UseConcMarkSweepGC"

Pour mettre 1 Gb de RAM :

JAVA_OPTS="-Djava.awt.headless=true -Xmx1G -XX:+UseConcMarkSweepGC"

Relancer le service Tomcat

Pour que le nouvelle configuration soit prise en compte il faut relancer le service Tomcat :

# service tomcat7 restart

Vérifier le bon fonctionnement

Le serveur est joignable à l'adresse : http://IP_DU_SERVEUR_DEBIAN:8080/scenariserver4.0

scenariserver4.0 étant le chemin par défaut des fichiers de travail.

Pour vérifier le bon fonctionnement du serveur il existe une page sur laquelle faire pointer le navigateur web : http://IP_DU_SERVEUR_DEBIAN:8080/scenariserver4.0/s/chain/u/ping

Une boîte de dialogue demande le compte et le mot de passe par défaut qui sont : admin/admin

Le mot de passe sera modifiable plus tard à travers l'application cliente, SCENARIchain, connectée au serveur en tant qu'administrateur.

Si le serveur fonctionne bien une page blanche apparaît.

Installation du client SCENARIchain sur votre poste

SCENARIchain est l'outil de saisie de contenu pour les auteurs, il lui faudra au minimum un modèle documentaire pour fonctionner.

Suivant votre distribution GNU / Linux l'installation peut être différente. Pour les distributions GNU / Linux qui se basent sur Debian il faut installer le dépôt comme sur le serveur.

# echo "deb http://scenari-platform.org/deb wheezy main" > /etc/apt/sources.list.d/scenari.list

# wget -O- http://scenari-platform.org/deb/scenari.asc | sudo apt-key add -

# apt-get update

# apt-get install scenariclient4.0.fr-fr

Configuration du client

Lancer SCENARIchain par la ligne de commande ou par l'icône sur votre ordinateur.

Pour configurer le client il faut se rendre dans l'onglet Raccourcis (côté droit de la fenêtre).

Si vous utilisez un proxy il faut Paramétrer la connexion à internet avant de déclarer un entrepôt

Cliquer sur Ajouter un entrepôt, une boîte de dialogue apparaît, saisir les informations requises.

 

Valider avec le bouton Créer.

L'entrepôt apparaît dans la liste.

 

Le message Aucun atelier accessible sur cette entrepôt apparaît sous le nom de l'entrepôt, il manque un atelier mais il n'est pas possible de l'ajouter tant qu'il manque un modèle documentaire. Un modèle documentaire  est un modèle de document adapté à un contexte de publication donné :

  • documentations logicielles
  • documents académiques
  • documents d'une suite bureautique traditionnelle

Il est possible de réaliser ses propres modèles avec SCENARIbuilder mais on peut également télécharger et utiliser des modèles prêts à l'emploi. Nous allons faire de la documentation logicielle alors nous prendrons Dokiel édité par la société Kelis.

Télécharger le modèle documentaire à l'adresse http://scenari-platform.org/projects/dokiel/files/4.0.101/wsppack/ ou avec wget :

$ wget http://scenari-platform.org/projects/dokiel/files/4.0.101/wsppack/DokielGuide_4.0.101.wsppack

Les versions plus récentes de Dokiel sont ici : http://www.dokiel.fr/fr/co/download.html

Le pack version 4.0 gère les versions 3.0 et 4.0 de Dokiel, c'est utile pour faire migrer des documents d'une version à une autre.

Sur la ligne de l'entrepôt cliquer sur le bouton Ajouter, puis sur Installer un pack, choisissez l'archive wsppack précédement téléchargée.

Le modèle documentaire apparaît dans la liste, cliquer sur Fermer.

Il faut maintenant créer un ou plusieurs ateliers selon comment vous souhaitez découper les publications. Cliquer sur le bouton Ajouter, une fenêtre s'affiche.

 

Il faut lui donner un nom, le modèle documentaire sélectionné par défaut est Dokiel version 4.0. Si vous souhaitez retravailler des documents en version 3.0 il faut cocher la case Dokiel 3.0 pour assurer la compatibilité. Cliquer sur le bouton Créer pour valider.

L'atelier TEST apparaît dans la liste. Double cliquer sur le nom de l'atelier pour l'ouvrir ou cliquer sur le bouton Ouvrir.

Pour apprendre à utiliser Dokiel il faut se référer à la documentation du modèle documentaire : http://docs.kelis.fr/models/dokiel/40/site/co/_GuideUtilisateurFS.html.

Vous pouvez également consulter l'onglet Aide mémoire dans l'accueil de l'atelier.

La configuration du serveur peut être personnalisée

Il est possible de personnaliser un peu le serveur SCENARIserver :

  • chemin de l'application
  • activations des fonctions collaboratives
  • chemin des journaux systèmes
  • activation de l'automatisation des traitements

Configuration de SCENARIserver : http://docs.kelis.fr/sc40/adminTech/lin/co/scenariServer.html

Les fichiers de configuration de SCENARIserver 4.0 se trouvent dans le répertoire /etc/scenariserver4.0/conf/

Une fois les modifications apportées il faut lancer un script pour que générer à nouveau les fichiers de configurations :

# scenariserver4.0-cfg reconfig

Pour que la nouvelle configuration soit prise en compte il faut relancer le service :

# service tomcat7 restart

Il est possible de réaliser la génération automatique des documentations en PDF ou HTML avec SCENARIbatch mais cela fera l'objet d'une autre documentation.