Formation Ginger - 1ère journée
description
Transcript of Formation Ginger - 1ère journée
making convergence a realitymaking convergence a reality
Formation Ginger - 1ère journée
Présentation à la Société ATOSJanvier 2005
Niji, making convergence a reality
Plan de la formation
Aujourd'hui Ce matin
Introduction Le découpage fonctionnel de la plate-forme L'architecture logicielle La documentation projet
Cet après-midi L'environnement de développement Le modèle de données L'environnement de production
Prochaine journée Matin
Intégration d'une nouvelle MMG Stratégie de tests
Après-midi Réponse aux questions
Niji, making convergence a reality
Introduction
Objectifs du projet pour Cegetel La communication plurimédia vers l'ensemble de ses clients Un guichet unique pour les SI et le NSI
Un projet d'intégration Client : Cegetel SI "Multimedia Messaging Gateway" fournie par Swapcom SVI et moteur VxML fourni par Netcentrex
Calendrier Démarrage : Sept. 2003 (T0 en Déc.) Livraison lot 1 (SMS) : Mars 2004 Livraison lot 2 et 3 (Vocal + Email) : Juillet 2004 Livraison V2.3 (évolutions) : Mars 2005
Niji, making convergence a reality
1. Le découpage fonctionnel
Niji, making convergence a reality
1. Schéma d'ensemble
Niji, making convergence a reality
GINGER
Enregistrement
PlateForme
De ServiceCegetel
ClientSI Cegetel
Accuséde prise
en compte
Accusé d’émission
Emission
Traitement et stockage
en file d’attente
Emission
Accusé de prise en compte
SMS-C
Status ReportStatus ReportAccusé de réception
MessageClient
Message Client
1
2
3
5 4
6
789
101112
Emission
TraitementRésultatémission
TraitementStatusReport
TraitementRéponses Message
Client
1. Le flux de messages
Niji, making convergence a reality
1. Terminologie "flux de messages"
Terme Description Commentaire
MT message envoyé par Ginger
SI -> client
MO message reçu par Ginger Client -> SI
ACKG Acquittement 'Ginger' GDM -> SI
ACKN Acquittement 'Network'
(aka 'Shipping' dans MMG)
PFS->MMG->GDM->SI
ACKU Acquittement 'Utilisateur'
(aka 'Tracking' dans MMG)
Terminal->PFS->MMG-> GDM->SI
Niji, making convergence a reality
1.1 Les fonctionnalités principales de GDM
111 : Interface batch (fichiers csv) Prétraitement des formats batchs existants Traitement des batchs Génération de fichiers d'acquittements (ACKG, ACKN, ACKU) Remontée de messages MO batch
112 : Interface temps réel (MQ-Series) Traitement des messages TR Génération d'acquittements TR (ACKG, ACKN, ACKU) Remontée de messages MO TR
113 : Génération et réception de messages Génération de messages dans un format unifié Mise en file d'attente de MMG Réception d'acquittements ACKN et ACKU Réception de messages MO
Niji, making convergence a reality
1.1.1 GDM : prétraitement des formats existants et traitement des batchs
EnregistrementsClient SI existant
ORIAN PNMPMVSABO EpiphanyAnnuaireExterneMobilité
EIR
Systèmes d'Information Cegetel
…
Banque de
données
Templatesde
messages
Enregistrement auFormat pivot Ginger
EnregistrementsClient SI
Dépôt fichier
Mise au format générique GINGER (cas d'un système existant)
Validation dufichier
Dépôt fichier
Automate Ginger
Génération des messages
Validation dufichier
Mise au format pivot(cas générique)
Niji, making convergence a reality
1.1.2 GDM : traitement des messages temps réel
Clarify GINGER
QueueMQ-Series "GINGER"
QueueMQ-Series "Clarify"
émissionconsommation
acquittement MQ(automatique)
émission
consommation
acquittement MQ
Niji, making convergence a reality
1.1.3 GDM : génération de messages MT
Configurationdu service SI
Mise en filed'attente
Module I nterface SI
Module de traitement (GDM)
TemplateMessage
Enregistrement Client (au format unifié Ginger)
Paramètres Message
Corps du message (au format média)
Paramètres Media
Paramètres Média(overload)
Corps duMessage
Trame du message (au format MMG)
Module d'émission (MMG)
Systèmes d'Information Cegetel
SMS-C
SMS-MT
1
2
HTTP Connect
3
Niji, making convergence a reality
Terminologie "Objets GDM"
Terme Description Commentaire
SI Système d'Information Cegetel
Orian, Sabo, etc…
Service SI Service d'envoi de messages d'un SI
Template Objet de mise en forme de messages (associé à un service SI et un média)
Gestion du mot de passe par SMS, etc…
Plage horaire
Période d'émission autorisée pour un type de message
0-24h, 9-21h, etc…
Niji, making convergence a reality
Paramètres de template
Terme Description Commentaire
Types de base
Chaîne, Entier, Réel, Euros, Volume, Durée
Ex : 10 mn 28 s
Type 'Unité' Accord singulier-pluriel (Entier ou réel)
1 texto->10 textos
Type 'MAP' Table d'association de chaines
29->Finistère
Type 'Objet Composé'
Mise en forme de tableaux
Ex: Orian Mail
Niji, making convergence a reality
1.2 Les fonctionnalités de MMG
Configurationdu service SI
Module I nterface SI
Module de traitement (GDM)
Enregistrement Client (au format unifié Ginger)
Module d'émission (MMG)
Systèmes d'Information Cegetel
SMSC
UCP-IP
URL standard URL sécurisée
OU
Moteur d'envoi HTTP Connect
Paramètres HTTP Connect
HTTP HTTPS
ModuleHTTP Connect
ModuleRoutage
Routage Message
ModuleStockage
ModuleEmission
SMS-MT (au format UCP-IP)
Filesd'attente
ConnecteurCMG
Message Sortant (au format HTTP Connect)
Niji, making convergence a reality
1.2 Les fonctionnalités principales de MMG
1.2.1 Interface avec GDM Connecteur "HTTP Connect" pour les MT Connecteur "Reverse ACK" pour ACKG et ACKN Connecteur "Reverse MO" pour les MO
1.2.2 Routage des messages Module "Messaging Manager"
1.2.3 Interface avec les Plates-formes de Service Connecteur "SMS Connect" UCP/IP Connecteur "Mail Connect" Connecteur "IVR" (VXML)
1.2.4 Serveur de licences SLS
1.2.5 Outil d'administration MMG Ajout des fonctionnalités GDM
Niji, making convergence a reality
1.2.1 Connecteur "HTTP Connect"
Interface GDM -> MMG utilisée pour soumettre les messages MT
Option de sécurisation (HTTPS + cryptage de messages en base)
Vu de GDM, utilisation du SDK Swapcom pour générer le format HTTP
Vu de GDM, un ACKG positif correspond à une réponse positive de MMG
Niji, making convergence a reality
1.2.1 Connecteur "Reverse ACK"
Interface MMG -> GDM utilisée pour soumettre les acquittements "Shipping" et "Tracking"
Protocole HTTP Connect
Vu de GDM, une servlet de réception traite ces requêtes et les met au format ACKN et ACKU, batch ou TR
Niji, making convergence a reality
1.2.1 Connecteur "Reverse MO"
Interface MMG -> GDM utilisée pour soumettre les messages reçus des clients
Protocole HTTP Connect
Vu de GDM, une servlet de réception traite ces requêtes et les met au format MO, batch ou TR
Niji, making convergence a reality
1.2.2 Routage des messages
La partie "centrale" de MMG
Contrôle de flux "global" Selon la configuration Selon la licence
Réutilisation des concepts de routage MMG 1 compte = 1 SI 1 sous-compte = 1 template Voir routage dans SD, chap 4.1 et Note Technique NT119
Niji, making convergence a reality
1.2.3 Connecteurs PFS
SMS Connect UCP/IP, connecté au SMS-C (ou à la gateway SMS-C) de
Cegetel
IVR Connect VXML, connecté au SVI Netcentrex
Mail Connect SMTP, connecté au serveur Mail de Cegetel Support du format MIME
Niji, making convergence a reality
1.2.4 Serveur de licences
"SLS" doit être démarré pour que MMG fonctionne
Procédure d'obtention d'une licence voir documentation Swapcom
Niji, making convergence a reality
1.2.5 Module d'administration
IHM Web Configuration des comptes / sous-comptes Configuration du routage Configuration des connecteurs "OUT" Configuration des connecteurs "IN" Tracking de messages Visualisation de statistiques
HTTP Admin Les fonctionnalités de l'IHM Web sous forme de "Web
Services" (voir SDK Swapcom et protocole Burlap) L'IHM d'administration de Ginger a été insérée dans ce
module MMG
Niji, making convergence a reality
1.3 Les fonctionnalités du SVI Netcentrex
le connecteur IVR de Swapcom émet une demande d’appel au call generator via l’émission du requête http
le module connector se charge de la requête http et fait un appel de procédure WNP au module CallGen qui est une application WorkSCE
l’application CallGen émet un appel
lorsque l’appel aboutit, l’application CallGen transmet la demande au module de traitement VoiceXML du SVI
l’application VoiceXML du SVI joue le script VoiceXML généré par le connecteur IVR swapcom
des notifications sont remontées au connecteur IVR lors de la fin d’appel si celui-ci aboutit ou échoue
Niji, making convergence a reality
1.3 Les fonctionnalités du SVI
SVI
Appli.CallGen
ApplicationCible
App
lis
Connector
Serveur HTTP
Serveur WNP
RequêteHTTP
AppelTéléphonique
généré
LiaisonWNP
TransfertInter BE
Configuration du SVI: voir NT 102
Niji, making convergence a reality
2. L'architecture logicielle de Ginger
Niji, making convergence a reality
2.1 Architecture logicielle GDM / MMG
Niji, making convergence a reality
2.2 Découpage en applications Websphere
Niji, making convergence a reality
2.3 Architecture du SVI
Niji, making convergence a reality
3. Revue de la documentation projet
Niji, making convergence a reality
Spécifications
Spécifications Générales SG08
Spécifications Fonctionnelles SF19 : interfaces avec les SI SF20 : traitement des messages SF21 : IHM d'administration
Spécifications Détaillées SD037 : le dossier de conception technique
Niji, making convergence a reality
Tests et Recette
Cahiers de recette Un cahier par groupe de fonctionnalité
Fiches de test détaillées Une fiche par fonctionnalité testée
Niji, making convergence a reality
Documents d'exploitation
Manuel d'installation (MINS)
Manuel d'exploitation (MEX)
Guides EDISON (FEX)
Niji, making convergence a reality
3. L'environnement de développement
Niji, making convergence a reality
Hardware utilisé
Serveur de développement Sun-Fire-V240
Serveur de recette Sun-Fire-V240
SVI Sun-Fire-V280 R
Niji, making convergence a reality
3.1 Produits utilisés (1)
Outil de développement Java Eclipse (2.1.2) JDK Sun (jre1.3.1_09 pour le dev, celui de websphere pour
l'exécution : 1.3.1_08-b03) Plug-in MyEclipse (dev JSP, 2.6.4)
Outil de versioning CVS (intégré à eclipse)
Serveur d'application Websphere (5.0.2)
Base de données Oracle (9.2.0.1.0) Design sous PowerAMC (8.0) Administration par Toad (7.6.0.11, option Debugger, Xpert, DBA,
Formatter Plus)
Niji, making convergence a reality
3.1 Produits utilisés (2)
Serveurs Unix Solaris 8 (SunOS 5.8) Scripts sous sh et ksh Samba (2.2.8a)
Annuaire LDAP
Simulateur de SMSC CMG Mobile Message Tester 4.0
Simulateur de Serveur Email CMailServer 5.2
Simulateur de boîtes vocales Développement spécifique commandé par Cegetel (à Atos ?)
Niji, making convergence a reality
3.1 Utilisateurs Unix
Voir MIS_Ginger v1.7, chap. 4.1.3
gingadm (groupe ginger) Administrateur Ginger
swapadm (groupe swapcom) Administrateur Swapcom
wasadm (groupes swapcom, ginger, mqm et administrateur cft )
Administrateur Websphere
syscft (groupes swapcom, ginger, administrateur cft)
Administrateur CFT
Niji, making convergence a reality
CVS : Modules java GDM (1)
Conf et classes de gdm.jar, jar de GDM.ear
default package classes main des applications clientes et des classes de test
com.ginger.aui classes d'accès à l'AUI
com.ginger.common classes du coeur du moteur GDM
com.ginger.db classes mappant la base à un haut niveau (API)
com.ginger.db.model
classes générées automatiquement mappant les tables de la base
com.ginger.db.util classes utilitaires pour les packages com.ginger.db et com.ginger.db.model
com.ginger.ihm classes utiles à la présentation des pages de statistiques
Niji, making convergence a reality
CVS : Modules java GDM (2)
com.ginger.io classes de lecture/écriture MQ et batch pour ce qui concerne les ack et MO
com.ginger.jvmdependentutil
classes utilitaires reecrites pour faciliter un eventuel passage du jdk 1.3 au jdk1.4
com.ginger.logging classes spécialisant log4j pour Ginger + les messages de log préformattés
com.ginger.preparser classes mères et leurs dérivées pour les preparsers Orian et DDM
com.ginger.stat classes du module GdmGenerateStat
com.ginger.util classes utilitaires pour tout Ginger
com.ginger.web servlet générique pour les modules ACK et MO
Niji, making convergence a reality
CVS : Modules de génération de librairies .jar et EAR GDM
Ginger conf servant à générer GDM.ear
GdmGenerateStat conf servant à générer GdmGenerateStat.jar
gen conf servant à générer gen.jar
importExport conf servant à générer import/export.jar
JMSSender conf servant à générer JMSSender.jar (utilisé dans des scripts pour AUTOSYS)
preparser conf servant à générer preparser.jar
mo conf et classes servant à générer mo.war
ack conf et classes servant à générer ack.war
Niji, making convergence a reality
CVS : Modules de génération de EAR MMGEarMMG conf servant à générer MMG.ear
ihm pages .jsp de l'ihm Ginger + pages spécialisant le framework Swapcom
mmg environnements de conf MMG pour les serveurs : DEV, PACK, PROD chez Cegetel, LOIFUSHI, QUIMPER, QUIMPER_REF chez Niji
.tgz des connecteurs et serveur de licences, patch des connecteurs et de la MMG pour la version en cours
Niji, making convergence a reality
CVS : Modules de génération de EAR MMG-SDKEarMMG-SDK conf servant à générer MMG-SDK.ear
mmg-sdk environnements de conf du SDK MMG pour les serveurs : DEV, PACK, PROD chez Cegetel, LOIFUSHI, QUIMPER, QUIMPER_REF chez Niji
.tgz du SDK MMG pour la version en cours
Niji, making convergence a reality
CVS : Modules SVI
SVI applications, patchs, fichiers sons, script vxml et xslt pour le SVI
Niji, making convergence a reality
CVS : Scripts et divers
admg shell scripts d'administration Ginger, du répertoire /product/ginger/ginger/bin
bd scripts sql de gestion des bases de données GDM et MMG + dumps.tgz du SDK MMG pour la version en cours
conf environnements de conf GINGER pour les serveurs : DEV, PACK, PROD chez Cegetel, LOIFUSHI, QUIMPER, QUIMPER_REF chez Niji
Niji scripts de generation des classes de la base
scripts et conf pour la livraison
scripts et conf pour la livraison
SimGinger conf, scripts et classes du simulateur Ginger
Niji, making convergence a reality
Présentation du modèle de données
Revue du modèle sous PowerAMC
Présentation de la génération automatique de code Java
Niji, making convergence a reality
4. L'environnement de production
Niji, making convergence a reality
Les standards imposés par Cegetel
Voir Guide EDISON Système opérationnel : Solaris
recommandations pour scripts shell Autosys Base de données : Oracle
recommandations pour répartition des données Serveur d'application : Websphere
recommandations pour déploiement Websphere Interface Temps Réel : MQ Series
recommandations pour implémentation MQ-Series Interface Batch : CFT
recommandations pour implémentation CFT Supervision : agent Tivoli
recommandations pour stratégie supervision
Niji, making convergence a reality
Environnement Cegetel
Serveurs 1 serveur de Packaging 1 serveur de Production
CFT Serveur CFT
Annuaire LDAP Serveur LDAP
Scripts AUTOSYS Ordonnancement
Tivoli Supervision générique Supervision spécifique