sM-Client Projekt - Cambridge Technology Partners
Contents
1. 4 2 4 1 Connexion On peut configurer la connexion comme suit JAVA_OPTS Dlog4j configuration ile C log config On peut r gler la JAVA OPTS soit dans la ligne de commandement ou dans les variables d environnement La connexion peut tre configur e comme suit dans log_config txt log4j rootCategory INFO console R log4j appender console org apache log4j ConsoleAppender log4j appender console layout org apache log4j PatternLayout log4j appender console layout ConversionPattern m n log4j appender R org apache log4j DailyRollingFileAppender log4j appender R File D smclient log Roll file per day log4j appender R DatePattern yyyy MM dd log4j appender R layout org apache log4j PatternLayout log4j appender R layout ConversionPattern d 5p C 1 Sm n 4 2 4 2 Certificat SSL Si l utilisation d un certificat est souhait e pour exploitation le JBoss peut tre configur en cons quence On trouvera ici http www jboss org community wiki SSLSetup une description fouill e de la mani re dont ceci pe t tre fait conform ment aux exigences 4 2 4 3 Changement de ports Port web connection JBoss Pour changer le port de web connection on peut adapter l entr e dans le fichier JBoss Home server default deploy jboss web deployer server xml lt Connector port 8080 address jboss bind address maxThreads 250 maxHttpHeaderSize 8192 emptySessionPath true protocol HTTP 1 12. message participants list participants_list message participants dL SIE sett 7 VERIFICATION DE L INSTALLATION ll faut proc der aux 3 tests suivants une fois l installation du client sM effectu e e Appel d une page de version dans le navigateur e V rification dans le log JBoss e Envoi et r ception d un message de test 7 1 Appel de la page de version On peut appeler la page de version du client sM l aide d un navigateur Vous atteignez cette derni re avec la configuration standard a http localhost 8080 smclient version seam Si l adresse et le port du client sM devaient avoir t configur s diff remment on trouvera la page de version au lieu adapt en cons quence La page doit afficher la version actuelle du client sM install e de fa on analogue l illustration suivante Anmelden 7 a X TAHVAV SSK AM CLRENTT 5 Hilfe Version Page Current version of sM Client Release 1 0 0 RC1 DATABASE PROPERTIES DataBase properties OK CONFIGURATION FILES Configuration properties OK 7 2 V rification dans le log JBoss Au cas o la page de version n est pas affich e on peut v rifier dans le log JBoss si des erreurs quelconques apparaissent 7 3 Envoi et r ception d un message de test Un message de test peut tre copi dans un des dossiers de sortie valide afin de v rifier si l envoi et la r ception fonctionnent correctement Ce message doit tre cette occasion adress l e
3. enableLookups false redirectPort 8443 acceptCount 100 connectionTimeout 20000 disableUploadTimeout true gt Si une autre Bind Address devait tre souhait e en tant que localhost elle peut tre r gl e dans les fichiers run sh Linux bzw run bat Windows dans JBoss Home bin p ex d smclient jboss 4 2 3 GA bin run bat set JAVA OPTS JAVA OPTS Djboss bind address 127 0 0 1 Port JBoss RMI JBoss AS emploie en standard le port 1098 pour les liaisons RMI Si ce port devait tre d j occup on peut adapter le port JBoss comme suit Dans JBoss Home server default conf jboss service xml vous pouvez adapter la ligne lt attribute name RmiPort gt 1098 lt attribute gt sur un port qui n est pas d j occup L autre port est utilis apr s un red marrage e Be Port MySQL En fonction de la mani re dont MySQL est install le port peut tre adapt A En cas d installation manuelle le port peut tre modifi dans le fichier my cnf dans le dossier mysql home bin Le port doit tre modifi sous client et serveur la ligne est la m me aux deux endroits port 3306 B Sile client sM a t install avec le wizard d installation il faut adapter le script de d marrage dans SINSTALL DIR scripts windows start smclient bat resp SINSTALL DIR scripts linux start smclient sh et savoir comme suit La ligne start mysqld console doit tre compl t par port
4. Cambridg ge 7 Technology Partners AHV IV AVS AI client sM Manuel d installation Ebauche CSI OFAS eAVS AI Si G Ro Gi bei Version 0 10 Publication Date 06 Juli 2009 COPYRIGHT Copyright 2009 Cambridge Technology Partners All Rights Reserved For Internal use only No part of this publication may be reproduced transmitted transcribed stored in a retrieval system or translated into any language in any form by any means without the written permission of Cambridge Technology Partners Inc While every precaution has been taken in the preparation of this document Cambridge Technology Partners Inc assumes no responsibility for errors omissions or for damages resulting from the use of the information herein Products or corporate names may be trademarks or registered trademarks of other companies and are used only for the explanation and to the owner s benefit without intent to infringe 4 2 4 3 5 1 5 2 5 3 5 4 5 5 6 1 6 2 6 3 SOMMAIRE OBJET DU DOCUMEN VE 7 APERCU G N RAL notes nn 8 INSTALLATION ET CONFIGURATION DU LOGICIEL D INFRASTRUCTURE 9 INSTALLATION MANUELLE ET CONFIGURATION iii 9 3 1 1 Installation e UE KEE 9 3 1 2 Installation et configuration de l adaptateur sedex AA 9 3 1 3 Installation et configuration de JBoss AS eee 9 3 1 4 Installation de MySQL eae id ete a eae Al 10 INSTALLATION ET CONFIGURATION DU CLIENT SM 11 INSTALLATION MANU
5. accueil contient certaines informations g n rales comme p ex le num ro de version du client sM devant tre install Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 26 42 Z sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 cran d information d IzPack Installation of sM Client Please read the following information a eee The following wizard will quide you through the installation of the sM Clien In case of problems please contact stefan malaer ctp consulting com lt Made with IzPack http izpack org Figure 2 cran d information L cran d information contient d autres informations Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 27 42 amp Z sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 1 Choix du dossier d installation d IzPack Installation of sM Client B Select the installation path C smclientbase Es Browse Made with IzPack http izpack org Figure 3 Choix du dossier d installation On peut s lectionner sur cet cran le dossier d installation pour le client sM L ensemble des donn es JBoss mysql client sM dossiers d interfaces etc sont inst
6. dans le cas de mySQL mysql connector java 5 1 7 bin jar doit tre m moris e dans le dossier JBoss Home server default lib Autres biblioth ques Il faut en outre encore ajouter le xml resolver 1 2 jar ce dernier peut tre t l charg ici http repoi maven org maven2 xnl resolver xml resolver 1 2 xml resolver 1 2 jar Il faut ensuite m moriser le fichier dans le dossier JBoss Home 1lib endorsed Configuration de la m moire vive Afin d assurer un fonctionnement sans incidents il faut r gler le MaxPermSize 128MO Cela peut se faire soit dans les JAVA OPTS par l interm diaire de la ligne de commande ou des variables de syst me ou dans les fichiers run sh Linux resp run bat Windows dans JBoss Home bin p ex d smclient jboss 4 2 3 GA bin run bat La ligne suivante doit tre pour cela compl t e par XX MaxPermSize 128m set JAVA OPTS JAVA OPTS Xms128m Xmx512m XX MaxPermSize 128m 6 3 1 6 3 1 1 kat Installation von testbed war La derni re version du banc d essai peut tre t l charg e ici http sm client ctp consulting com Veuillez tenir compte du fait qu en cas de t l chargement l aide d Internet Explorer l extension de fichier peut tre modifi e de war zip Dans ce cas il faut nouveau changer le suffixe en war une fois le t l chargement effectu Le fichier t l charg ne doit pas tre d comprim l aide de Win Zip ou de programmes similaires
7. Windows Resource Kit Tools other SCC Figure 7 Menu de d marrage et raccourci Sur cet cran l utilisateur peut g n rer une inscription dans le menu de d part et ou un raccourci de desktop On peut continuer vers le prochain cran l aide du bouton Next Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 32 42 Z sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 6 Fin de l installation d IzPack Installation of sM Client 2 Installation has completed successfully An uninstaller program has been created in C smclientbase Uninstaller I Generate an automatic installation script Made with IzPack http Vizpack org Figure 8 Fin de l installation Ceci est le dernier cran de l installation Generate an automatic installation script permet de g n rer un script d installation qui contient exactement la m me configuration comme effectu e Le wizard d installation cr e en outre un wizard de d sinstallation Ce dernier peut tre utilis pour une d sinstallation compl te Il se trouve sous INSTALL DIR Uninstaller 5 4 Adaptations manuelles Dans le fichier SINSTALL DIR configuration config properties pour adapter le champ sedexId sur votre ID de sedex Au cas o l adaptateur sedex n a pas encore t install il doit tre install comme d crit sous 3 1 2 Il faut a cette occasion veiller ce que l
8. compl ments 22 05 2009 ML Mise a jour pour la version 2 beta 07 Martin Liebrich Description de l installation avec le wizard 27 05 2009 SM 08 Martin Liebrich Mises a jour version 1 0 RC1 08 06 2009 SM ML Stefan Malar 09 Martin Liebrich Mises a jour installation du banc d essai 15 06 2009 SM ML Stefan Malar Markus Vitalini 10 Martin Liebrich Mises a jour version 1 0 RC2 06 07 2009 SM ML Stefan Malar References ID Nom Version Document 01 Design technique V1 2 Technisches_Design_sM Client_v1 2 pdf 02 Manuel utilisateur Derni re version 03 04 05 06 07 08 09 E R la Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 6 42 Z sM Client Projekt Draft Installations Handbuch Objet du document 1 OBJET DU DOCUMENT Le document suivant d crit l ensemble des tapes d installation et des configurations n cessaires afin d installer et de mettre en service le client sM et le banc d essai correspondant Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 7 42 2 APERGU GENERAL La mise en service du client sM et du banc d essai exige diff rentes tapes d installation et de configuration On peut a cette occasion proc der l installation manuellement ou en ayant recours un wizard Les syst mes d exploitation Windows Linux ou Unix sont pris en charge Il faut installer les composants suivants JDK 6 0 adaptateur sedex ne fait pas partie int grante de la livraison du client sM J
9. d essai banque de donn es e Banc d essai fichier WAR e Configuration des dossiers des interfaces 6 1 Installation de la banque de donn es des bancs d essai On montre ici titre d exemple la mani re dont la banque de donn es peut tre install e sous mySQL ll faut cr er sous mySQL une banque de donn es portant le nom de smclient testbed Myst CREATE IDATABASE ee Query OK 1 row affected 0 05 sec Il faut ensuite cr er un utilisateur de la banque de donn es pour pouvoir acc der a la banque de donn es Nom smclientUser Mot de passe password mysql gt GRANT Alt PRIVILEGES ON smelivent testbed 10 tesbedUser localhost IDENTIFIED BY mot de passe Query OK 0 rows affected 0 06 sec Tableau de configuration On cr e ensuite un tableau de configuration que l on remplit des valeurs correspondantes Le script ci apr s doit tre adapt et ex cut mysg e vse smekend testbed Myc CNEA MABLI sno Ment EE keycoltima VARCHAR 255 NOT NULL PRIMARY KEY value VARCHAR 255 TNS ERENS me Mentee t Deacon oura T ET RLH handler location di7 smelient messaqe nancaler th properetes i TNSERTMNEORSme lient testbed contigucacren VALUES repository location ch smelient repository Properties y e message handler location d finit l endroit o se trouve le fichier Properties avec les configurations pour le banc d essai S Te e 8 L e repository locati
10. galement besoin d un pilote JDBC afin que la banque de donn es fonctionne p ex mySQL Driver http dev mysql com downloads connector j 5 1 html Le fichier Zip t l charg doit d abord tre d comprim La biblioth que des pilotes dans le cas de mySQL mysql connector java 5 1 7 bin jar doit tre m moris e dans le dossier JBoss Home server default lib Autres biblioth ques Il faut en outre encore ajouter le xmil resolver 1 2 jar on peut le t l charger ici http repo1 maven org maven2 xml resolver xml resolver 1 2 xml resolver 1 2 jar Il faut ensuite m moriser le fichier dans le dossier JBoss Home 1lib endorsed Configuration de la m moire vive Afin d assurer un fonctionnement sans incidents il faut r gler le MaxPermSize sur 128MO Cela peut se faire soit dans JAVA_OPTS par l interm diaire de la ligne de commande ou des variables de syst me ou dans les fichiers run sh Linux resp run bat Windows dans JBoss Home bin p ex d smclient jboss 4 2 3 GA bin run bat ll faut pour cela compl ter la ligne par XX MaxPermSize 128m set JAVA OPTS JAVA OPTS Xms128m Xmx512m XX MaxPermSize 128m Installation de smclient war On peut t l charger la derni re version du client sM ici http sm client ctp consulting com Veuillez tenir compte du fait que lors d un t l chargement au moyen d Internet Explorer l extension de fichier peut tre modifi e de war zip Dans ce cas il faut
11. mysql com doc refman 5 1 en installing html Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 10 42 T 4 INSTALLATION ET CONFIGURATION DU CLIENT SM Une fois que l infrastructure a t install e on peut installer le client sM et le banc d essai Il faut installer les composants suivants et proc der aux configurations correspondantes s Fichier WAR client sM e Banque de donn es client sM e Configuration des dossiers des interfaces e Configuration technique e Configuration m tier apr s le d marrage du syst me Une configuration par d faut est livr e avec l ensemble 4 1 Installation manuelle 4 1 1 Installation banque de donn es client sM On montre ici titre d exemple comment la banque de donn es client sM est install e sous mySQL Une banque de donn es portant le nom de smclient doit tre cr e sous mySQL mysql gt CREATE DATABASE smclient Query OK 1 row affected 0 05 sec Il faut ensuite cr er une banque de donn es utilisateur afin de pouvoir acc der a la banque de donn es Nom smclientUser Mot de passe password mysql gt GRANT ALL PRIVILEGES ON smclient TO smclientUser localhost IDENTIFIED BY password Query OK O rows affected 0 06 sec Tableau de configuration On cr e ensuite le tableau de configuration et on le remplit avec les valeurs correspondantes Il faut pour cela adapter et ex cuter le script ci apr s mysql gt use smclient mysql gt CR
12. pour la case postale e Sortie message e Messages envoy s o Sous dossiers pour chaque application m tier triage o Sous dossier pour les messages qui n ont pas pu tre envoy s o Sous dossier pour les les messages qui n ont pas pu tre transmis Les noms des dossiers peuvent tre librement choisis mais doivent tre d finis par l interm diaire d un fichier property On trouvera des d tails au chapitre 4 2 et 4 8 du document de design technique Les dossiers suivants doivent tre configur s en tant que stockage Les dossiers doivent tre ventuellement cr s et tre pourvus des droits de lecture et d criture correspondants pour le client sM e Stockage o Documentation o Contr le d int grit o Liste des participants o XSD XSLT Les noms des dossiers peuvent tre choisis librement mais doivent tre d finis par l interm diaire d un fichier property Vous trouverez des d tails aux chapitres 4 2 et 4 3 du document de design technique 4 2 2 Configuration technique Vous trouverez la liste des configurations techniques au chapitre 3 5 3 du document de design technique La configuration est entreprise manuellement dans les fichiers de configuration correspondants Important assure vous que tous les dossiers indiqu s sont existent galement bien 4 2 2 1 config properties sedexld Ihre Sedex ID update message types Types de message pour les mises jour de syst me Autoupdate Ex cuter les
13. sM Les autres chemins sont relatifs par rapport a ce dossier xsd_ xslt Ensemble des formats de message XSD Instructions de conversion correspondantes XSLT documentation Contient la documentation concernant le client sM p ex manuel utilisateur peut contenir des sous dossiers si envoy ainsi integrity Contient a la rigueur des documents qui ne sont utilis s pour le contr le d int grit que par le client sM ce dossier n est pour cette raison galement accessible qu au client sM participants list Contient la liste des participants actuels message list Contient la liste des messages actuels d crit les messages qui sont actifs message participants list Contient le dossier des participants d crit les messages que les participants peuvent changer Exemple de configuration Stockage is file repository used to store xsd xslts and documentation Sstockage base dir D smelient intertace reposi tory direct Ee direct documen direct ory for all xsds and xsls tse xslt ory for documentation tation documentation ory for optional integrity check files integri 1 1 locati 1 locati Lenert Ey Mie ee ee Check ONnNOrMpanticHpant es Mrs EE EE EE lish Parte tpamt sss Ce ccm on of messages list message list participants_list message list xml on of message participants list
14. your port Dans les deux cas il faut en outre adapter la ligne suivante dans le fichier smclient ds xml dans le dossier JBoss Home server default deploy lt connection url gt jdbc mysql localhost your port smclient lt connection url gt 4 2 4 4 Red marrage automatique Au cas o le client sM a t install avec l aide du Wizard il existe un script de d marrage qui permet le simple d marrage red marrage du client sM On d marre a cete occasion MySQL DB et JBoss AS et galement ainsi le client sM Au cas o le client sM resp MySQL DB et JBoss AS ont t install manuellement et en tant que services un red marrage a lieu automatiquement lors du red marrage du serveur Les services peuvent tre galement red marr s manuellement par l interm diaire des outils d environnement correspondants L installation en tant que service de MySQL est faite automatiquement si cela a t indiqu ainsi Il faut ex cuter les tapes suivantes pour installer JBoss en tant que service sous Windows 1 T l chargement de JBoss Native pour la plate forme souhait de http www jboss org jbossweb downloads jboss native 2 Copier joosssvc exe et service bat partir du fichier zip vers le dossier JBOSS HOME bin O set SVCNAM GI JBoss4java6 set SVCDISP JBoss Application Server 4 2 SMClient set SVCDESC JBoss Application Server 4 2 GA Platform Windows x86 4 On peut adapter en option le c
15. 3 1 Configuration des dossiers des interfaces 37 V RIFICATION DE L INSTALLATION sss sese 40 APPEL DE LA PAGE DE VERSION a 0 1 2 40 L sM Client Projekt Draft Installations Handbuch 7 2 VERIFICATION DANS LE LOG JBOSS oiononneoeneeeneseeneeeeeesnenenennananananannnnnan ananasas anan an anana a nananana anana a annann n 40 7 3 ENVOI ET R CEPTION D UN MESSAGE DE TEST 40 e e a e D se Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 4 42 TABLEAU DES ILLUSTRATIONS Figure 1 cran d accueil E 26 Figure 2 cran d information see 27 Figure 3 Choix du dossier d installation ss 28 Figure 4 cran du jeu complet 29 Figure 5 Proc dure d instalation aasan az eaa aaan aN RANEE ARA RSR 30 Fig re 6 Configuration E 31 Figure 7 Menu de d marrage et raccourci iii 32 Figure 8 Fin de l installation AA 33 sM Client Projekt Installations Handbuch Historique Modifi Draft GESTION DES DOCUMENTS Description Valid Version 01 Martin Liebrich Cr ation et chapitrage 30 03 2009 SM 02 Martin Liebrich Chapitre 3 6 06 04 2009 SM 03 Sergey Abagyan Suggestions suppl mentaires 08 04 2009 ML 04 Martin Liebrich Passage en revue pour la version 1 beta 09 04 2009 SM 05 Sergey Abagyan Passage en revue pour la version 1 beta 17 04 2009 SM 06 Stefan Malar Restructuration et
16. 3 GA 2 Overall installation progress Made with IzPack http izpack org Figure 5 Proc dure d installation Cet cran montre le progr s de l installation Une fois l installation achev e on peut continuer vers le prochain cran par l interm diaire du bouton Next Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 30 42 H Z sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 4 Configuration Ki d IzPack Installation of sM Client Processing start database C workspace sm client _installer gt cd C smcelienthase mysql 5 1 34 win32 bin C smelientbase mysql 5 1 34 win32 bin gt start mysqld console C smelienthbase mysql 5 1 34 win32 bin gt cd C smclienthase scripts C smelienthbase scripts gt wait 10 lt Made with IzPack http izpack org Figure 6 Configuration L cran montre le progr s de la configuration Des fen tres DOS sont ouvertes cette occasion mais qui sont a nouveau ferm es a la fin Une fois la configuration achev e on peut continuer vers le prochain cran par l interm diaire du bouton Next 5 3 5 Menu de d marrage et raccourci Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 31 42 H Z sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM es IzPack Installation of sM Client Accessories Administrative Tools
17. Boss 4 2 3 GA MySQL 5 1 GA Fichier WAR client sM Banque de donn es client sM Banc d essai fichier WAR Banc d essai banque de donn es Il faut ensuite proc der aux configurations suivantes sur l installation Configuration de l adaptateur ne fait pas partie int grante de la livraison du client sM Configuration des dossiers des interfaces client sM et banc d essai Configuration technique client sM et banc d essai Configuration m tier apr s le d marrage du syst me client sM et banc d essai Une configuration par d faut est fournie avec l ensemble 3 INSTALLATION ET CONFIGURATION DU LOGICIEL D INFRASTRUCTURE Le logiciel d infrastructure correspondant doit d abord tre install resp tre d j l en tant que base permettant de faire fonctionner le client sM et le banc d essai Les composants suivants doivent tre en principe install s e JDK6 0 e adaptateur sedex ne fait pas partie int grante de la livraison du client sM e JBoss 4 2 3 GA e MySQL 5 1 GA Il faut ensuite proc der aux configurations suivantes sur l installation e Configuration de l adaptateur ne fait pas partie int grante de la livraison du client sM e Configuration de JBoss et MySQL 3 1 Installation manuelle et configuration 3 1 1 Installation du JDK On peut t l charger un environnement Java correspondant JDK version 6 0 ou plus depuis Internet http java sun com javase downloads index jsp L installat
18. EATE TABLE configuration keycolumn VARCHAR 255 NOT NULL PRIMARY KEY value VARCHAR 255 INSERT INTO configuration VALUES 7 contig locacion your tilepath conkig properties E 0 2 L EN Sie NL OR Gen your filepat INSERT INTO your il epai INSERT INTO Your ilegpa DS 19 en INSERT INTO con ELC configura th repository properties SONO fig fig uration VALUES message handler location th message handler properties Ton VAILWES UneposmitzOm Mlocations s uration VALUES rules eegener A th rules xml uration VALUES timeout time 30 uration VALUES keep deleted time 10 e config location d finit l endroit o se trouve le fichier properties avec les configurations qui valent g n ralement pour le client sM e message handler location d finit l endroit o se trouve le fichier properties avec les configurations du MessageHandler gestionnaire de messages e repository location d finit endroit o se trouve le fichier properties avec les configurations du stockage e rules location d finit l endroit o se trouve le fichier avec les r gles de triage e timeout time d finit en minutes le temps pendant lequel un utilisateur reste connect sans activit e keep deleted time d finit en jour le temps pendant lequel des messages restent conserv es dans la corbeille papiers avant d tre effac
19. EELE eessen reese dee eege ene 11 4 1 1 Installation banque de donn es client SM 11 4 1 2 Installation client SM sur JBoss 13 CONFIGURATION DU CLIENT SM 14 4 2 1 Configuration des dossiers des interfaces 14 4 2 2 Configuration technique sisi 15 4 2 3 Gonfig ration en 21 4 2 4 Configurations en option sise 21 INSTALLATION D UNE MISE JOUR retirant ah nine td vereedegt eso 24 INSTALLATION ET CONFIGURATION DU CLIENT SM L AIDE DU WIZARD 25 CONDITIONS PREALABLES csceecseeseesececeenceaeesenenceaesneneaceaeesaecaaeeneeaesaaneaesaessaneassaeeneseaaeaeesaesaaseaeeaesaneeseaees 25 TOn e BE Ne RE 25 5 2 1 cran GL eMC EE 26 CRAN D INFORMATION user snserneererneeennensneeeneenenaneenanenen eee eneneneneeneneneneneneeninnnensneneneeenene nee 27 5 3 1 Choix du dossier d installation sss ce eececeee cence ee ecne cece eae ee erences ee eaaeeeeetaaeeeeeeaeeeeeeaeeeeeeaeeeeneaea 28 5 3 2 cran du jeu complet 29 5 3 3 Proc dure d installation wise sees cccis facets sheet Ed A e ed 30 5 3 4 ele te UC 31 5 3 5 Menu de d marrage et raccourci 31 5 3 6 Fi Ce instalation nn ati deeg 33 ADAPTATIONS MANUELLE S 52 222020 soicionaeedneacdensndsatwisietc conahocn ENEE Een eeneg Eege tees 33 D MARRAGE DU CLIENT SM 34 INSTALLATION ET CONFIGURATION DU BANC D ESSAI 35 INSTALLATION DE LA BANQUE DE DONNEES DES BANCS D ESSAI sse ee ee 35 INSTALLATION DU BANC D ESSAI SUR JBOSS iii 36 CONFIGURATION DU BANC D ESSAI eee 37 6
20. Le fichier WAR doit tre ensuite copi dans le dossier JBOSS HOME Server default deploy Le serveur JBoss proc de automatiquement un d ploiement de l application option Autodeploy doit tre activ e c est le cas de fa on standard 6 3 Configuration du banc d essai Configuration des dossiers des interfaces Les interfaces sont d finies dans le fichier Property message handler properties Veuillez vous assurer que les dossiers indiqu s existent bien message handler tb properties Interface vers les applications m tieres base dir smclient interface Le dossier de base pour le client sM les autres chemins sont relatifs par rapport a ce dossier sent location outbox location Dossier ou sont stock s les messages recus inbox location Contient les messages ne pouvant pas tre trait s failed tosend location Contient les messages qui chouent au moment de leur envoi failed transmit location receipt location Interface de l adaptateur sedex simul base dir adapter Chemin du dossier de l interface de l adptateur sedex doit correspondre ceux du client sM tester adapter inbox location Entr e message doit correspondre celle du client sM tester adapter receipt location Entr e quittance doit correspondre celle du client sM tester adapter outbox location Sortie message doit correspondre celle d
21. all s en dessous de ce dossier Le dossier peut tre choisi librement et est cr au besoin Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 28 42 H Z sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 2 cran du jeu complet d IzPack Installation of sM Client Select the packs you want to install Q Note Grayed packs are required M Boss 45 4 2 3 GA 109 09 MB mysql 5 1 GA 414 93 MB sM Client 0 1 2 28 87 MB scripts 16 94 KB Description JBoss Application Server Total space Required 552 91 MB Available space 2 22 GB i Figure 4 cran du jeu complet Made with IzPack http izpack org Cet cran montre l ensemble des fichiers devant tre install s Tous les fichiers doivent tre imp rativement install s si bien qu il n existe pas de possibilit de s lection Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 29 42 H Z sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 3 Proc dure d installation d IzPack Installation of sM Client 2 Pack installation progress C smclientbase jboss 4 2 3 GA4 server all deploy jmx console war WEB INF classes org jboss jmx adaptor html Htmladapt JBoss 45 4 2
22. at lt triage xmlns xsi http www w3 org 2001 XMLSchema instance xSi noNamespaceSchemaLocation rules xsd gt lt rule gt LOCRI COLLES lt messageType gt 3001 lt messageType gt lt messageSubType gt 000201 lt messageSubType gt lt messageAction gt 1 lt messageAction gt lt criteria gt lt desStinartonrolder Dbs smelient inrertace inbox app l lt 7 destin ationFolder gt lt PDFGeneration boolean true gt lt useCase gt receive lt useCase gt lt rule gt lt default rule has no criteria gt lt rule gt des pind Tonva lider Db smeltenL ineeriace anbox pest box des tinationFolder gt lt PDFGeneration boolean false gt lt useCase gt receive lt useCase gt lt rule gt lt rule gt lt destinationFolder gt D smclient interface sent lt destinationFo lder gt lt PDFGeneration boolean false gt lt useCase gt send lt useCase gt lt rule gt lt default rule for adapter so all messages are picked up gt lt rule gt lt useCase gt adapter lt useCase gt lt rule gt lt triage gt Explication de l utilisation de r gles L l ment lt triage gt contient un nombre illimit d l ments lt rule gt Les r gles sont appliqu es dans t te de liste Il doit y avoir imp rativement un r gle par d faut par Use Case lt useCase gt Une r gle par d faut n a pas de crit res lt criteria gt ll y a les Use Cases envoyer recevoir et a
23. d attachments be validated false defines if backup is enabled backup enabled true folder used for backup and restore folder must exist backupDirectory D smclient backup time of backup hour of day time of day for backup 12 defines if inbox is enabled inbox enabled true defines if formservice is enabled formservice enabled false 4 2 2 2 message handler properties Interface vers les applications m tiers base dir smclient interface Dossier de base du client sM les autres chemins sont relatifs par rapport a ce dossier sent location outbox location Sortie message inbox location Entr e message i failed Contient les messages ne pouvant pas tre trait s failed tosend location Contient les messages qui chouent au moment de leur envoi failed transmit location Contient les messages qui chouent d s avant leur envoi deleted location Contient les messages qui ont t d plac s dans la corbeille a papiers exported location Contient les messages export s Interface vers l adaptateur sedex base dir adapter Chemins de dossier de l interface de l adaptateur sedex adapter inbox location Entr e message adapter receipt location Entr e quittance adapter outbox location Sortie de message Exemple de configuration base directory for messages all directorie
24. daptateur les Use Cases d signent les cas dans lesquels les r gles s appliquent lt rule gt contient lt criteria gt Crit res de r gles qui sont valu es n existent pas pour les r gles par d faut lt destinationFolder gt dossier dans lequel le message est m moris au cas o une r gle s applique lt PDFGeneration gt true false un PDF est g n r dans ce cas en fonction de la valeur lt useCase gt comme d crit ci dessus lt criteria gt peut contr ler les valeurs suivantes lt messageType gt lt messageSubType gt lt messageAction gt Toutes ces valeurs font r f rence aux valeurs correspodantes dans le message Les combinaisons de valeurs suivantes sont possibles pour lt criteria gt comme d crit dans le design technique chapitre 3 1 1 pas de gt r gle par d faut lt messageType gt lt messageAction gt lt messageType gt et lt messageAction gt lt messageType gt et lt messageSubType gt lt messageType gt lt messageSubType gt et lt messageAction gt 4 2 3 Configuration m tier On trouvera la liste des configurations m tiers au chapitre 3 5 1 du document de design technique On proc de a la configuration par l interm diaire d une interface web On en trouvera la description dans le manuel utilisateur 02 4 2 4 Configurations en option Certaines autres configurations du client sM sont en option et il ne faut y proc der qu en cas de besoin
25. e client sM a cr les interfaces de l adaptateur sedex sous l adresse suivante SINSTALL DIR adapter Erstellt 06 Juli 2009 von Cambridge Technology Partners 2009 33 42 9 A cas o l adaptateur sedex a d j t pr c demment install et qu il y a d j des interfaces d adaptateur sedex la configuration du client sM doit tre adapt e manuellement en cons quence Sous SINSTALL DIR configuration le fichier message handler properties doit tre adapt en r glant la valeur base dir adapter au dossier correspondant On n a dans ce cas plus besoin des dossiers cr s par le wizard INSTALL DIR adapter et ils peuvent tre effac s D autres configurations peuvent tre adapt es vos besoins au besoin et de fa on analogue l installation manuelle chapitre 4 5 5 D marrage du client sM La derni re tape du wizard installe une entr e de client sM dans le menu de d marrage et ou une ic ne de raccourci sur le desktop Le client sM peut tre d marr On d marre d abord la banque de donn es mysql une fen tre DOS propre est ouverte pour cela ensuite le serveur JBoss D s que le serveur JBoss l application est disponible 6 INSTALLATION ET CONFIGURATION DU BANC D ESSAI L installation et la configuration du Banc d essai sont semblables a celles du client sM et suppose galement que l installation de l infrastructure a t faite Il faut ex cuter les tapes suivantes e Banc
26. et aussi le mot de passe Admin Il faut faire attention aux majuscules et aux minuscules au moment de la saisie 4 1 2 Installation client sM sur JBoss Configuration de la source de donn es pour le client sM Il faut configurer une source de donn es afin de pouvoir acc der aux donn es depuis le serveur d application et donc depuis l application Il faut pour cela configurer dans JNDI une entr e smclient montrant la banque de donn es et le sch ma correspondants Pour la configuration il faut ajouter p ex dans le dossier JBoss Home server default deploy un fichier smclient ds xml Voici une configuration pour MySQL titre d exemple lt xml version 1 0 encoding UTF 8 gt lt DOCTYPE datasources PUBLIC JBoss DTD JBOSS JCA Config 1 5 EN http www jboss org j2ee dtd jboss ds_ 1 5 dtd gt lt datasources gt lt local tx datasource gt lt jndi name gt smclient lt jndi name gt lt connection url gt jdbce mysql localhost 3306 smclient lt connection url gt lt driver class gt com mysql jdbc Driver lt driver class gt lt user name gt smclientUser lt user name gt lt password gt password lt password gt lt local tx datasource gt lt datasources gt Les champs user name et password correspondent aux valeurs qui ont t d finies au 4 1 1 On peut trouver ici http jboss org community docs DOC 9328 de la documentation suppl mentaire sur la configuration On a
27. hemin pour les fichiers Log jbosssvc exe p 1 Starting SSVCDISP gt run Log call run bat lt r lock gt gt run log 2 gt amp 1 jbosssvc exe p 1 Shutdown SVCDISP service gt gt run log jbosssvc exe p 1 Shutting down SSVCDISP gt shutdown log call shutdown S lt s lock gt gt shutdown log 2 gt amp 1 jbosssvc exe p 1 Shutdown SVCDISP service gt gt shutdown log La sortie de la console Jboss la console est sorte dans ce cas vers run log et shutdown log Pour intaller Joss en tant que service Windows il faut ex cuter la commande suivante JBOSS HOME bin gt service bat install Pour d sinstaller le service JBOSS HOME bin gt service bat uninstall On peut maintenant faire passer le Start mode dans Start Control Panel Administrative Services de manuel en automatique afin de faire d marrer le JBoss lors du d marrage du syst me 4 3 Installation d une mise jour Au cas o ce n est pas le client sM qui est r install mais une mise jour cette derni re peut tre install e manuellement Il faut en principe pour la nouvelle version copier seulement le nouveau smclient war dans le dossier JBOSS HOME Server default deploy Au cas o il faut proc der des mises jour de la banque de donn es ou des fichiers de configuration ce point est communiqu dans les notes de la version et des scripts de mise jour sont galement mises disposition pou
28. ion de JDK s effectue conform ment aux instructions d installation de SUN http java sun com javase 6 webnotes install index html 3 1 2 Installation et configuration de l adaptateur sedex L adaptateur sedex version actuelle 2 0 8 peut tre t l charg depuis Internet http www media stat admin ch software sedex sedex_ adapter _ installer v2 0 8 exe L installation et la configuration s effectue conform ment aux instructions d installation de l OFAS http Awww bfs admin ch bfs portal de index news 00 00 12 01 html 3 1 3 Installation et configuration de JBoss AS On peut t l charger JBoss AS 4 2 3 GA depuis Internet http www jboss org jbossas downloads Il faut utiliser la version pour JDK 6 0 L installation s effectue conform ment aux instructions d installation de JBoss http Awww jboss org file access default members jbossas freezone docs Installation Guide 4 html index html Il faut tenir compte du fait que JBOSS HOME montre le dossier root correspondant de JBoss et non bin ou lib Il faut tenir compte du fait qu il ne doit pas y avoir d espace dans le chemin du dossier d installation Z sM Client Projekt Draft Installations Handbuch Installation et configuration du logiciel 3 1 4 Installation de MySQL On peut t l charger MySQL 5 1 GA depuis Internet http dev mysql com downloads mysql 5 1 html L installation s effectue conform ment aux instructions d installation de MySQL http dev
29. mises jour automatiquement time of day for update Heure de la journ e a laquelle les mises a jour sont effectu es default locale Langue standard p ex pour l exportation filechange listener interval Intervalle d interrogation du client sM en secondes should message be validated Les messages doivent tre valid s selon le sch ma XML should attachments be validated Les annexes de type mime doivent tre valid es backup enabled D finit si la sauvegarde est active backupDirectory Dossiers dans lequel les sauvegardes sont stock es en m moire time of day for backup Heure de la journ e a laquelle les sauvegardes doivent tre ex cut es inbox enabled D finit si l Inbox est active formservice enabled D finit si le service formulaires est actif Exemple de configuration your sedex id sedexId 6 900014 1 type of message used to update the system repository xml files documentation update message types 2990 3999 allow automatic updates autoupdate true time of update hour of day time of day for update 18 default application language default locale de finterval for checking files in seconds filechange listener interval 60 should messages xml files be validated with the schema should message be validated true should attachment mime types be validated shoul
30. n concernant le client sM p ex manuel utilisateur peut contenir des sous dossiers si envoy ainsi integrity Contient la rigueur des documents qui ne sont utilis s pour le contr le d int grit que par le client sM ce dossier n est pour cette raison galement accessible qu au client sM participants list Contient la liste des participants actuels message list Contient la liste des messages actuels d crit les messages qui sont actifs message participants list Contient le dossier des participants d crit les messages que les participants peuvent changer Exemple de configuration Stockage is file repository used to store xsd xslts and documentation stockage base dir D smclient interface repository director for all xeds and xsls XSC xs lt xse xslt directory for documentation documentation documentation directory for optional integrity check files EE EE PlLoCation Of Participants list location of messages list EE EE hls e pant we lpanue wh Sk EE bree scm message list participants_list message list xml location of message participants list message participants list participants_list message participants List zma 4 2 2 4 rules xml Le fichier rules xml contient les r gles concernant le triage Il est cr sous la forme d un fichier XML du fait de sa complexit Exemple de configuration k
31. nouveau changer le suffixe en war une fois le t l chargement effectu Le fichier t l charg ne doit pas tre d comprim l aide de Win Zip ni d autres programmes similaires Le fichier WAR doit tre ensuite copi dans le dossier JBOSS HOME Server default deploy Le serveur JBoss proc de automatiquement un d ploiement de l application option Autodeploy doit tre activ e c est le cas de fa on standard 4 2 Configuration du client sM 4 2 1 Configuration des dossiers des interfaces Les interfaces sont d finies dans le Property File message handler properties Il faut configurer les dossiers des interfaces e Vers l adaptateur sedex e Vers les applications m tiers le triage externe e Stockage e Interfaces internes Les dossiers suivants doivent tre consid r s en tant qu interface par rapport l adaptateur sedex Les dossiers ont d j t cr s lors de l installation de l adaptateur e Message d entr e e Entr e quittance sedex e Message sortie e Vous pourrez trouver des d tails au chapitre 4 1 du document de design technique Il faut configurer les dossiers suivants en tant qu interface vers les applications m tiers le triage externe resp en tant qu interfaces internes faut ventuellement cr er les dossiers et les pourvoir des droits d criture et de lecture pour le client sM e Entr e message o Sous dossier pour chaque application m tier triage o Sous dossier
32. on d finit l endroit o se trouve le fichier Properties avec les configurations pour le stockage Si le client sM est aussi simultan ment install on peut employer le m me stockage 6 2 Installation du banc d essai sur JBoss Configuration de la source de donn es pour le banc d essai Il configurer une source de donn es afin de pouvoir acc der aux donn es depuis le serveur d application et donc de l application II faut pour cela configurer dans JNDI une entr e testbed montrant la banque de donn es correspondante et le sch ma Pour la configuration on peut p ex ajouter dans le dossier JBoss Home server default deploy un fichier testbed ds xm1 Voici ici un exemple de configuration pour MySQL lt datasources gt lt local tx datasource gt lt jndi name gt testbed lt jndi name gt lt connection url gt jdbc mysql localhost 3306 smclient testbed lt connection url gt lt driver class gt com mysql jdbc Driver lt driver class gt lt user name gt testbedUser lt user name gt lt password gt password lt password gt lt local tx datasource gt lt datasources gt Les champs user name et password correspondent aux valeurs qui ont t indiqu es au 6 1 On a galement besoin d un pilote JDBC pour que la banque de donn es fonctionne p ex mySQL Driver http dev mysql com downloads connector j 5 1 html Le fichier Zip t l charg doit d abord tre d comprim La biblioth que des pilotes
33. r la banque de donn es 5 INSTALLATION ET CONFIGURATION DU CLIENT SM A L AIDE DU WIZARD Un wizard simplifiant l installation est livr pour des installations standard On proc de a cette occasion a une installation et une configuration analogue la description du chapitre 4 mais les possibilit s de configuration de la part de l utilisateur sont cette occasion un peu restreintes Mais des configurations peuvent tre adapt es manuellement apr s ex cution du wizard 5 1 Conditions pr alables Le wizard d installations est livr en tant qu Executable JAR et peut ainsi tre directement ex cut La condition pr alable cela est qu une JAVA SDK soit install comme cela a t d fini sous 3 1 1 Au cas o l adaptateur sedex n est pas encore install il est recommand de ne le faire qu apr s l installation du client sM 5 2 Installation Le sous chapitre suivant conduit cran apr s cran travers l installation l aide du wizard E sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 2 1 cran d accueil d IzPack Installation of sM Client Welcome to the installation of sM Client 0 1 2 Q This software is developed by Cambridge Technology Partners lt info ctp consulting com gt LI The homepage is at http www ctp consulting com Made with IzPack http fizpack org Figure 1 cran d accueil L cran d
34. s Tables d utilisateurs Les tables d utilisateurs doivent tre galement cr s et remplis avec les valeurs correspondantes II faut pour cela ex cuter le script ci apr s Mysql gt CREATE TABLE Role id BIGINT NOT NULL AUTO INCREMENT name VARCHAR 255 description VARCHAR 255 PRIMARY KEY D insert in Ee insert in ES Bol Active User insert in EO Rol Passive User CREATE TABLE User id BIGINT NOT NULL AUTO INCREMENT username VARCHAR 255 password VARCHAR 255 firstname VARCHAR 255 lastname VARCHAR 255 defaultLanguage VARCHAR 255 PRIMARY KEY Le Sp tert eege D 9 Role Le id name descript name descript name descripl id ELORN Elon Eilean val val val lues Admin lues ActiveUser lues PassiveUser kat insert into User username password firstname lastname defaultLanguage values Admin 46 tAEewgFnQ toQ9ADB5Q administrator administrator isis 1 y CREATE TABLE Weer eRele ieee KS BIGINT NOT NULL role ial BIGINT NOT NULL Lier Lee T SLMRGIS TRS 7 ele at Sete selec wel from user where username Admin select id from role where name Admin Ce script cr e un utilisateur standard auquel d autres utilisateurs peuvent tre ensuite ajout s Cet utilisateur a le nom d utilisateur Admin
35. s below are relative to base directory base dir eren SEET Eed De Smolen annette tracey Hlocationmorssente res sent location sent outbox location outbox location for incoming messages inbox location inbox post box location for deleted messages deleted location deleted location for exported messages exported location exported location of failed messages failed location failed failed to send it could not be location form messages to be send send by the smclient failed tosend location failed failed_to_send failed to transmit means that in the send the sedex client could not transmit the message Tallec creansmit locatilon taillec tallec to cransmiit configuration of sedex adapter working directory of sedex adapter all directories below are relative to base directory base dir adapter D smclient interface adapter directory for incoming messages adapter inbox location inbox directory for technical receipt ES adapter receipt location receipt ce directory for outgoing messages kat adapter outbox location outbox 4 2 2 3 repository properties Stockage stockage base dir Stockage du repository du client sM Les autres chemins sont relatifs par rapport a ce dossier xsd_xslt Ensemble des formats de message XSD Instructions de conversion correspondantes XSLT documentation Contient la documentatio
36. u client tester Exemple de configuration base directory for messages all directories below are relative to base directory base dir smclient interface D smclient BEER location for sent files sent location sent location for messages received outbox location received location for messages to send inbox location tosend location for deleted messages deleted location deleted location of exported messages exported location exported location of receipts receipt location receipts location of failed messages failed location failed failed to send it could not be send by the smclient failed tosend location failed failed_to_send failed to transmit means that in the send the sedex client could not transmit our message tailed transmit locatlonstailec tallec to trensmilt configration of simulated sedex adapter working directory of sedex adapter all directories below are relative to base directory base dir adapter directory for incoming messages adapter inbox location inbox directory for technical receipts adapter receipt location receipts directory for outgoing messages adapter outbox location outbox 6 3 1 2 repository properties Le repository properties est le m me que que celui qui a d ja t d crit pour le client sM Stockage stockage base dir Stockage pour le repository du client
37. xp diteur Le message doit ensuite tre envoy par le client sM et aussi tre re u par lui L ensemble du traitement du message peut ainsi tre suivi l aide de l Audit Trail et le cas ch ant des logs On peut en outre v rifier si l envoi et la r ception de tous les messages et quittances se trouvent dans les bons dossiers Erstellt sM Client Projekt Installations Handbuch 06 Juli 2009 von Cambridge Technology Partners 2009 Draft V rification de l Installation EI D Ki sis e e ete e 41 42 Te Cambridge Technology Partners Switzerland S A Nyon 27 Ch de Pr cossy CH 1260 Nyon T l 41 0 22 306 4646 Fax 41 0 22 306 4647 Zurich Imperial 4th floor Leutschenbachstrasse 41 8050 Zurich T l 41 0 43 456 2300 Fax 41 0 43 456 2301
Download Pdf Manuals
Related Search