application Chouette
Contents
1. 3 7 31 05 13 compl ment mise jour de version Patrick Gendre 20 06 13 Corrections diverses suites aux remarques Michel Etienne 15 10 13 mise jour Patrick Gendre 28 02 2014 Suppression de jruby et tomcat Michel Etienne 2 3 Mars 2014 Migration technique Java Michel Etienne CITYWAY 2 15 Version Date d applica Description des changements Auteur tion Mai 2015 Train de maintenance n 1 correction d ano Michel Etienne malies CITYWAY 3 15 Table des mati res IVue d ensemble rusinai anaa a anse he nn cancedataue easenecdantauvonedanieesiessdeaiastenagandagees 4 PIRATES RE EE ees 5 2 1 Ea a PA e e nn ans I E E A E E E EAT E P R E R 2 re 5 22 D p ndances exterm s s rein E suet Sa M il eee eee re th este tante 6 3Migration depuis une version pr c dente 7 3 1 Version V1 x vers une version 2Q X ccicccccicrccsscrcciccocsecscossocecosssetsescsssocensnscsrnsesssosevvassontersnsunsneneness 7 3 2 Version V2 XVEFS V2 eessiveassesetecesawaceeyesayavestsduenineacupds vashanseedetensnveces enr ein etre ot ete 7 AInstallation 9 inner E an ne a N E e EEE AR 7 4 1 R cup ration des SOULCES cccsscccesssccessseecseseeecseseccssseeecenseeesseeesscseeesesseeseenaaaeeseeeesesseeeessnnaeenes 7 4 2 Installation du programme d import export Validation ccccccccscccssscssscsesscssseesseesseeessseeeeesees 8 4 3 Installation du serveur WEB cccesesereeseeeeeseceeseneneceseeeeneaeeesenaneeeseasene2. Choustte GroupOfLine comment suing creation time caen creator ld sting rame inng object version insor bjectid siring access typa string closing time me comment stig contained in sing country_code stn creation time dto mo creator jd sion latitude cocimai 19 16 lih availability boclar long lat type sing longitude om 19 16 mobilty_restricted_sutability bocicar rame Din chect version integer cest steno panning time cine projection type sinna stairs_avallablity bo ea Chouette ConnectionLink comment ina create time detre costar 200 etal drain tie aqua traveler duration tio ire user needs o MR gala hour link stanca do 19 link yox roby resticted suiatity boclar mobi res tictod_iravaller_duration c m rame Sing abject version irtocor abeat s ana occasion anale duration time stais_awilabity 205107 comment string creation time dame crealor slong defaut duration timo Fequent_travdles_ duration le int_user needs age it axatiabilty boon link_distance ccm 19 2 Tink orientation stn link_type stong mobility restricted suitablity boles moblity resticted trxellor duration mo name siring object a sion iniogor Chouettelhm domain model Chouette Network Choue comment sining creation time daoino creator id st description
3. CHOUETTE Maintenance accompagnement et recette de logiciels pour les changes de donn es multimodales application Chouette manuel d installation V2 4 Auteurs Michel ETIENNE Luc DONNET Marc Florisson CityWay Patrick GENDRE CEREMA Jean SENG AFIMB R sum CHOUETTE est un logiciel libre d velopp a 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 a tre d ploy e sur un serveur WEB et d une application en ligne de commande Ce manuel d installation liste les logiciels a installer puis les instructions pour cr er la base de don n es installer et configurer l application web L utilisation depuis une console Ruby est galement document e Agence fran aise pour l information multimodale et la billettique Libert galit F
4. CITYWAY 9 15 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 p var lib chouette imports sudo mkdir p var lib chouette exports sudo chown myuser mygroup var lib chouette imports var lib chouette exports sudo chmod a x var lib chouette imports var lib chouette exports 5 CONFIGURATION La configuration 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 API G oportail http api ign fr accueil API Google Analytics https www google fr intl fr analytics Configuration des URLs des vues Action Mailer Modifier le param tre config action mailer default url options Configuration de SMTP Modifier le param tre ActionMailer Base smtp settings Configuration de l adresse E mail serveur Modifier le param tre config mailer sender Configuration de la Cl G oportail IGN D commenter et fixer l 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 insta
5. n rame sining bject version ger objecta a registration_number string source identifier Saroe hype sing Tare n de da comment sing cration _time dstotimo name sinn number sirrg abject_version integer object string published name si registration number sinno transport mode name sn comment sr creation time satin creator fd shy rection sirno name sling number sting object version ini otjectid stringe opposite route id intogs 5 Published name sino Wayback ziun Chouette StopPoint creation lime dale ine Creator Id strin object version object sting position integer Chouette Journey arthal ime fine connecting serice id in departure time ti dapse_duraticn jie hoadway_frequancy irc waiting time time Chouette Company coda siring creation time calling creator id sting emal sinna fax stig name anna object version loleger object sting operating_dapartment_name sino organizational unit str phone sirina registration number sting short_name sg lt a rame n File Validation fle_name string fle type siang options string 2000 status string Referential bounds string name siring prof string projection type sining slug authentication token sir confirmation sent_at cofotime confirmation token nna Confirmed at dats
6. ets proj bin et libproj dev http trac osgeo org proj pour Windows proj_lib Librairie Proj4 Sous wndows 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 OSGeo4W64 CITYWAY 6 15 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 Plate forme jdk http www oracle com technet work java javase downloads in dex html Version minimale Version conseill e Int r t Compilation java Git pour r cup rer les modules sur github http git scm com RVM pour installer Ruby https www digitalocean com c ommunity articles how to ins tall ruby on rails on ubuntu 12 04 Its precise pangolin with rvm acces au r f rentiel des sources de Chouette Le lien indique l installation de la derni re version stable 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
7. 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 7 15 c as 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 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 r
8. hed joumey_identifier si comment nna creation time come creator ja zina end date dte int_day_types riocor object sersion 11 200 object 09 star date dete version sind Chouette Vehicle JourneyAtStop boarding alighting possibility sinna Chouette TimeT ableDate date 10 position Heu Choustte TImeTable Period period end aic Referential all map amp slug Lister les r f rentiels disponibles Se placer dans un r f rentiel de la base Referential find by slug tatrobus switch en supposant que la liste ci dessus contienne tatrobus CITYWAY 13 15 Lister les noms des lignes du r seau Chouette Line all map amp name S lectionner une ligne par son nom en supposant que la liste ci dessus contienne Ligne 1 Bleue line Chouette Line find by name Ligne 1 Bleue S lectionner la premi re s quence d arr ts route line routes first Lister les noms des arr ts de la s quence route stop areas map amp name Lister les noms des arr ts commerciaux relatifs aux arr ts de la s quence route stop areas map amp parent map amp name Affichage des horaires de d part d une s quence d arr ts Lister les r f rentiels disponibles Referential all map amp slug Se placer dans un r f rentiel de la base en supposant que la liste ci dessus contienne ta
9. llant des scripts dans les r per toires adapt s au syst me d exploitation Base RedHat ou Debian CITYWAY 10 15 Dans la suite le lancement est expliqu pour un d marrage la demande 1 Lancer la gestion des t ches asynchrones import export et validation RAILS EN production bundle exec rake jobs work 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 sactiver cette action dans config environments production rb en passant le param tre serve static assets a false CITYWAY 11 15 7 ANNEXE UTILISATION DE LA CONSOLE RAILS Le framework RubyOnRails fournit un certain nombre de facilit s en mode commande http guides rubyonrails org command_line html rails console Il est int ressant d en tirer parti pour manipuler de mani re souple les donn es m tier g r es par Chouette Par d faut l environnement au sens des applications RubyOnRails de la console est development Dans ce cas la console utilise les param tres de connexion associ s development dans le fichier config database yml L environnement peut tre pr cis en option Par exemple la commande ci dessous permet de se connecter en environnement de produc
10. mport export validation Le programme chouette qui command doit tre install afin d ex cuter les t ches d import ex port 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 cityway fr fr certu chouette chouette gui command 2 4 0 chouette gui command 2 4 0 zip unzip chouette gui command 2 4 0 zip ed choucere emda 4 0 sudo chmod a w 4 3 Installation du serveur WEB 1 R cup ration des sources sous github cd working directory wget https github com afimb chouette2 archive V2 4 0 zip tnaro WZ 4 023 2 T l charger les librairies externes gems cd chouette2 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 sudo su postgres createuser d P U postgres chouette Enter password for new role chouette Enter it again chouette Shall the new role be a superuser y n y exit 4 Initialiser ou mettre a jour la base de donn es RAILS ENV production bundle exec rake db create apartment migrate 5 Pr parer les donn es statiques RAILS ENV production bundle exec rake assets clean assets precompile
11. oot celui ci est nomm myuser mygroup dans la suite du document Ce compte doit disposer du droit sudoer 4 1 R ecup 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 r cup rer les sources disponibles sur github nous vous invitons a vous enregistrer sur le site internet www chouette mobi dans la rubrique CHOUETTE Sources ce qui nous permet de mieux connaitre nos utilisateurs L archive contenant les sources est accessible sur github aux adresses http github com afimb chouette code java en ligne de commande branche V2_3 http github com afimb chouette2 code ruby de l ihm web branche V2_2 http github com afimb ninoxe code ruby du mod le de donn e Neptune branche V2_2 Le mo dule gem Ninoxe n apparait pas dans la proc dure d installation car il est inclus dans les d pen dances de chouette2 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 a date d dition de ce document est la V2 4 0 pour Chouette et Chouette2 CITYWAY 8 15 4 2 Installation du programme d i
12. raternit R PUBLIQUE FRAN AISE Minist re de l cologie de l nergie du D veloppement durable et de la Mer CITYWAY 1 15 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 CITYWAY CEREMA DT Med Maitre d ouvrage AFIMB Mots cl s profil d change Neptune information multi EY ND modale application Chouette manuel d ins tallation postgreSQL JAVA Ruby R dacteurs Participants Marc FLORISSON Patrick GENDRE Zakaria BOUZIANE Jean SENG Michel ETIENNE Luc DONNET Diffusion publique licence Creative Commons CC by nd Nombre de pages 15 pages Date Confidentialit Bibliographie Mai 2014 a Non Oui Historique des versions r visions Version Date d applica Description des changements Auteur tion 19 09 2012 15 01 13 04 2013 07 05 13 Installation environnement Jruby Michel Etienne Patrick Gendre refonte du plan et mise jour Mise jour version 2 0 3 Michel Etienne Ajout du chapitre 3 7 Marc Florisson 28 05 13 Ajout du 4 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
13. saeeesnsaneeeeeeeenseneaaaaaeeees 8 SConfigUratiON ss a aed TER Lad obne EAC Stade mere Need eire getat ment 9 6Lancement de l application sise 10 7Annexe Utilisation de la console Rails 11 7 1 Pr sentation du mod le de donn es en persistance 11 7 2 EXeMples is nt ed teen item A tete handle li didtirtes eau 12 CITYWAY 4 15 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 ainsi que pour Windows Chouette est une application web organis e selon l architecture suivante IHM Mod le de donn es Utilisateur 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 3 de g n rer 4a ou r cup rer 4b les applica
14. tion bundle exec rails c production Dans la suite de cette annexe quelques scripts sont d taill s de mani re a illustrer quelques cas d utilisation de la console Ces scripts ruby peuvent tre ex cut s d s l ouverture de la console par copier coller de chaque ligne de commande 7 1 Pr sentation du mod le de donn es en persistance Le sch ma pr sent dans le document Modele classes pdf introduit les mod les au sens d une application Rails qui sont g r s en persistance Le sch ma pr cise les relations entre les mod les fl ches ainsi que les propri t s de chacun des mod les Ce sch ma est pr sent ci apr s en petite taille CITYWAY 12 15 attempts inogor taled at datcrins handler ion last_error text locked at datetime locked by store prierity lager queue sirg nn at dstetime Chouette PtLink comment surg ration time datoume creator id stn end in id ic 8 link_distance decimal 192 name string object version noose ebjectid sr route id 030 3 start_ot_link_id age 8 Chouette StopArea area type sting comment sining country_code uing creation time datetime creator id siring fare_code intear latitude ocima 19 164 Jong lat type sir longitude cocirmai 19 16 name sg nearast_topic_name sinna object version noose ebjectid siring projection type string registration number sir street name siir x decimal 19 2 Y decimal 19 2
15. tions compil es war jar 4 de configurer ces applications Une documentation de base quick install des commandes linux lancer pour installer Chouette est disponible en ligne https github com afimb chouette2 blob V2_2 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 CITYWAY 5 15 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 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 http www java com fr down mande 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 postgresql org Pp Proj 4 8 8 Fonctions G ographiques pour Linux pack
16. to cumrent_sign_in_at ateti eurent sign inip sting enerypted_password stn tailed attempts 1092 invtation accepted at astetime invitation mt integer invitation sent_at catotime invitation token stang 00 invited by id teger invited by_type lt rg last sigh n at code last sig in ip in locked at dome name Sing remember created at coin reset passwerd_sent_at die reset password token siu sign in count i020 unconfined emal str unlock token strna 7 2 Exemples Affichage des arr ts commerciaux d une s quence d arr ts name sting tokan string Chouette JourneyPattern anival_stop_point id nteger E comment na creation time ici creator Ta sinna departure_stop_point jd integer 8 name sing object version inicoer object sinna Published name in registration_number 9 970 status sing Export ExportLogMessage options siang arguments ig 1000 ference ids sin gt key sting references type sinna position vag Import ImportLogMessage fle_typs string options sirg status suing arguments si ing 1000 key strno leger position 1 comment eg creation time cr me creator id 19 facility sing Number integer 8 ciject_vwersion inger objectid strina published joumey namne strin status value 24002 time_slot id nteger 8 transport_moda 207717 enicle_type_identrfer siring publis
17. trobus Referential find by slug tatrobus switch S lectionner la premi re s quence d arr ts route Chovetess Line find by nemel Licne I Bleue routes Tirer Lister les horaires de d part par ordre croissant route vehicle journeys map v vo vehicle journey at Stops tist deperture times Sort Consultation des liens d acc s d un arr t Lister les r f rentiels disponibles Referential all map amp slug CITYWAY 14 15 Se placer dans un r f rentiel de la base Referential find by slug tatrobus switch access link Chouette AccessLink all first atticher larret access link stop area afficher l acc s access link access point en supposant que la liste ci dessus contienne tatrobus V rification d une date pour un calendrier d application Lister les r f rentiels disponibles Referential all map amp slug Se placer dans un r f rentiel de la base R reremententiinehio Site Guteciet OOM Sun mrsiwantacin S lectionner un calendrier tm Chouette TimeTable all first tm include day Date today en supposant que la liste ci dessus contienne tatrobus V rifier si la date du jour est comprise dans le calendrier CITYWAY 15 15
Download Pdf Manuals
Related Search