Manuel d`installation
Contents
1. CHOUETTE Maintenance accompagnement et recette de logiciels pour les changes de donn es multimodales application Chouette manuel d installation V2 5 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 don n es installer et configurer l application web Agence fran aise pour l information multimodale et la billettique p B TT es L hrr1e Fyah n so Frumshe Abe LH Te Fa mms pi insite de l cabigie de l rigie2. s d acc s et de leurs conditions d utilisation e le site http api ign fr accueil permet d obtenir une cl de d veloppement pour un serveur local accessible 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 environments production rb permet de d finir la cl d acc s au portail IGN config geoportail api key abcde Pour un d ploiement de l application en environnement de d veloppement au sens Rails le fichier de param trage est celui ci config environments development rb 7 2 Cas d un serveur sans serveur de messagerie e mail Pour utiliser l application web Chouette il faut cr er au moins un compte et une organisation et pour se connecter la premi re fois il faut avoir re u un e mail de confirmation Cela implique donc que le serveur dispose d un serveur e mail Si ce n est pas le cas ou par exemple pour une version en machine virtuelle il est possible de faire fonctionner l application quand m me Dans le r pertoire webapps chouette2 WEB INF app models user rb modifier le d but du source et supprimer validatable confirmable gt gt class User lt ActiveRecord Base gt gt Include default devise modules Others available are gt gt token authenticatabl
3. 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 V2 y La proc dure d installation d crite ci apr s convient aussi bien pour une premi re 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 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 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 de l application web et du pro gramme java chouette command utilis par la web pour les imports exports validations Il est r dig uniquement pour linux la proc dure devrait fonctionner pour Windows compte tenu de la por tabilit 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
4. Y 5 12 3 de g n rer 4a ou r cup rer 4b les applications compil es war jar 4 de configurer ces applications 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 proc dures si n cessaire reportez vous aux proc dures et ou outils d installation de ces compo sants Logiciel Version mi Version Int r t nimale conseill e Plate forme JRE 1 7 64 bits 1 7 64 bits ex cution en ligne de com mande http wWww java com fr down load Ruby 9 9 Interpreteur Ruby pour l appli cation WEB https www ruby lang org fr Base PostgreSQL persistance des donn es de l application CHOUETTE http Www postaresqal or Proj 4 8 8 Fonctions G ographiques pour Linux packets proj bin et libproj dev http trac osqeo org proi pour Windows proj_lib Librairie Proj4 Sous windows une fois l installation de OSGEO4W effectu e e cr er la variable d environnement PROJ_LIB r pertoire OSGeo4W share proj e ajouter au Path r pertoire OSGeo4W bin Si vous avez choisi une VM 64 bits installez proj4 aussi en version 64 bits 0SGeo4W64 CITYWAY 6 12 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 d
5. du D meperai dun el ec Hi ni CITAAT 1 12 Informations sur ce document Organisme commanditaire AFIMB Titre Manuel d installation de l application CHOUETTE Sous titre Proc dure suivre pour installer et configurer l application CHOUETTE Organismes auteurs R dacteurs Participants CITYWAY Marc FLORISSON Patrick GENDRE CEREMA DT Med Zakaria BOUZIANE Jean SENG Michel ETIENNE Luc DONNET Maitre d ouvrage AFIMB Mots cl s Diffusion profil d change Neptune information multi modale application Chouette manuel d ins RI NOR POS E i a publique licence Creative Commons CC by nd Nombre de pages Date Confidentialit Bibliographie Octobre 2014 12 pages aid Non Oui Historique des versions r visions Date d applica Description des changements tion 2 0 0 19 09 2012 Installation environnement Jruby Michel Etienne Patrick Gendre 15 01 13 refonte du plan et mise jour 04 2013 Mise jour version 2 0 3 Michel Etienne 07 05 13 Ajout du chapitre 3 7 2 0 2 2 0 5 28 05 13 Ajout du 84 4 2 pour la configuration de Marc Florisson l acc s au G oportail Ajout du document Modele classes pdf en ressource externe R f rencement de ce document au chapitre 3 7 CITAAT 2 12 Version Date d applica Description des changements tion 2 4 Mai 2014 Train de maintenance n 1 correction d ano Michel Etienne malies 2 4 1 Juillet 2014 Train de maintenance n 2 Michel Et
6. e encryptable confirmable lockable gt gt timeoutable and omniauthable gt gt devise database authenticatable registerable J7 recoverable rememberable trackable validatable 7 gt gt confirmable invitable gt a J Puis relancez Tomcat la confirmation de login ne devrait plus tre n cessaire CITAAT 12 12
7. es 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 Compilation java http www oracle com technet work java javase downloads in dex html Git pour r cup rer les modules 1 7 acc s au r f rentiel des sources sur github de Chouette http it scm com RVM pour installer Ruby Le lien indique l installation de la derni re version stable https www digitalocean com c ommunity articles how to ins tall ruby on rails on ubuntu 12 04 Its precise pangolin with rvm Par exemple sous Linux base Debian installer les packages linux suivants sudo apt get install postgresql 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 Installer RVM soit par apt get install ruby rvm si la distribution linux en dispose soit en suivant la proc dure fournie dans le lien fourni dans le tableau Installer ruby 1 9 3 rvm install ruby 1 9 3 p448 rvm default use 1 9 3 p448 CITYWAY 4 12 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
8. ienne correction d anomalies Octobre 2014 volutions pour le SISMO Michel Etienne CITYWAY 3 12 Table des mati res 1Vue CSD as de de ad ana 5 2P A 2L0 10 LES RER RE RES E E A A 6 2 L O E A R 6 2 Benen n eS EK ETE e E A 7 3Migration depuis une version pr c dente esssesesresesrreserreresrrrrrssreresrrressrreeserresrereserereseeresereesersreeee 8 NOTION VLX Vers UNE VESTON Rd E 8 3 2 Version VX VES VZ Vician a iaar iaei iiai 8 An OO TO e E E E 8 4 1 R cup ration des SOUFCeS sss ssssesesseesssreresrrerssrrresrrersssrrresererssrtrrssrereseressrressrtressreessrerereeseereeeent 8 4 2 Installation du programme d import export validation ss 9 4 3 Installationdu Serveur WEB essaie e a scene memes 9 SCORE OR A E E 10 GLancemem de ADD NEO TOM heiren E a 11 7Annexes configuration de l installation Chouette2 ss 12 7 1 Param trage de l acc s aux cartes du g oportail IGN 12 7 2 Cas d un serveur sans serveur de messagerie e mail ss 12 CITYW AY 4 12 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 adresse un utilisateur confirm il d crit en d tail la proc dure d installation pour la plate forme Linux a
9. insi que pour Windows Une documentation de base quick install des commandes linux lancer pour installer Chouette est disponible en ligne https aithub com afimb chouette2 blob V2 5 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 packaqgqes 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 Mod le de n rsistance Fe L application Chouette comprend une application web Ruby Rails pour g rer l IHM fonctions de ges tion des donn es et pour g rer les fonctions d import export et validation un programme Java Toutes deux mettent jour une base de donn es PostgreSQL L installation de l application n 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 1 sous Windows nous n avons pas document la g n ration des ex cutables CITYWA
10. se E mail serveur Modifier le param tre config mailer sender Configuration de la Cl G oportail IGN D commenter et fixer le param tre config geoportail api key Configuration de Google Analytics Modifier le param tre GA tracker 6 LANCEMENT DE L APPLICATION L application pourra tre lanc e 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 l Lancer la gestion des t ches asynchrones import export et validation PA ENV OCUC tt ON M OURCNE Er ES 2e ke MOIDS Ole 2 Lancer le serveur Web WEBrick serveur par d faut de RubyOnRails RMS ENTER rOCUe OMS UNIES MAINS CEE 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 sactiver cette action dans config environments production rb en passant le param tre serve static assets false Un document s par pr sente l utilisation de la console Rails pour acc der aux donn es via les objets m tier CITYWAY 11 12 Ko 7 ANNEXES CONFIGURATION DE _ L INSTALLATION CHOUETTE2 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
11. sur le site inter net www chouette mobi ce qui nous permet de mieux connaitre nos utilisateurs L archive contenant les sources est accessible aux adresses http github com afimb chouette code java en ligne de commande branche V2 5 http github com afimb chouette2 code ruby de l ihm web branche V2 5 http github com afimb ninoxe code ruby du mod le de donn e Neptune branche master Le mo dule gem Ninoxe n apparait pas dans la proc dure d installation car il est inclus dans les d pen dances de chouette Attention les versions stables de Chouette et Chouette2 sont celles qui portent un TAG se r f rer au dernier TAG disponible sur Github La version date d dition de ce document est la V2 5 0 pour Chouette et Chouette2 CITAAT 8 12 4 2 Installation du programme d import export validation Le programme chouette qui command doit tre install afin d ex cuter les t ches d import export et validation sudo mkdir p usr local opt chouette command sudo chown R myuser mygroup usr local opt chouette command cd usr local opt chouette command wget http maven chouette mobi fr certu chouette chouette qui command 206 Chou EE gui conmand 2 9 O ie unzip chouette guli command 2 10 7216 C houc tte cmd 2o 0 sudo chmod a w 4 3 Installation du serveur WEB 1 R cup ration des sources sous github COM ICI kan areor wget https qgithub com afimb chouette2 archive V2 5 0
12. up var lib chouette imports var lib chouette exports sudo chmod atx var lib chouette importer re choueree export 5 CONFIGURATION Les principaux r pertoires cr s pour l application configur e par d faut sont les suivants Les r pertoires chouette2 imports exports sont sur var lib chouette Les r pertoires chouette sont dans usr local opt chouette Les param tres de configuration de l import export validation sont dans etc default chouette command Les logs syst mes sont dans var log syslog Le d mon du serveur chouette est d fini dans le fichier etc init d chouette il permet de lancer arr ter l application en tant que service sudo service chouette start stop sta tus La configuration chouette2 est d finie dans le fichier config environments production 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 analytics 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 Configuration des URLs des vues Action Mailer Modifier le param tre config action mailer default url options CITAAT 10 12 Configuration de SMTP Modifier le param tre ActionMailer Base smtp settings Configuration de l adres
13. zip Unz AV 2 SN 0 Ci 2 T l charger les librairies externes gems cd chouette gem install bundler pour une nouvelle installation bundle install 3 Pr parer la base de donn es pour une nouvelle installation cr ation du compte d exploitation chouette gt cr er l utilisateur chouette password chouette privil ges admin SUCIONSUREN LOSLCEESS createuser d P U postgres chouette darer Pas Vorl Eor nen ole Cove L Enter it again chouette Shall the new role be a superuser y n y exit 4 Initialiser ou mettre jour la base de donn es PATES TEN produ tioni bumile eee riken D re nte parr meni mT grate 2 Ce programme est pr compil et t l chargeable sur le d p t git de Chouette Il est n anmoins possible de le g n rer en clonant les sources de git github com dryade chouette par la commande mvn install ou pour ne pas xecuter les tests mvn Dmaven test skip true install CITYWAY 5 Pr parer les donn es statiques RME SIENNE re t ter PONMotMONENErSOMERE EEE a aa 6 Pr parer les r pertoires d exploitation pour une nouvelle installation Les valeurs utilis es sont fix es dans le fichier config environments production rb e __ImportTask root e __ ExportTask root Cr ation des r pertoires sous le compte myuser mygroup sudo mkdir prp var mb chouetie imperts sudo mkdir p var lib chouette exports sudo chown myuser mygro
Download Pdf Manuals
Related Search