Configuration de SCENARIserver

Sommaire
  1. Fichier "main.property "
  2. Fichier "advanced/server.xml"

La webApp SCENARIserver est fortement paramétrable en fonction du contexte d'utilisation et des fonctionnalités désirées.

ProcédureConfigurer SCENARIserver⚓

  1. Décompressez le fichier SCENARIserver_xxx.zip fourni dans le répertoire [pathSrc]/Vx.y.z/SCENARIserver.

    Compléments

  2. Paramétrez les fichiers de configuration du répertoire [pathSrc]/Vx.y.z/SCENARIserver/conf.

Fichier "main.property "⚓

[requis] server.webapp.name : Nom de l'application⚓

Cette variable définit le nom de la webApp qui sera déployée. Seuls les caractères alphanumériques sont autorisés.

ex : server.webapp.name=scserver41

Chemins d'accès⚓

[requis] server.work.path : Répertoire principal des données⚓

Cette variable définit le répertoire [pathData] utilisé dans le présent document à diverses reprises.

Exemple : server.work.path=E:/data/scserver41

[optionnel] server.temp.path : Répertoire de travail (backup inutile)⚓

Cette variable définit le répertoire [pathData] utilisé dans le présent document à diverses reprises.

Exemple : server.temp.path=E:/tmp/scserver41

[optionnel] server.gen.path : Répertoire racine de sortie des générateurs⚓

Cette variable définit le répertoire [pathData] utilisé dans le présent document à diverses reprises.

Exemple : server.gen.path=E:/data/scserver41/javaserver/gen

[optionnel] server.log.path : Répertoire des logs scenari⚓

Cette variable définit le fichier de log scenari.

Exemple : server.log.path=[pathLog]/[webAppName]/scenari_[date].log

Remarque : penser à retirer le caractère # de mise en commentaire de la variable server.log.path

Sécurité⚓

[optionnel] server.conf.enhancedSecurity : Activation de la sécurité avancée⚓

Cette variable permet d'activer un niveau de sécurité accru

Remarque : consommateur de ressources

Configuration du mode batch⚓

[optionnel] server.conf.batch : Activation du service de batch (scripting applicatif)⚓
  • Décommenter la ligne "# server.conf.batch=batch/server.xml" pour activer le service ;
  • Décommenter la ligne "# server.conf.batch.destPathRoot=${server.work.path}/batchGen" et spécifier le chemin ou seront créés les fichiers générés via SCENARIbatch 

liveCollab ⚓

[spécifique DB - optionnel] service liveCollab : module de collaboration entre auteurs⚓
  • Décommenter la ligne "# server.conf.liveCollab=collab/odb/liveCollab.xml" pour activer le service ;
  • Spécifier le port à utiliser : server.conf.liveCollab.port=8120 ;
  • Paramétrer l'URL d’accès au service à décommenter dans les environnements où liveCollab est lancé via un proxy : server.conf.liveCollab.connectUrl=https://[xxx.xxx.xxx.xxx]/scserver41/ws ;
  • Décommenter les ligne d’accès à l'outil node JS : server.conf.liveCollab.nodeJsExePath=${server.work.path}/nativlib/node.exe et server.conf.liveCollab.nodeJsLibPath=${server.work.path}/nodejslib ;
  • Paramétrer le path du fichier de log : server.conf.liveCollab.logPath=[logPath]/scserver41/scenari-liveCollab.log;

LDAP⚓

[optionnel] LDAP⚓

Pour activer le mode LDAP :

  • Déclarer le userMgr :

    • Sur FS : server.conf.usermgr=usermgr/fs/fsWithLdap.xml ;

    • Sur DB : server.conf.usermgr=usermgr/odb/odbWithLdap.xml;

  • Configurer la connexion LDAP dans les fichiers fsWithLdap.xml ou odbWithLdap.xml.

Remarques :

  • en environnement FS, les utilisateurs ne doivent pas être redéclarés dans scenari ;
  • en environnement FS, le rôle est commun à tous les utilisateurs LDAP ;
  • en environnement DB, les utilisateurs LDAP doivent être déclarés dans scenari afin de spécifier pour cet utilisateur le ou les rôles utiles.

Ateliers dérivés & brouillon (Spécifique à la version base de données)⚓

[optionnel] server.db.drv : active la possibilité de créer des ateliers dérivés.⚓

Cette option n'existe que dans SCENARIserver (pas dnas SCENARIserverLite).

[optionnel] server.db.drf : active la possibilité de créer des ateliers calque de brouillon.⚓

Cette option n'existe que dans SCENARIserver (pas dnas SCENARIserverLite).

Fichier "advanced/server.xml"⚓

Ce fichier permet de définir des paramètres avancés du serveur

[optionnel] Propriété "sOoLoadWaitFactor"⚓
  • Décommenter la ligne !-- <properties type="Alone" code="com.scenari.s.co.transform.oo.HTransformerOo.sOoLoadWaitFactor" level="2000">8</properties>-- pour contourner des problèmes de génération de LibreOffice (chargement faussement synchrone du fichier LibreOffice).
  • La valeur "8" peut être ajustée en fonction du volume des documents générés et de la puissance du serveur.
[optionnel] Tags "ooConnectionPool"⚓

Ces directives permettent de paramétrer le mode de communication de Scenari avec LibreOffice, et notamment de définir un pool de connexions permettant un usage parallèle de LibreOffice (plusieurs requêtes simultanées) améliorant les performances de générations multiples simultanées.

Attention

Le mode headless ne fonctionne pas correctement sous Windows (OO3.3) : le process OO peut se figer dans certains cas.

ExempleExemple de paramétrage sous Linux :⚓
1
<declareTag tagName="ooConnectionPool" classParser="com.scenari.s.co.transform.oo.OoConnectionPoolLoader"/>
2
<ooConnectionPool>
3
	<ooConnection pipeMode="true" autoLaunch="true" headless="true" profilePath="file:///tmp/LO1"/>
4
	<ooConnection pipeMode="true" autoLaunch="true" headless="true" profilePath="file:///tmp/LO2"/>
5
</ooConnectionPool>
ExempleExemple de paramétrage sous Windows :⚓
1
<declareTag tagName="ooConnectionPool" classParser="com.scenari.s.co.transform.oo.OoConnectionPoolLoader"/>
2
<ooConnectionPool>
3
	<ooConnection pipeMode="true" autoLaunch="true" headless="false" profilePath="file:///C:/tmp/OO1"/>
4
	<ooConnection pipeMode="true" autoLaunch="true" headless="false" profilePath="file:///C:/tmp/OO2"/>
5
</ooConnectionPool>
AttentionWindows 64bits⚓

LibreOffice n'existe qu'en 32bits pour le moment sous Windows. Pour un fonctionnement avec Tomcat 64bits, il est nécessaire de réaliser les actions suivantes :

  • déclarer la variable d'environnement UNO_PATH (exemple : C:\Program Files (x86)\LibreOffice 4.0\program (ajuster le path vers OO)) ;
  • déclarer une connexion en mode socket dans Scenari via le fichier [pathSrc]/Vx.y.z/SCENARIserver/conf/advanced/server.xml.

Exemple :

1
<declareTag tagName="ooConnectionPool" classParser="com.scenari.s.co.transform.oo.OoConnectionPoolLoader"/>
2
<ooConnectionPool>
3
	<ooConnection host="localhost" port="8244" autoLaunch="true" autoKill="true" headless="false" profilePath="file:///C:/TMP/LO1"/>
4
</ooConnectionPool>
5