Home

SCENARIserver4.1 : manuel d`installation et d`administration

1. SCENARIserver4 1 manuel d installation et d administration technique Linux SCENARI server4 1 manuel d installation et d administration technique Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration technique Version Date Editeur Auteur s Copyright Licence 1 2 Juillet 2015 Kelis Antoine Pourchez Laurent Riviere Samuel Monsarrat Kelis cc a Cette ceuvre est mise a disposition selon les termes de la Licence Creative Commons Attribution 3 0 France lhttp creativecommons org licenses by 3 0 fr Table des mati res IMFOQUCHONM 22 DZ eye nn na me N Ne Gadet De de RALA AT tenant eae eue 4 Chapltre T Architecture technique 222880 aaa palatine 6 Chapitre 2 Installation des outils ti rs 2 2 andere nn attentat anal 7 1 Installation d une JVM 7 2 Installation d un moteur de servlet 7 3 Installation de LibreOffice 4 3 ou plus Optionnelle 8 4 Installation de Latex Optionnelle 9 5 Compl ments 9 Chapitre 3 Configuration syst me is 10 Chapitre 4 Configuration de Tomcat ec aaa nee Sepascnse gteaadach es ne 0eme ts Len dote dre 13 Chapitre 5 Installation Configuration de SCENARISerVer s seceseeseseeeceeeceeceeeeeseeeeaeseeeseeeesaeeaeaseeaeeeaees 22 1 Configuration de SCENARIserver 22 2 Installation 26 3 Mont e de version 29 Chapitre 6 Installation Configuration de SCENAR server sous Debian cccccccse
2. lt properties type Alone code com scenari s co transform oo HTransformerOo sOoLoadWaitFactor level 2000 gt 8 lt properties gt pour contourner des probl mes de g n ration de LibreOffice htip qa openoffice org is sues show_bug cgi id 635641 chargement faussement synchrone du fichier LibreOffice e 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 37 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver sous Debian technique Linux requ tes simultan es am liorant les performances de g n rations multiples simultan es Le mode headless ne fonctionne pas correctement sous Windows 008 3 le process OO peut se figer dans certains cas Exemple de param trage sous Linux 1 lt declareTag tagName ooConnectionPool classParser com scenari s co transform oo 0oConnectionPoolLoader gt 2 lt ooConnectionPool gt 2 3 lt ooConnection pipeMode true autoLaunch true headless true profilePath trile tmp LOL gt 4 lt ooConnection pipeMode true autoLaunch true headless true profilePath a tile tmp LO2 gt
3. 11 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Configuration syst me technique Linux Au prochain d marrage de SCENARIserver le nombre maximal de fichiers ouverts simultan ment sera de 4096 e http ubuntuforums org showthread php t 902873 e http j 4newbies blogspot com 2007 04 too many open files html Juillet 2015 Version 1 2 Kelis 12 SCENARIserver4 1 manuel d installation et d administration technique Linux Configuration de Tomcat Chapitre 4 Configuration de Tomcat Pour permettre a des webapps SCENARIserver de fonctionner correctement dans le serveur de servlets Tomcat il est n cessaire d y apporter certaines modifications de param trage 4h S curit A l heure actuel Les webapps SCENARIserver ne sont pas compatible avec le Security Manager de Tomcat Il est important de ne pas activer le module Security Manager lors du d marrage de Tomcat Par d faut le Security Manager n est pas actif cependant il faut tre vigilant sur ce point lors de l usage de versions packag es de Tomcat sous Linux im Usage d un proxy Apache ll est possible de cacher Tomcat derri re un proxy Apache Ceci permet entre autres d acc der SCENARIserver sur le port 80 m me si vous avez d j une serveur web Apache d install Il y a plusieurs fa ons de mettre en place un proxy Apache vers Tomcat le plus simple et le seul qui t test avec succ s ave
4. backup en cours m morisant ainsi les suppressions de fichier blobs et mettant a disposition des fichiers d index complets et corrects e apr s la sauvegarde permet de remettre le syst me dans un tat de fonctionnement normal suppression du statut backup en cours La pr c dente proc dure s ex cute avec le SCENARIserver lanc et ne g ne en rien la production Juillet 2015 Version 1 2 Kelis 44 SCENARIserver4 1 manuel d installation et d administration technique Linux SCENARIbatch Ex cuter le script pathScBatch apps backup backup bat pre ou pathScBatch apps backup backup sh pre Pa Cette ex cution doit se faire dans le r pertoire pathScBatch apps backup Sauvegarder les fichiers de donn e via l outil de backup au choix R pertoires a sauvegarder Base de donn es e pathData javaserver blobs e pathData javaserver backup e optionnel Environnement de travail pathData javaserver privData e optionnel Mod les documentaires install s pathData javaserver updt et pathData javaserver pack e optionnel G n rations pr c dentes pathData javaserver gen w Les diff rents types de backup de fichiers usuels sont utilisables totale incr mentale diff rentielle Ex cuter le script pathScBatch apps backup backup bat post ou pathScBatch apps backup backup sh post OU Sauvegarde syst me arr t Seule l tape Sauvegarder les fichiers de donn
5. 20 21 Set this if you need to specify a specific JURE 22 export JAVA HOME opt SCENARIserver jre 23 export PATH SPATH usr bin 24 25 SCENARIserver needs a minimum of 256Mb of heap space 26 heapspace 512M at 28 Extra JVM options 29 extra_options 30 31 JVM options 32 opts_start XmsSheapspac XmxSheapspace Dorg apache tomcat util buf UDecoder ALLOW_ENCODED_SLASH true Sextra_options 33 opts_stop Xms64M Xmx128M 34 85 Path to tomcat pid file 36 export CATALINA_PID tomcat tomcat pid 37 38 Shutdown timeout before tomcat is killed in seconds 39 kill_timeout 30 40 41 42 LibreOffice Configuration 43 44 Set DISPLAY variable if you want LibreOffice to use a specific display 45 export DISPLAY 1 0 46 47 If set this stops the recovery dialog prompting you as 00 0 starts up 48 after a crash instead the recovery files are just silently 49 accumulated 50 export OOO_DISABLE_RECOVERY 1 51 52 export UNO_PATH usr lib libreoffice program 53 54 55 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Configuration de Tomcat technique Linux 56 startup Stomcat bin startup sh 57 shutdown tomcat bin shutdown sh 58 59 lib lsb init functions 60 61 start 62 Tomcat pid checks 63 if SCATALINA_PID then 64 if ps p cat CATALINA_PID we I gt 1 then 65 To
6. 200 succ s 503 warning e erreur dans tous les autres cas Exemple de param trage Nagios D claration d une nouvelle commande define command command_name ping_scserver_ssl command_line usr lib nagios plugins check_http S H ARG1 u ARG2 s chain u ping a ARG3 ARG4 D claration d un nouveau service define service use generic service host_name serverHostname service_description SCserver coperia2 servicegroups scservers check_command ping_scserver_ssl serverHostname nameWebapp scuserSystem mot de passe scuserSystem 41 Juillet 2015 Version 1 2 Kelis Monitoring SCENARIserver4 1 manuel d installation et d administration technique Linux L Contr le d int grit des donn es du SCENARIserver DB Service check_http pour contr ler la coh rence des donn es url https urlWebapp s chain u adminOdb cdaction CheckAuto user scuserSystem password mot de passe scuserSystem Assertion sur la r ponse HTTP 200 succ s 503 warning erreur dans tous les autres cas un check par 24h lors d une activit applicative faible Exemple de param trage Nagios D claration d une nouvelle commande define command command_name ping_scserverdata_ssl command_line usr lib nagios plugins check_http S H SARG1 ARG2 s chain u adminOdb cdaction CheckAuto a ARG3 ARG4 D claration d un nouveau service define service u
7. 87 stop 88 echo n Stopping serverName 89 Kill all LibreOffice instances run but the tomcat user 90 pkill 9 u Srunasuser soffice 91 export JAVA_OPTS Sopts_stop 92 su s bin bash c Sshutdown kill_timeout force S Srunasuser 93 retval 94 echo 95 return Sretval 96 97 98 restart 99 stop 100 start 101 102 103 See how we were called 104 case 1 in 105 start 106 start 107 108 stop 109 stop MO 111 status 112 This doesn t work 113 status SCENARIserver WA Sirestart 116 restart A 61 87 119 echo Usage 0 start stop restart 120 exit 1 121 esac 122 123 exit 0 Juillet 2015 Version 1 2 Kelis 18 SCENARIserver4 1 manuel d installation et d administration technique Linux Configuration de Tomcat Debian Ubuntu Mint 19 Juillet 2015 1 bin bash 2 This is the init script for starting up SCENARIserver 3 4 description Starts and stops the Tomcat daemon of SCENARIserver 5 6 7 8 Server configuration 9 10 Name of the server used when printing out status 11 serverName SCENARIserver 12 13 Set this to the path of the tomcat folder 14 tomcat opt SCENARIserver tomcat 15 16 user to run the tomcat server as 17 you have to create this user yourself he must be owner or have write permission 18 on tomcat webapp dir scenari workshop dir and other temporary dirs 19 runasuser root
8. a tomcat dans cet exemple est 512M Adaptez les valeurs Xms et Xmx votre contexte le display utilisable pour libreoffice Installation e Sauver le fichier dans etc init d sous le nom SCENARIserver ce r pertoire est standard sur les distributions r centes Rendre le script ex cutable chmod a x SCENARIserver Ajouter SCENARIserver au bon runlevel sous Fedora chkconfig add SCENARIserver sous Ubuntu update rc d SCENARIserver defaults 90 10 21 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver Installation Configuration de SCENARIserver SCENARIserver est fourni sous la forme d une archive compress e technique Linux Chapitre 5 Une fois d compress et param tr SCENARIserver sera a compiler pour produire la webApp fichier war installer dans Tomcat 1 Configuration de SCENARIserver La webApp SCENARIserver est fortement param trable en fonction du contexte d utilisation et des fonctionnalit s d sir es Configurer SCENARIserver D compressez le fichier SCENARI server_xxx zip fourni dans le r pertoire pathSrc Vx y z SCENARIserver Fai re un cl ick d ro it sur le fi ch ler SCENARIclient_4 0 3 11nightly_20120903 0452_fr FR WINNT_x86 9 J scenariclient_4 0 3 1 tnightly_20120903 0452_fr FR WINNT_x86 9 S CE NA R l serve r_XXX zi p By SCENARIserver_4 0 311nigh
9. amp sudo apt get install oracle java7 set default 2 Installation d un moteur de servlet 7 Scenari est packag de fa on standard war permettant un d ploiement sur divers serveurs d application N anmoins les installations sur Tomcat sont les plus courantes aujourd hui et sont donc conseill es Tomcat conseill Installation de Tomcat Suivre la documentation d installation fournie par Apache Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation des outils tiers technique Linux Sources de l installeur Tomcat 7 http tomcat apache org download 70 cgi Sources de l installeur Tomcat 8 http tomcat apache org download 80 cgi Installation L installation de Tomcat passe par la d compression du fichier t l charg sur le disque dur dans le r pertoire pathApp Tomcat7 par exemple Le path d installation de Tomcat ne doit contenir que des caract res alphanum riques bug pr sent dans la JVM 1 6 Si vous ne respectez pas cette recommandation svous risquez de tomber sur cette erreur java net URISyntaxException Illegal character in path Le path d installation sera appel TOMCAT_HOME dans le suite du document JBoss Installation de JBoss Suivre la documentation d installation fournie par JBoss Sources de l installeur JBoss http jbossas jboss org downloads amp Le path d installation sera appel JBOSS HOME d
10. 1 le ou les mod les documentaires d di s R pertoires concern s purger donc server work pathl javaserver pack server work path javaserver updt 31 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver sous Debian technique Linux Chapitre 6 Installation Configuration de SCENARI server sous Debian scenari platform org fournit SCENARIserver sous format DEB pour Debian et Ubuntu Cette m thode d installation de SCENARIserver apporte des avantages mais aussi des inconv nients Avantages e Une installation simplifi e utilisant toute la force du syst me de paquetage Debian pour garantir que tous les pr requis seront galement install s en particulier OpenJDK et Tomcat Jetty mais galement Imagemagick et ffmpeg e UnSCENARIserver utilisant le param trage par d faut est op rationnel en quelques minutes SCENARIserver sera mis a jour automatiquement d s qu une nouvelle version est disponible sur des d p ts A Inconv nients amp Points a contr ler e Cette m thode ne permet pas l installation de plusieurs webapps SCENARIserver dans le m me serveur d application Votre serveur devient donc un SCENARIserver unique Si vous avez besoin de ce type d installation alors vous devez vous reporter a la proc dure l installation g n rique e Ce mode d installation ne vous dispense pas d effectuer les tapes de
11. 5 lt ooConnectionPool gt La commande scenariserver4 1 cfg Les version DEBs de SCENARIserver sont fournies avec un script de maintenance scenariserver4 1 cfg Celui ci permet de reconfigurer ou de r initialiser la configuration et d effectuer une sauvegarde simple de SCENARI server DB Appliquer des modifications de configuration reconfig Une fois la configuration de SCENARIserver modifi e il faut re g n rer le fichier etc scenariserver4 1 init xml puis relancer le serveur d application pour que les modifications soient prises en compte G n rer le fichier de configuration etc scenariserver4 1 init xml user computer sudo scenariserver4 1 cfg reconfig Cette commande sauvegarde le fichier etc scenariserver4 1 init xml actuel en letc scenariserver4 1 init xml bkp puis l crase avec une nouvelle version construite a partir des l ments dans etc scenariserver4 1 conf Relancer le serveur d application Pour Tomcat6 user computer sudo service tomcat6 restart R initialiser la configuration reset tout moment il est possible de supprimer toute modification de la configuration de SCENARIserver et de revenir au param trage par d faut Juillet 2015 Version 1 2 Kelis 38 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation Configuration de SCENARIserver sous Debian Cette proc dure ne peut tre annul e et effacera toute mo
12. Configuration syst me cf Configuration syst me P1 et de Configuration de Tomcat cf Configuration de Tomcat P131 1 Installation Installer SCENARIserver sur Debian Ubuntu Pr requis Vous devez disposer des droits d administration Choix du serveur d application SCENARIserver peut tre int gr dans l un des trois serveur d applications suivants Juillet 2015 Version 1 2 Kelis 32 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation Configuration de SCENARI server sous Debian e Tomcat6 e Tomcat7 e Jetty ll existe un paquet sp cifique chacun de ces serveurs Le serveur d application pr conis pour SCENARIserver est actuellement Tomcat 6 Peu d installations ont t faites sous d autres serveurs d applications Pour installer l application SCENARI server proc der comme suit Ouvrir un terminal Ajouter le d p t concernant votre distribution Ubuntu user computer echo deb http scenari platform org deb lsb_release sc main sudo tee a etc apt sources list d scenari IBES Ou vous pouvez galement ajouter la ligne deb appropri via Logiciels amp mises jour dans les param tres syst me 14 10 Utopic deb http scenari platform org deb utopic main 14 04 LTS Trusty deb http scenari platform org deb trusty main 12 04 LTS Precise deb http scenari platform org deb precise main Debia
13. S assurer que le serveur d application est bien lanc et que SCENARIserver est bien accessible Lancer la commande de sauvegarde 39 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver sous Debian technique Linux user computer S sudo scenariserver4 1 cfg backup R sultat Une copie de la base de donn es est maintenant disponible dans le dossier backupFolder par d faut var lib scenariserver4 1 backup QO Vous pouvez incorporer cette proc dure dans votre strat gie de sauvegarde de vos serveurs Le contenu de backupFolder peut alors tre r cup r par un syst me tiers tel que backuppc ou backula etc Juillet 2015 Version 1 2 Kelis 40 SCENARIserver4 1 manuel d installation et d administration technique Linux Monitoring Chapitre 7 Monitoring SCENARI4 1 offre des possibilit s de surveillance par des environnements de monitoring nagios afin de suivre la bonne sant du syst me Nous recommandons vivement la mise en place de ces sondes de contr le dans les syst me mis en production Nous pr conisons au minimum la d claration des deux services suivants Contr le de la webApp SCENARIserver Service check_http pour contr ler que la webapp SCENARIserver fonctionne url https urlWebapp s chain u ping user scuserSystem password mot de passe scuserSystem Assertion sur la reponse HTTP
14. il vous faudra ex cuter le script batch apps dbMigrFrom40T041 pr sent dans l application SCENAR I batch cf SCENARIbatch P43 Donn es utilisateur SCENARIserver db La compatibilit ascendante est assur e Ainsi dans un environnement 4 1 il suffit de r f rencer le m me jeu de donn es variable de configuration server work path que celui pr c demment exploit en 4 0 pour qu une transformation automatique de celui ci soit op r e lors du premier lancement R pertoires concern s e server work path javaserver db e server work path javaserver blobs server work path javaserver privData Fichier txLog db La structure du fichier de log server work path javaserver db txlog otx a chang dans SCENARI4 1 Ce fichier exploit uniquement pour enregistrer des logs transactionnels peut tre supprim avant la migration SCENARIserver4 1 Si cette suppression n est pas r alis e l erreur ci dessous peut se produire et sera ignorer aucune incidence fonctionnelle 1 INFO Server startup in 4225 ms 215 juil 2014 12 14 56 com orientechnologies common log OLogManager log 3 ATTENTION Error on opening the txlog file File txlog otx os size 1000000 stored 998976 filled 998976 max 536870912 reset it 29 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver technique Linux 4 com oriente
15. monitoring au risque de compromettre l int grit des donn es Sp cificit s SCENARIserver Les parties sp cifiques a SCENARIserver non applicables a SCENARIserverLite sont indiqu es par la marque DB DB pour database Les parties sp cifiques a SCENARIserverLite non applicables a SCENARIserver sont indiqu es par la marque Lite Ce manuel d installation et d administration technique s adresse a un profil Administrateur en charge de l installation surveillance et administration technique de SCENARIserver E Pr requis Avant toute manipulation sur votre SCENARIserver assurez vous d avoir effectu une sauvegarde et v rifi son int grit Kelis ne saurait tre tenu pour responsable de tout dommage direct ou indirect r sultant de l application de ces proc dures conform ment la licence du pr sent document Debian Ubuntu SCENARIserver est disponible dans les d p ts Debian de scenari platform org Si vous voulez installer SCENARIserver de cette mani re reportez vous a Installation Configuration de SCENARIserver sous Debian cf Installation Configuration de SCENARIserver sous Debian P 32 Juillet 2015 Version 1 2 Kelis 4 SCENARIserver4 1 manuel d installation et d administration technique Linux Introduction m Documentation papier La version papier de cette documentation est disponible ici http docs kelis fr sc41 adminTech lin paper guidePapier_lin pdf 5 Juillet 2015
16. nodejslib Juillet 2015 Version 1 2 Kelis 36 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation Configuration de SCENARI server sous Debian e 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 e D clarer le userMor SurFS server conf usermgr usermgr fs fsWithLdap xml e Sur DB server conf usermgr usermgr odb odbWithLdap xml e 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 e 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 amp brouillons 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 commenterlaligne
17. webapp name en fonction des param tres de compilation de la webApp et du param trage du serveur d application m Login password par d faut Le login password d administration par d faut est admin admin Remarque Celui ci est modifiable travers une application cliente connect e au serveur en tant qu administrateur L application cliente peut maintenant tre utilis e et la connexion vers ce SCENARiserveur entrep t d clar e Se r f rer au manuel de gestion fonctionnelle pour plus de d tail sur le param trage applicatif auteur Juillet 2015 Version 1 2 Kelis 28 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation Configuration de SCENARIserver 3 Mont e de version Passage de SCENARIserver4 0 a SCENARIserver4 1 Param trage du serveur Les fichiers de configuration de la webapp n ont que peu volu entre SCENARI server4 0 et SCENARIserver4 1 hormis une r organisation mineure N anmoins de fa on g n rale pour toute nouvelle version il convient de reporter dans ces nouveaux fichiers de configuration les ajustements que vous avez r alis pour votre pr c dent syst me Evolution de la configuration LDAP DB uniquemennt L volution du param trage de la connexion LDAP n cessite d op rer un ajustement sur les diff rents utilisateurs d ja d clar s Pour r aliser cela automatiquement si un contexte LDAP tait d j actif dans votre syst me en 4 0
18. 6 restart Charger les librairies LibreOffice L utilisation de plusieurs webApp SCENARI sur le m me serveur Tomcat n cessite un param trage permettant le partage de l acc s LibreOffice Ouvrir le fichier TOMCAT_HOME conf catalina properties Modifier la ligne shared loader pour y d clarer les chemins des librairies LibreOffice jurt jar ridl jar et unoil jar Exemple de configuration windows shared loader file D Program Files x86 LibreOffice 4 URE java jurt jar file D Program Files x86 LibreOffice 4 URE java ridl jar file D Program Files x86 LibreOffice 4 Basis program classes unoil jar Exemple de configuration linux shared loader opt libreoffice4 3 ure share java jurt jar opt libreoffice4 3 ure share java ridl jar opt libreoffice4 3 program classes unoil jar Connecteurs Tomcat Le connecteur Tomcat doit tre utilis pour les sp cification suivantes Sp cification du port 8080 par d faut e Encodage des URLs Taille des buffers Pour viter des probl mes d encodage de nom de fichier il est important de forcer Tomcat traiter toutes les url en UTF 8 Ouvrir le fichier TOMCAT_HOME conf server xml avec un diteur XML type notepad Juillet 2015 Version 1 2 Kelis 14 SCENARIserver4 1 manuel d installation et d administration technique Linux Configuration de Tomcat Assurez vous de bien dispos
19. Connection pipeMode true autoLaunch true headless true profilePath file tmp LO2 gt 5 lt ooConnectionPool gt Exemple de param trage sous Windows 1 lt declareTag tagName ooConnectionPool classParser com scenari s co transform o0 0oConnectionPoolLoader gt 2 lt ooConnectionPool gt 3 lt ooConnection pipeMode true autoLaunch true headless false profilePath file C tmp 001 gt 4 lt ooConnection pipeMode true autoLaunch true headless false profilePath files C Emp 0027 gt 5 lt ooConnectionPool gt Windows 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 e 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 lt declareTag tagName ooConnectionPool classParser com scenari s co transform o0 0oConnectionPoolLoader gt 25 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver technique Linux 2 lt ooConnectionPool gt lt ooConnection host localhost port 8244 autoLaunch true autoKill true headless false profi
20. Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Architecture technique technique Linux Chapitre 1 Architecture technique L environnement applicatif vis est de type client serveur 2 tiers Il est compos de e SCENARIserver webapp bas e sur Java installer dans un serveur d application Tomcat e SCENARIclient client riche de type RDA Rich Desktop Application qui s installe comme une application standalone La communication entre ces deux niveaux applicatifs se fait via le protocole http ou https Sp cifications mat rielles Les sp cifications mat rielles requises pour SCENARIserver d pendent beaucoup du nombre d utilisateurs du volume de contenu produire de l usage simultan du syst me de publication et du mod le documentaire Les chiffres suivants sont fournis titre indicatif Pour le mod le Opale un nombre d utilisateurs de 20 qui ont un usage normal de la publication pas de publication toutes les 5 minutes on pourrait recommander les sp cifications suivantes Processeur quad core gt 2 5Ghz RAM 4Go ou plus recommand DD 1Go d espace disque disponible pour effectuer l installation 50Go d espace disque disponible recommand la taille du disque dur d pend beaucoup du type de contenu qui sera traiter les ressources multim dia occupent beaucoup plus d espace disque que les ressources textuelles e OS Windows Exp riences avec Windows Ser
21. ans le suite du document 3 Installation de LibreOffice 4 3 ou plus Optionnelle Suivre la documentation d installation fournie par The Document Foundation Source de l installeur https www libreoffice org download libreoffice still Les polices Il faut avoir sur votre syst me les Microsoft Core Fonts voir les Compl ments Ubuntu Server et LibreOffice 4 3 Depuis LibreOffice 4 3 sous un Ubuntu Server 12 04 ou plus il faut avoir les packages libgl1 mesa glx et libglu1 mesa Juillet 2015 Version 1 2 Kelis 8 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation des outils tiers 4 Installation de Latex Optionnelle L exploitation des formules math matiques LaTeX impose la pr sence de Tex Live sur le serveur Source de l installeur http www tug org texlive Vous trouverez des informations compl mentaires sur cette page http scenari platform org trac modelet wiki math latex Sous Ubuntu et Debian sudo apt get install texlive latex base texlive latex recommended texlive fonts recommended texlive latex extra preview latex style dvipng Sous Redhat et Centos yum install texlive latex texlive dviutils 5 Compl ments Polices Pour certains mod les de document ou pour int grer des ressources LibreOffice il est vivement recommand d installer le package msttcorefonts de votre distribution Linux Sous Debian et Ubuntu sudo apt get insta
22. aram trage par d faut Commentaires g n raux Test de bon fonctionnement Pour tester la bonne installation de l application visiter dans un navigateur web l URL suivante http xxx xxx xxx XXxx 8080 scenariserver4 1 s chain u ping Apr s s tre authentifi la page web r sultante doit tre blanche Remarque ajustez les param tres 8080 port et scenariserver4 1 server webapp name en fonction des param tres de compilation de la webApp et du param trage du serveur d application Juillet 2015 Version 1 2 Kelis 34 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation Configuration de SCENARIserver sous Debian m Login password par d faut Le login password d administration par d faut est admin admin Remarque Celui ci est modifiable a travers une application cliente connect e au serveur en tant qu administrateur L application cliente peut maintenant tre utilis e et la connexion vers ce SCENARIiserver entrep t d clar e Se r f rer au manuel de gestion fonctionnelle pour plus de d tail sur le param trage applicatif auteur 2 Configuration Pour commencer La webApp SCENARIserver est fortement param trable en fonction du contexte d utilisation et des fonctionnalit s d sir es Le param trage d un SCENARIserver install sous Debian Ubuntu en DEB se trouve dans letc scenariserver4 1 Ce dossier contient e un fichier init xml contena
23. c SCENARIserver est l usage du module Apache mod_proxy e HOWTO de la documentation Tomcat 7 http tomcat apache org tomcat 7 0 doc proxy howto html ou HOWTO de la documentation Tomcat 8 http tomcat apache org tomcat 8 0 doc proxy howto html e Documentation du module Apache mod_proxy http httpd apache org docs 2 2 mod mod_proxy html Tomcat sous Debian Ubuntu Si vous utilisez la version packag e de Tomcat tous les fichiers de configuration de Tomcat sont dans etc tomcat6 Il convient alors de remplacer les chemins TOMCAT_HOME conf dans les proc dures ci dessous par etc tomcat6 conf Param trer la m moire RAM allou e l application Si Tomcat est lanc le stopper cf proc dure dans le pr sent guide Ouvrir le fichier TOMCAT _HOME bin catalina sh Cr er la variable JAVA_OPTS en d but de fichier Exemple pour 1024Mo JAVA_OPTS Xms1024M Xmx1024M JAVA_OPTS e Proc dure alternative 13 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Configuration de Tomcat technique Linux Param trer la m moire RAM allou e Tomcat dans Debian Ouvrir le fichier etc defaults tomcat6 Modifier la variable JAVA_OPTS en milieu de fichier Adapter l option Xmx et ajouter l option Xms Exemple pour 1024Mo JAVA _OPTS Xms1024M Xmx1024M SJAVA OPTS Relancer le serveur d application Pour Tomcat 6 user computer sudo service tomcat
24. chnologies common io OIOException You cannot access outside the file size 998976 bytes You have requested portion 83439842 83439841 bytes File File txlog otx os size 1000000 stored 998976 filled 998976 max 536870912 5 at com orientechnologies orient core storage fs OAbstractFile checkRegions OAbstractFile java 363 6 at com orientechnologies orient core storage fs OFileClassic checkRegions OFileClassic java 230 7 at com orientechnologies orient core storage fs OFileClassic readByte OFileClassic java 120 8 at com orientechnologies orient core storage impl local OTxSegment scanForTransactionsToRecover OTxSegment java 233 9 at com orientechnologies orient core storage impl local OTxSegment recoverTransactions OTxSegment java 200 10 at com orientechnologies orient core storage impl local OTxSegment open OTxSegment java 87 Avant de r aliser cette mont e de version il convient de r aliser une sauvegarde compl te des donn es La phase de transformation automatique des donn es peut durer plusieurs minutes en fonction de la taille de la base de donn es Son d but est signifi par les lignes suivantes dans le fichier de log 11 Info Tue Jul 15 11 54 30 CEST 2014 DbScheduler repos 2 Start database migration DbVersion core from 0 to 1 class eu scenari orient init migr DbMigrCore0_1 3 4 51 Info Tue Jul 15 11 54 35 CEST 2014 DbScheduler rep
25. des param tres avanc s du serveur Juillet 2015 Version 1 2 Kelis 24 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation Configuration de SCENARIserver optionnel Propri t sOoLoadWaitFactor D commenter la ligne lt properties type Alone code com scenari s co transform oo HTransformerOo sOoloadWaitFactor level 2000 gt 8 lt properties gt pour contourner des probl mes de g n ration de LibreOffice http qa openoffice org is sues show_bug cgi id 63564 Chargement faussement synchrone du fichier LibreOffice e 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 Le mode headless ne fonctionne pas correctement sous Windows 003 3 le process OO peut se figer dans certains cas Exemple de param trage sous Linux 1 lt declareTag tagName ooConnectionPool classParser com scenari s co transform o0 0oConnectionPoolLoader gt 2 lt ooConnectionPool gt 3 lt ooConnection pipeMode true autoLaunch true headless true profilePath file tmp LO1 gt 4 lt oo
26. dification apport e a la configuration de SCENARIserver R initialiser la configuration dans etc scenariserver4 1 user computer S sudo scenariserver4 1 cfg reset Cette commande crase le dossier etc scenariserver4 1 conf avec les fichiers originaux scenariserver4 1 cfg propose ensuite de lancer la reconstruction du fichier etc scenariserver4 1 init xml Relancer le serveur d application Pour Tomcat 6 user computer sudo service tomcat6 restart Sauvegarder les donn es backup DB scenariserver4 1 cfg propose une fonction simple de sauvegarde de la base de donn es de SCENARIserver Cette commande d pend de la bonne configuration de scenariserver4 1 cfg qui s effectue dans le fichier etc scenariserver4 1 cfg conf 1 scenariserver4 1 cfg script config file 2 webappUrl http localhost 8080 scenariserver4 1 3 webappUser admin 4 webappPasswd admin 5 dataFolder var lib scenariserver4 1 javaserver 6 backupFolder var lib scenariserver4 1 backup webappUri url dans la webapp SCENARIserver telle que vue depuis le serveur webappUser webappPasswd identifiant et mot de passe permettant de se connecter SCENARIserver dataFolder dossier source contenant la base de donn es backupFolder dossier de destination de la sauvegarde IMPORTANT ne pas oublier d adapter ces valeurs en fonction de votre param trage de SCENARIserver Cette sauvegarde s effectue forc ment chaud
27. e via l outil de backup au choix de la proc dure ci dessus est mettre en oeuvre Restauration Processus de restauration Un incident syst me grave compromettant l int grit r f rentielle de la base de donn e peut conduire la n cessit de restauration d une sauvegarde Dans cette proc dure on consid rera le r pertoire backupDir comme r pertoire contenant une sauvegarde compl te des donn es utilisateur Arr ter le serveur d application Restaurer les r pertoires sauvegard s Restauration de la base de donn e Supprimer le r pertoire pathData javaserver db e Copier le contenu du r pertoire backupDir javaserver backup dans le r pertoire pathData ljavaserver db 45 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration SCENARIbatch technique Linux Restauration des autres r pertoires Copier coller le contenu des autres r pertoires sauvegard s privData updt pack gen blobs de backupDir dans les r pertoire du m me nom de pathData Relancer le serveur d application Juillet 2015 Version 1 2 Kelis 46 SCENARIserver4 1 manuel d installation et d administration technique Linux Proxy DB Chapitre 9 Proxy DB Le coeur de SCENARIserver est une webapp qui r side dans un serveur de servlet tel que Tomcat la plupart de la communication entre le serveur et les clients se fait en http ou https SCENARIserver comporte un module qu
28. er des droits d criture sur ce fichier Si tel n est pas le cas et que vous disposez des droits de remplacement uniquement copier coller au pr alable le fichier sur votre bureau le temps de le modifier Modifier ou ajouter un Connector sur le protocole HTTP 1 1 e Pour modifier le port utiliser l attribut port e Pour viter des probl mes d encodage de nom de fichier il est important de forcer Tomcat traiter toutes les url en UTF 8 Ajouter donc le param tre URIEncoding UTF 8 e Pour tendre la taille autoris e des ent tes HTTP ajouter le param tre maxHttpHeaderSize 65536 Exemple complet de param trage lt Connector port 8080 protocol HTTP 1 1 connectionTimeout 20000 redirectPort 8443 URIEncoding UTF 8 maxHttpHeaderSize 65536 gt TRES CET File Edit Format View Help pathname conf tomcat users xml gt lt GlobalNamingResources gt lt A Service is a collection of one or more Connectors that share a single container Note A Service is not itself a Container so you may not define subcomponents such as valves at this level Documentation at docs config service htm gt lt service name Catalina gt lt The connectors can use a shared executor you can define one or more named thread pools gt lt lt Executor name tomcatThreadPool namePrefix catalina exec maxThreads 150 minspareThreads 4 gt lt A Connector rep
29. esceceeeceeeceeeeesaeeeeeeteeees 32 1 Installation 32 2 Configuration 35 Chapitr 7 lt Monitoring ame ee NEGU Ri rn ee Rel PP sr on open T TATO Ec AN un ce 41 Chapitre 8 SCENARIDAICH st nes he nn ele eral dl ee Il oh el ee 43 1 Installation 43 2 Sauvegarde Restauration DB 43 Chapltre 9 Proxy DB ar sees enter en Mt ne nen tes dee are E es eke eee eee inter 47 SCENARIserver4 1 manuel d installation et d administration Introduction technique Linux Introduction Conventions Dans ce document nous utiliserons les conventions suivantes xXX XXX XXX XXX adresse IP du serveur ou URL d acc s e pathData path absolu d acc s au r pertoire de travail de l application SCENARIserver vs SCENARIserverLite Depuis la version 4 0 de SCENARIserver deux branches sont propos es e SCENARIserverLite les fichiers de contenu utilisateur sont enregistr s sur le disque dur du serveur sous la m me forme que leur vue dans l atelier L administration est simplifi e mais les fonctionnalit s limit es e SCENARIserver cette application int gre un syst me de base de donn es orient graphe de documents Les fichiers de contenu utilisateur sont enregistr s dans un ensemble de fichiers binaires blobs IMPORTANT Cette application au spectre fonctionnel complet gestion des fonctions collaboratives impose une administration mat rielle et logicielle rigoureuses stabilit du syst me gestion des backups
30. i prend en charge tous les aspects collaboratifs entre auteurs Ce module est un serveur nodejs qui communique par d faut avec le client en websocket sur un port d di Nginx http nginx org en docs http websocket html et Apache http httpd apache org docs 2 4 mod mod_proxy_wstunnel html sont des serveurs Web HTTP HTTPS qui permettent de faire passer les deux flux http et websocket par un port unique 47 Juillet 2015 Version 1 2 Kelis
31. lePath file C TMP LO1 gt 4 lt ooConnectionPool gt 2 Installation Cr ation de la webApp SCENARIserver Les sources SCENARI server doivent avoir t d compr ss es au pr alable dans le r pertoire pathSrc Vx y z SCENARIserver Param trer la webApp via les fichier de configuration du r pertoire pathSrc Vx y z SCENARIserver conf cf section Configuration Ex cuter le fichier pathSrc makeWar bat ou pathSrc makeWar sh S Compilation en cours sous windows Le fichier scserver40 war doit alors avoir t cr dans le r pertoire ou pathSrc initialisation de l environnement d ex cution L installation et la mise jour de SCENARIserver impliquent la d finition de l environnement d ex cution Cr er le r pertoire pathData si il n existe pas Copier coller le contenu du r pertoire pathSrc Vx y z SCENARIserver data dans le r pertoire pathData Juillet 2015 Version 1 2 Kelis 26 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation Configuration de SCENARIserver Exemple windows Gu Computer Data D Data scserver40 Organize Include in library v Share with v New folder E ve Favorites Name Date modified Type BD Desktop nativlib 9 18 2012 10 30 4M File folder ie Downloads nodejslib 9 18 2012 10 30 AM File folder Recent Places Commentaires g n raux Sp cifique
32. ll ttf mscorefonts installer Sous Redhat et Centos yum install curl cabextract xorg x11 font utils fontconfig rpm i https downloads sourceforge net project mscorefonts2 rpms msttcore fonts installer 2 6 1 noarch rpm 9 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Configuration syst me technique Linux Chapitre 3 Configuration syst me Variables d environnement Les variables suivantes doivent tre d clar es adapter les path e CATALINA_HOME si le serveur d application Tomcat a t choisi chemin absolu vers apache Tomcat ex opt apache tomcat 7 0 64 e JAVA HOME chemin absolu vers la JDK pr c demment install e ex opt jdk1 7 0_80 e OOO_DISABLE_RECOVERY 1 si libreOffice a t install configuration du mode de reprise sur incident de LibreOffice e UNO_PATH si libreOffice a t install chemin vers le r pertoire program de LibreOffice ex opt libreoffice4 3 program M moire swap L application SCENARIserver est amen e ex cuter des applications tierces LibreOffice convert etc L impl mentation sous Unix Linux bsd etc de JAVA un limitation s rieuse qui dicte que lorsqu un processus Java d marre un nouveau processus effectue un fork le syst me doit avoir au moins la m me quantit de m moire disponible que la quantit occup e par le processus Java Si l OS ne dispose pas d assez de m moire l excepti
33. mcat SCENARIserver en service Copier coller le code suivant dans un diteur de texte Red Hat Fedora CentOS 1 This is the init script for starting up SCENARIserver 2 3 chkconfig 345 90 10 4 description Starts and stops the Tomcat daemon of SCENARIserver 5 6 7A 8 Server configuration Juillet 2015 Version 1 2 Kelis 16 SCENARIserver4 1 manuel d installation et d administration technique Linux Configuration de Tomcat 9 10 Name of the server used when printing out status 11 serverName SCENARIserver 12 13 Set this to the path of the tomcat folder 14 tomcat opt SCENARIserver tomcat 15 16 user to run the tomcat server as 17 you have to create this user yourself he must be owner or have write permission 18 on tomcat webapp dir scenari workshop dir and other temporary dirs 19 runasuser root 20 21 Set this if you need to specify a specific JURE 22 export JAVA_HOME opt SCENARIserver jre 23 24 SCENARIserver needs a minimum of 256Mb of heap space 25 heapspace 512M 26 27 Extra JVM options 28 extra_options 29 30 JVM options 31 opts_start Xms heapspace Xmx heapspace Dorg apache tomcat util buf UDecoder ALLOW_ENCODED_SLASH true extra_options 32 opts_stop Xms64M Xmx128M 33 34 Path to tomcat pid file 35 export CATALINA_PID tomcat tomcat pid 36 37 Shutdown timeout before tomcat is killed in seconds 38 kill_
34. mcat process is still running 66 echo ERROR S serverName seems to be already running as process cat SCATALINA_PID exit 1 68 else 69 Tomcat process not running but lock file not deleted 70 echo WARNING orphan lock file Lock file deleted 71 rm SCATALINA_PID 72 fi UE Fi 74 log_begin_msg Starting serverName 75 export JAVA_OPTS Sopts_start 76 su s bin bash c startup runasuser Ti log_end_msg 78 79 stop 80 log_begin_msg Stoping serverName 81 export JAVA_OPTS Sopts_stop 82 Kill all LibreOffice instances run but the tomcat user 83 pkill 9 u Srunasuser soffice 84 su s bin bash c shutdown kill_timeout force runasuser 85 log_end_msg 86 87 restart 88 stop 89 start 90 91 92 See how we were called 93 case 1 in 94 start 95 start 96 ii 97 stop 98 stop 99 ae 100 status 101 status SCENARIserver 102 echo Status not implemented 103 ae 104 restart 105 restart 106 oe 107 108 echo Usage 0 start stop restart 109 exit 1 110 esac 111 112 exit 0 EditeR les lignes indiquant Juillet 2015 Version 1 2 Kelis 20 SCENARIserver4 1 manuel d installation et d administration technique Linux Configuration de Tomcat e le r pertoire de tomcat variable tomcat e le r pertoire de la JRE variable JAVA HOME e le r pertoire de libreoffice variable UNO_PATH les options de lancement de la JRE la m moire allou
35. n Versions support es sid jessie OU wheezy Ajoutez la ligne deb appropri vos sources d applications sid deb http scenari platform org deb sid main jessie deb http scenari platform org deb jessie main wheezy deb http scenari platform org deb wheezy main Veuillez consulter la documentation du gestionnaire de paquets de votre distribution pour plus d information Ubuntu https help ubuntu com Its ubuntu help addremove sources html Ajouter la cl d authentification user computer wget O http scenari platform org deb scenari asc sudo apt key add D Cette cl permet au syst me de v rifier l authenticit et l int grit des paquets propos s Vous pouvez installer cette cl via votre gestionnaire de paquet graphique en la t l chargeant au pr alable Il est cependant possible d utiliser un d p t sans ajouter la cl d authentification Mais ce n est pas recommand Plus d information ce sujet et installation manuelle dans la documentation ubuntu htip doc ubuntu fr or g tutoriel comment_modifier_sources_maj gerer_les_cles_d_authentification 33 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver sous Debian technique Linux Mettre a jour la liste des paquets disponible user computer sudo apt get update Installer SCENARIserver l aide du paque
36. nt la configuration actuellement active un dossier conf contenant les ressources n cessaires la construction du fichier init xmil Ne pas diter le fichier init xml directement mais modifier les fichiers dans le dossier conf Une fois les modifications apport es la commande scenariserver4 1 cfg permet de reconstruire le fichier init xml Dans les parties suivantes nous allons d crire une partie du param trage disponible dans le dossier etc scenariserver4 1 conf Fichier main property 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 35 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver sous Debian technique Linux 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 va
37. on suivante est lev e java io IOException java io IOException Cannot allocate memory at java lang UNIXProcess lt init gt UNIXProcess java 148 at java lang ProcessImpl start ProcessImpl java 65 at java lang ProcessBuilder start ProcessBuilder java 451 at java lang Runtime exec Runtime java 591 cf http developers sun com solaris articles subprocess subprocess html http stackoverflow com questions 209875 from what linux kernel libc version is java runtime exec safe with regards to m e http www coderanch com t 419196 Java General java there any way execute Linux Si le processus Java de SCENARIserver utilise 900MB de m moire au moment ou SCENARI d marre l application convert pour redimensionner un image il faut que le syst me dispose d au moins 900MB de m moire allouable RAM et swap confondu Les 900MB suppl mentaires ne seront jamais r ellement allou s convert utilise en moyenne 3MB mais pendant un cours instant il faut qu ils soient pr sents Juillet 2015 Version 1 2 Kelis 10 SCENARIserver4 1 manuel d installation et d administration technique Linux Configuration syst me Contournement du probl me ajouter de la m moire swap Une solution ce probl me est simplement d ajouter de la m moire swap suppl mentaire en g n rale d au mois la quantit de m moire allou au processus Java La proc dure suivante ajou
38. onnel 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 e D commenterlaligne server conf batch batch server xml pour activer le service e D commenterlaligne 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 23 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver technique Linux sp cifique DB optionnel service liveCollab module de collaboration entre auteurs e D commenter la ligne server conf 1liveCollab collab odb liveCollab xml pour activer le service Sp cifier le port utiliser server conf 1liveCollab 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
39. os 6 Start rebuild Db repos local sc D scenari data scserver41 javaserver db La fin et la r ussite de cette tape seront indiqu par ces lignes 11 Info Tue Jul 15 11 56 13 CEST 2014 DbScheduler repos 2End rebuild Db repos in 98280ms 3 4 51 Info Tue Jul 15 11 56 13 CEST 2014 DbScheduler repos 6End database migration DbVersion core from 0 to 1 Un arr t du serveur pendant cette phase de migration peut conduire a une perte des donn es et n cessitera l utilisation d un backup Les donn es de la 4 1 ne peuvent pas tre utilis es dans un contexte 4 0 pas de compatibilit descendante SCENARIserverLite Aucune transformation de donn e n est op r e les structures de donn e sont iso fonctionnelles R pertoires concern s server work path javaserver wsps server work path javaserver privData Donn es applicatives R pertoire temporaire Le r pertoire temporaire param tr via la variable server temp path peut tre purg Juillet 2015 Version 1 2 Kelis 30 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation Configuration de SCENARIserver Mod le documentaire Le ou les mod les documentaires wsppack install s et exploit s dans une version X Y de scenari sont incompatibles avec toute version X Y 1 le syst me l indiquera clairement Il convient donc d installer sur SCENARIserver4
40. pourraient apporter des faille de s curit Il est donc conseill de les supprimer 15 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Configuration de Tomcat technique Linux Supprimer les r pertoires docs examples host manager manager dans TOMCAT_HOME webapps Purge des webapps par d faut de Tomcat Ouvrir le fichier TOMCAT_HOME conf server xml et supprimer le connector AJP Supprimer ou commenter la ligne lt Connector port 8009 protocol AJP 1 3 TedirectPort 3443U f gt D marrer Tomcat Cette proc dure d crit comment d marrer le serveur d application Tomcat Conditions d utilisation Tomcat a t param tr pour d marrer automatiquement lors de l initialisation du serveur Cette proc dure n est donc utiliser qu en cas de dysfonctionnement rencontr sur le serveur d application Ex cuter la commande TOMCAT_HOME bin catalina sh start Il faut tre connect avec votre utilisateur pour tomcat pour r aliser cette action Test de bon fonctionnement Une fois d marr la requ te suivante doit r pondre http 127 0 0 1 8081 scserver40 s chain u ping page blanche Stopper Tomcat Cette proc dure d crit comment arr ter le serveur d application Tomcat Ex cuter la commande TOMCAT_HOME bin catalina sh stop Il faut tre connect avec votre utilisateur pour tomcat pour r aliser cette action Passer To
41. resents an endpoint by which requests are received and responses are returned Documentation at Java HTTP Connector docs config http html blocking amp non blocking Java AJP Connector docs config ajp htm APR CHTTP AJP Connector docs apr html Define a non SSL HTTP 1 1 Connector on port 8080 gt lt connector po using the shared thread pool gt lt lt Connector executor tomcatThreadPool port 8080 protocol HTTP 1 1 connect ionTimeout 20000 redirectPort 8443 gt gt lt Define a SSL HTTP 1 1 Connector on port 8443 This connector uses the JSSE configuration when using APR the connector should be using the openSsL style configuration described in the APR documentation gt lt lt Connector port 8443 protocol HTTP 1 1 SSLEnabled true maxThreads 150 scheme https secure true clientauth false ss1Protocol TLs gt gt lt Define an AJP 1 3 Connector on port 8009 gt lt Connector port 8009 protocol AIP 1 3 packetsize 65536 redirectPort 8443 gt lt An Engine represents the entry point within Catalina that processes facultatif Si le fichier server xml a t copi au pr alable sur le bureau pour y effectuer les modifications penser a le remettre dans le r pertoire TOMCAT_HOME conf server xml Suppression des l ments non utilis s de Tomcat Tomcat apporte un lot d outils lors de son installation standard non utilis s ou qui
42. riable d finit le fichier de log scenari Exemple server log path pathLog webAppNamel 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 e D commenter la ligne server conf batch batch server xml pour activer le service e 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 1liveCollab 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 e 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
43. rver4 Effectivement ce type d architecture logicielle est sensible aux instabilit s syst me qui peuvent compromettre l int grit des donn es arr t non programm de la machine Sauvegarde chaud syst me en fonctionnement 43 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration SCENARIbatch technique Linux Sauvegarde configuration Ouvrir le fichier pathScBatch apps backup backup property logs backup bat _ backup property _ backup sh build xml _ readme txt Sp cifier les propri t s du programme dans ce fichier et l enregistrer _ requis program webapp url URL d acc s la webApp Exemple program webapp url http 127 0 0 1 8080 scserver41 requis program user login d administration Exemple program user admin requis program password password d administration Exemple program password admin requis program logs dir Chemin absolu vers le r pertoire de log Exemple program logs dir pathLog scBatch Processus de sauvegarde SCENARIserverDb int gre un syst me de base de donn es orient graphe de documents Ainsi il est important de lancer les processus de backup sur un tat stable de la base afin d en maintenir l int grit r f rentielle lors des restaurations Pour ce faire deux commandes sont a ex cuter e avant la sauvegarde des fichiers permet de passer la base de donn e dans un statut
44. se generic service host_name serverHostname service_description SCserver coperia2 servicegroups scservers check_interval 1440 retry_interval 30 U check_command ping_scserverdata_ssl serverHostname nameWebapp scuserSystem mot de passe scuserSystem Autres contr les utiles Ex cution des backups Place disque Ram utilis e Juillet 2015 Version 1 2 Kelis 42 SCENARIserver4 1 manuel d installation et d administration technique Linux SCENAR Ibatch Chapitre 8 SCENARI batch SCENARlbatch propose des librairies utilitaires permettant de piloter en dehors de l interface cliente SCENARIserver gestion des items d claration massive d utilisateurs d clenchement de g n ration Les librairies propos es sont cod es dans le langage de scripting ANT fip antapache org T 1 Installation Installation Convention pathScBatch Chemin d installation de SCENARIbatch Activation du service batch Afin de rendre utilisables les directives SCbatch il est imp ratif d activer le service batch lors du param trage et de la compilation de la webapp D compresser le fichier SCENARIbatch zip t l charg dans le r pertoire pathScBatch 2 Sauvegarde Restauration DB La mise en place d un syst me de sauvegarde des donn es est fortement recommand e sur SCENARIserverLite fileSystem mais devient indispensable dans l environnement base de donn es de SCENARIse
45. serveur lite Les informations d identifications sont stock es dans le r pertoire pathData users ac D ploiement de la webApp SCENARIserver D ploiement du fichier xxx war pr c demment cr dans le serveur d application Convention Dans cette proc dure xxx d signe le nom de la wepApp produite Stopper le serveur d application si a n est pas d j fait Copier coller le fichier xxx war dans le r pertoire TOMCAT_HOME webapps ou JBOSS_HOME server scserver deploy 27 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARIserver technique Linux GU m Computer Data D Program Tomcat 6 0 webapps Organize v Open New folder Al Name Qu Computer ca System C dora ca Data D Data Logs T scserver40 war Program Java Tomcat 6 0 d bin d conf d ISAPI db lib db logs LogsTomcat temp webapps work manager i ROOT Supprimer le r pertoire TOMCAT_HOME webapps xxx si il existe Relancer le serveur d application Commentaires g n raux Test de bon fonctionnement Pour tester la bonne installation de l application visitez dans un navigateur web l URL suivante http localhost 8080 scserver41 s chain u ping Apr s s tre authentifi la page web r sultante doit tre blanche Remarque ajustez les param tres 8080 port et scserver41 server
46. t instrumentalisant l int gration souhait e Vous devez maintenant choisir votre serveur d application Tomcat 6 Tomcat 7 ou Jetty Pour SCENARIserver 4 1 sous Tomcat 6 user computer S sudo apt get install scenariserver4 1 tomcat6 Pour SCENARIserverLite 4 1 sous Tomcat 6 user computer sudo apt get install scenariserverlite4 1 tomcat6 SCENARIserver DB user computer apt cache search SCENARIserver4 1 scenariserver4 1 SCENARIserver 4 1 Core web app files scenariserver4 1 jetty SCENARIserver 4 1 Jetty integration scenariserver4 1 tomcat6 SCENARIserver 4 1 Tomcat6 integration scenariserver4 1 tomcat7 SCENARIserver 4 1 Tomcat7 integration SCENARIserverLite Lite user computer apt cache search SCENARIserverLite4 1 scenariserverlite4 1 SCENARIserverLite 4 1 Core web app files scenariserverlite4 1 jetty SCENARIserverLite 4 1 Jetty integration scenariserverlite4 1 tomcat6 SCENARIserverLite 4 1 Tomcat6 integration scenariserverlite4 1 tomcat7 SCENARIserverLite 4 1 Tomcat7 integration Relancer le serveur d application Pour Tomcat 6 user computer sudo service tomcat6 restart R sultat L installation de SCENARIserver est finie Celui ci est maintenant op rationnel avec le p
47. te un fichier de swap suppl mentaire de 1Gb Dans notre exemple on ajoute un ficher vide dans sudo dd if dev zero of swap img bs 1024k count 1024 Le formater en swap sudo mkswap swap img Ajouter le swap au syst me en cours d ex cution sudo swapon swap img Vous pouvez ajouter ce fichier fstab pour qu il soit ajout automatiquement au d marrage erdo nano ete istab Ajouter la ligne suivante la fin du fichier swap img none swap sw 0 0 Limite du nombre de fichiers ouverts simultan ment L application SCENARIserver est amen ouvrir un grand nombre de fichier simultan ment Par d faut Linux impose une limite au nombre de fichiers ouvrable par un m me utilisateur en g n ral cette limite est de 1024 fichiers Il convient donc d augmenter cette limite pour l utilisateur qui fait tourner la JVM de Tomcat sinon vous risquez de tomber sur l erreur Java Too many open files Augmentation de cette limite 4096 sur Debian Ubuntu Ouvrir le fichier etc security limits conf et ajoutez les lignes lt user gt soft nofile 4096 lt user gt hard nofile 4096 ou lt user gt est l utilisateur qui doit faire tourner SCENARIserver Indique au Kernel qu il doit recharger sa configuration fSysct ll p Activer la prise en compte des limites de etc security limits conf par PAM Ouvrir le fichier etc pam d su et d commenter la ligne session required pam_limits so
48. timeout 30 39 40 41 LibreOffice Configuration 42 43 Set DISPLAY variable if you want LibreOffice to use a specific display 44 export DISPLAY localhost 1 0 45 46 If set this stops the recovery dialog prompting you as 00 0 starts up 47 after a crash instead the recovery files are just silently 48 accumulated 49 export OOO_DISABLE_RECOVERY 1 50 51 52 53 Source function library 54 etc rc d init d functions 55 56 Get config 57 etc sysconfig network 58 59 Check that networking is up 60 S NETWORKING no amp amp exit 0 61 62 startup Stomcat bin startup sh 63 shutdown tomcat bin shutdown sh 64 65start 17 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Configuration de Tomcat technique Linux 66 x startup exit 5 67 Tomcat pid checks 68 if f SCATALINA_PID then 69 if ps p cat CATALINA_PID we 1 gt 1 then 70 Tomcat process is still running 71 echo ERROR serverName seems to be already running as process cat CATALINA_PID 72 exit 1 73 else 74 Tomcat process not running but lock file not deleted 75 echo WARNING orphan lock file Lock file deleted 76 rm SCATALINA_PID 77 78 fi 79 echo n Starting serverName 80 export JAVA_OPTS Sopts_start 81 su s bin bash c Sstartup runasuser 82 retval 83 echo 84 return Sretval 85 86
49. tly 20120917 0530 Open in new window Send to gt Create shortcut Cliquer sur Extract Open Open with Restore previous versions Cut Copy Rename Properties F Show extracted files when complete Es ee Param trez les fichiers de configuration du r pertoire pathSrc Vx y z SCENARIserver conf Fichier main property Juillet 2015 Version 1 2 Kelis 22 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation Configuration de SCENARIserver 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 opti
50. ver 2008 R2 Windows Server 2012 OS Linux Exp riences avec Debian 7 Tomcat 7 et 8 Ubuntu 14 04 Tomcat 7 et 8 Redhat Centos 6 Jboss Tomcat 7 et 8 T l chargement Windows http scenari platform org projects scenari files SCENARIserver win latestStable Linux 32bits http scenari platform org projects scenari files SCENARIserver lin latestStable Linux 64bits http scenari platform org projects scenari files SCENARIserver lin_x86_64 latestStable Juillet 2015 Version 1 2 Kelis 6 SCENARIserver4 1 manuel d installation et d administration technique Linux Installation des outils tiers Chapitre 2 Installation des outils tiers Vous trouverez des exemples de script d installation sur cette page http scenari platform org trac scenari wiki InstallServerLinux 1 Installation d une JVM SCENARIserver doit tourner dans une JVM d Oracle JDK JRE 7 ou OpenJDK version 7 Vous pouvez utiliser la JVM propos e par votre distribution ou bien en t l charger une SCENARIserver EST INCOMPATIBLE avec gij GNU Interpreter for Java Installation de la JVM d Oracle Java SE 7 Suivre la documentation d installation fournie par Oracle pour Java SE 7 Source de l installeur http www oracle com technetwork java javase archive 139210 html htip www oracle c om technetwork java javase archive 139210 htm Sous Debian et Ubuntu sudo add apt repository y ppa webupd8team java sudo apt get update amp
51. xxx xxx xxx scserver41 ws e 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 e Param trer le path du fichier de log server conf liveCollab logPath logPath scserver4 1 scenari liveCollab log LDAP optionnel LDAP Pour activer le mode LDAP e D clarer le userMor SurFS server conf usermgr usermgr fs fsWithLdap xml Sur DB server conf usermgr usermgr odb odbWithLdap xml e 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 a 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 amp brouillon Sp cifique a 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

SCENARIserver4.1 : manuel d`installation et d`administration

Contents

Download Pdf Manuals

Related Search

Related Contents