Manuel d`Installation application Chouette V3.0
Contents
1. 4 4 Installation du serveur IEV Le serveur chouette _iev n cessite l installation et la configuration du serveur d applications J2E Wild fly et la r cup ration du driver jdbc postgresql Cr er et installer les bases IEV et Chouette sudo su postgres createdb O chouette iev createdb 0O chouette E UTF 8 T templatel chouette2 Si le serveur est install partir des sources sudo su postgres createdb 0 chouette E UTF 8 T templatel chouette test Adapter la m moire du serveur Wildfly Si le serveur est amen traiter des lignes de transport volumineuses passer la JVM de Wildfly de 512 Mo de m moire 1024Mo e diter le fichier Wildfly install directory bin standalone conf et modifier l option Xmx512m de JAVA OPT Lancement du serveur Wildfly dans un terminal d di cd Wildfly install directory bin standalone sh b 0 0 0 0 c standalone full xml Djboss socket bin ding port offset 100 l option jboss socket binding port offset permet de d caler les ports utilis s par Wildfly par d faut Wildfly utilise les port 8080 pour les applications et 9990 pour l administration Cr er un compte adminsitrateur sur le terminal principal bin add user sh CITYWAY 9 15 type management user a login admin password admin Note Les comptes et mots de passe ne sont pas impos s Cr er les connecteurs bases de donn es wget https jdbc postgresql org download p2. A CHOUETTE Maintenance accompagnement et recette de logiciels pour les changes de donn es multimodales Manuel d Installation application Chouette V3 0 Auteurs Michel ETIENNE Luc DONNET Marc FLORISSON CityWay Patrick GENDRE CEREMA Jean SENG AFIMB R sum CHOUETTE est un logiciel libre d velopp l initiative du minist re fran ais charg des transports et du d veloppement durable dans le but de faciliter l change de donn es d offre th orique de trans port collectif TC en s appuyant pour cela sur la norme NFP 99506 dite Neptune qui sp cifie un pro fil d change XML Les utilisateurs vis s sont les collectivit s locales Autorit s Organisatrices de Transport AOT les ex ploitants des r seaux TC ainsi que leurs prestataires bureaux d tude ou soci t de services et d autres acteurs tels que services de l tat diteurs de logiciels op rateurs de services d information chercheurs L application CHOUETTE est disponible sous la forme d une application WEB destin e tre d ploy e sur un serveur WEB et d une application en ligne de commande Ce manuel d installation liste les logiciels installer puis les instructions pour cr er la base de donn es installer et configurer l application web Agence fran aise pour l information multimodale et la billettique Ex Libert galit Fraternit R PUBLIQUE FRAN AISE Minist re de l colog
3. cessite 4 tapes d taill es dans les Chapitres suivants 1 d avoir install les librairies et outils paquets utilis s par le logiciel 2 d installer la base de donn es 3 de g n rer ou r cup rer les serveurs compil s ear 4 d installer et de configurer ces serveurs 2 PR REQUIS 2 1 Logiciels Le tableau ci dessous dresse la liste des logiciels n cessaires avant de proc der l installation de Chouette Ces composants doivent tre install s dans votre environnement suivant leurs propres pro c dures si n cessaire reportez vous aux proc dures et ou outils d installation de ces composants Logiciel Version Version Int r t minimale conseill e Plate forme JRE 1 7 64 bits 1 7 64 bits Ex cution en ligne de commande http www java com fr download Wildfly 8 2 0 Final 8 2 0 Final Serveur d application J2E http wildfly org Ruby 1 A Interpr teur Ruby pour l applica tion WEB https www ruby lang org fr Base PostgreSQL Persistance des donn es de l ap plication CHOUETTE http www postgresql org Driver jdbc postgresql 9 3 1103 9 3 1103 Pilote d acc s Postgresql ins taller dans Wildfl https jdbc postgresql org down load html Librairie libpq API postgresql Bundler gem ruby Gestionnaire de environnement http bundler io d une application Ruby Proj 4 8 8 Fonctions G ographiques pour Linux packets proj bin et
4. cnoustte car path to ear est remplacer par le chemin absolu de l archive EAR du serveur 5 CONFIGURATION DU SERVEUR IHM WEB Les logs de l application configur e par d faut sont redirig es dans les logs syst mes var log syslog ou var log messages selon les distributions Linux La configuration chouette2 est d finie dans les fichiers e config environments production rb e config secrets yml CITYWAY 12 15 e config initializers devise_async rb Pour les diff rents param trages il faut se r f rer aux documents suivants e Action Mailer http guides rubyonrails org action_mailer_basics html e API G oportail http api ign fr accueil e __ API Google Analytics https www google fr intl fr analvtics e Rails documentation http guides rubyonrails org 4 1 release notes html config secrets yml e Devise Async specification https github com mhfs devise async D autres d tails sur la configuration des cl s IGN et du mailer en l absence de serveur de messagerie sur la marchine sont donn es en Annexe Dans le fichier production rb e Configuration des URLs des vues Action Mailer Modifier le param tre config action_mailer default_url_options e Configuration de SMTP Modifier le param tre ActionMailer Base smtp_ settings e Configuration de l adresse E mail serveur Modifier le param tre config mailer_sender Dans le fichier secrets yml choisir au pr alable le bon environnement e C
5. libproj dev http trac osgeo org proj pour Windows proj_lib CITYWAY 5 15 Librairie Proj4 Note Sous windows une fois l installation de OSGEO4W64 effectu e e cr er la variable d environnement PROJ_LIB r pertoire OSGeo4W share pro j e ajouter au Path r pertoire OSGeo4W bin 2 2 D pendances externes En compl ment des logiciels n cessaires au d ploiement si vous souhaitez g n rer les ex cutables partir des sources il faudra en outre installer les logiciels suivants pour linux sous Windows nous n avons pas document la g n ration des ex cutables Logiciel Version Version Int r t minimale conseill e Plate forme jdk 1 7 1 7 Compilation java http www oracle com technet work java javase downloads in dex html Git pour r cup rer les modules 1 7 9 1 7 10 Acc s au r f rentiel des sur github sources de Chouette http qgit scm com Maven 3 3 Compilation java Unzip D compression des archives make Installation des gems Exemple d installation des paquets sous Linux base Debian sudo apt get install postgresql 9 3 sudo apt get install libpq dev sudo apt get install openjdk 7 jdk sudo apt get install git sudo apt get install unzip sudo apt get install proj bin sudo apt get install libproj dev sudo apt get install make sudo apt get install maven CITYWAY 6 15 A Installer RVM soit par paquet si la distributio
6. installation que pour une mise jour de version La descente de version n est pas garantie il peut y avoir des pertes de donn es Note Le passage la version 3 0 d truit les rapports d import d export et de validation existants 4 INSTALLATION L installation d crite ci apr s suppose d tre faite avec un compte utilisateur linux d di exclure root celui ci est nomm myuser mygroup dans la suite du document CITYWAY 7 15 Ce compte doit disposer du droit sudoer 4 1 R cup ration des sources Cette section pr sente la proc dure pour g n rer les ex cutables du serveur web et du serveur iev utilis par le premier pour les imports exports validations I est r dig uniquement pour linux DE BIAN et syst mes d riv s la proc dure devrait fonctionner pour Windows compte tenu de la porta bilit de Java et Ruby mais elle n est pas document e ici Avant de t l charger les sources nous vous invitons nous laisser vos coordonn es sur le site inter net http www chouette mobi rubrique Club Utilisateurs ce qui nous permet de mieux conna tre nos utilisateurs L archive contenant les sources est accessible aux adresses http github com afimb chouette code java du serveur IEV branche V3_0 http github com afimb chouette2 code ruby du serveur IHM web branche V3_0 Attention les versions stables de Chouette et Chouette2 sont celles qui portent un TAG se r f rer au dernier TAG dis
7. T QUIS AR ei nn E a I tn tt nt Pinus a 5 2 LOCI E CPR PR EE R 5 2 2 D pendances Externes a p ar nn ne ANNE AE Da en mere 6 3Migration depuis une version pr c dente 7 3 1Version V1 x vers une version 2 Kessrsvsecorssrsiriioneriiivsisasdiosivsissnssisivaiesuvs ivei sinisini 7 3 2 Version VZ AVES VIU eea A EAEE ENA AREEN ERRA 7 AlnstallatiO Mistas rieir aiani a aon eiia E a e i TRE a S Ea E a aS 7 4 1 R cup ration des SOUrCES es ierrerrneessnneeesseeessnneeenns 7 4 2 Installation des bases de donn es ss 8 4 3 Installation du serveur WEB iii 8 4 4 Installation du serveur IEV iii 9 5Configuration du serveur IHM WEB iiiierreerereerenneeeeeeennes 11 GLancement d s SENVeEUTS pisiseeni iiia arig et een een nindt ete a kia 12 6 1 Serveur IHM WEB orosenie rarr R E ER rien einen lines AERA 12 6 2 S rveur EVE transat S EAEE nan fines ft meme nid center etre ete 13 7Annexes configuration de l installation Chouette IHM WEB 13 7 1 Param trage de l acc s aux cartes du g oportail IGN 13 7 2 Cas d un d ploiement sans serveur de messagerie e mail 14 CITYWAY 3 15 es mati res 1 VUE D ENSEMBLE Ce document d crit comment installer l application Chouette mais galement comment l utiliser depuis un interpr teur Ruby pour manipuler les donn es m tier Java et Ruby tant portables Chouette est compatible avec de multiples plates formes Mac Linux Windows etc Le pr sent manuel s ad
8. ble en http localhost e le site http professionnels ign fr permet d obtenir une cl de production pour un site WEB publi sur un nom de domaine Pour un d ploiement de l application en environnement de production au sens Rails le fichier de param trage config secrets yml permet de d finir la cl d acc s au portail IGN dans la ru brique production geoportail api key abcde 7 2 Cas d un d ploiement sans serveur de messagerie e mail Dans production rb retirer la structure ActionMailer Base smtp_ settings ajouter la variable config action_mailer delivery_method letter_opener CITYWAY 15 15
9. ie de l nergie du D veloppement durable et de la Mer Informations sur ce document CITYWAY 1 15 Organisme commanditaire AFIMB Titre Manuel d installation de l application CHOUETTE code source V3 0 Sous titre Proc dure suivre pour installer et configurer l application CHOUETTE Organismes auteurs CITYWAY CEREMA DT Med Maitre d ouvrage AFIMB Mots cl s profil d change Neptune information multi modale application Chouette manuel d ins tallation postgreSQL JAVA Ruby R dacteurs Marc FLORISSON Zakaria BOUZIANE Michel ETIENNE Luc DONNET Diffusion GC D publique licence Creative Commons CC by nd Participants Patrick GENDRE Jean SENG Nombre de pages Date Juillet 2015 15 pages Confidentialit Non Bibliographie Oui Version du document 1 3 V3 0 x Versions du code source applicable Historique des versions r visions Date d Ho Description des changements Mai 2015 Juin 2015 1 2 Juin 2015 Serveur IEV Compl ments sur le Serveur IEV Compl ments sur l application Web Michel Etienne Michel Etienne Luc Donnet 1 3 Juillet 2015 Pr cisions sur l installation du serveur IEV Michel Etienne CITYWAY 2 15 Table d Ive d ensemble dia nnreessterteneinenineatenteeene ste treenneetene en mean denim it 4 2 PT
10. n linux en dispose sudo apt get install ruby rvm Sinon Installer RVM en suivant la proc dure sudo apt get install curl gpg keyserver hkp keys gnupg net recv keys 409B6B1796C275462A1703113804BB82D39DCO0E3 ouril S81 hrrose cetr mumcie basn s erable Installer ruby 2 1 6 partir de RVM ryn Install ruby 2 1 6 vin Cea eS 2 146 Installer le gem bundler ou le mettre jour gem install bundler v 1 10 3 Installer wildfly dans un r pertoire du style opt wildfly exemple d installation simplifi e wget http download jboss org wildfly 8 2 0 Final wildfly 8 2 0 Final zip unzip wildfly 8 2 0 Final zip 3 MIGRATION DEPUIS UNE VERSION PR C DENTE 3 1 Version V1 x vers une version 2 x La version 2 correspond une r criture compl te de l IHM dans le framework Ruby on Rails Le sch ma de la base 2 0 est totalement modifi pour s adapter aux r gles de Rails Active Records de plus la gestion des organisations des utilisateurs et des espaces de donn es ne permettent pas de r aliser une proc dure de migration de sch ma Pour r cup rer vos donn es g r es avec une version ant rieure la V2 dans la nouvelle version il faut donc exporter l ensemble des r seaux au format Neptune puis importer les fichiers Neptune dans les espaces de donn es ad quats depuis Chouette V2 3 2 Version V2 x vers V3 0 La proc dure d installation d crite ci apr s convient aussi bien pour une premi re
11. onfiguration de la Cl G oportail IGN D commenter et fixer le param tre geoportail_api_key e Configuration de Google Analytics Modifier le param tre google_analytic_tracker e Configuration de l url d acc s l API Chouette Web Service IEV Modifier le param tre api_endpoint e Configuration de la cl pour Rails et Devise Modifier le param tre secret_key_base Dans le fichier config initializer devise_async rb e Configuration de la fa on dont l application envoie les mails non asynchrone par d faut mais peut tre activ Modifier le param tre Devise Async enabled 6 LANCEMENT DES SERVEURS Les serveurs pourront tre lanc s au d marrage de la machine en installant des scripts dans les r per toires adapt s au syst me d exploitation Base RedHat ou Debian Dans la suite le lancement est expliqu pour un d marrage la demande 6 1 Serveur IHM WEB 1 Lancer la gestion des t ches asynchrones pour l envoi de mail si besoin Voir 5 Configuration du serveur IHM WEB outline CITYWAY 13 15 RAILS PN production bundle exec rake jobs work Attention cette commande ne rend pas la main 2 Lancer le serveur Web WEBrick serveur par d faut de RubyOnRails RAILS ENV production bundle exec rails server Cette action peut tre remplac e par un d ploiement sous Phusion Passenger sous Apache ou sous Nginx Apache et Nginx g rent les ressources statiques auquel cas il faut d sac
12. ostgresql 9 3 1101 jdbc41 jar bin jboss cli sh Connect module add name org postgres resources path to driver postgresql 9 3 1101 jdbc41 jar dependencies javax api javax transaction api subsystem datasources jdbc driver postqgres add driver name postgres dri ver module name org postgres driver class name org postgresql Driver data source add jndi name java jboss datasources chouette name chouette connection url dbc postgresql 1localhost 5432 chouette2 driver name postgres user name chouett password chouette max pool size 30 data source add jndi name java jboss datasources iev name iev connec tion url j dbc postgresql localhost 5432 iev driver name postgres user name chouett password chouette subsystem ee managed executor service default write attribute name max threacis va lue lt rhreacl s1ire gt subsystem ee managed executor service default write attribute name gueue length value lt queue size gt reload path to driver est remplacer par le chemin absolu du driver postgresql t l charg lt thread_size gt et lt queue_size gt sont adapter aux param tres iev started jobs max et iev copy by im port max d finis dans le fichier iev properties e lt thread_size gt gt 2 x iev started jobs max e lt thread_size gt lt queue size gt gt iev started jobs max x iev copy by import max 1 e Note Les comptes et mots de passe ne sont pa
13. ponible sur Github La version date d dition de ce document est la V3 0 0 pour Chouette et Chouette2 Note chouette peut tre r cup r e sous forme binaire l adresse suivante http maven chouette mobi mobi chouette chouette_iev x v z chouette iev x y z zi o x y z repr sente la version de l application 4 2 Installation des bases de donn es Les serveurs Web et IEV utilisent une base Postgres il est n cessaire de la configurer avant d installer les serveurs pour une mise jour cette tape n est pas n cessaire Pour une premi re installation cr er le compte utilisateur de la base de donn es SUAONSUM POsStgres createuser s d P U postgres chouette Enter password for new role chouett Enter it again chouette exit NOTE la version 3 de Chouette oblige passer Postgres en version 9 3 minimum une migration de Postgres vers la 9 3 est donc effectuer si n cessaire 4 3 Installation du serveur WEB 1 R cup ration des sources sous github cd working directory wget https github com afimb chouette2 archive V3 0 0 zip DAMON VE 0 0 219 CITYWAY 8 15 2 T l charger les librairies externes gems cd chouette2 bundle install 3 Initialiser ou mettre jour la base de donn es RAILS ENV production bundle exec rake db create db migrate 4 Pr parer les donn es statiques RAILS ENV production bundl xec rake assets clobber assets precompile
14. resse un utilisateur confirm il d crit en d tail la proc dure d installation pour une plate forme Linux de type Debian Une documentation de base quick install des commandes linux lancer pour installer Chouette est disponible en ligne https aithub com afimb chouette2 blob V3 0 README md La version de linux doit tre bas e sur un noyau version 2 6 minimum et 64 Bits C est le cas par exemple Ubuntu 13 10 Sous Debian 7 5 et et ubuntu 13 et Chouette peut aussi tre install comme Package cf http packages chouette mobi debian chouette Au niveau m moire il est recommand de disposer d une machine ayant au minimum 2 Go de RAM Pour traiter de grands r seaux comme ceux d Ile de France il est n cessaire de disposer d un mini mum de 4Go de Ram et de 4 CPUs mais attention dans ce cas utiliser une JVM 64 bits Chouette est une application web organis e selon l architecture suivante IHM Mod le de donn es Utilisateur L application Chouette comprend e un serveur web Ruby Rails pour g rer l IHM fonctions de gestion des donn es et pour pilo ter les actions d import d export et de validation e Un serveur Rest serveur IEV en Java pour ex cuter les actions d import d export et de valida tion Les deux serveurs se partagent une base de donn es PostgreSQL commune pour lire et sauvegarder les donn es de transport CITYWAY 4 15 L installation de l application n
15. s impos s mais doivent rester coh rents avec l installation du serveur web Param trage de la taille maximale des fichiers t l charg s Par d faut Wildfly limite la taille des fichiers d import 10 Mo pour l ajuster aux besoins exemple avec 80Mo pour tre en ad quation avec les besoins du serveur Web bin jboss cli sh CITYWAY 10 15 connect subsystem undertow server default server http listener default write at tribute name max post size value 83886080 exit Param trage du r pertoire de stockage et du nombre maximum de jobs Le r pertoire de stockage par d faut est USER HOME pour le changer il faut installer un fichier iev properties dans le r pertoire etc chouette iev le contenu du fichier est le suivant exemple fourni dans le zip de chouette _iev properties for iev server base directory for referential storage comment to use default location iev directory var lib chouette iev maximun jobs working at same time iev started jobs max 5 maximun copy by import save passing times for a line iev copy by import max 5 admin key comment or empty disable admin API iev admin key Installer le fichier iev propertes sudo mkdir p etc chouette iev sudo chown R lt myuser gt lt mygroup gt etc chouette cat gt etc chouette iev iev properties properties for iev server base directory for referential storage comment to use default location iev directory var lib choue
16. tiver cette action dans config environments production rb en passant le param tre serve static assets true Un document s par pr sente l utilisation de la console Rails pour acc der aux donn es via les objets m tier 6 2 Serveur IEV 1 Lancer le conteneur d application Wildfly cd Wildfly install directory bin standalone sh b 0 0 0 0 c standalone full xml Djboss socket bin ding port offset 100 l option jboss socket binding port offset permet de d caler les ports utilis s par Wildfly par d faut Wildfly utilise les port 8080 pour les applications et 9990 pour l administration 2 Cr er des r f rentiels pour un usage ind pendant du serveur web r cup rer le fichier chouette sql sous github https github com afimb chouette blob V3_0 src main sql chouette sal cr er un r f rentiel psc a 127 0 0 1 U Shonetre v CHE lt SChEme name Cl Chov tEeZ chouette sql o lt schema name gt est le nom du r f rentiel uniquement en minuscules et sans espace 7 ANNEXES CONFIGURATION DE L INSTALLATION CHOUETTE IHM WEB 7 1 Param trage de l acc s aux cartes du g oportail IGN L acc s aux cartes du g oportail n cessite une cl C est l IGN d finit la politique de distribution des cl s d acc s et de leurs conditions d utilisation CITYWAY 14 15 e le site http api ign fr accueil permet d obtenir une cl de d veloppement pour un serveur local accessi
17. tte iev maximun jobs working at same time iev started jobs max 5 maximun copy by import save passing times for a line iev copy by import max 5 admin key comment or empty disable admin API iev admin key CLSC Cr er le r pertoire de stockage sudo mkdir p var lib chouette iev CITYWAY 11 15 A sudo chown myuser mygroup var lib chouette iev sudo chmod arx var lib chouette iev Activation du l API de supervision L api de supervison n est pas active par d faut il faut pr ciser dans le fichier etc chouette iev iev properties le param tre iev admin key et utiliser la m me valeur dans la requ te de supervision para m tre key dans l url properties for iev server base directory for referential storage comment to use default location iev directory var lib chouette iev admin key comment or empty disable admin API iev admin key MyKey Installation du serveur IEV partir des sources cd working directory wget https github com afimb chouette archive V3 0 0 zip Wings V30 0 719 cd chouette dans le r pertoire racine cr par git wildfly doit tre actif mvn clean install la derni re tape publie l application dans wildfly Installation du serveur IEV partir de l archive compil e wget bite maven chouette mobi mobi chouettelchouette iev 2 0 0 chouette lev SOMME unzip Chouette 16v 3 0 071 bin Jboss eli sh Connect Ceploy roree patn tO ear
Download Pdf Manuals
Related Search