Installation IRYS
Contents
1. nom de la classe implementant le service FacilityMonitoring siri FacilityMonitoringService nom de la classe implementant le service ProductionTimeta ble siri ProductionTimetableService nom de la classe implementant le service StopTimetable siri StopTimetableService nom de la classe implementant le service SituationExchange siri SituationkxchangeService nom de la classe implementant le service VehicleMonitoring siri VehicleMonitoringService nom de la classe implementant le service Discovery siri DiscoveryService chouetteDiscoveryService chouette database name lt nom de la base exemple chouette gt database schema chouette database showsql false hibernate username chouette hibernate password chouette 1Cice Heroes ces bc Scies het es a a terme Joer driver rg POSTGgGre escdql Driver database hbm2ddl auto update system code lt pr fixe des identifiants Neptune dans la base chouette gt reload referential cache on Network s VersionDate change SE Fererent ia SCanNetwomkVerS1IonDete true S TIRI r t renr Lale E siri database sirin J De driver Org posraresdih Driver siri jdbc url jdbc postgresql localhost 5432 lt nom de la base exemple chouette gt AFIMB 2013 13 Pr sentation et installation de l application IRYS siri jdbc username chouette siri jdbc password chouette siri schema siri param trage de log4j properties De2. canisme de plug in pour se connecter un SAE ou tout autre syst me fournisseur e Ja disponibilit de l acc s aux services en mode requ te simple et en mode abonne ment e un programme client de test permettant de valider les flux de donn es en retour des requ tes SIRI ainsi que les performances e un programme serveur de test permettant de simuler des flux SIRI ce programme utilise une base normalis e au format Neptune e l utilisation du framework SOAP Apache Axis 2 avec une possibilit de bascule ment sur Apache CXF e l utilisation du mod le Apache XmlBeans AFIMB 2013 Pr sentation et installation de l application IRYS x V nu D O 47 Interface interne Interface SIRI Interface sp cifique Architecture Serveur SIRI r 2 O v 2 S 0 Serveur SIRI interface interne Interface SIRI Interface sp cifique Architecture Client SIRI ap O N m LL lt Pr sentation et Installation de l application IRYS 1 3 Le d monstrateur SIRI Le d monstrateur est configur avec les l ments suivants CHOUETTE AFIMB 2013 Une base Chouette enrichie d un r seau de simulation TATROBUS Un serveur SIRI sous la forme d un ex cutable Un Client SIRI pour dialoguer directement avec le serveur SIRI Une application D mo en contexte cartographique permettant de consulter le r seau de test TATROBUS Une application D mo
3. demo siri dryadebox net SiriServer siri serverURL lt url publique du serveur gt AFIMB 2013 11 Pr sentation et installation de l application IRYS activation de la validation de la requete complete siri validation request true activation de la validation de la reponse siri validation response false Gestion des identifiants du referentiel par defaut iden tiriant local si false alors refercntiel commun ces trois items sont a passer a false pour un reseau Ile D shrance siri idWithloc Line true siri idWithloc Network true siri idWithloc Company true siri idWithloc JourneyPattern true siri idWithloc VehicleJourney true siri idWithlLoc Route true Sheet aelairo se Sros noie e True Moi ol o Srosrorai bE Eru Sirl 1oWithEoc StopPoint OUAY true cu lee Eo pr onnee POR rUe siri allowedStopPointTypes SPOR BrP O oE Parametres StopMonitoring e version de compatibilite SIRI assuree par le service Se c COpmonitoring ver Ion IS presence des stat dans les logs Siril S COpmonit oring SEE true seuil en seconde pour d clarer un bus en avance Ss1iri stopmonitoring earlyGap 60 seuil en seconde pour d clarer un bus en retard Siri stopmonitoring delayedGap 180 Parametres GeneralMessage version de compatibilite SIRI assuree par le service Siri generalmessage version 1 3 reference de format de message siri generalmessage formatRef SITRI IDF liste des canaux de messages S
4. en contexte Web Une application D mo via un formulaire Http Un composant logiciel qui modifie al atoirement les horaires th oriques en alimentation de Chouette Le client de tests pour mettre en oeuvre les services StopMonitoring Gene ralMessage et CheckStatus Serveur Modifications Al atoires Des horaires Navigateur Pr sentation et installation de l application IRYS 2 Installation 2 1 Pr Requis L application serveur IRYS CHOUETTE est bas e sur l architecture de Chouette se r f rer au manuel d installation de Chouette pour les pr requis JRA Tomcat PostgreSQL Post GIS ainsi que Maven2 JDK git pour installation partir des sources 2 2 R cup ration du projet IRYS 2 2 1Sources Les sources sont disponibles sur le site internet www chouette mobi dans la rubrique SIRI T l chargements qui vous invite nous laissez vos coordonn es avant d obtenir les sources afin de mieux conna tre nos utilisateurs merci d avance de nous signaler qui vous tes avant d installer l application L archive contenant les sources est accessible sur github aux adresses http github com dryade IRYS code java de l application g n rique http github com dryade IRYS CHOUETTE code java de l application associ e une base de donn es Chouette La pr sente documentation d taillera l installation de IRYS CHOUETTE 2 2 2 Archive war L archive contenant le fichier war de Irys Chouette pr
5. t d ployer et du client est disponible sur le site internet www chouette mobi dans la rubrique SIRI T l chargements 2 3 Base de donn es ajout des tables temps r el IRYS Chouette utilise la base Chouette V2 0 se r f rer au manuel d installation associ La base de donn es Chouette n est pas suffisante pour g rer le temps r el un compl ment est donc n cessaire 2 3 1 Param tres associ s la base Le tableau suivant r capitule les param tres relatifs la base Tous ces param tres peuvent tre adapt s il s agit seulement de rester coh rent sur leur valeur tout au long de la proc dure d installation Param tre Valeur propos e la machine d h bergement est la machine lo localhost cale le nom de la base chouette2 le nom du compte applicatif et propri taire du chouette sch ma le mot de passe du compte applicatif chouette AFIMB 2013 Pr sentation et Installation de l application IRYS 2 3 2Cr ation du sch ma siri Le script siri sql est disponible dans l archive irys_server_2 0 0 distribution zip psql U lt propri taire gt W h localhost f siri sql v schemaname lt schema gt v username lt propri taire gt d lt base gt Le nom du sch ma doit tre en MINUSCULES 2 4 Installation partir des sources Voir le manuel d installation CHOUETTE la proc dure est similaire pour IRYS avec Ma ven 2 5 Installation partir de l archive war C
6. AFIMB IRYS Server v2 0 0 PRESENTATION et INSTALLATION F vrier 2013 Agence Fran aise pour l Information Multimodale et la Billettique E EM Libert galit Fraternit R PUBLIQUE FRAN AISE Minist re de l cologie du D veloppement durable et de l nergie Informations sur ce document Organisme commanditaire AFIMB Titre Pr sentation et installation de IRYS serveur SIRI sur base Chouette Sous titre Proc dure suivre pour installer et configurer le serveur IRYS Organismes auteurs R dacteurs Participants CITYWAY Michel ETIENNE Patrick GENDRE Marc FLORISSON Michel ETIENNE Jean SENG Fr d ric SCHETTINI DGITM MTI Jean Dominique LECA R sum IRYS est un logiciel libre d velopp l initiative du minist re fran ais charg des transports et du d ve loppement durable dans le but de faciliter l change de donn es transport collectif TC temps r el en s appuyant pour cela sur SIRI sp cification technique europ enne CEN TS 15531 2007 en 5 parties qui d finit un protocole d change en XML et plus pr cis ment sur le local agreement fran ais du profil STIF CERTU L application IRYS est disponible sous la forme d une application Web destin e tre d ploy e sur un ser veur Web J2EE Elle impl mente les services suivants Discovery CheckStatus StopMonitoring Gene ralMessage Ce document pr sente l architecture du logiciel IRYS client et serveu
7. IRYS application client serveur SIRI 1 1 Rappel sur SIRI Afin de fournir aux transporteurs et aux industriels un cadre normalis pour l change de donn es concernant l information temps r el le CEN TC278 WG3 SG7 a d cid de lancer le projet SIRI Service Interface for Realtime Information d s 2004 SIRI est une norme TS d change d information inter Syst mes orient e vers les Syst mes Aide l Exploitation et les Syst mes d Information Voyageur SIRI a t d velopp pour tre compatible avec les normes et standards pr existants que sont TransModel mod le de donn es conceptuel pour le transport en commun IFOPT description des lieux d arr t ain si que DATEX et TPEG Dans le contexte Fran ais SIRI est un compl ment naturel NEPTUNE profil d change de l offre th orique un profil dit CERTU STIF a t pu bli http www predim org spip php article3387 Une version 2 de SIRI a t labor e et soumise au vote en 2012 Pour en savoir plus http www normes donnees tc org spip php rubrique 19 SIRI se pr sente sous la forme d un ensemble de services e Horaires planifi s Production Timetable Service pour la mise jour des horaires th oriques des missions et des itin raires publi s mise jour en amont de la jour n e d exploitation consid r e e Horaires calcul s Estimated Timetable Service horaires estim s pendant la course et mise Jour des missio
8. T ri generalmessage channels Perturbation Information Commercia JE liste des acronymes de langue siri generalmessage langs FR EN langue par defaut si non precisee dans les requetes siri generalmessage defaultlLang FR specifie si les infochannels sont passes en texte false ou codes true siri generalmessage encoded false Parametres Discovery Ver on de opac bilit o Ik Uree pre crc siri dic COM version I cities d nmre kerent ori ena meCi enr 12 AFIMB 2013 Pr sentation et Installation de l application IRYS siri wsdl version I gt nom de la classe implementant le service stopMonitoring Ssiri StopMonitoringService chouetteStopMonitoringService nom de la classe implementant le service generalMessage siri GeneralMessageService generalMessageService nom de la classe implementant le service checkStatus siri CheckStatus checkStatus nom de la classe implementant le service DataSupply siri DataSupplyService nom de la classe implementant le service Subscription Siri SubscriptionService subscriptionService nom de la classe implementant le service Capabilities siri CapabilitiesService nom de la classe implementant le service ConnectionMonito ETG siri ConnectionMonitoringService nom de la classe implementant le service ConnectionTimeta ble siri ConnectionTimetableService nom de la classe implementant le service EstimatedTimetable siri EstimatedTimetableService
9. ase chouette gt reload referential cache on Network s VersionDate change siri referential scanNetworkVersionDate false SIL 4 NE cneeriod 0 San Rar Cat Vere 2 access realtime jdbc url jdbc postqgresql localhost 5432 lt nom de la base exemple chouette gt realtime dbc username chouette realtime jdbc password chouette realtime hbm2ddl auto update realtime showsql false 18 SE im eTts n ma Es el param trage de logdj properties Definition des cibles pour les traces 16 AFIMB 2013 Pr sentation et Installation de l application IRYS FAP root Care egom ERROR SSL douer Parametrages pour la cible stdout l0o941 appender stdout org apache log4 ConsoleAppender 10941 appender stdout layout org apache log4 PatternlLayout log4j appender stdout layout ConversionPattern d ISO8601 SR CNRC CEE name On ri Parametrages pour la cible R log4j appender R o0org apache 1og4j RollingFileAppender log4j appender R File lt chemin absolu des fichiers de log gt log4j appender R layout org apache l1log4j PatternLayout log4j appender R layout ConversionPattern d ISO8601 5p SC 1 SX username m n MN IE Td Len l rie roc log4j appender R MaxFileSize 1000KB moe E a h a o log4j appender R MaxBackuplndex 5 Niveaux des traces du composant Hibernate log4 logger or
10. d cal es par rapport au th orique mais n voluent pas dans la Journ e Des donn es de type GeneralMessaging sont aussi g n r es al atoirement partir de mod les d finis dans le jar de l application fichier 1rysContext xml Ces messages sont ventuellement affect s a des lignes et des arr ts du r seau d fini dans la base Chouette Le g n rateur de donn es TR est livr dans l archive irys_realtime_simulator_2 0 0 z1p Le d compresser dans un r pertoire d installation au choix Il contient Fichier description irys chouette realtime simulator 2 0 0 jar Application simulateur lib Librairies applicatives du simulateur simulator bat Lanceur en mode windows simulator sh Lanceur en mode unix irys client properties Param tres SIRI AFIMB 2013 15 Pr sentation et installation de l application IRYS Fichier description log4 properties Param tres de log param trage de irys client properties chere NcCOnELqNe bon pour Eee Ce SIP NID chouette database access database name lt nom de la base exemple chouette gt database schema chouette database showsql false hibernate username chouette hibernate password chouette jdbc url jdbc postqgresql localhost 5432 lt nom de la base exemple chouette gt jJdbc driver org postgresql Driver database hbm2dd1l auto update system code lt pr fixe des identifiants Neptune dans la b
11. e chapitre explique les tapes de d ploiement de l archive WAR Cette archive est g n r e avec les param tres d application expos s ci dessous 2 5 1Installation du serveur Le serveur SIRI sera install en tant que web service sous tomcat 1 cr er le r pertoire de configuration C Program Fi les Irys Server conf i lt nom_webapp gt ou etc irys server conf lt nom_webapp gt selon syst me 2 d compacter l archive irys_server_2 0 0 distribution zip dans un r pertoire tempo raire copier le fichier log4j properties dans le r pertoire de configuration 4 copier le fichier irys properties dans le r pertoire de configuration 5 configurer le serveur SIRI les param tres r gler sont en bleu dans les fichiers suivants 6 copier le fichier irys_server war dans le r pertoire lt chemin d installation de tom cat gt webapps en le renommant lt nom de webapp gt war ce nom sera visible dans l URL publique 7 verifier qu un dossier lt nom de webapp gt se cr e cot dans le cas contraire relan cer le service Tomcat param trage de irys properties Fichier de configuration pour les services SIRI IDF Parametres generaux reference operateur rendue par d efaut Sro pe rato STRTI COomeany deyade tnc reference producteur de donnees premier item des referen CESSER siri producerRef lt Nom du syst me metteur des donn es gt adresse publique du serveur soap siri serverURL http
12. e proposer un service en mode requ te direct ou en mode abonnement IRYS propose la mise disposition de clients SIRI mode requ te ou abonnement l encore AFIMB 2013 Pr sentation et Installation de l application IRYS e Comme base pour mettre en place des services d information e Pour alimenter un SAE le SAE naturellement fournisseur peut aussi tre client pour proposer une information multi exploitants ou proposer des services de r gula tion exploitant les informations d autres transporteurs e Pour alimenter un pilote d afficheur e Pour r aliser des tests des validations ou encore des op rations de qualification Le client est propos en mode ligne de commande avec possibilit de scripting en en mode client Web pour une mise en uvre simple et interactive La solution est multi plates formes Linux Windows etc et est conforme au profil d fini par le STIF et le CERTU Les figures ci dessous proposent une vue synoptique de l architecture du serveur et du client SIRI Parmi ses principales caract ristiques on peut noter e l impl mentation des m thodes des services WEB e le contr le de validit des requ tes r ponses par rapport aux exigences SIRI et au profil IDF CERTU e l impl mentation de bouchons permettant un premier niveau de test avant m me la connexion au service fournisseur et retournant une erreur sur les m thodes non impl ment es e Ja disponibilit d un m
13. finition des cibles pour les traces log41 rootCategory ERROR R Parametrages pour la cible stdout log4 appender stdout org apache log4j ConsoleAppender log43 appender stdout layout org apache log41 PatternLayout log4j appender stdout layout ConversionPattern p SX username 5C 1 o Parametrages pour la cible R 1og4j appender R org apache 1og4j RollingFileAppender 1og4j appender R File lt chemin absolu des fichiers de log gt log4j appender R layout org apache log4j PatternLayout log4j appender R layout ConversionPattern d ISO8601 5p CIM ENV ame E Taille maximmum du fichier de trace log4j appender R MaxFileSize 1000KB gt Toral Ge Tichiers dilarerire log4j appender R MaxBackuplndex 5 lo941 logger org hibernate ERROR log4 logger org hibernate engine StatefulPersistenceContext ERROR 14 AFIMB 2013 Pr sentation et Installation de l application IRYS log4 logger org hibernate tool hbm2ddil WARN log4 logger org springframework WARN log4 logger org springframework transaction WARN log4 logger org springframework orm hibernate3 WARN log4 logger org springframework ws INFO Poire losger 16 dvi NEO 2 5 2 Installation du g n rateur de donn es Temps R el mode d mo Le g n rateur de donn es Temps R el g n re des courses TR statiques pour la journ e d ex ploitation en exploitant les calendriers de Chouette Ces courses sont l g rement
14. g hibernate ERROR POS oc der org Aibernate ecngine roate ul Persistence onte ERROR log4 logger org hibernate tool hbm2ddil WARN lt SS S Niveaux des traces du composant Spring AFIMB 2013 17 Pr sentation et installation de l application IRYS log41 logger org springframework WARN log4 logger org springframework transaction WARN log4 logger org springframework orm hibernate3 WARN Niveaux des traces de l application irys Se log oser Lee Sri TINEO Le simulateur sera lanc tous les jours de bon matin en param trant la crontab sous linux ou une t che planifi e sous Windows 2 6 Exploitation et maintenance Les op rations d import XML et CSV modifient des volumes importants de donn es Il devient important de mettre jour les index et les statistiques des donn es en base L op ration vacuum analyse doit donc tre lanc e de fa on r guli re La version 8 3 de PostgreSQL permet de r aliser cette tache dans un traitement part d mon auto vacuum cf http www postgresql org docs 8 3 static maintenance html Le travail de l admin BDD peut tre tr s variable selon la plateforme et la version de Post greSQL utilis es 18 AFIMB 2013
15. l mente les services minimums obligatoires dans le cadre du Profil IDF CERTU et peut tre compl t e de l ensemble des services SIRI en fonction des besoins des projets AFIMB 2013 Pr sentation et installation de l application IRYS 1 2 Architecture d IRYS articulation avec CHOUETTE IRYS facilite la mise en conformit SIRI de syst mes existants ou dans le contexte de nou veaux d veloppements IRYS est un frontal non intrusif de diffusion de donn es qui change avec un autre client serveur SIRI CHOUETTE peut jouer le r le de frontal SAE le serveur SIRI interroge alors en fait Chouette via un composant plug in qui r pond en SIRI aux requ tes du serveur L application IRYS est disponible en 2 versions IRYS g n rique correspondant la figure ci dessous IRYS CHOUETTE correspondant la figure plus bas pr sentation le d monstrateur o une base de donn es CHOUETTE est int gr e l application et compl t e par des donn es temps r el IRYS est modulaire et permet une mise en place de SIRI progressive L application prend en compte nativement les services 1 StopMonitoring information temps r el au passage un arr t 2 GeneralMessage information textuelle temps r el 3 Discovery information simplifi e sur la topologie du r seau liste des arr ts et des lignes 4 CheckStatus demande d tat du syst me L architecture permet suivant les fonctionnalit s attendues d
16. ns et des itin raires e Horaires l arr t Stop Timetable Service Information horaire l arr t th orique planifi et command mise Jour en amont de la Journ e d exploitation consid r e Ce service n a pas t retenu dans le Profil IDF CERTU e Passage l arr t Stop Monitoring Service information sur les prochains bus pas sant un arr t calcul uniquement e Supervision des v hicules Vehicle Monitoring Service localisation d un v hicule au cours d une course e Gestion des correspondances planifi es Connection Timetable Service mise jour des informations sur les correspondances par rapport aux informations th ori ques Ce service n a pas t retenu dans le Profil IDF CERTU e Gestion des correspondances calcul es Connection Monitoring Service informa tion et gestion des correspondances pendant l exploitation e Messagerie General Messaging Service messagerie g n rique e Supervision des quipements Facility Monitoring information sur l tat des qui pements avec un accent particulier sur les besoins PMR et les besoins sp cifiques e Gestion des v nements Situation Exchange mod le structur d incident et des cription d taill e des cons quences SIRI est con u comme une boite outils qui permet une impl mentation progressive et peut s adapter des syst mes existants pour en diffuser les informations dans un format normali s IRYS imp
17. r notamment en association avec le logiciel Chouette pour le d monstrateur visible sur le site www chouette mobi Est pr sent es ensuite la deux proc dure d installation de l application partir d une distribution de sour ces ou partir d une archive WAR ex cutable Mots cl s profil d change Neptune SIRI information multimodale application Chouette manuel d installation postgreSQL Tomcat java Diffusion publique licence Creative Commons CC by nd Nombre de pages Date ep Pr sentation et Installation de l application IRYS Historique des versions r visions Historique des versions r visions Version Date Description des changements Auteur r vision d application 05 02 13 Fusion avec document DRYADE de Patrick Gendre pr sentation de la D mo SIRI de mars 2011 AFMIB 2013 Pr sentation et installation de l application IRYS Sommaire 1 Pr sentation d IRYS application client serveur SIRI 1 1 1 2 1 3 Rappel sur SIRI Architecture d IRYS articulation avec CHOUETTE Le d monstrateur SIRI 2 Installation 2 1 2 2 2 3 2 4 2 9 2 6 Pr Requis R cup ration du projet IRYS Base de donn es ajout des tables temps r el Installation partir des sources Installation partir de l archive war Exploitation et maintenance 10 10 10 11 11 18 10 AFIMB 2013 Pr sentation et Installation de l application IRYS 1 Pr sentation d
Download Pdf Manuals
Related Search