SCENARIserver4.1 : manuel d`installation et d`administration
Contents
1. Le SCENARIserver4 1 manuel d installation et d administration technique Windows SCENARI server4 1 manuel d installation et d administration technique Juillet 2015 Version 1 2 Kelis SCENARI server4 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 CES Cette uvre est mise a disposition selon les termes de la Licence Creative Commons Attribution 3 0 France http creativecommons org licenses by 3 0 fr Table des mati res L O Co UC LORS neta a nee ages Rea re Chapitre 1 Architecture technique ccccccscssseesseessseecseeessseecseeessseesseessseeesseeeeaes Chapitre 2 Installation des outils tiers 4 1 Installation de LibreOffice 4 3 The Document Foundation 2 Installation d une JVM 3 Installation d un moteur de servlet 4 Installation de Latex Optionnelle Chapitre 3 Configuration syst me sis Chapitre 4 Configuration de Tomcat ccccccsscssseesseessseesseeessseessseesseesseessseesseeess Chapitre 5 Installation Configuration de SCENARIserver ccscccessseeesseeeeseeeees 1 Configuration de SCENARI server 2 Installation 3 Mont e de version Chapitre 6 MONDION O enrian uote Chapitre 7 SCENARIDAICR neram a a ini 1 Installation 2 Sauvegarde Restauration DB Chapitre PO DB2. 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 OS Windows Exp riences avec Windows Server 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 htip 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 Windows Installation des outils tiers Chapitre 2 Installation des outils tiers 1 Installation de LibreOffice 4 3 The Do
3. 0 32 Server Http Mtomcat apache Path to executable D Program Tomcat 6 0binitomecat exe HRSH Tomcat Startup type Automatic Service Status Started Stop Pause Restart OK Cancel Apply Commentaires g n raux D marrage automatique ll est conseill de param trer le service afin qu il General Log On Logging Java Startup Shutdown se lance de fa on automatique lors de Service Name tomcat l initialisation dus syst me o Description apache Tomcat 6 0 32 Server http fftomcat apache Pour ce faire positionner le champ Startup ee n T D Program Tomcat 6 0 bin tomcat exe RS Tomcat type Automatic Service Status Started OK Cancel Apply Arr ter Tomcat Ex cuter le gestionnaire de service Tomcat cf procedure dans le pr sent guide Aller dans l onglet General Cliquer sur le bouton Stop 17 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Configuration de Tomcat technique Windows Apache Tomcat 6 Properties Apache Tomcat 6 Apache Tomcat 6 0 32 Server http itomcat apache automatic o O PAUSE Apple Juillet 2015 Version 1 2 Kelis 18 SCENARIserver4 1 manuel d installation et d administration technique Windows Installation Configuration de SCENARI server Chapitre 5 Installation Configuration de
4. URISyntaxException Illegal character in path gt 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 Le path d installation sera appel JBOSS HOME dans le suite du document 4 Installation de Latex Optionnelle L exploitation des formules math matiques LaTeX impose la pr sence de Miktex sur le serveur Source de l installeur http www miktex org _ Les ex cutables doivent tre pr sents dans le PATH Juillet 2015 Version 1 2 Kelis 8 SCENARIserver4 1 manuel d installation et d administration technique Windows Configuration syst me 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 pathAppl Tomcat7 e JAVA HOME chemin absolu vers la JDK pr c demment install e ex C Program Files Java jdk1 7 0_80 OOO DISABLE RECOVERY 1 si libreOffice a t install configuration du mode de reprise sur incident de LibreOffice UNO PATH si libreOffice a t install chemin vers le r pertoire program de LibreOffice ex D Program Files x86 LibreOffice org 4 program D claration des variables d en
5. connexion vers ce SCENARI serveur 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 D5 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARI server technique Windows 3 Montee de version Passage de SCENARI server4 0 a SCENARIserver4 1 Parametrage du serveur Les fichiers de configuration de la webapp n ont que peu volu entre SCENARI server4 0O et SCENARI server4 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 j d clar s Pour r aliser cela automatiquement si un contexte LDAP tait d j actif dans votre syst me en 4 0 il vous faudra ex cuter le script batch apps dbMigrFrom40To41 pr sent dans l application SCENARIbatch cf SCENARIbatch P31 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
6. ee license thirdParty_link 9 17 2012 5 33 4M makewar 9 17 2012 5 30 AM Windows Batch File 1 KB manual 9 17 2012 5 34 AM Text Document 2KB 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 23 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration technique Windows Installation Configuration de SCENARI server Exemple windows i CL j Computer Data Dit Data scserver40 Include in library Share with New Folder Organize ihe re P A Favorites Mame Date modified Type BY Desktop ut nativlib 9162012 10 30 4M File Folder de Downloads nadejslib 9 18 2012 10 30 AM File Folder S Recent Places Commentaires g n raux Sp cifique 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 ja fait r pertoire TOMCAT HOME webapps ou Copier coller le
7. fichier xxx war dans le JBOSS HOME server scserver deploy Kelis Juillet 2015 Version 1 2 24 SCENARIserver4 1 manuel d installation et d administration technique Windows Installation Configuration de SCENARI server L webapps 1 a m Computer Data Ds Program Tomcat 6 0 webapps Organize Open New folder a Mame jE Computer Ba ocs a System Cr a Pata Di di Data di Logs scservert war di Program di Java di Tomcat 6 0 di bin d conf d ISAPI d lb di logs di LogsTomcat d temp d webapps di work d manager Wb 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 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
8. pertoire pathLog Cette proc dure d crit comment d finir le r pertoire de log de Tomcat Ex cuter le gestionnaire de service Tomcat via l outil TOMCAT HOME bin tomcat6w exe Aller dans l onglet Logging Modifier la valeur de champ Log path 2 Exemple de param trage ajuster en fonction des besoins Log path logPath Tomcat 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 Juillet 2015 Version 1 2 Kelis 14 SCENARIserver4 1 manuel d installation et d administration technique Windows Configuration de Tomcat Exemple de configuration windows Sharec loader irites Dc Biceenn RL Les ato MM re0office A URE java jurt jar file D Program Files x86 LibreOffice AV URE java riche ar tikes 7 D Ptogram 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 5 program classes noil Jar Connecteurs Tomcat Le connecteur Tomcat doit tre utilis pour les sp cification suivantes Specification du port 8
9. 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 amp 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 SCENARI server pas dnas SCENARI serverLite optionnel server db drf active la possibilit de creer des ateliers calque de brouillon Cette option n existe que dans SCENARI server pas dnas SCENARI serverLite Fichier advanced server xml Ce fichier permet de d finir des param tres avanc s du serveur Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Installation Configuration de SCENARI server technique Windows optionnel Propri t sOoLoadWaitFactor D commenter la ligne lt properties type Alone code com scenari s co hd IS ho CO Tam Some OO S OL oA ON MSC LOMME UOU gt 8 lt properties gt pour contourner des probl mes de g n ration de LibreOffice lMtP a8 openoftice orgris sues show_bug cgi id 63564 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 di
10. reponse HTTP 200 succ s e 503 warning erreur dans tous les autres cas un check par 24h lors d une activit applicative faible Exemple de param trage Nagios Declaration d une nouvelle commande define command command _ name ping _scserverdata ssl command _line usr lib nagios plugins check_http S H ARG1 ARG2 s chain u adminOdb cdaction CheckAuto a ARG3 ARG4 D claration d un nouveau service define service use generic service host_name serverHostname service description SCserver coperia2 servicegroups scservers check interval 1440 retry_interval 30 check command ping_scserverdata_ssl serverHostname nameWebapp scuserSystem mot de passe scuserSystem j Autres contr les utiles Ex cution des backups Place disque Ram utilis e Juillet 2015 Version 1 2 Kelis 30 SCENARIserver4 1 manuel d installation et d administration technique Windows SCENARIbatch Chapitre 7 SCENARI batch SCENARIbatch 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 generation Les librairies propos es sont cod es dans le langage de scripting ANT ftip antapache org 1 Installation Installation Convention pathScBatch Chemin d installation de SCENARIbatch Activation du service batch Afin de rendre
11. 0 pour qu une transformation automatique de celui ci soit op r e lors du premier lancement R pertoires concern s server work path javaserver db 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 SCENARI server4 1 Si cette suppression n est pas r alis e l erreur ci dessous peut se produire et sera ignorer aucune incidence fonctionnelle 1INFO 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 Juillet 2015 Version 1 2 Kelis 26 SCENARIserver4 1 manuel d installation et d administration technique Windows Installation Configuration de SCENARI server 4com orientechnologies 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 Onbstractlhile java 363 6 at com orientechnologies orient core storage fs OFileClassic checkRegi
12. 080 par d faut Encodage des URLs aille 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 D Assurez vous de bien disposer 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 Pour modifier le port utiliser l attribut port 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 UTr 8 Pour tendre la taille autoris e des ent tes HTTP ajouter le param tre maxHttpHeadersSize 65536 Exemple complet de param trage lt Connector port 8080 protocol HTTP 1 1 connectionTimeout 20000 redirectPort 8443 URSEMmeecamne llr 8 maxHttpHeaderSize 65536 gt 15 Juillet 2015 Version 1 2 Kelis SCENARIserver4 1 manuel d installation et d administration Configuration de Tomcat technique Windows Bj server Notepad fal EX 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
13. 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 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 gt lt A Connector represents 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 html APR CHTTP AIP Connector ee ep emi Define a non SSL HTTP 1 1 Connector on port 8080 gt lt connector port 8080 protocc HTTP 1 1 connectionTimeout 20000 redirectPort 8443 gt lt A Connector using the shared thread pool gt lt lt Connector executor tomcatThreadPool port 8080 protocol HTTP 1 1 connectionTimeout 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 ss Protocol TLs gt gt lt D
14. HOME bin startup bat Il est n anmoins possible est conseill de l installer en tant que service Windows Executer TOMCAT _ HOME bin service install Tomcat doit interagir avec le bureau Windows pour pouvoir envoyer des t ches LibreOffice Pour que le service interagisse avec le bureau aller dans l cran de gestion des services Outils d administration gt service et sur le service Tomcat clic droit puis propri t s gt connexion Utiliser un compte autoris lancer le service Administrateur par exemple Lancer au moins une fois LibreOffice avec ce compte pour supprimer un ventuel message d invite qui rendrait inutilisable le lancement de LibreOffice par Scenari lanc en service Ouvrir le Gestionnaire de service Ex cuter le gestionnaire de service Tomcat via l outil TOMCAT HOME bin tomcat6w exe Juillet 2015 Version 1 2 Kelis 12 SCENARiserverd 1 manuel d installation et d administration technique Windows Configuration de Tomcat tenative 1 dil ep tomcath exe AS tomcat w exe Le tomcat juli jar tomcat native tar gz rT ll est indispensable de l ex cuter en tant la bootstrap 2j qu administrateur Pour ce faire faire un click Yp tomcat zi droit sur OMCAT_HOME bin tomcat6w exe tomeat juli OPEN b Run as administrator DUIS choisissez entree de menu Run as Troubleshoot compatibility Ten Pin to Taskbar ad MI nistrator Pin to Start Menu Restore previous versi
15. SCENARIserver SCENARI server est fourni sous la forme d une archive compress e Une fois d compress et param tr SCENARI server sera compiler pour produire la webApp fichier war a installer dans Tomcat 1 Configuration de SCENARI server 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 zZ SCENARI server Fai re u n cl i C k d ro it S u r e fi ch i e r S ee 1inightly_20120903 0452_fr FR WINNT_x86 jB SCENARIcient_4 0 3 11ni htly_20120903 0452_fr FR WINNT_x86 oft S G E N A R se rve r XXX Z p Eh SCENARIserver_4 0 3 rs 20120917 0530 9j Restore previous versions Send to gt Cut Copy Create shortcut Delete Rename Properties Cliquer sur Extract Cee Select a Destination and Extract Files Files will be extracted to this folder Ey Parametrez les fichiers de configuration du r pertoire pathSrc Vx y z SCENARI server cont Fichier main property 19 Juillet 2015 Version 1 2 Kelis SCENARiserverd4 1 manuel d installation et d administration Installation Configuration de SCENARI server technique Windows 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 riq
16. cument Foundation Suivre la documentation d installation fournie par The Document Foundation Source de l installeur https www libreoffice org download libreotfice stable 2 Installation d une JVM Installation de la JDK 1 7 d Oracle 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 3 Installation d un moteur de servlet Scenari est packag de facon 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 Sources de l installeur Tomcat 7 htip tomcat apache org download 70 cgi Sources de l installeur Tomcat 8 htip 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 7 duillet 2015 Version 1 2 Kelis SCENARiserverd4 1 manuel d installation et d administration Installation des outils tiers technique Windows 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
17. duct key genuine Microsoft software See also Learn more online Action Center Windows Update Dans l cran System Properties qui appara t cliquer sur le bouton Environment Variables System Properties ki Computer Name Hardware Advanced Remote ou must be logged on as an Administrator to make most of these changes Performance Visual effects processor scheduling memory usage and virtual memory Settings User Profiles Desktop settings related to your logon Settings Startup and Recovery Sistem startup patem failure and debugging information Settings Environment Variables OF Cancel Apply Juillet 2015 Version 1 2 Kelis 10 SCENAR Iserver4 1 manuel d installation et d administration technique Windows Configuration syst me Dans l cran Environment Variables qui appara t cliquer sur le bouton New Environment Yariables User variables For AL0385709 SUSERPROFILES 4ppDatalLocall Temp SUSERPROFILES AppDatalLocall Temp Edit Delete System variables USERNAME SYSTEM windir Cp INDOS windows tracin 3 gt ca Delte OK Cancel Remplir les champs Variable Name et Variable Value Windows tracina CABYTBin Tests installpackagecsilogfile a New System Yariable Variable name 7444 HOME Variable value D Program Javatidk OK Cancel Cliquer sur Ok dans les diff rentes fen tre
18. efine 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 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 pourraient apporter des faille de s curit Il est donc conseill de les supprimer Supprimer les repertoires docs examples host manager manager dans TOMCAT HOME webapps Purge des webapps par defaut de Tomcat Ouvrir le fichier TOMCAT_HOME conft server xml et supprimer le connector AJP Supprimer ou commenter la ligne lt Connector port 8009 protocol AJP 1 3 redirectPort 8443 gt D marrer Tomcat Ex cuter le gestionnaire de service Tomcat cf procedure dans le pr sent guide Aller dans l onglet General Cliquer sur le bouton Start Juillet 2015 Version 1 2 Kelis 16 SCENARIserver4 1 manuel d installation et d administration technique Windows Configuration de Tomcat Apache Tomcat 6 Properties General Log On Logging Java Startup Shutdown Service Name tomcat Display name Apache Tomcat 6 Description Apache Tomcat 6
19. emple 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 ex cuter avant la sauvegarde des fichiers permet de passer la base de donn e dans un statut backup en cours m morisant ainsi les suppressions de fichier blobs et mettant disposition des fichiers d index complets et corrects apres 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 SCENARI server lance et ne gene en rien la production Juillet 2015 Version 1 2 Kelis 30 SCENARI server4 1 manuel d installation et d administration technique Windows SCENARIbatch Ex cuter le script pathScBatch apps backup backup bat pre ou pathScBatch apps backup backup sh pre E 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 sauvegarder Base de donn es pathData javaserver blobs pathData javaserver backup optionnel Environnement de travail pathData javaserver privData optionnel Mod les documenta
20. es 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 oo CoConneacti1oneool Loader gt Juillet 2015 Version 1 2 Kelis 29 SCENAR Iserver4 1 manuel d installation et d administration technique Windows Installation Configuration de SCENARI server 2 lt ooConnectionPool gt lt ooConnection host localhost port 8244 autoLaunch true autokKill true headless false profilePath file C TMP LO1 gt 4 lt ooConnectionPool gt 2 Installation Cr ation de la webApp SCENARIserver Les sources SCENARIserver doivent avoir ete d compr ss es au pr alable dans le r pertoire pathSrc Vx y z SCENARIserver Parametrer la webApp via les fichier de configuration du r pertoire pathSrc Vx y zZ SCENARI server conf cf section Configuration Ex cuter le fichier pathSrc makeWar bat ou pathSrc makeWar sh Compilation en cours Sous windows 9 18 2012 10 11 AM File Folder Le fichier scserver40 war doit alors avoir a es es D data 9 18 2012 10 11 AM File Folder license scen ari 9 17 2012 5 34 AM Text Document 4KB t cr dans le r pertoire ou pathSrc eae oe
21. ires install s pathData javaserver updt et pathData javaserver pack optionnel G n rations pr c dentes pathData javaserver gen D 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 systeme arrete Seule l tape Sauvegarder les fichiers de donn e via l outil de backup au choix de la procedure ci dessus est a mettre en oeuvre Restauration Processus de restauration Un incident syst me grave compromettant l int grit referentielle de la base de donn e peut conduire a 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 repertoire pathData javaserver db Copier le contenu du r pertoire backupDir javaserver backup dans le r pertoire pathData javaserver db 33 Juillet 2015 Version 1 2 Kelis SCENARI server4 1 manuel d installation et d administration SCENARIbatch technique Windows Restauration des autres repertoires Copier coller le contenu des autres r pertoires sauvegard s privData updt pack gen blobs de backupDir da
22. ns les r pertoire du m me nom de pathData Relancer le serveur d application Juillet 2015 Version 1 2 Kelis 34 SCENAR Iserver4 1 manuel d installation et d administration technique Windows Proxy DB Chapitre 8 Proxy DB Le c ur 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 qui prend en charge tous les aspects collaboratifs entre auteurs Ce module est un serveur nodejs qui communique par defaut avec le client en websocket sur un port d di Nginx http nginx org en docs http websocket html at 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 35 Juillet 2015 Version 1 2 Kelis
23. ons OFileClassic java 230 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 at com orientechnologies orient core storage impl local OTxSegment O 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 1i Info Tue Jul 15 11 54 30 CEST 2014 DbScheduler repos 2Start database migration DbVersion core from 0 to 1 class eu scenari orient init migr DbMigrCore0_1 CD 4 2311 Info Tue Jul 15 11 54 35 CEST 2014 DbScheduler repos 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 i Info Tue Jul 15 11 56 13 CEST 2014 DbScheduler repos 2End rebuild Db repos in 98280ms CO D 31 Info Tue Jul 15 11 56 13 CEST 2014 DbScheduler repos 6 End database migration DbVersion core from 0 to 1 Un arr t du serveur pendant cette
24. ons Send bo ut Copy Create shortout ay Delete Il Rename Properties Cliquer sur yes dans l cran de confirmation Param trer la m moire RAM allou e l application Si Tomcat est lanc le stopper cf proc dure dans le pr sent guide Ex cuter le gestionnaire de service Tomcat cf proc dure dans le pr sent guide Aller dans l onglet Java Sp cifier les valeurs des champs Initial memory pool et Maximum memory pool Exemple de param trage ajuster en fonction des besoins Initial memor ool 1024 Maximum memor ool 2048 13 Juillet 2015 Version 1 2 Kelis SCENARiserverd4 1 manuel d installation et d administration Configuration de Tomcat technique Windows Apache Tomcat 6 Properties General Log On Logging Java Startup Shutdown Use default Java virtual Machine D Program Jayvaljre bin serverljym dll 7 Java Classpath C Program Tomcat 6 0binibootstrap jar Java Options Dratalina home C Program Tomcat 6 0 Dratalina base D Program Tomcat 6 0 Djawa endorsed dirs D Program Tomcat 6 0 endorsed Djawa io trpdir C Program Tomcat 6 0temp Initial memory pool 1074 ME Maximum memory pool 2046 ME Thread stack size KE cm Cliquer sur Ok Param trer des fichiers de log Tomcat Afin de faciliter l administration de l outil il est conseill de centraliser les diff rents fichiers de logs dans un unique r
25. phase de migration peut conduire 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 emp path peut tre purge 27 Juillet 2015 Version 1 2 Kelis SCENARiserverd4 1 manuel d installation et d administration Installation Configuration de SCENARI server technique Windows Modele 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 SCENARI server4 1 le ou les mod les documentaires d di es R pertoires concern s purger donc server work path javaserver pack server work path javaserver updt Juillet 2015 Version 1 2 Kelis 28 SCENARIserver4 1 manuel d installation et d administration technique Windows Monitoring Chapitre 6 Monitoring SCENARI4 1 offre des possibilit s de surveillance par des environnements de monitoring nagios afin de sui
26. qu es par la marque DB DB pour database Ce manuel d installation et d administration technique s adresse a un profil Administrateur en charge de l installation surveillance et administration technique de SCENARI server 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 S Documentation papier Juillet 2015 Version 1 2 Kelis 4 SCENARIserver4 1 manuel d installation et d administration technique Windows Introduction win pdf 5 Juillet 2015 Version 1 2 Kelis SCENARiserverd4 1 manuel d installation et d administration Architecture technique technique Windows 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 SCENARI server d pendent beaucoup du nombre d utilisateurs du volume de contenu
27. rectives 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 oo 0CeConnecri10nePoo Loader gt 2 lt ooConnectionPool gt 3 lt ooConnection pipeMode true autoLaunch true headless true profilePath Eile tmp LO1 gt 4 lt ooConnection pipeMode true autoLaunch true headless true profilePath riles tmp LO2 7 gt oi lt ooConnectionPool gt Exemple de param trage sous Windows 1 lt declareTag tagName ooConnectionPool classParser com scenari s co transform oo QoConnect tonPool Loader 7 gt 2 lt ooConnectionPool gt 3 lt ooConnection pipeMode true autoLaunch true headless false profilePath file Cr tmo O01 gt 4 lt ooConnection pipeMode true autoLaunch true headless false profilePath Wt less C tmp 002 gt o 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 suivant
28. s ouvertes ci dessus 11 Juillet 2015 Version 1 2 Kelis SCENARiserverd4 1 manuel d installation et d administration Configuration de Tomcat technique Windows Chapitre 4 Configuration de Tomcat Pour permettre des webapps SCENARI server de fonctionner correctement dans le serveur de servlets Tomcat il est n cessaire d y apporter certaines modifications de param trage S curit A l heure actuel Les webapps SCENARI server ne sont pas compatible avec le Security Manager de Tomcat Il est important de ne pas activer le module Security Manager lors du demarrage 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 S Usage d un proxy Apache ll est possible de cacher Tomcat derri re un proxy Apache Ceci permet entre autres d acc der a SCENARI server 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 a t test avec succes avec SCENARIserver est l usage du module Apache mod_ proxy HOWTO ae 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 D clarer Tomcat en tant que service Tomcat peut tre lanc manuellement via la commande TOMCAT
29. server conf batch destPathRoot server work path batchGen et sp cifier le chemin ou seront cr s les fichiers g n r s via SCENARI batch liveCollab Juillet 2015 Version 1 2 Kelis 20 21 SCENAR Iserver4 1 manuel d installation et d administration technique Windows Installation Configuration de SCENARI server specifique 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 Parametrer l URL d acc s au service d commenter dans les environnements o liveCollab est lance via un proxy server conf liveCollab connectUr1 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 Parametrer 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 SurFS server conf usermgr usermgr fs fsWithLdap xml e 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
30. siii ennemie SCENARIserver4 1 manuel d installation et d administration Introduction technique Windows Introduction Pour des probl mes de performance et de stabilit nous ne recommandons pas l installation sur un serveur Windows et pr conisons un syst me d exploitation Linux Conventions Dans ce document nous utiliserons les conventions suivantes XXX XXX XXX XXX adresse IP du serveur ou URL d acc s 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 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 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 monitoring au risque de compromettre l int grit des donnees Sp cificit s SCENARIserver Les parties sp cifiques a SCENARI server non applicables a SCENARI serverLite sont indi
31. ues sont autoris s ex server webapp name scserver4 1 Chemins d acc s requis server work path R pertoire principal des donn es Cette variable d finit le repertoire pathData utilis dans le present 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 repertoire pathData utilis dans le present 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 repertoire pathData utilis dans le pr sent document diverses reprises Exemple server gen path E data scserver41 javaserver gen optionnel server log path Repertoire des logs scenari Cette variable definit le fichier de log scenari Exemple server log path pathLog webAppName scenari_ date log Remarque penser a retirer le caractere de mise en commentaire de la variable server log path Securite 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 Decommenier la ligne
32. utilisables les directives SCbatch il est imp ratif d activer le service batch lors du parametrage et de la compilation de la webapp D compresser le fichier SCENARlbatch zip t l charg dans le repertoire 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 SCENARIserver4 Effectivement ce type d architecture logicielle est sensible aux instabilites syst me qui peuvent compromettre l int grit des donn es arr t non programme de la machine Sauvegarde chaud syst me en fonctionnement 31 Juillet 2015 Version 1 2 Kelis SCENARI server4 1 manuel d installation et d administration SCENARlbaich technique Windows Sauvegarde configuration Ouvrir le fichier pathScBatch apps backup backup property di logs backup bat _ backup property _ backup sh build xml ES readrre brt 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 htip 127 0 0 1 8080 scserver4 1 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 repertoire de log Ex
33. vironnement La proc dure suivante est d di e Windows Server 2012 Lancer l Explorateur Windows Faire un click droit Sur Computer Puis choisir l entr e de menu Properties Collapse HE 5 16 E ay Manage amp Coo Open in new window TL Map network drive Disconnect network drive El tki Met PE F mot Delete Add a network location Fename Properties Dans l cran System qui appara t cliquer sur Advanced settings Q Juillet 2015 Version 1 2 Kelis SCENAR Iserver4 1 manuel d installation et d administration Configuration syst me technique Windows JE Control Panel System and Security System Search Control Panel LD 7 Control Panel Home View basic information about your computer a Device Manager Windows edition a A A Windows Server 2008 R2 Enterprise 5 es E Copyright 2009 Microsoft Corporation All rights reserved Service Pack 1 EEE System Processor Intel R eontRi CPU E7330 2 40GHz 2 40 GHz 2 processors Installed memory RAM 4 00 GE System type 64 bit Operating System Pen and Touch Ho Pen or Touch Input is available For this Display Computer name domain and workgroup settings Computer name FREPLEF amp Eu 001 Change settings Full computer name FREPDEF 40 W001 main glb corp local Computer description Domain main glb corp local Windows activation Windows is activated ask for Product ID O0486 001 0001076 84150 Change pro
34. vre 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 Controle de la webApp SCENARIserver Service check_http pour contr ler que la webapp SCENARliserver fonctionne url httos urlWebapp s chain u ping user ScuserSystem password mot de passe scuserSystem Assertion sur la r ponse HTTP 200 succ s 503 warning 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 SARG3 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 29 Juillet 2015 Version 1 2 Kelis Monitoring Controle d int grit des donn es du SCENARIserver DB SCENARIserver4 1 manuel d installation et d administration technique Windows Service check_http pour controler la coherence des donnees url httos urlWebapp s chain u adminOdb cdaction CheckAuto user ScuserSystem password mot de passe scuserSystem Assertion sur la
Download Pdf Manuals
Related Search