4 installation et configuration du client sm
Contents
1. 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 install 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 15 Juni 2009 von Cambridge Technology Partners 2009 27 41 e sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 2 cran du jeu complet e IzPack Installation of sM Client 18 Select the packs you want to install Q Note Grayed packs are required JBoss S 4 2 3 G mysql 5 1 G 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 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 15 Juni 2009 von Cambridge Technology Partners 2009 28 41 e sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 3 Proc dure d installation d2. Cambridg ge 2 Technology Partners AHV IV AVS AI client sM Manuel d installation Ebauche CSI OFAS eAVS AI e Qo o o o o Version 0 9 Publication Date 15 Juni 2009 e 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 DOCUMENT rss on 7 APER U G N RAL cto ete aeui G i lncetnddi biben oa i nid E cute a REP 8 INSTALLATION ET CONFIGURATION DU LOGICIEL D INFRASTRUCTURE 9 INSTALLATION MANUELLE ET CONFIGURATION 4 nnne ennnre tnn nnnn nnn nennen EAEE nennen nnne rennen 9 3 1 1 Installation du JDK E 9 3 1 2 Installation et configuration de l adaptateur seen 9 3 1 3 Installation et configuration de JBoss AS cc cccesc
3. Cambridge Technology Partners lt info ctp consulting com gt H The homepage is at http fm ctp consulting com Made with IzPack http izpack org Figure 1 cran d accueil L cran d 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 15 Juni 2009 von Cambridge Technology Partners 2009 25 41 sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 cran d information IzPack Installation of sM Client 2 Please read the Following information The following wizard will guide you through the installation of the sM Clien In case of problems please contact stefan malaer ictp consulting com CSN ji 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 15 Juni 2009 von Cambridge Technology Partners 2009 26 41 e sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 1 Choix du dossier d installation di IzPack Installation of sM Client E Select the installation path C smclientbase Esos Made with IzPack http izpack org moss Je Oar Figure 3
4. interval 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 should 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 E inbox is enabled inbox enabled true defines if formservice enabled false 4 2 2 2 E formservice is enabled 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 ce dossier sent location Dossier des messages mis outbox location Sortie message inbox location Entr e message 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 papiers exported location Contient les messages export s Interface vers l adaptateur sedex base dir adapter Chemins de dossier de l interface de l adapt
5. 0 43 456 2300 Fax 41 0 43 456 2301 e e Q
6. 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 installation 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 www 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 www jboss org file access default members jbossas freezone docs Installation Guide A html index html Il faut tenir compte du fait que JBOSS HOME montre le dossier root correspondant de JBoss et non bin ou lib I faut tenir compte du fait qu il ne doit pas y avoir d espace dans
7. IzPack Installation of sM Client 2 Pack installation progress C smclientbase jboss 4 2 3 GA server all deploy imx console war WEB INF classes org jboss jmx adaptor html HtmlAdapt JBoss AS 4 2 3 G 2 Overall installation progress 1 4 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 15 Juni 2009 von Cambridge Technology Partners 2009 29 41 e sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 4 Configuration Gei di IzPack Installation of sM Client Processing start database C workspace sm client installer cd C smelientbase mysql 5 1 34 win32 bin C smelienthase mysgl 5 1 34 win32 bin gt start mysqld console C smelienthase mysgl 5 1 34 win32 bin gt cd C smclientbase scripts C smclientbase 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 a 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 15 Juni 2009 von Ca
8. Les r gles sont appliqu es dans t te de liste I doit y avoir imp rativement un r gle par d faut par Use Case useCase Une r gle par d faut n a pas de crit res criteria ll y a les Use Cases envoyer recevoir et adaptateur les Use Cases d signent les cas dans lesquels les r gles s appliquent rule contient criteria Crit res de r gles qui sont valu es n existent pas pour les r gles par d faut destinationFolder 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 useCase comme d crit ci dessus criteria peut contr ler les valeurs suivantes messageType messageSubType 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 messageSubType et lt messageAction gt D e 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 la configuration par l interm diaire d une interface web
9. properties Stockage ablage base dir Stockage du repository du client sM Les autres chemins sont relatifs par rapport 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 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 e stockage is file repository used to store xsd xslts and documentation ablage base dir D smclient interface repository directory for all xsds and xsls xsd xslt xsd xslt directory for documentation documentation documentation fdirectory for optional integrity check files integrity integrity check flocation of participants list Participants list partacipants list participants list xmil location of messages list message list participants list message list xml location of message participants list mess
10. Menu de d marrage et raccourci is 30 5 3 6 Ein d VISTA ALON RETE 32 Diet Nie EINEN 32 D MARRAGE DU CLIENT SM eneee 33 INSTALLATION ET CONFIGURATION DU BANC D ESSAI 34 INSTALLATION DE LA BANQUE DE DONN ES DES BANCS D ESSAI sss 34 INSTALLATION DU BANC D ESSAI SUR JBOSS iii 35 CONFIGURATION DU BANC D ESSAI een 36 6 3 1 Configuration des dossiers des interfaces emen 36 V RIFICATION DE LINSTALLATION erret nennt inerte trt 39 APPEL DE LA PAGE DE VERSION A tette ttn te tette tte ttes tto tte tato tto testae te cta ec a Mig ethan 39 sM Client Projekt Draft Installations Handbuch T 2 V RIFICATION DANS LE LOG JBOSS creto torte tte deepest siue aaa SES Desde ve cereis ce reu ava due 39 7 8 ENVOI ET R CEPTION D UN MESSAGE DE TEST 39 e e e b e Erstellt 15 Juni 2009 von Cambridge Technology Partners 2009 4 41 TABLEAU DES ILLUSTRATIONS Figure E 25 Figure 2 cran d information EE 26 Figure 3 Choix du dossier d installation ss 27 Figure 4 cran du entlueden 28 Figure 5 Proc dure d installation seen 29 Fig re 6 ele le E 30 Figure 7 Menu de d marrage et raccourci see 31 Figure 8 Fin de l installation eiie ertet adeo shame EE ee X poe S a ae 32 e e 3 sM Client Projekt Draft Installations Handbuch GESTION DES DOCUMENTS Histo
11. 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 4 2 4 1 Connexion On peut configurer la connexion comme suit JAVA OPTS Dlog4j configuration C log config txt 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 m n 4 2 4 2 Certificat SSL Si l utilisation d un certificat est souhait e pour l 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 depl
12. age participants list participants list message participants list xml 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 triage xmlns xsi http www w3 org 2001 XMLSchema instance xsi noNamespaceSchemaLocation rules xsd rule criteria 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 destinationFolder gt D smclient interface inbox app_1 lt destin ationFolder gt PDFGeneration boolean true gt lt useCase gt receive lt useCase gt lt rulle gt default rule has no criteria gt rule lt destinationFolder gt D smclient interface inbox lt destinationF older gt lt PDFGeneration boolean false gt lt useCase gt receive lt useCase gt lt rule gt rule 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 rule
13. as 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 pour la banque de donn es e 5 INSTALLATION ET CONFIGURATION DU CLIENT SM L AIDE DU WIZARD Un wizard simplifiant l installation est livr pour des installations standard On proc de cette occasion 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 l 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
14. ateur 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 directories below are relative to base directory base dir smclient interface D smclient interface 4j E ocation for sent files sent location sent 4j SES ocation form messages to be send outbox location outbox 4j Ws ocation for incoming messages inbox location inbox 4j E ocation or deleted messages e deleted location deleted location for exported messages exported location exported location of failed messages failed location failed E failed to send it could not be send by the smclient ailed tosend location failed failed to send failed to transmit means that in the send the sedex client could not transmit the message failed transmit location failed failedsto transmit configuration of sedex adapter working directory of sedex adapter all directories below are relative to base directory base dir adapter D smclient interface adapter Je directory for incoming messages adapter inbox location inbox LE directory for technical receipts adapter receipt location receipts lt directory for outgoing messages adapter outbox location outbox 4 2 2 3 repository
15. dmin 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 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 ll 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 smc1ient 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 local tx datasource lt jndi name gt smclient lt jndi name gt connection url jdbc mysql localhost 3306 smclient connection url driver class com mysql jdbc Driver driver class user name smclientUser user name lt password gt password lt password gt lt local tx datasource gt lt datasources gt Les champs user name et password correspondent aux vale
16. droit o se trouve le fichier avec les r gles de triage timeout time d finit en minutes le temps pendant lequel un utilisateur reste connect sans activit keep deleted time d finit en jour le temps pendant lequel des messages restent conserv es dans la corbeille papiers avant d tre effac s Tables d utilisateurs Les tables d utilisateurs doivent tre galement cr s et remplis avec les valeurs correspondantes Il faut pour cela ex cuter le script ci apr s Mysql CREATE TABLE Role insert Administrator insert Active User insert id BIGINT NOT NULL AUTO_INCREMENT name VARCHAR 255 description VARCHAR 255 PRIMARY KEY id into Role name description values Admin into Role name description values ActiveUser into Role name description values PassiveUser 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 id e insert into User username password firstname lastname defaultLanguage values Admin 46 tAEewgFnQO toQ9ADB5Q administrator administrator ele CREATE TABLE User Role User id BIGINT NOT NULL role id BIGINT NOT NULL insert into User Role User id role id values select id from user where username A
17. eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaeesesaeeseeaeesseneeneaes 9 3 1 4 Installation de MySQL e dept eterne nantaise dite AIL ABE RS ud Da Fase dE Ce eg 10 INSTALLATION ET CONFIGURATION DU CLIENT SM 11 INSTALLATION MANUELLE Enge n etc noie t tac tede cete dile sie Ee a be E uc etes Pn ERR E Md eua coe tante den 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 criticis cicuta eade i eu cua enr EO E Ld Cac euo De 4E Aa ic ea dead ael 14 4 2 1 Configuration des dossiers des Imtertaces eneen 14 4 2 2 Configuration technique sise 15 4 2 3 Configuration m tier u a oe rc edere derniere Faune t dee ana a dee ade a 21 4 2 4 Configurations en Option viz dissin icc ci tieni ea a incited eor aed Eno EH e EOD eee a eese as 21 INSTALLATION D UNE MISE JOUR 2 cscccsecesereeeceesceesecesecensenescesassensssnseaesceeastecsasnsenssenenseesesaesecenenenensesess 23 INSTALLATION ET CONFIGURATION DU CLIENT SM L AIDE DU WIZARD 24 CONDITIONS PREALABLES c sscccssssccssseecsseeesseecsssecessseceessecsaesessaeeesseseesaesesaeeeseeeesesessaeseseeeessseesseeceeees 24 INSTALLATION c H 24 5 2 1 Edi EE 25 EE E 26 5 3 1 Choix du dossier d installation ss 27 542 Jderandujellpompletusssus nent nent 28 5 8 3 Proc dure To E30 E Le REPRE 29 5 3 4 SOM TIUATION EE 30 5 3 5
18. 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 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 l 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 ce dossier sent location Dossier pour les messages envoy s outbox location Dossier o sont stock s les messages recus inbox location Dosseir o sont stock s les messages destin s l exp dition 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 papiers exported location Contient les messages expo
19. ent repository properties e message handler location d finit l endroit o se trouve le fichier Properties avec les configurations pour le banc d essai e e e e repository location 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 Il 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 xml Voici ici un exemple de configuration pour MySQL datasources local tx datasource lt jndi name gt testbed lt jndi name gt connection url jdbc mysql localhost 3306 smclient testbed connection url driver class com mysql jdbc Driver driver class user name testbedUser user name password password password local tx datasource 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 fonctio
20. ez 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 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 l 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 nessage handler properties I 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 Il faut ventuellement cr er les dossier
21. figuration 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 E d Autoupdate Ex cuter les mises jour automatiquement time of day for update Heure de la journ e laquelle les mises 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 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 2999 3999 allow automatic updates autoupdate true time of update hour of day time of day for update 18 default application language default locale de
22. icipants 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 directory xsd_xslt xsd_xslt directory directory SES de LE or all xsds and xsls or documentation documentation documentation or optional integrity check files integrity integrity_check 41 ocation o SES participants 1 participants list participants_list participants list xml location of messages list message list participants_l wu keeege Zeng GE list message list xml message participants list message participants list participants list message participants IES e sat 7 V RIFICATION DE L INSTALLATION Il 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 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 doi
23. ient bat resp SINSTALL DIR scripts linux start smclient sh et savoir comme suit La ligne start mysqld console doit tre compl t par port 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 ou 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 I 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 jbosssvc exe et service bat partir du fichier zip vers le dossier JBOSS_HOME bin 3 Le fichier JBOSS_HOME bin service bat peut tre adap
24. l GRANT ALL PRIVILEGES ON smclient TO smclientUser localhost IDENTIFIED BY password Query OK O0 rows affected 0 06 sec Tableau de configuration On cr e ensuite le tableau de configuration et on le remplit avec les valeurs correspondantes faut pour cela adapter et ex cuter le script ci apr s mysql use smclient mysql gt CREATE TABLE configuration keycolumn VARCHAR 255 NOT NULL PRIMARY KEY value VARCHAR 255 INSERT INTO configuration VALUES conl ig location your ilepa h coni ig proper ies INSERT your_f INSERT VOUS INSERT VOTE INSERT INSERT INTO configuration VALUES message handler location l ilepath message handler properties INTO configuration VALUES repository location ilepath repository properties INTO configuration VALUES rules location ilepath rules xml INTO configuration VALUES timeout time 30 INTO configuration VALUES keep deleted time 10 config location d finit l endroit o se trouve le fichier properties avec les configurations qui valent g n ralement pour le client sM message handler location d finit l endroit o se trouve le fichier properties avec les configurations du MessageHandler gestionnaire de messages repository location d finit l endroit o se trouve le fichier properties avec les configurations du stockage rules location d finit l en
25. le chemin du dossier d installation 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 mysql com doc refman 5 1 en installing html Erstellt 15 Juni 2009 von Cambridge Technology Partners 2009 10 41 ke e 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 e 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 CREATE DATABASE smclient Query OK 1 row affected 0 05 sec I faut ensuite cr er une banque de donn es utilisateur afin de pouvoir acc der la banque de donn es Nom smclientUser Mot de passe password mysq
26. mbridge Technology Partners 2009 30 41 e es IzPack Installation of sM Client Accessories Administrative Tools Windows Resource Kit Tools Figure 7 Menu de d marrage et raccourci sM Client Projekt Installations Handbuch Installation et Configuration du Client sM Draft ME 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 15 Juni 2009 von Cambridge Technology Partners 2009 sM Client Projekt Draft Installations Handbuch Installation et Configuration du Client sM 5 3 6 Fin de l installation IzPack Installation of sM Client 18 Installation has completed successfully 18 An uninstaller program has been created in C smclientbase Uninstaller 2 Generate an automatic installation script Made with IzPack http izpack 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 p
27. nne 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 l faut en outre encore ajouter le xml resolver 1 2 jar ce dernier peut tre t l charg ici httpz repo1 maven org maven2 xml resolver xml resolver 1 2 xml resolver 1 2 jar ll faut ensuite m moriser le fichier dans le dossier JBoss Home 1ib 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 e 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
28. our 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 cette occasion veiller ce que le client sM a cr les interfaces de l adaptateur sedex sous l adresse suivante SINSTALL_DIR adapter Erstellt 15 Juni 2009 von Cambridge Technology Partners 2009 32 41 e e 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 facon 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 e 6 INSTALLATION ET CONFIGURATION DU BANC D ESSAI L installation e
29. oy jboss web deployer server xml Connector port 8080 address jboss bind address maxThreads 250 maxHttpHeaderSize 8192 emptySessionPath true protocol HTTP 1 1 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 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 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 smcl
30. rique Version Modifi Description Date Valid 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 beta1 17 04 2009 SM 06 Stefan Malar Restructuration et 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 jour version 1 0 RC1 08 06 2009 SM ML Stefan Mal r 09 Martin Liebrich Mises jour installation du banc d essai 15 06 2009 SM ML Stefan Mal r Markus Vitalini R f rences 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 Erstellt 15 Juni 2009 von Cambridge Technology Partners 2009 6 41 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 15 Juni 2009 von Cambridge Technology Partners 2009 7 41 e 2 APER U G N RAL La mise en service du client sM et du banc d e
31. rt s receipt location Contient les quittances envoy es 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 du client tester E e e Exemple de configuration base directory for messages all directories below are relative to base directory base dir smclient interface D smclient Banc d essai 41 S 41 4 i 41 E ocation for sent files ent location sent ocation for messages received utbox location received ocation for messages to send nbox location tosend ocation for deleted messages E E deleted location deleted 41 e 44 de 41 SES ocation of exported messages xported location exported ocation of receipts eceipt location receipts ocation of failed messages E failed location failed failed to send it could not be send by the smclient ailed tosend location failed failed_to_send it n f failed to transmit means that in the send the sedex client could ot transmit o
32. s 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 pour la case postale e Sortie message o Sous dossiers pour chaque application m tier triage o Sous dossier pour le service formulaires e Messages envoy s o Sous dossiers pour chaque application m tier triage e Gescheiterte Messages 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 3 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 con
33. ssai exige diff rentes tapes d installation et de configuration On peut 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 ll faut installer les composants suivants e JDK 6 0 e adaptateur sedex ne fait pas partie int grante de la livraison du client sM JBoss 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 ll 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 des dossiers des interfaces client sM et banc d essai e Configuration technique client sM et banc d essai e 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
34. t en option et un nom peut tre d fini pour le service set SVCNAME JBoss4java6 set SVCDISP JBoss Application Server 4 2 SMClient set SVCDESC JBoss Application Server 4 2 GA Platform Windows x86 e e 4 On peut adapter en option le chemin 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 SVCDISP 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 service bat install Pour d sinstaller le service JBOSS HOME bin 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 c
35. t afficher la version actuelle du client sM install e de facon analogue l illustration suivante Anmelden 7 7 a JAHVAV SSK SEGUINT 3158 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 Envoiet 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 exp diteur Le message doit ensuite tre envoy par le client sM et aussi tre recu 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 e sM Client Projekt Installations Handbuch Draft V rification de l Installation Erstellt 15 Juni 2009 von Cambridge Technology Partners 2009 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 Z rich T l 41
36. t la configuration du Banc d essai sont semblables 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 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 I faut cr er sous mySQL une banque de donn es portant le nom de smclient testbed mysql gt CREATE DATABASE smclient testbed Query OK 1 row affected 0 05 sec I faut ensuite cr er un utilisateur de la banque de donn es pour pouvoir acc der la banque de donn es Nom smclientUser Mot de passe password mysql GRANT ALL PRIVILEGES ON smclient testbed TO tesbedUser localhost IDENTIFIED BY mot de passe Query OK O0 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 mysql gt use smclient testbed mysql CREATE TABLE smclient testbed configuration keycolumn VARCHAR 255 NOT NULL PRIMARY KEY value VARCHAR 255 INSERT INTO smclient testbed configuration VALUES message handler location d smclient message handler tb properties INSERT INTO smclient testbed configuration VALUES repository location d smcli
37. ur message ailed transmit location failed failed_to_transmit it configration of simulated sedex adapter working directory of sedex adapter all directories below are E elative to base directory base dir adapter D smclient Sedex Adapter a a SES directory for incoming messages dapter inbox location inbox E directory for technical receipts dapter receipt location receipts SES 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 j t d crit pour le client sM Stockage stockage base dir Stockage pour le repository du client sM Les autres chemins sont relatifs par rapport ce dossier xsd xslt Ensemble des formats de message XSD Instructions de conversion correspondantes amp E e 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 part
38. urs 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 e On a 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 mysgl connector java 5 1 7 bin jar doit tre m moris e dans le dossier JBoss Home server default lib Autres biblioth ques l faut en outre encore ajouter le xml resolver 1 2 jar on peut le t l charger ici httpz 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 1ib 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 I faut pour cela compl ter la ligne par XX MaxPermSize 128m set JAVA OPTS JAVA OPTS Xmsi128m 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 Veuill
Download Pdf Manuals
Related Search