Home

sM-Client Projekt

1. defines the connection sting for the jms context of the JMS PRON TACHE Jus Concert url jnp localhost 1100 defines the rmi connection string of the JMS provider jms emi url seryvice jmx emis neai rmi localhostes3000 qmxrmi defines the timeout for a sub step in a jms task jms sub step timeout in minute 15 defines the timeout for small stuck message stuck retry time offset minutes 60 defines the timeout for large stuck message stuck retry big msg minutes 720 defines the search frequency for stuck messages stuck job interval minutes 60 defines the maximal numbers of re processing for stuck messages stuck retry max amount 2 defines the size in Bytes of the message that is considered as a small msg stuck retry small msg size 1048576 4 2 2 2 config properties sedexld Ihre Sedex ID plus utilis depuis la version 2 0 0 remplac par une valeur dans la base de donn e update message types Types de message pour les mises jour de syst me autoupdate Ex cuter les mises a jour automatiquement true false 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 message batch pickup size Optionnel Nombre de message que le clien
2. de gt Failed to receive ELM adapter failed tosend location Failed to send FA iled transmit location l EH Standard Verschiebung r iii IRINA Verzeichnis wird d Verzeichnis wird _ 8 4 GEES q i normal dargestellt D Verschiebung im Fehlerfall Rs mee e PES 4 x Verschiebung von FA Verzeichnis wird Verzeichnis wird Verschiebung von SMC nicht dargestellt gepollt _ _ Verschiebung von sdA 4 8 2 Configuration du cantonal repository Le cantonal repository est utilis uniquement pour transf rer les messages Taxes a la source du canton a une commune via Sedex 1 D abord il faut modifier le fichier repository properties comme suit FOR ELM domain only abllage cantonal base d12 Cs smeltentbasce Intertace cantonal repost tory cantonal cantonal listos list message message list participants_list message odiosi mpare ei lion IESEL eet Le art contendere ipnotica perineo Conconi dd 2 dans hand corre Dans le fichier message list xml du cantonal repository est d fini quel type de message est emplpy Sedex Le type de message doit auparavant avoir t enregistr aupr s de Sedex voir Sedex buch et manuel d exploitation Sedex Il faut modifier les valeurs en jaunes pour qu elles spondent a votre environnement e Son eelere HN csimeochiag Uri ANR lt messages xmlns xsi http www w3 0rg 20
3. username VARCHAR 255 NOT NULL password VARCHAR 255 firstname VARCHAR 255 lastname VARCHAR 255 defaultLanguage VARCHAR 255 NOT NULL sedexId VARCHAR 255 PRIMARY KEY id insert THES smUser username password firstname lastname defaultLanguage sedexId values Admin 46 tAEewgFnQ toQ9ADB5Q administrator administrator de yourSedexId insert into smUser username password firstname lastname defaultLanguage sedexId values SuperUser 2atHgjIcy5hGeeRwzY mh0 Super User Pet nuil 9 Cr er le tableau smUser_smRole et ajouter les valeurs selon proc dure ci dessous sM Client Projekt Version finale Installations Handbuch Installation sur d autres banques de EATE TABLE smUser smRole smUser id BIGINT NOT NULL Role id BIGINT NOT NULL INSERT INTO smUser smRole smUser id Role id SELECT select id from smUser wher username Admin select id from smRole where name Admin INSERT INTO smUser smRole smUser id Role id SELECT select id from smUser wher username SuperUser select id from smRole where name SuperUser 10 Installer MSSQL JDBC Driver pour JBoss T l charger MS Microsoft SQL Server JDBC Driver 2 0 sqljdbc4 jar du site Web Microsoft http www microsoft com downloads details aspx displaylang en amp FamilyID 99b21b65 e98f 4a61 b811 19912601fdc9
4. Copier dans JBOSS HOME server default lib directory 11 Configuration de MS SQL Server Data Source Editer le fichier suivant JBOSS HOME server default deploy smclient ds xml 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 jdbc sqlserver hostname SQLEXPRESS 1433 databaseName smclient SelectMethod cur sor lt connection url gt lt driver class gt com microsoft sqlserver jdbc SQLServerDriver 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 lt connection url gt doit correspondre a la configuration DB respective Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 82 95 7 2 Oracle Cr er le login smclientUser attribu Cr er le tableau smMandant et Cr er une banque de donn es smclient tion du r le db_owner pour banque de donn es smolient ajouter les valeurs selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex F EATE F TABLE smMandant sedexId varchar2 255 char name v
5. 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 Il faut tenir compte du fait qu il ne doit pas y avoir d espace dans le chemin du dossier d installation Vous arrivez l cran suivant par l interm diaire du bouton Next Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 66 95 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 2 cran du jeu complet 18 Select the packs you want to install Q Note Grayed packs are required H JBoss AS 4 2 3 GA 109 15 MB mysql 5 1 GA 414 93 MB sM Client 57 91 MB HornetQ 2 2 1 4 Final 30 76 MB scripts 7 03 KB Total space Required Available space Made with IzPack http izpack org Figure 4 cran du jeu complet 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 26 juillet 2012 von Cambridge Technology Partners 2014 67 95 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 3 Choix des param tres de configuration Specify your sedexId SedexId Specify the JMS port for sM Client Queue JMS port
6. LI The homepage is at http www 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 26 juillet 2012 von Cambridge Technology Partners 2014 64 95 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 cran d information 27 Please read the following information The following wizard will guide you through the installation of the sM Clie In case of problems please ask your question on jira ctp consulting com bro Hi 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 26 juillet 2012 von Cambridge Technology Partners 2014 65 95 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 1 Choix du dossier d installation B Select the installation path C smdientbase 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
7. handler properties par domaine ainsi le sM Client sait quel domaine un message appartient Ces r pertoires doivent tre cr s avant le d marrage du sM Client 4 message handler properties for the eSchKG domain HEHH use ech standard for eschkg message should message be converted true base directory for messages all directories below are relative to base directory base dir smclient interface C smclientbase interface eschkg ilocation for sent files sent location sent location form messages to be send outbox location outbox location for incoming messages inbox location inbox 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 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 failed transmit location favilled rtallec to transmit 4 Optionnel Les messages eschkg peuvent tre re us et envoy s depuis l application m tier au format eCH ou au format eSchKG Par d faut le format eSchKG est utilis Pour employer le format eCH il faut configurer le sM Client de mani re appropri e La configuration s effectue soit pour tous les messages dans le message handler eschkg properties ou par type de message dans le fich
8. des diff rentes Queues soient uniques La configuration du nom des Queues est d crite au chapitre 4 2 2 1 2 JBoss sur un serveur Server Si 2 JBoss sont install s sur un serveur la question se pose o mettre le JBOSS HOME JBOSS HOME est seulement n cessaire si Ton veut d marrer JBoss directement de la ligne de commande sans aller pr alablement dans le bon r pertoire Snon il est possible de simpler laisser JBOSS HOME II faut alors d abord navigueur vers Jboss1 bin et l appeler run bat la m me chose pour JBoss2 JBOSS HOME ne doit pas tre utilis dans ce cas Si l on doit utiliser JBOSS HOME et JBOSS HOME2 il faut adapter la procedure de d marrage et configurer JBOSS HOME1 JBOSS HOME Por un service cela fonctionne de mani re quivalente soit on n utilise pas JBOSS HOME et on d marre directement Jboss Services soit on adapte les proc dures correspondantes 4 2 4 2 7 Ecriture du journal sur une banque de donn es Au lieu d crire le journal dans un dossier du Filesystem il est possible de l crire dans une banque de donn es La configuration n cessaire est d crite ci dessous Etablir un tableau banque de donn es LOG_ENTRY dans la banque de donn es client sM CREATE TABLE LOG ENTRY id BIGINT NOT NULL AUTO INCREMENT PRIMARY KEY log date DATETIME log_level varchar 5 location varchar 255 message VARCHAR 255 Il faut ensuite ajouter un nouveau Appender dans jBoss log4j dossier configuration JBOSS_
9. doit d abord tre d comprim Un nouveau module doit tre cr e dans le dossier JBOSS_HOME modules Pour cela il faut construire la hi rarchie de r pertoires com mysql main La biblioth que des pilotes dans le cas de mySQL mysql connector java 5 1 7 bin jar doit tre copi e dans le dossier nouvellement cr Un fichier module xml doit aussi tre cr dans ce dossier Il doit avoir le contenu suivant lt xml version 1 0 encoding UTF 8 gt lt module xmlns urn jboss module 1 1 name com mysql gt lt resources gt lt resource root path mysql connector java 5 1 19 jar gt lt resources gt lt dependencies gt lt module name javax api gt lt dependencies gt lt module gt Ce module d finit le pilote MySQL en tant que module du serveur sous le nom com mysgdl Modifications du EAP6 Transaction Manager EAP6 n cessite d un Transaction Manager sp cial Ceci peut tre configur en modifiant le fichier hibernate cfg xml dans message handler X X X jar Ce dernier se trouve dans WEB INF lib smclient war Lo configuration est d j pr sente il faut juste la d commenter lt EAP6 lt property name hibernate jta UserTransaction gt java jboss UserTransaction lt property gt EAP6 gt Modifications du Module JDK Les classes du paquet com sun jndi url rmi doivent tre disponible C est pourquoi il faut modifier le module sun jdk main module xml et ajouter une nouvelle entr
10. galement que l installation de l infrastructure a t faite Le banc d essai peut tre utilis dans une installation existante du client sM il n est pas besoin d ajouter une banque de donn es JBoss ou MySQL s par e Si le client sM a d j t compl tement install les tapes marqu es seulement pour installation individuelle ne doivent plus tre effectu es Elles ont t faites lors de l installation du client sM Remarque Le banc d essai ne peut simuler qu un seul adaptateur sedex Il n y a pas de fonctionnalit de mandants multiples ni les domaines ELM ech0058v4 eschkg et ne supporte que MySQL Les tapes suivantes doivent tre effectu es pour utiliser le banc d essai e Banc d essai banque de donn es e Banc d essai fichier WAR e Configuration des dossiers des interfaces 8 1 Installation de la banque de donn es des bancs d essai On montre ici a titre d exemple la mani re dont la banque de donn es peut tre install e sous mySQL Il faut cr er sous mySQL une banque de donn es portant le nom de smclient testbed ile NC ENTER NE SE Cire lle Ares lee el Query OK 1 row affected 0 09 sec Il faut ensuite cr er un utilisateur de la banque de donn es pour pouvoir acc der la banque de donn es Nom testbedUser Mot de passe password mysql GRANT Alb RI EER GES Ek tesbedUser localhost IDENTIFIED BY mot de passe Query OK 0 rows affected 0 06 sec Tableau de con
11. messageSubType gt came lt destinationFolder gt C smclientbase interface inbox applicati on_l lt destinationFolder gt lt PDFGeneration boolean true pdfSplitting true gt lt useCase gt recelve lt useCase gt lt rule gt lt Rules with TestMessage Applied from top to bottom so the less specific one should be at the bottom gt lt rule gt lt criteria gt lt messageAction gt 2 lt messageAction gt lt testMessage gt lt criteria gt lt destinationFolder gt inbox test multiple messages location lt destinationFolder gt lt useCase gt receive lt useCase gt lt rule gt lt rule gt lt criteria gt lt testMessage gt lt criteria gt lt destinationFolder gt inbox test messages location lt destinationFolder gt lt useCase gt receive lt useCase gt lt rule gt lt default rule has no criteria gt lt rule gt lt destinationFolder gt C smclientbase interface inbox post_box lt destinationFolder gt lt PDFGeneration boolean false pdfSplitting false gt lt useCase gt receive lt useCase gt lt rule gt lt rule gt lt destinationFolder gt C smclientbase interface sent lt destinati onFolder gt lt PDFGeneration boolean false pdfSplitting 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 useC
12. 1 jbosssvc exe p 1 Shutdown SVCDISP service gt gt shutdown log Le output de la console de HornetQ Konsole est envoy vers run log et shutdown log La commande suivante doit ensuite tre execut e pour que le service s installe HORNETO_HOME bin gt hornetq_service bat install Pour desinstaller le service HORNETO_HOME bin gt hornetq_service bat uninstall Dans Start Control Panel Adminstrative Services der Start mode il est possible de changer le d marrage du service de Manuel a Automatique pour que HornetQ d marre avec Windows Il est galement n cessaire de d finir le parcours absolu de hornetQ dans config stand alone non clustered logging properties f r handler FILE fileName Par exemple handler FILE fileName C smclientbase log hornetq log Dans logging properties il est possible de choisir le niveau de logging logger level INFO handler CONSOLE level INFO handler FILE level INFO Plus de d tails peuvent tre trouv sur la page suivante http docs jboss org hornetg 2 3 0 Final docs user manual html logging html 5 8 Wizard d installation pour Linux Il existe galement un Wizard d installation pour Liux Celui ci est d marr cmme suit sudo java jar smclient linux jar L installation est analogue a Windows il faut toutefois observer les points suivants Il est recommand de ne pas utiliser d espaces dans le r pertoire d installation S assurer qu aucune ins
13. Updates Release 3 0 05 01 2011 SM Berthouzoz 1 9 Sylvain Updates Release 3 0 after feedback from test 11 02 2011 SM Berthouzoz 2 0 Sylvain Updates Release 3 0 after feedback from test 07 03 2011 SM Berthouzoz 2 1 Sylvain Updates Release 4 0 chapter 4 7 chapitre 04 01 2012 SM Berthouzoz 4 2 2 6 2 2 A Rapanaro Updates Release 4 0 rajout le repertoire 18 01 2012 SM plugins dir au chapitre 4 2 2 4 2 3 S Berthouzoz Update chapitre 4 7 ech0058v4 message 08 02 2012 SM handler outbox 2 4 S Berthouzoz Update durant les tests 4 2 2 Limitations pour les 22 02 2012 SM backups 2 5 S Berthouzoz SMCTESTING 37 Beim Versenden von 29 02 2012 SM ech0058v4 Meldungen wird die Sedex Quittung nicht abgelegt 4 2 2 message handler properties 2 6 Andrea PDF Splitting von Sammelmeldungen 4 2 2 15 06 2012 CW Rapanaro 2 7 Sylvain ELM Konfiguration 4 8 27 06 2012 CW Berthouzoz 2 8 Christian ELM Konfiguration 4 8 Rules 10 07 2012 SB Wattinger 2 9 Andrea Description des param tres dans la configuration 26 07 2012 CW Rapanaro de ELM 3 0 Sylvain Remark on installer on windows 64bits and add 17 09 2012 CW Berthouzoz XML declaration to example rules xml 3 1 Sylvain Monitoring triage rule 24 09 2012 CW Berthouzoz 5 0 Andreas Dejung Informations pour la release 5 0 06 03 2013 SB 5 0 1 S Berthouzoz Feedback RC2 24 07 2013 FG Andrea Informations pour la release 5 0 1 Rapanaro 5 0 7 S Berthouzoz Informations pour la release 5 0 7 3 1 5 1 20 0
14. applique seulement pour send uet receive lt PDFGeneration gt true false un PDF est g n r ou non dans ce cas en fonction de la valeur seulement pour send et receive lt PDFGeneration gt pdfSplitting true false d s 4 1 g n re un seul Zip pour tout le message group false ou un fichier pdf par messages internes true Valable uniquement pour les messages group s lt useCase gt comme d crit ci dessus lt criteria gt peut avec send et receive v rifier les valeurs suivantes lt messageType gt lt messageSubType gt lt messageAction gt lt testMessage 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 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 lt testMessage gt doit toujours tre une balise vide lorsqu elle est pr sente Ce crit re v rifie s il s agit d un message de test Le message est marqu avec le champ TestDeliveryFlag sur vrai Cette balise peut tre combin e avec les autres combinaisons indiqu es ci dessus Les r gles contenant lt testMessage gt sont appliqu es dans le m me ordre que dans le fichier rules xml La premi re r gle renc
15. be converted Optionnel D fini si les messages d autres domaine tel que eschkg doivent tre converti au format eCH Par d faut aucune conversion n est effectu e should sedex receipt be added Optionnel depuis R4 0 0 D fini si la quittance Sedex doit tre ajout au fichier zip du message durant le processus d envoi Ceci ne fonctionne que pour les messages au format zip Tout les messages sauf eschkg sans conversions La valeur par d faut est false export pdf splitting Optionnel depuis R4 1 D finit si il faut g n rer un seul fichier PDF pour tout le message group false ou un fichier PDF par message interne true Cette configuration est valable pour tout les types de messages La valeur par d faut est false Cela peut aussi tre configur pour un type de message particulier voir 4 2 2 6 message process xml 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 Dossier des messages qui ont t envoy s outbox location Sortie message pour les messages m tiers devant tre exp di s inbox location Entr e message pour les messages qui ont t re us et pour lesquels la case postale doit tre affich e Failed location Contient les messages ne pouvant pas tre trait s failed tosend location Contient les messages qu
16. crit pour le client sM sedexld Ihre Sedex ID update message types Types de message pour les mises jour de syst me 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 backup fullDB enabled D finit s il faut faire un vidage complet de la banque de donn es lors de la sauvegarde On peut employer celui ci pour une restauration manuelle compl te backupBatch Lieu ou le fichier MySQLSmClientBackup bat pour Windows resp MySQLSmClientBackup sh pour Linux Dans le cas d une installation manuelle le fichier doit tre copi ici par l installateur inbox enabled D finit si l Inbox est active formservice enabled D finit si le service formulaires est actif LDAP enabled D finit si LDAP doit tre utilis pour la gestion des
17. de la console Jboss la console est sortie dans ce cas vers run log et shutdown log Pour intaller JBoss 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 On trouvera une description exhaustive en anglais sous http something about tech blogspot com 2009 01 running jboss as windows service html sM Client Queue Il faut ex cuter les tapes suivantes pour installer HornetQ 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 HornetQ_HOME bin 3 Le fichier HornetQ HOME bin service bat doit tre adapt dans le fichier et un nom doit tre d fini pour le service set SVCNAME HornetQ set SVCDISP HornetQ set SVCDESC hornetq 2 2 14 Final 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 hornetq lock gt gt run log 2 gt amp 1 jbosssvc exe p 1 Shutdown SVCDISP service gt gt run log jbosssvc exe p
18. des configurations techniques au chapitre 3 5 3 du document de design technique La configuration est entreprise manuellement dans les fichiers de configuration correspondants A partir de la version 5 0 7 le sM Client dispose d un processus de retraitement des messages de mani re a recommencer l envoi ou la r ception d un message qui serait bloqu en cours de traitement Les messages qui pendent un laps de temps d fini reste dans le statut message handler validate message ou message handler await validation sont consid r s comme bloqu s Les param tres pour le retraitement des messages sont d crits ci dessous Important assure vous que tous les dossiers indiqu s existent bien Il faut galement d finir les droits d acc s sur les r pertoires en fonction des crit res de s curit de l entreprise L application n cessite dans tous les cas les droits de lecture et d criture Les valeurs contenues dans tous les fichiers de type properties ne doivent pas avoir d espace au d but et la fin 4 2 2 1 global config properties jms queue name standard Nom de la Queue JMS Standard Est construite au d marrage si elle n existe pas encore jms queue name priority Nom de la Queue JMS Priority Est construite au d marrage si elle n existe pas encore jms queue name result Nom de la Queue JMS Resultat Est construite au d marrage si elle n existe pas encore jms context url URL de
19. le fichier Properties avec les configurations pour le banc d essai Si le client sM est aussi simultan ment install on peut employer le m me fichier 8 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 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 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 Ajouter JDBC Driver seulement pour installations individuelles On a galement besoin
20. qu au client sM participants Contient des documents qui d crivent les participants les messages et les droits 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 version Contient le chemin relatif depuis ablage base dir vers le fichier version properties Cette propri t est optionnelle et a comme valeur par d faut participants list version properties Cette valeur ne doit pas tre chang e lors de l utilisation du stockage de base Exemple de configuration Stockage is file repository used to store xsd xslts and documentation ablage base dir C smclientbase interface repository directory for all xsds and xsls eee teste directory for documentation documentation documentation directory for optional integrity check files Pig ny MN eV Check directory of participants message lists Posi eee location Of participants list Portieri location of messages list message list participants_list message list xml location of message participants list message participants list participants_list message participants list ozm 8 3 1 3 config properties Le config properties est le m me que que celui qui a d j t d
21. r e Elle se trouve sous INSTALL_DIR Uninstaller Il s agit d un Executable JAR qui peut tre utilis pour supprimer tous les r pertoires et banques de donn es de tout le client sM L utilisateur par d faut est Admin dont le mot de passe est aussi Admin Le nom d utilisateur ainsi que le mot de passe sont sensible a la casse 5 7 Installation comme service Der Le Wizard d installation pour Windows est galement livr en une deuxi me version qui permet l installation comme service JBoss et MySQL sont alors install s sous le nom de service suivant e MySQL MySQL e JBoss JBoss Application Server 5 1 SMClient e Home HORNETQ Modifications manuelles n cessaires pour JBoss 5 1 comme service Pour JBoss 5 1 dans le fichier JBOSS HOME bin run conf bat il faut effacer la ligne suivante sous windows if not xSUAVA OPTS5 x goto JAVA OPTS SET Et sous linux dans le fichier JBOSS_HOME bin run conf effacer la ligne suivante if xSUAVA OPTS x then JAVA OPTS Xms128m Xmx512m XX MaxPermSize 256m Dorg jboss resolver warning true Dsun rmi dgc client gcInterval 3600000 Dsun rmi dgc server gcInterval 3600000 Fi MySQL est d s le d part configur sur Startup Type Automatic Il est donc d marr automatiquement lors du d marage du syst me HornetQ et JBoss sont sur manuel et doivent donc tre d marr s manuellement ou leur Startup Type doit tre mis sur Aut
22. 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 3 Le fichier JBOSS HOME bin service bat doit tre adapt dans le fichier et un nom doit tre d fini pour le service set SVCNAME JBoss4java6 set SVCDISP JBoss Application Server 4 2 SMlient set SVCDESC JBoss Application Server 4 2 GA Platform Windows x86 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 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 5 Pour JBoss 5 1 dans le fichier JBOSS HOME bin run conf bat il faut effacer la ligne suivante sous windows if not xsJAVA_OPTS x goto JAVA OPTS SET Et sous linux dans le fichier JBOSS_HOME bin run conf effacer la ligne suivante if xSJAVA OPTS x then JAVA OPTS Xms128m Xmx512m XX MaxPermSize 256m Dorg jboss resolver warning true Dsun rmi dgc client gcInterval 3600000 Dsun rmi dgc server gcInterval 3600000 Fi La sortie
23. utilisateurs Si ceci est r gl sur true les configurations d crites au chapitre 4 2 5 doivent tre en outre faites 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 sM Client Projekt Version finale Installations Handbuch Installation et configuration du banc 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 is full backup DB dump enabled Backup fullDB enabled false path to backup script backupBatch C smclientbase scripts windows MySQLSmClientBackup ba E defines if inbox is enabled inbox enabled true defines if formservice is enabled formservice enabled true defines if formservice is enabled formservice enabled false defines if LDAP should be used LDAP enabled false Erstellt 26 juille
24. 01 XMLSchema instance xsi noNamespaceSchemaLocation message list xsd gt lt message type 9999 subtype 000909 inFormService false sendWithoutProtocolReceipt false domain elm gt Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 59 95 lt redirectFrom type elm subtype qst gt lt name gt elm 9999 000909 lt name gt lt version number http www elm ch xmlns elm 9999 00 05 00710 valide con EE EE From Ee HE lt version gt lt message gt lt messages gt 3 Dans le fichier participants list xml du cantonal repository sont d finies les communes Pour d sactiver la transmission une commune particuli re il faut lui supprimer l attribut municipalityld Les valeurs en jaunes doivent tre modifi es lt P weicsslon 11 0 encod neo OH EE lt participants xmlns xsi http www w3 0rg 2001 XMLSchema instance xsi noNamespaceSchemaLocation participants list xsd gt lt participant sedexId 99 ZH 99 municipalityId 1234 gt lt shortName gt Musterdorf lt shortName gt lt longName gt Gemeinde Musterdorf lt longName gt lt participant gt lt participant sedexId 99 ZH 98 municipalityld 4321 gt lt shortName gt Musterdorf 2 lt shortName gt lt longName gt Gemeinde Musterdorf 2 lt longName gt lt participanta lt j part recipantks 4 Dans le fichier message paritcipants list xml du cantonal repository est d finis quels participants ont
25. 1 Shutting down SVCDISP gt shutdown log call stop bat lt hornetg shutdown 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 HornetQ la console est sortie dans ce cas vers run log et shutdown log Pour intaller HornetQ en tant que service Windows il faut ex cuter la commande suivante HORNETQ HOME bin gt hornetq service bat install Pour d sinstaller le service HORNETQ HOME bin gt hornetq service Pat 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 HornetQ lors du d marrage du syst me HornetQ doit tre d marr en premier La commande suivante va cr er une d pendance entre les 2 services n cessite les droits administrateurs sc config JBoss4java6 depend HornetQ 4 2 4 2 5 Modification du dossier temporaire Si on souhaite avoir un autre dossier temporaire que le dossier System Temp on peut configurer ceci dans les fichiers run sh Linux resp run bat Windows dans JBoss Home bin p ex C smclientbase jboss 4 2 3 GA bin run bat set JAVA OPTS JAVA OPTS Djava io tmpdir C smclientbase temp 4 2 4 2 6 Installation de plusieurs clients sur un adaptateur Pour installer plusieurs clients sM ou plusieurs mandants sur le m me serveur il faut proc der comme suit 1 Apr s inst
26. 1100 Specify the JMX port for sM Client Queue JMX port 3000 Specify the RMI port for sM Client Queue RMI port 1101 Made with IzPack http izpack org Figure 5 Choix de l identifiant Sedex Sur cet cran doit tre entr l identifiant Sedex du sM Client Il est aussi possible de changer les ports employ s pour la communication entre sM Client Core et sM Client Queue Le choix des ports est libres il faut veiller employer des ports qui ne sont pas utilis s par d autres applications Vous arrivez l cran suivant par l interm diaire du bouton Next 5 3 4 Proc dure d installation Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 68 95 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client Pack installation progress C smdientbase interface repository xsd_xslt eahv iv common 1 eventReport 1 0_it xsl sM Client Overall installation progress See o Made with IzPack http izpack org Figure 6 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 26 juillet 2012 von Cambridge Technology Partners 2014 69 95 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 3 5 Configuration Processing start datab
27. 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 11 Martin Liebrich Mises a jour version 1 0 RC3 27 07 2009 SM ML Stefan Malar 12 Martin Liebrich Mises a jour version 1 0 RC4 17 08 2009 SM ML Stefan Malar 13 Martin Liebrich Mises a jour version 1 0 RC5 24 08 2009 SM ML Stefan Malar 1 0 Stefan Malar Version finale 04 09 2009 ML 1 1 Sylvain Information sur l utilisateur par d faut au chap 11 09 2009 Berthouzoz 5 5 7 nouvel version MS SQL JDBC Driver mises jour selon email regu sm client support ctp consulting com 1 2 Sylvain Correction de l exemple LDAP 15 12 09 Berthouzoz 1 3 Sylvain Mises a jour version 1 1 0 19 01 09 Berthouzoz 1 4 Sylvain Updates Release 2 1 03 03 2010 Berthouzoz 1 5 Christian Updates for Tomcat Installation 11 03 2010 Wattinger 1 6 Sylvain Updates for Tomcat with Oracle or MySQL 23 03 2010 Berthouzoz Kg sM Client Projekt Installations Handbuch Modifi Description Version finale WEL Co 5 Version 1 7 Sylvain Update page 21 Chapter 4 3 8 11 2010 SM Berthouzoz 1 8 Sylvain
28. 3 2014 FG 3 1 5 2 4 1 2 4 1 4 5 0 8 S Berthouzoz Informations pour la release 5 0 8 3 1 5 2 29 07 2014 CW Description des param tres pour la configuration du processus de retraitement des messages dans global config properties S Berthouzoz Informations concernant l inscription a la 30 09 2014 plateforme de Monitoring References Version Document V5 2 Technisches_Design_sM Client_v5 2 pdf Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 ID 02 Nom sM Client Projekt Installations Handbuch Manuel utilisateur Version Document Version finale V2 0 CHM_sM Client_Manuel_de_l utilisateur_v2 0 pdf 03 04 05 06 07 Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 8 95 sM Client Projekt Version finale 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 26 juillet 2012 von Cambridge Technology Partners 2014 9 95 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 cette occasion proc der l installation manuellement ou en ayant recours un wizard Les syst mes d exploitation Windows Li
29. 512Mo et la m moire principale maximale sur 1024Mo Il s agit des exigences minimales pour une installation simple 2048Mo si une grande quantit de messages est attendues Veuillez vous r f rer au manuel d expoitation pour les exigences d une installation pour plusieurs mandants domaines et ou utilisateurs 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 startup sh Linux resp startup bat Windows dans CATALINA HOME bin Il faut pour cela modifier la ligne par Xms512m Xmx1024m XX MaxPermSize 512m set JAVA OPTS JAVA OPTS Xms512m Xmx1024m XX MaxPermSize 512m Pour Windows il est recommand d utiliser les m me valeurs pour MinHeapSize et MaxHeapSize pour viter le swapping de m moire par example set JAVA OPTS JAVA OPTS Xms1024m Xmx1024m XX MaxPermSize 512m Lors l utilisation de plusieurs mandants il faut allouer plus de m moire de mani re correspondante Voir aussi le manuel d expoitation chapitre 2 2 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 nouveau changer le suffixe en war une fois le t l chargement effectu Le fichier t l charg ne doit pas t
30. 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 de la base 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 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 CREATE TABLE smclient smMandant sedexId varchar 255 NOT NULL name varchar 255 DEFAULT NULL active bit DEFAULT false PRIMARY KEY sedexId mysql gt CREATE TABLE domain Ad bigint 20 NOT NULL AUTO INCREMENT name varchar 255 NOT NULL PRIMARY KEY ad UNIQUE KEY name name insert into domain name values smclient mysql gt CREATE TABLE smclient configuratio
31. Driver pour JBoss File ojdbc6 jar de ORACLE HOME product version db 1 jdbc lib classes12 zip vers JBOSS HOME server default lib directory 11 Configuration de Oracle Server Data Source Le dossier suivant sert a diter JBOSS HOME server default deploy smclient ds xml sM Client Projekt Version finale Installations Handbuch Installation sur d autres banques de 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 jdbc oracle thin localhost 1521 smclient lt connection url gt lt driver class gt oracle jdbc driver OracleDriver 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 x lt connection url gt doit correspondre la configuration DB respective Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 86 95 8 INSTALLATION ET CONFIGURATION DU BANC D ESSAI Important Testbed n est plus d velopp ni support Pour effectuer des tests il est possible d envoyer un message a soi m me via sM Client et Sedex L installation et la configuration du Banc d essai sont semblables a celles du client sM et suppose
32. HOME server default conf jboss log4j xml lt appender name MySQLAppender class org apache log4j jdbc JDBCAppender gt lt connection URL gt lt param name URL value jdbc mysql localhost 3306 smclient gt lt driver in this case mysql gt lt param name driver value com mysql jdbc Driver gt lt username and password used to connect to DB gt lt param name user value smclientUser gt lt param name password value password gt lt SQL statement that will be used to store data in DB gt lt layout class org apache log4j PatternLayout gt lt param name ConversionPattern value INSERT INTO LOG ENTRY log date log level location message VALUES d yyyy MM dd HH MM SS s 5p sCsL sm gt lt layout gt lt appender gt Pour finir l Appender doit tre ajout a la cat gorie Root lt root gt lt appender ref ref MySQLAppender gt lt appender ref ref CONSOLE gt lt appender ref ref FILE gt lt root gt Adaptations 4 2 4 2 8 Adaptations n cessaires pour Full Backup sous Windows Au cas ou le Full Backup est activ il faut lors d une installation manuelle adapter le dossier SINSTALL PATH scripts windows MySQLSmClientBackup bat L entr e set path path INSTALL PATH mysql 5 1 34 win32 bin doit tre adapt e de mani re ce qu elle indique le r pertoire bin du MySQL Lors d une installation avec Wizard le chemin est con
33. KEY id UNIQUE NAME 4 Cr er le tableau configuration analogue a la proc dure ci dessous sM Client Projekt Version finale Installations Handbuch Installation sur d autres banques de FATE TABLE dbo configuration keycolumn varchar 255 NOT NULL confValue varchar 255 NULL sedexId varchar 255 NOT NULL domain id BIGINT NOT NULL PRIMARY KEY keycolumn ASC sedexId ASC domain id ASC ON PRIMARY 5 Saisie des valeurs dans le tableau configuration analogue a la proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex INSERT INTO configuration domain id keycolumn confvalue sedexid VALUES select id from domain wher name lik smclient global tonfig location C smclientbase config global config properties yourSedexId INSERT INTO configuration VALUES config location C smclientbase config config properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES message handler location C smclientbase config message handler properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES repository location C smclientbase config repository properties yourSedexId select id from domain where name
34. Messages envoy s elm properties Failed FA message handler EE EE Messages qui n ont pas pu tre elm properties trait s Failed to send message handler failed transmit location Messages qui n ont pas pu tre FA elm properties transmis Failed to message handler filed tos ndocation Message dont l envoi est transmit FA elm properties impossible Le tableau suivant d crit les propri t s qui sont utilis es pour la configuration de ELM Nom de la propri t Type Fichier de configuration Description elm timeout days Integer message handler elm properties Ce param tre d crit le temps attendu par le sM Client avant qu il d place un message envoy du repertoire Out ELM au repertoire Failed to send FA quand le sdA ne le collecte pas forward message zipped Boolean message handler elm properties Si true les messages transf r s aux communes sont zipp s Ce diagamme d crit les dossiers servant d interface dans le domaine ELM exept le transfert aux communes via Sedex sM Client Projekt Version finale Installations Handbuch Installation et configuration du client sM In ELM adapter inbox location Fach Applikation Sent ELM adapter sent location Meldung Ausgang FA outbox location Out ELM adapter outbox location Failed to transmit ELM adapter failed transmit location _
35. Platform 6 pdf Installation Guide JBoss Enterprise Application Platfo rm 6 Installation Guide en US pdf 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 3 1 4 Installation et configuration de Apache Tomcat On peut t l charger Apache Tomcat 7 x depuis Internet http tomcat apache org download 70 cgi Il faut utiliser la version Core Par example pour Windows apache tomcat 7 0 37 windows x86 zip Il faut tenir compte du fait que les variables d environement JRE_HOME et CATALINA HOME doivent tre configur es correctement Par example JRE_HOME C Program Files Java jdk1 7 0_17 et CATALINA_HOME C Program Files Tomcat apache tomcat 7 0 37 3 1 5 Installation de MySQL On peut t l charger MySQL 5 5 GA depuis Internet http dev mysql com downloads mysql 5 5 html L installation s effectue conform ment aux instructions d installation de MySQL http dev mysql com doc refman 5 5 en installing html 3 1 5 1 Am lioration des performances Pour am liorer les performances les param tres suivants sont recommand s e innodb lock wait timeout configur dans my ini dans le dossier d installation de MySQL doit tre augment 150 si le param tre n est pas pr sent il faut l ajouter e Pour am liorer les performances de la base de
36. Pour une utilisation du sM Client avec un seul mandant aucun changement n est donc signaler e Si plusieurs mandants sont configur s il faut tenir compte des points suivants o La sauvegarde simple peut tre configur par mandant et restaur par l administrateur du mandant La sauvegarde compl te fonctionne pour la base de donn e dans son ensemble soit pour tout les mandants g r s par le sM Client C est pourquoi il ne faut activer la sauvegarde compl te que pour un seul mandant ET ce mandant ne doit pas ex cuter la sauvegarde au m me moment que les autres il faut une valeur diff rente pour time of day for backup ni dans le m me r pertoire Apr s une restauration compl te de la base de donn e qui a lieu en dehors de l application sM client tous les administrateurs doivent restaurer les fichiers depuis l interface Cela pour autant que ces mandant aient activ s la sauvegarde simple sinon aucun fichier ne peut tre restaur s Le sM Client ne fait aucune v rification ce sujet Exemple de configuration your sed sedexId 6 ex id 900014 1 type of message used to update the system repository xml files documenta update me tion allow au autoupdat time of lime OE Gl default default ssage types 2990 3999 tomatic updates e true update hour of day ay for update 18 application language ocale de interval filechang for checking files in se
37. S Schweizerische Steuerkonferenz CSI Conf rence suisse des imp ts Conferenza svizzera delle imposte e AHV IV AVS AI sM Client Manuel d installation Version finale CSI OFAS eAVS AI Version 5 0 8 Publication Date 26 juillet 2012 COPYRIGHT Copyright 2014 Cambridge Technology Partners All Rights Reserved 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 SA While every precaution has been taken in the preparation of this document Cambridge Technology Partners 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 4 4 4 5 4 6 4 7 4 8 4 9 5 1 5 2 5 3 SOMMAIRE OBJET DU DOCUMENT irreali 9 APER U GENERAL RTRT 10 INSTALLATION ET CONFIGURATION DU LOGICIEL D INFRASTRUCTURE 11 INSTALLATION MANUELLE ET CONFIGURATION non nostnonnottnetnneenectnsctnsernsstesstnsstenstenstenstnnntnnet 11 3 1 1 mMatalation te UE KEE 11 3 1 2 Installation et configuration de l adaptateur sedex 11 3 1 3 Insta
38. T CA ae an 83 INSTALLATION ET CONFIGURATION DU BANC D ESSAI 87 INSTALLATION DE LA BANQUE DE DONNEES DES BANCS D ESSAI iii 87 INSTALLATION DU BANC D ESSAI SUR JBOSS i 88 CONFIGURATION DU BANC D ESSAI usines ces erereneneee esse snnnneee cree ennnenenesseseeenennnn 90 8 3 1 Configuration des dossiers des interfaces 90 TABLEAU DES ILLUSTRATIONS Figure SI eh liebe 64 Figure 3 Egranid infanmiationi Larson 65 Figure 3 Choix du dossier d installation sssseessnnesesnneessnneneennoennnneseenneonnnnentennnonnnnnneennonnnnnneenneonnnn nenna 66 Figure 4 cran du jeu complet 67 Figure 5 Choix de l identifiant Sedex i aaa I rates 68 Figure 6 Proc dure d installation seine 69 Nees IIe e io aiar 70 Figure 8 Menu de d marrage et raccourci sisi 71 Figure 9 lt Fin dell installationi rrnr aiar altera 72 Historique GESTION DES DOCUMENTS Description Valid Version Modifi 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 Mal r Restructuration et compl ments 22 05 2009 ML Mise jour pour la version
39. TALLATION ET CONFIGURATION DU CLIENT SM A L AIDE DU WIZARD 63 CONDITIONS PREALABLES 5 220220 dl dates Tate eme ane et nement entente nt 63 INSTALLATION ici ili M nn a na Eten nade 63 5 2 1 cran RE Lo E EE 64 CRAN IRIS PRIUS TOI Sysco lesa sde clan end to onde 65 5 3 1 Choix du dossier d installation i 66 5 3 2 cran du jeu TE 67 5 4 5 5 5 6 5 7 5 8 6 1 6 2 6 3 7 1 7 2 8 1 8 2 8 3 5 3 3 Choix des param tres de configuration 68 5 3 4 Proc edure dinstallationi lt iueriga dents nr EEN 68 5 3 5 Configuration anatra nn ti ne acter PA ANR mt mi 70 5 3 6 Menu de d marrage et raccourci sie 70 5 3 7 Ein de l installation nue nt nn tin mate 72 ADAPTATIONS MANUELLE S czeresni a a aiar 72 DEMARRAGE DU CLIENT SM cits a alal 73 DESINSTALLATION DU SM CLIENT iiiiiieiieererrrineenineeneeeiereeeniineneeeeneneenns 73 INSTALLATION COMME SERVICE 73 5 7 1 Configuration Manuelle de HornetQ comme service 74 WIZARD D INSTALLATION POUR LINUX nn nnnneennennnnnnnnnnnennnnnnnnnnnnnnnnnes 75 VERIFICATION DE L INSTALLATION tisisscisctiaccicstdcccaichatincinaaticicintiaabinebaabatias 76 APPEL DE LA PAGE DEVERSION ix liana oa 76 VERIFIGATIONIDANSILE LOG iii iii 77 ENVOI ET RECEPTION D UN MESSAGE DE TEST 00 tnnn tn tn tanata Annana Annn nnnn Annana Ennn nn nannan EnEn nn nannan nnna 77 INSTALLATION SUR D AUTRES BANQUES DE DONNEES 79 MS SQL EE 79 OS
40. ages re exported location exported location of failed messages failed location failed failed to send it could not be send by the smclient favled Ccosend locati on taiea tamled sre send failed to transmit means that in the send the sedex client could not transmit the message fanled transmit location raea tailed to transmit configuration of sedex adapter working directory of sedex adapter all directories below are relative to base directory base dir adapter C smclientbase adapter directory for incoming messages adapter inbox location inbox directory for technical receipts adapter receipt location receipts directory for outgoing messages re adapter outbox location outbox 4 8 Configuration du domain ELM 4 8 1 Configuration principale Important Ce domaine a besoin de l adaptateur Swissdec sdA Le sdA doit tre pr alablement install Voir pour cela le manuel de l utilisateur de l adaptateur Swissdec Cette configuration est uniquement n cessaire pour l envoi et la r ception des messages ELM Swissdec certificats de salaire et Taxes la source 1 Ins rer le domaine ELM dans la base de donn es insert into domain name values elm 2 D finition de l emplacement des fichiers de configuration Modifier d abord la requ te avec votre sedexld et l emplacement correct du fichier INSERT INTO configuration VALUES message handl
41. allation de MySQL il est n cssaire de configurer une banque de donn es pour chaque client comme d crit sous 4 1 1 Toutes les tapes de 4 1 1 doivent tre effectu es Les noms des banques de donn es doivent tre diff rents 2 Un serveur JBoss doit tre install pour chaque client comme d crit sous 3 1 3 3 Chaque serveur JBoss doit tre connect sur un port diff rent La modification des ports est d crite sous 4 2 4 2 3 4 Le client sM doit tre install sur chaque serveur JBoss comme d crit sous 4 1 2 Les configurations d crites sous 4 2 doivent tre r alis es pour chaque client Il faut s assurer que tous les clients se r f rent aux m mes r pertoires d adaptateur 6 Le triage est configur de mani re ce que chaque client ne recoive du r pertoire adaptateur que les messages qui lui sont destin s Ceci est d crit dans le chapitre 4 2 2 5 et dans Conception technique chapitre 4 7 Ilya deux possibilit s pour l installation de sM Client Queue e UnsM Client Queue pour chaque sM Client Core Dans ce cas il faut installer un sM Client Queue pour chaque sM Client Core Suivez pour cela les instructions du chapitre 3 1 6 Il faut veiller a ce que les diff rents ports n entrent pas en conflit La configuration des ports est d crite au chapitre 4 9 e Un seul sM Client Queue pour tout les sM Client Core Dans ce cas il ne faut installer qu un seul sM Client Queue Pour cela il faut que les noms
42. ants_list message participants t Version properties 4 2 2 6 message process xml Optionnel D claration du fichier dans la base de donn es du sM Client par domaine Le fichier message process xml doit tre d clar dans la table configuration par domaine du sM Client Ajouter le fichier de configuration suivant pour chaque Mandant qui va utiliser un script Dans la requ te suivante la valeur de yourSedexld doit correspondre une valeur de la table Mandant INSERT INTO configuration VALUES message process location C smclientbase config message process xml yourSedexId select id from domain where name like metteg Win Le fichier message process xml permet de d finir certains param tres du processus par type de message ceux ci ont priorit sur la configuration standard ainsi que de d finir un script ex cuter lors de la r ception et ou l envoi d un message du domain correspondant Exemple de configuration PME RS On WVi 0N geet EDD Se Document 3 Taleg amb Cheated oni noto ra re 7007 Author Sylvain Berthouzoz Description Test Example message process xml file to define scripts that the sM Client can perfom before the triage gt lt processes gt Sie only thae most e SE e Ome is executed gt Se esca ror every message ARM lt Script Path rarder Leste EE lt args gt default lt args gt lt args gt config lt args gt gere lt l scrips onl
43. aps il faut installer le certifacat du serveur dap dans l environnement Java employ par JBoss de la mani re suivante 1 T l charger http blogs sun com andreas resource InstallCert java et compiler le programme InstallCert en ex cutant dans une fen tre de commande a l endroit o se trouve le fichier InstallCert java javac InstallCert java 2 ex cuter le programme InstallCert java InstallCert IdapServerUrl 636 choisissez le certificat a installer 3 R p ter l op ration 1 pour chaque serveur dap que le sM Client doit utiliser Cela va cr er un fichier jssecacerts dans le r pertoire courant 4 copier ce fichier dans votre environnement java JAVA_HOME jre lib security 5 changer l url du serveur Idap dans config properties par exemple dap provider url Idaps IdapServerUrl 636 Pour plus d informations reportez vous cette adresse http blogs sun com andreas entry no more unable to find 4 3 Installation d une mise jour Au cas o ce n est pas le client sM qui est r install mais une mise a 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 m
44. archar2 255 char DEFAU active number 1 NOT NULL PRIMARY K NOT NULL Or INSERT INTO smMandant VALU domain F EATE id F TABLE NUMBER 19 0 name VARCHAR2 255 CHAR G H UNIQUE name T insert in to domain NOT NULL PRIMARY K id name ES mandantName 1 yourSedexId NOT NULL values 1 smclient 4 Cr er le tableau configuration selon proc dure ci dessous n EATE G TABLE configuration keycolumn varchar2 255 confvalue varchar2 255 sedexId varchar2 255 ER 19 0 domain id NUMBI PRIMARY K m EY E Saisie des valeur dans NOT NU sedexId keycolumn le tableau NOT NU NOT NU domain id configuration selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex INSERT INTO configuration domain id keycolumn confvalue sedexid VALUES select id from domain wher name lik smielient alobal contig location C smclientbase config global config properties yourSedexId INSERT INTO configuration VALUES config location C smclientbase config config properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES message handler location C smclientba
45. ase mat C workspaces sm client smclient project installer target gt cd D C smclien C smclientbase mysql 5 1 34 win32 bin gt start mysqld console C smclientbase mysql 5 1 34 win32 bin gt cd D C smclientbase scripts windo C smclientbase scripts windows gt wait 10 HP Made with IzPack http izpack org Figure 7 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 la fin Une fois la configuration achev e on peut continuer vers le prochain cran par l interm diaire du bouton Next 5 3 6 Menu de d marrage et raccourci Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 70 95 sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client Setup Shortcuts V Create shortcuts in the Start Menu Select a Program Group for the Shortcuts Accessories create shortcut for Administrative Tools a current user Android SDK Tools all users Made with IzPack http izpack org Figure 8 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 a l aide du bouton Next Remarque Sous Windows 64bits les raccourcis ne peuvent pas toujours tre cr e l
46. ase 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 Pour les Use Cases lt useCase gt send et receive il est absolument n cessaire d avoir une r gle par d faut Une r gle par d faut n a pas de crit res lt criteria gt La configuration standard la r ception est telle que le message pour lequel il n existe pas de r gles sp cifiques est d plac l entr e de la case postale doit correspondre avec inbox location dans messagehandler properties Pour l envoi ces messages sont d pos s dans le dossier Sent doit correspondre avec sent location dans messagehandler properties affich dans la case postale Tous les messages sont saisis dans l adaptateur Il existe les Use Cases send receive et adapter les Use Cases d finissent les cas o les r gles doivent tre appliqu es send est utilis pour l envoi des messages receive pour la r ception des messages et adapter d finit quel message doit tre saisi dans le Inbox p ex si plusieurs clients sM utilisent un adaptateur 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
47. bossweb sar server xml lt 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 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 Autres Ports Une liste de tous les ports employ s par JBoss est disponible dans le document suivant http manoharviswanathan com blog tech running multiple jboss instances on the same machine dans la 2e partie Many of you requested steps for current release of JBoss 4 2 2 GA 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
48. conds e listener interval 60 should messages xml files be validated with the schema should me should a folders ssage be validated true ttachment mime types be validated tachments be validated false displayed under the inbox default is unread important filterfolders read unread important max size for generating pdf from message in KB bigger messages won t be printed default is 2048 print message smaller 2048 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 is full backup DB dump enabled Backup fullDB enabled false EE bo backup script backupBatch C smclientbase scripts windows MySQLSmClientBackup ba IE defines if inbox is enabled inbox enabled true defines if formservice is enabled formservice enabled true defines if formservice is enabled formservice enabled false defines if LDAP should be used LDAP enabled false 4 2 2 3 message handler properties Param tres pour les processus protocol receipt timeout days Les Messsage n cessitant une quittance de protocoles sont copi s dans le dossier Failed to transmit si la quittance de protocole n arrive pas apr s X jours La valeur par d faut est de 3 jours La valeur doit tre comprise entre 3 et 28 jours should message
49. connexion au sM Client Queue Le port JMS correspondant doit tre configur dans le script de d marrage du sM Client Queue jms rmi url URL de connexion au sM Client Queue Le port JMX correspondant doit tre configur dans le script de d marrage du sM Client Queue jms sub step timeout in minute Timeout d une sous tape de processus en minutes Param tres pour le processus de retraitement stuck retry time offset minutes Timeout en minutes avant de consid rer un petit message comme bloqu par d faut 60 stuck retry big msg minutes Timeout en minutes avant de consid rer un grand message comme bloqu par d faut 720 stuck job interval minutes Fr quence en minutes laquelle la base de donn es est v rifi e pour trouver les messages bloqu s par d faut 60 stuck retry max amount Nombre maximal de retraitement possible pour un message avant d tre d finitivement mis en chec dans le dossier Failed par d faut 2 stuck retry small msg size Taill en octets jusqu a laquelle un message est consid r comme petit par d faut 1048576 soit 1Mo Example de configuration defines the name of the standard task queue jms queue name standard queue standardMessage defines the name of the priority task queue jms queue name priority queue priorityMessage defines the name of the result task queue jms queue name result queue resultMessage
50. could not be send by the smclient failed tosend location tailed tailed to send failed to transmit means that in the send the sedex client could not transmit our message teilec transmit Vocation tarilcd teilec to transmit configration of simulated sedex adapter working directory of sedex adapter all directories below are relative to base directory base dir adapter C smclientbase 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 d custom error text for specialist reply testbed errortext Example Error Text 8 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 ablage 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 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
51. 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 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 seulement pour installations individuelles Il faut en outre encore ajouter le xml resolver 1 2 jar ce dernier peut tre t l charg 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 lib endorsed Configuration de la m moire vive seulement pour installations individuelles Afin d assurer un fonctionnement sans incidents il faut r gler le MaxPermSize a 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 C smclientbase 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 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
52. d rromecdeomanmn where name like smclient INSERT NO CONE OUr ELON WOU A Keen Claileresiel Emme RE OS Eede ATP S e lee domain where name like smclient e global config location d finit l endroit o se trouve le fichier properties aver les configurations valables pour tous les mandants Cela ne doit tre d fini que pour un seul domaine et mandant Quel domaine mandant est utilis n est pas important mais ils doivent exister 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 l endroit o se trouve le fichier properties avec les configurations du stockage e formservice location D fini l emplacement du fichier Properties avec les configurations pour le service formulaire 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 s e messsage Tables d utilisateurs Les tables d utilisateurs doivent
53. 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 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 8 3 Configuration du banc d essai 8 3 1 Configuration des dossiers des interfaces Les interfaces sont d finies dans le fichier Property message handler tb properties L exemple de configuration peut tre utilis avec l exemple de configuration client sM indiqu plus haut Veuillez vous assurer que les dossiers indiqu s existent bien 8 3 1 1 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 Dossier pour les messages qui ont t envoy s outbox location Dossier dans lequel sont sauvegard les messages re us par le banc d essai inbox location Dossier o sont stock s les messages que le banc d essai doit envoyer failed location Contient les messages ne pouvant pas tre trait s failed t
54. donn es un script est mis disposition pour la cr ation d indexes sur les tables JBPM http sm client ctp consulting com index php 3 1 5 2 Moteur de base de donn es MySQL Pour la base de donn es MySQL il faut employer INNODB comme moteur de base de donn es Pour des informations concernant le changement INNODB veuillez vous r f rer la documentation de MySQL http dev mysql com doc Les param tres validationQuery Tomcat ou lt valid connection checker class name gt JBoss doivent tre configur s dans le serveur d application voir les fichiers d example plus bas De cette fa on le serveur d application va v fifier l tat de la connection a la base de donn e avant de la donner au sM Client Si la connexion n est plus valide le serveur d application va en cr er une nouvelle Si apr s plusieurs essai aucune connexion n a pu tre obtenue la transaction sera restaur Si aucune connexion n est possible avant le d marrage du processus le processus ne sera pas d marr Le param tre sert viter que la connexion choue une fois seulement et bloque le processus alors ou elle peut tre recr e avec succ s Le processus complet consiste en plusieurs parties qui chacune corresponde une transaction il n y a donc pas de transaction maitre pour l ensemble du prossesus Si la base de donn es est stopp e au moment de la transaction il est possible qu un message reste bloqu dans l
55. 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 INSTALL 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 2 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 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 JBoss Il faut ex cuter les tapes suivantes pour installer JBoss en
56. droit de recevoir les messages Ici votre sedexld ainsi que ceux des communes d finis au point 3 doivent tre pr sent Le type et sous type de message doit correspondre aux valeurs du fichier message list xml d fini au point 2 lt P version OM E lt groups xmlns xsi http www w3 0rg 2001 XMLSchema instance xsi noNamespaceSchemaLocation message participants list xsd gt lt group name elm 1 gt lt participant sedexId 99 ZH 98 gt lt participant sedexId 99 ZH 99 gt participant sede ic EE lt participant sedexId T6 900014 2 gt lt message type 9999 subtype 000909 gt lt group gt lt groups gt 4 8 3 R gles de triage pour ELM Les r gles de triage pour ELM suivent la configuration standard voir Error Reference source not found Error Reference source not found avec les particularit s suivantes e La g n ration automatique du fichier PDF ou CSV n est pas possible pour le domaine ELM e L lement lt messageAction gt dans lt criteria gt n est pas autoris e Le type et sous type de message ne sont pas des types Sedex mais d fini dans le fichier message list xml du repository o Type de message elm o Sous type qst oder la Example de r gle pour ELM lt xml version 1 0 encoding UTF 8 gt lt triage xmlns xsi http www w3 0rg 2001 XMLSchema instance xsi noNamespaceSchemaLocation rules xsd gt lt Siehe Kapitel 4 2 2 5 f r die komplette Konfiguration g
57. e name Admin TNO ERENTO Sie size bs anos acl RG TE ach EU selec acl from smUser where username SuperUser select id from smRole where name SuperUser 4 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 1 2 Installation client sM sur JBoss Incompatibilit avec JBoss 7 Versions pr c dentes 7 2 Les versions de JBoss ant rieures 7 2 ne sont pas compatibles avec le sM Client cause d une erreur dans la gestion des librairies de JBoss 7 De plus amples informations sont disponibles ce sujet l adresse suivante https issues jboss org browse AS7 4313 Les premiers tests du sM Client avec JBoss 7 2 alpha ont t concluants en date de f vrier 2013 D s que la version 7 2 sera disponible le sM Client sera de nouveau test sur cette version 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 s
58. e lt path name com sun jndi url rmi gt La section lt paths gt doit ensuite ressembler cela Example pour EAP6 1 lt paths gt lt path name com sun script javascript gt lt path name com sun jndi dns gt lt path name com sun jndi ldap gt lt path name com sun jndi url gt lt path name com sun jndi url rmi gt lt path name com sun jndi url dns gt lt path name com sun security auth gt lt path name com sun security auth login gt lt path name com sun security auth module gt lt path name sun misc gt lt path name sun io gt lt path name sun nio gt lt path name sun nio ch gt lt path name sun security gt lt path name sun security krb5 gt lt path name sun util gt lt path name sun util calendar gt lt path name sun security provider gt lt path name META INF services gt lt paths gt 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 configurer la source de donn es il faut modifier le fichier JBOSS_HOME standalone configuration standalone xml donn es Un l ment datasource doit tre ajout dans la d finition des datasourc
59. e d exemple Pour les autre bases de donn es il faut changer les champs driverClassName et ur1 Reportez vous aux chapitres correspondant pour les valeurs exactes lt Context path smclient gt lt Resource name jdbc smclient auth Container type javax sql DataSource maxActive 100 maxIdle 30 maxWait 10000 username smclientUser password password driverClassName com mysql jdbc Driver url jdbc mysql localhost smclient gt lt Context gt Les champs username et password correspondent aux valeurs qui ont t d finies la section 4 1 1 Autres biblioth ques Il faut en outre encore ajouter le commons logging 1 1 1 jar le pilote JDBC correspondant a votre base de donn es et la librairie log4j on peut les t l charger ici http dev mysql com downloads connector j pilote JDBC pour MySQL http www microsoft com downloads details aspx displaylang en amp FamilyID 99b21b65 e98f 4a61 b81 1 19912601 fdc9 sqljdbc4 jar pilote JDBC pour Mircosoft SQL Server 2000 a 2008 http www oracle com technology software tech java sqlj_jdbc index html ojdbc6 jar pilote JDBC pour Oracle http commons apache org downloads download logging cgi http logging apache org log4j 1 2 download html Il faut ensuite d poser le fichier dans le dossier CATALINA HOME lib Configuration de la m moire vive Afin d assurer un fonctionnement sans incidents il faut r gler le MaxPermSize
60. e dossier temporaire Exemple pour JBOSS_HOMEY server default deploy smelient ds xml JBoss 4 2 3 et 5 1 avec MySQL mssql et oracle Ces fichiers sont aussi disponibles sur le site du sM Client http sm client ctp consulting com en dessous du manuel d installation smclient mysql ds xml smclient mssql ds xml smclient oracle ds xml Exemple pour CATALINA HOME config CATALINA localhost smclient xml Datei pour Tomcat avec MySQL voir les commentaires dans le fichier pour les autres bases de donn es smclient xml Extrait de standalone xml lt datasource gt pour EAP6 1 avec MySQL mssql et oracle standalone eap61 myssql datasource txt standalone eap61 mssql datasource txt standalone eap61 oracle datasource txt 3 1 6 Installation von HornetQ sM Client Queue HornetQ 2 2 14 peut tre t l charg depuis Internet http www jboss org hornetg downloads html L installation s effectue conform ment aux instructions d installation de HornetQ http docs jboss org hornetg 2 2 14 Final quickstart guide en html index html Il faut tenir compte du fait que la version standalone non clustered est employ e par d faut 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
61. e programme montre une page vierge et il faut cliquer sur Quit L installation est malgr tout compl te Le raccourcit vers INSTALL_PATH scripts windows start_smclient bat peut tre cr manuellement Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 71 95 istallation et Configuration du Client 8 Installation has completed successfully An uninstaller program has been created in C smclientbase Uninstaller Generate an automatic installation script Made with IzPack http izpack org Figure 9 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 Au cas ou 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 a ce que le client sM a cr les interfaces de l adaptateur sedex sous l adresse suivante SINSTALL DIR adapter 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
62. 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 20 Juile Installation du stockage Le stockage est est mis a disposition sur notre site web http sm client ctp consulting com Produktive Ablage ou Test Ablage pour les instances de test sedexID commen ant par T et doit tre copi l endroit correspondant d fini dans repository properties p ex C smclientbase interface repository D autres configurations peuvent tre adapt es a vos besoins au besoin et de fa on analogue l installation manuelle chapitre 4 Il est aussi recommand d utiliser un mot de passe pour l utilisateur root pour la banque de donn es MySQL 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 sM Client Queue puis la banque de donn es mysql une fen tre DOS propre est ouverte pour cela ensuite sM Client Core le serveur JBoss D s que le serveur JBoss est d marr l application est disponible 5 6 D sinstallation du sM Client Lors de l installation du client sM avec le Wizard une proc dure de d sinstallation est g n
63. er et ajouter les valeurs selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex EATE TABLE smUser id NUMBER 37 NOT NULL username VARCHAR2 255 NOT NULL password VARCHAR2 255 firstname VARCHAR2 255 lastname VARCHAR2 255 defaultLanguage VARCHAR2 255 NOT sedexId VARCHAR2 255 PRIMARY KEY id insert into smUser id username password firstname lastname defaultLanguage sedexId values 1 Admin 46 tAEewgFn0 t009ADB50 administrator administrator Eer yoursedexIid insert into smUser id username password firstname lastname defaultLanguage sedexId values 2 SuperUser 2atHgjIcy5hGeeRwzY mh0 Super User fr quil 9 Cr erle tableau smUser_smRole et ajouter les valeurs selon proc dure ci dessous EATE TABLE smUser smRole smUser id NUMBER 37 NOT NULL Role id NUMBER 27 NOT NULL 5 ERT INTO smUser smRole smUser id Role id VALUES select id from smUser wher username Admin select id from smRole where name Admin INSERT INTO smUser smRole smUser id Role id VALUES select id from smUser wher username SuperUser select id from smRole where name SuperUser S quences et Contraintes sont seulement apliqu es apr s le d marrage du client sM 10 Installer Oracle JDBC
64. er location C smclientbase config message handler elm properties yourSedexId select id from domain where name Like Gina 3 Un nouveau domaine peut aussi besoin de ses propres r pertoires c est pourquoi il y a un message handler properties par domaine ainsi le sM Client sait quel domaine un message appartient Ces r pertoires doivent tre cr s avant le d marrage du sM Client Les r pertoires de l adaptateur doivent correspondre ceux d fini lors de la configuration du sdA Important Les r pertoires mentionn s dans ce fichier doivent tre disponible avant le d marrage du sM Client Veuillez les cr er si n cessaire Reportez vous la table ci dessous pour la correspondance entre la configuration du sM Client et du sdA HHHH Message handler ELM configuration 4 elm timeout days 60 base directory for messages all directories below are relative to base directory base dir smclient interface C smclientbase interface location for sent files sent location elm sent location form messages to be send outbox location elm outbox location for incoming messages inbox location inbox post box location for deleted messages deleted location elm deleted location for exported messages exported location elm exported location of failed messages failed location failed failed to send it could not be send by the smclient failed tosend locatiton
65. es dans le fichier XML Un example de configuration est donn ici pour MySQL lt datasource jndi name java smclient pool name smclient pool nabled true use java context true gt lt connection url gt jdbc mysql localhost 3306 smclient lt connection url gt lt driver gt mysql lt driver gt lt pool gt lt min pool size gt 10 lt min pool size gt lt max pool size gt 100 lt max pool size gt lt prefill gt true lt prefill gt lt pool gt lt security gt lt user name gt user name lt user name gt lt password gt password lt password gt lt security gt lt statement gt lt prepared statement cache size gt 32 lt prepared statement cache size gt lt share prepared statements gt true lt share prepared statements gt lt statement gt lt datasource gt Les champs user name et password correspondent aux valeurs qui ont t d finies au 4 1 1 Le pilote MySQL doit tre d fini avec le m me nom mysql dans l example de configuration ci dessus dans la d finition des drivers dans le m me fichier XML Un example pour le pilote MySQL est fourni ci apr s lt driver name mysql module com mysql gt lt xa datasource class gt com mysql jdbc jdbc2 optional MysqlXADataSource lt xa datasource class gt lt driver gt L attribut module de la configuration du pilote correspond au nom du module d finir lors de l ajout du pilote JDBC De plus amples d tails concernant la configurat
66. eur 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 26 juillet 2012 von Cambridge Technology Partners 2014 77195 sM Client Projekt Version finale Installations Handbuch V rification de l Installation Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 78 95 7 INSTALLATION SUR D AUTRES BANQUES DE DONNEES Dans le cas d une installation sur une autre banque de donn es que MySQL le chapitre suivant d crit les tapes n cessaires et remplace ainsi le chapitre 4 1 7 1 MS SQL 1 Cr er une banque de donn es smolient 2 Cr er le login smclientUser attribution du r le db owner pour banque de donn es smclient 3 Cr er le tableau smMandanf et ajouter les valeurs selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex smMandant sedexId varchar 255 NOT NULL name varchar 255 1 active tinyint DEFAULT 0 PRIMARY KEY sedexId smMandant VALUES yourSedexId mandantName 1 domain id BIGINT NOT NULL IDENTITY 1 1 name VARCHAR 255 NOT NULL PRIMARY
67. ewMandantSedexId select id from domain where name like smclient INSERT INTO configuration VALUES formservice location C smclientbase config_newMandant f ormservice properties newMandantSedexId select id from domain where name like smclient INSERT INTO configuration VALUES rulles location smeltenl base contig newMandant mules x ml newMandantSedexId select id from domain where name like gmclient INSERT INTO configuration VALUES timeout time 30 newMandantSedexId select id from domain where name like smclient INSERT INTO configuration VALUES keep deleted time 10 newMandantSedexId select id from domain where name like smclient 3 Le nouveau mandant doit ensuite tre configur comme d crit au chapitre 4 2 Configuration du client sM 4 Dans l interface utilisateur le SuperUser peut maintenant activer le nouveau mandant Pour cela il faut s lectionner le nouveau mandant a l aide de la case a cocher correspondante et cliquer sur le lien activer d sactiver les mandants 5 L administrateur cr lors de l tape 1 peut maintenant s identifier et cr er de nouveaux utilisateurs 6 Important Pour activer la v rification des messages pour le nouveau mandant le server JBoss doit tre red marr 4 5 1 Activation de mandant multiple Pour pouvoir utiliser plusieurs mandants un utilisateur avec le r le SuperUser doit tre c
68. figur automatiquement 4 2 4 3 Configuration LDAP Si pour l administration des utilisateurs on utilise un LDAP au lieu d une administration interne les valeurs suivantes doivent tre configur es dans le dossier configuration config properties d crits sous 4 2 2 1 Pour que le LDAP soit utilis il est n cessaire de mettre la valeur LDAP enabled sur true NOTE La valeur username sera substitu e au login user name ldap provider url URL sous lequel LDAP ou AD sont joignables authentication type Doit toujours tre sur simple bindDN optional Directory Node d fini par le client sM comme base pour la communication Le bind DN est l utilisateur qui a le droit de chercher dans le LDAP dans les limites de la base de recherche d finie En cas normal le bind DN a le droit de chercher dans tout le LDAP Exemple Active Directory bind DN cn administrator cn Users dc domain dc com OpenLDAP bind DN cn root dc domain dc com Remarque Si bindDN bindCredential ne sont pas utilis s c est bindDN baserFiler username baseCtxDN qui le sera bindCredential Mot de passe pour que le client sM puisse se connecter au LDAP baseCtxDN Directory Node utilis par le client sM comme base pour les demandes utilisateurs Exemple OQU ZUR OU Accounts DC ctp DC com baseFilter Filtre selon quel utilisateur il faut chercher Remarque n est pas un filtre LDAP Pour la recherche on utilise le
69. figuration On cr e ensuite un tableau de configuration que Ton remplit des valeurs correspondantes Le script ci apr s doit tre adapt et ex cut mysgl gt uss enelisnt testech mysa e CREATE TABLE smelvene testbed smMandanti sedexid varchar 255 NOT NULL name varchar 255 DEFAULT NULL active bit DEFAULT false PRIMARY KEY sedexId My eCREA TE TAREE sme lment EE EE uao oli VARCHAR 255 NOT NULL confValue VARCHAR 255 sedexId VARCHAR 255 NOT NULL PRIMARY key sedexId keycolumn ii INSERT INTO smclient_testbed smMandant sedexId name active valss Gels toot Eeer CLUES 7 INSEE VINO ssi EEC eo EURO G messager handler location Cs smelientbase coniig message nandler to properties cesiclosel s INSODE INIO iui ese eee cont iguraTtion VALUES reposi tory bereet Le smelientbasc contig repository properties testbed INSERT UNTO gmeliecnt testbed UE Con VALUES contig location C smelientbasce conrig contig preperties Ncestloacl p e message handler location d finit l endroit o se trouve le fichier Properties avec les configurations pour le banc d essai 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 e config location d finit l endroit o se trouve
70. filtre suivant baseFiler username baseCtxDN Exemple cn languageAttributelD Montre le champ sur lequel la langue standard de l utilisateur est sauvegard e Il est possible de choisir entre de fr et it rolesCtxDN Directory Node utilis par le client sM comme base pour les demandes de r les roleFilter Filtre selon quel r le il faut chercher Exemple member cn username OU ZUR OU Accounts DC ctp DC com roleAttributelD Attribut dans lequel sont enregistr les r les Exemple nom AdminRoleMapper optionnel Nom de groupe qui doit tre d fini avec le r le Admin du client sM Exemple smClinetAdministrator Si non appliqu on utilise de mani re standard Admin ActiveUserRoleMapper optionnel Nom de groupe qui doit tre d fini avec le r le ActiveUser du client sM Exemple smClinetActiveUser Si non appliqu on utilise de mani re standard ActivUser Passive UserRoleMapper optionnel Nom de groupe qui doit tre d fini avec le r le PassiveUser du client sM Exemple smClinetPassiveUser Si non appliqu on utilise de mani re standard PassiveUser SuperUserRoleMapper optionnel Nom de groupe qui doit tre d fini avec le r le SuperUser du client sM Exemple smClientSuperUser Si non appliqu on utilise de mani re standard SuperUser Exemple d une configuration LDAP Hy
71. finale Installations Handbuch Installation et configuration du client sM e RMI Port 1101 e M moire minimale et maximale 256Mo Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 62 95 5 INSTALLATION ET CONFIGURATION DU CLIENT SM AL AIDE DU WIZARD Un wizard simplifiant l installation est livr pour des installations standard On proc de 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 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 a cela est qu une JAVA SDK soit install comme cela a t d fini sous 3 1 1 Au cas ou 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 a travers l installation l aide du wizard sM Client Projekt Version finale Installations Handbuch Installation et Configuration du Client 5 2 1 cran d accueil Welcome to the installation of sM Client 4 1 0 Q This software is developed by Cambridge Technology Partners lt info ctp consulting com gt
72. i chouent avant leur envoi failed transmit location Contient les messages qui chouent pendant 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 adaptateur sedex adapter inbox location Entr e message adapter receipt location Entr e quittance adapter outbox location Sortie de message JMS jms sender timeout hours Timeout en heures avant que le sM Client ne renvoie le message JMS Doit tre un nombre entier Minimum 1 En cas de configuration erron e la valeur par d faut est 24 max num msg Nombre maximal de fichiers XML dans le message group pour le traitement dans la Queue Priority lors de la validation max num msg pdf Nombre maximal de fichiers XML dans le message group pour le traitement dans la Queue Priority lors de la cr ation des fichiers PDF max size Taille maximale en ko des fichiers XML dans le message pour le traitement dans la Queue Priority lors de la validation max size DOT Taille maximale en ko des fichiers XML dans le message pour le traitement dans la Queue Priority lors de la cr ation des fichiers PDF Exemple EEEH de configuration message handler properties for the standard domain Ti
73. i sont actifs message participants list Contient le dossier des participants d crit les messages que les participants peuvent changer version Optionnel Contient le chemin relatif depuis ablage base dir vers le fichier version properties Cette propri t est optionnelle et a comme valeur par d faut participants list version properties Cette valeur ne doit pas tre chang e lors de l utilisation du stockage de base plugins dir Optionnel Peut contenir un chemin relatif par rapport au chemin de base ablage base dir ou un chemin absolu Ce chemin doit pointer vers un repertoire existant contentant les Plug ins fichiers JAR La valeur par d faut de ce repertoire est plugins Exemple de configuration Stockage is file repository used to store xsd xslts and documentation ablage base dir C smclientbase interface repository directory for all xsds and xsls EE EE xslt directory for documentation documentation documentation directory for optional integrity check files LOS ar eV EE EE directory of participants message lists Pave leipants pariredpanes location of participants participants list participants location of messages list WEB ae 4 Lier Serie ER location of message part message participants l ligt sl version properties vers on aan iste part pet t message list xml ticipants list icip
74. ia gt lt recipientId gt T6 900014 1 lt recipientId gt lt criteria gt lt useCase gt adapter lt useCase gt lt rule gt 4 2 3 R gle de triage Monitoring Les messages de monitoring seront envoy s chaque jour par smc monitoring ctp consulting com Pour que ces messages ne perturbent pas les applications m tiers il faut d finir une r gle de triage pour placer ces messages dans un dossier s par Voir aussi le chapitre 4 2 2 7 du manuel d installation Le Monitoring et l acc s la plateforme ne peut se faire qu apr s inscription aupr s de Support SM Client ctp com aupr s de dap bsv admin ch pour les particapants d pendant de l OFAS en indiquant votre sedexld ainsi que l adresse email qui recevra les messages d alerte provenant de la plateforme de Monitoring Cette r gle travaille sur le type de message lors de la r ception e type de message 2991 pour BSV e type de message 3991 pour SSK Pri re de modifier le destinationFolder selon votre installation locale et de cr er le r pertoire correspondant 4 2 3 1 SSK Exemple de r gle pour les messages de monitoring SSK rules xml Pri re de modifier le destinationFolder selon votre installation locale et de cr er le r pertoire correspondant LS lehe kapitel 4A 2 20 vai komolecte Konticghratiga gt lt rule gt lt criteria gt lt messageType gt 3991 lt messageType gt EE lt destinationFolder gt C smclientbase interface inbox monito
75. ier message process xml Les propri t s sp cifiques configur es dans ce fichier ont priorit sur la configuration g n rale On peut configurer la conversion dans le fichier message handler eschkg properties pour tous les types de messages du domaine Dans la version 4 0 seuls les messages eschkg utilisent cette propri t fuse ech standard for eschkg message should message be converted true Ou configuer la conversion dans le fichier optionel message process xml uniquement pour un type de message particulier Les valeurs dans ce fichier sont prioraires sur celles du message handler eschkg properties lt convert eschkg message in eCH format gt lt message type 10301 gt lt conversion gt true lt conversion gt lt message gt 5 Les fichiers eschkg doivent tre trait s par une application externe il faut donc d finir les r gles suivantes dans le fichier rules xml lt triage gt lt rule gt lt criteria gt lt messageType gt 10301 lt messageType gt lt _ Crikeria lt destinationrolder C smclientbase Vintertace eschkq inbox lt desti nationFolder gt lt PDFGeneration boolean false gt lt useCase gt receive lt useCase gt lt rule gt lt rule gt lt criteria gt lt messageType gt 10301 lt messageType gt lt criteria gt lt destinationFolder gt C smclientbase interface eschkg sent lt destin ationFolder gt lt PDFGeneration boolean false gt lt useCase gt se
76. ion 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 0u4 ou plus la derni re version du JDK 7 est recommand e exept pour JBoss 5 1 0 et l installation du sM Client via Wizard depuis Internet http java sun com javase downloads index jsp Remarque JBoss 5 1 0 n est pas compatible avec JDK7 et n cessite l emploi d un JDK6 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 lOFAS http Awww bfs admin ch bfs portal de index news 00 00 12 01 html 3 1 3 Installation et configuration de JBoss AS Des versions libres de JBoss peuvent tre t l charg es sur Internet http www jboss org jbossas downloads L installation s effectue conform ment aux instructions d installation de JBoss Version EAP 6 https access redhat com knowledge docs en US JBoss Enterprise Application
77. ion sont disponibles l adresse https community jboss org wiki DataSourceConfigurationinAS7 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 nouveau changer le suffixe en war une fois le t l chargement effectu Le fichier t l charg ne doit pas tre d comprim a 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 a un d ploiement de l application l option Autodeploy doit tre activ e c est le cas de fa on standard et effacer le fichier smclient war deployed si celui ci est pr sent Configurations des Logs La configuration des Logs est requise pour le support et est d crite dans le chapitre 4 2 4 1 1 Log 4 1 4 Installation client sM sur Apache Tomcat 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 Pour la configuration il faut ajouter p ex dans le dossier CATALINA HOME config CATALINA localhost un fichier smclient xml Voici une configuration pour MySQL titr
78. ises a disposition pour la banque de donn es Cela est souvent le cas lors d une mise a jour vers une version majeure De A Instructions 1 x 2 X Aktualisieren von 1 0 0 auf 2 x fr pdf 2 X 3 0 Aktualisierung von 2 x auf 3 0_fr pdf 4 4 Nouvelle installation avec Backup complet Si le client sM est configur pour le Full Backup le client sM peut faire une r installation la suite de gros probl mes arr t du syst me disque d fectueux et remettre le syst me l tat initial Les tapes suivantes sont n cessaires Si les processus client sM serveur d application et ou banque de donn es sont encore en cours ceux ci doivent tre pr alablement termin s Ensuite le client sM doit effectuer un r installation compl te comme d crit Les r pertoires ventuellement encore pr sents doivent tre compl tement d sinstall s supprim s Configuration du client sM comme d crit La banque de donn es doit tre d marr e en premier Ex cution de la proc dure MySQLSmClientBackup bat sur Windows resp MySQLSmClientBackup sh sur Linux Unix La banque de donn es est ainsi restaur e MySQLSmClientBackup bat restore MySQLSmClientBackup sh restore D marrage du client sM Connexion comme Admin Sur la page Configuration gt Backup avec le bouton Restore Files il est possible de restaurer les r pertoires des messages y compris temp avec le bouton Restore Files 4 5 C
79. itory H directory for all xsds and xsls usd_xslt xsd_xslt directory for documentation idocumentation documentation tdirectory for optional integrity check files i sintegrity integrity check itdirectory of participants message lists marticipants participants list location of participants list participants list participants list participants list xml H location of messages list H message list participants_list message list xml H i location of message participants list message participants list participants_list message participants list xml H H i i i i for the testplatform i message packages message packages config properties nena naeran aaaeeeaa H sedex identificator isedexId 6 900014 2 type of message used to update the system xml files documentation lupdate message types 2999 3999 Lors de la premi re connection vous pouvez utiliser l utilisateur par d faut Admin le mot de passe Admin Le nom d utilisateur ainsi que le mot de passe sont sensible la casse 6 2 V rification dans le log Au cas o la page de version n est pas affich e on peut v rifier dans le log JBoss ou Tomcat si des erreurs quelconques apparaissent 6 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 exp dit
80. like smclient INSERT INTO configuration VALUES formservice location C smclientbase config formservice properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES rules location C smclientbase config rules xml yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES timeout time 30 yourSedexId Les valeurs doivent correspondre a l installation client sM respective 6 Cr er le tableau smRole selon proc dure ci dessous Erstellt 26 juillet 2012 von Cambridge Technology Partners 2014 80 95 EATE TABLE smRole id BIGINT NOT ENTITY 0 1 name VARCHAR 255 description VARCHAR 255 PRIMARY KEY id 7 Ajouter les valeurs dans smRole selon proc dure ci dessous ERT INTO smRole name description values Admin in steator ERT INTO smRole name description values ActiveUser ive User Sender ERT INTO smRole name description values PassiveUser sive User Receiver ERT INTO smRole name description values SuperUser Super User 8 Cr er le tableau smUser et ajouter les valeurs selon proc dure ci dessous la valeur yourSedexld doit tre remplac dans chaque ligne par votre identifiant Sedex FATE TABLE smUser id BIGINT NOT NULL IDENTITY 0 1
81. llation et configuration de JBoss AS i 11 3 1 4 Installation et configuration de Apache ToMCat 12 3 1 5 installation de MySQL p ieri 12 3 1 6 Installation von HornetQ SM Client Oueuel 13 INSTALLATION ET CONFIGURATION DU CLIENT SM 14 INSTALLATION MANUELLE spiace 14 4 1 1 Installation de la base de donn es client SM 14 4 1 2 Installation client SM sur JBoss 17 4 1 3 Installation sM Client auf EAP6 nns 18 4 1 4 Installation client SM sur Apache Tomcat nn nnnn 21 CONFIGURATION DU CLIENT SM iii iieiisienenereseeserennene 22 4 2 1 Configuration des dossiers des interfaces 22 4 2 2 Configuration t ChNIQUe aaa ail i 24 4 2 3 R gle d triage MONItOringi carie Aia ia 40 4 2 4 del e Elei Mun 41 INSTALLATION D UNE MISE A JOUR ii 50 NOUVELLE INSTALLATION AVEC BACKUP COMPLET iiiiiiiiiieieicsesescscseseseseresesesesesesesesesees 51 CREATION D UN NOUVEAU MANDANT rec eserennnnene eee sc ennnne nee scennnenene seen 51 4 5 1 Activation de mandant multiple sis 52 CONFIGURATION DU DOMAIN ECHO 53 CONFIGURATION DU DOMAINE ECH0O058V4 iii 54 CONFIGURATION DU DOMAIN ELM Li 56 4 8 1 Configuration e Il neie EI 56 4 8 2 Configuration du cantonal repository nnen nt 59 4 8 3 R gles de triage pour ELMI eegen deed deg ee 60 GONFIGURATION SM GLIENT QUEUE 1ur iii iii iii ia 61 INS
82. mclient 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 jdbc 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 Ajouter JDBC Driver 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 mysql connector java 5 1 7 bin jar doit tre copi e dans le dossier JBoss Home server default lib Autres biblioth ques Il faut en outre encore ajouter le xml 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 ens
83. ment au moyen d Internet Explorer l extension de fichier peut tre modifi e de war a 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 option Autodeploy doit tre activ e c est le cas de fa on standard Configurations des Logs La configuration des Logs est requise pour le support et est d crite dans le chapitre 4 2 4 1 1 Log 4 1 3 Installation sM Client auf EAP6 Incompatibilit avec JBoss 7 Versions pr c dentes 7 2 Les versions de JBoss ant rieures a 7 2 ne sont pas compatibles avec le sM Client cause d une erreur dans la gestion des librairies de JBoss 7 De plus amples informations sont disponibles a ce sujet a l adresse suivante https issues jboss org browse AS7 4313 Les premiers tests du sM Client avec JBoss 7 2 alpha ont t concluants en date de f vrier 2013 D s que la version 7 2 sera disponible le sM Client sera de nouveau test sur cette version Ajouter JDBC Driver 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
84. meout for protocol receipt in send process Must be a positive integer Default is 3 protocol since l receipt timeout days 3 4 0 0 Add the Sedex Receipt to the zip of the message defaul lt is false should sedex receipt be added false base directory for messages all directories below are relative to base directory base dir smclient interface D smclient interface location for sent files sent location sent location form messages to be send outbox location outbox failed 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 Ccatmion tes failed to send it could not be send by the smclient failed tosend location failed failed to senc failed to transmit means that in the send the sedex client could not transmit the message fated transi tocar ton ravleq tatlec Len tranemi configuration of sedex adapter working directory of sedex adapter all directories below are relative to base directory base dir adapter C smclientbase 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 configuration of JMS interactio
85. ml adapter outbox location PATH_ELM_OUT result filesystem parent xml adapter failed receive PATH_ELM_FAILED_TO_RX failed filesystem parent xml adapter sent location PATH_ELM_SENT sent filesystem parent xml adapter failed transmit location PATH_ELM_FAILED_TO_TX undeliverable filesystem parent xml Nom du dossier DIE Fichier de sui Ze dans le Nom de la propri t Description design configuration techniqu message handler Contient les messages re us par le VELM elm properties ata Penne orainn sdA pour traitement au sM Client Le sM Client place ici les Out ELM WE tando adapter outbox location messages de r ponse pour le elm properties traitement au sdA message handler A 3 Sent ELM elm properties adapter sent location Messages envoy s avec succ s Failed to transmit ELM message handler elm properties adapter failed transmit Messages de r ponse que le sdA n a pas pu transmettre Failed to receive ELM message handler elm properties adapter failed receive Messages pour lesqels le sdA a d tect une erreur m tier Meldung message handler Messages recus et affich s dans la i inbox location A Eingang FA elm properties boite aux lettres Meldung message handler suber EE ER Bo te d envoi pour les messages Ausgang FA elm properties m tiers envoyer Sent FA message handler sent location
86. ml File pdf String args Ci dessous un exemple d impl mentation class HelloGroovy implements ch admin smclient service script GroovyScriptController String process ch admin smclient model Message msg File xml Piles pat String args 1 printlin Hello groovy Sargs for message msg messageId HSUCCESISM Pour plus d informations au sujet de Groovy reportez vous au site http groovy codehaus org Le sM Client emploie la version 1 7 5 de Groovy 4 2 2 7 Installation d imprimantes Pour pouvoir imprimer plusieurs messages il est n cessaire d installer une ou plusieurs imprimantes sur le serveur L installation d pend du syst me d exploitation du serveur Les imprimantes existantes dans le syst me d exploitation ET UNIQUEMENT celles compatibles Postscript sont utilis es automatiquement par le client sM Il faut toutefois contr ler si l imprimante directe fonctionne suivant le format d impression Installation de la librairie Ghostscript Windows 32 bits La derni re version peut tre t l charg depuis http www ghostscript com downloadf Il faut employer au minimum la version 8 71 gs871w32 exe Ex cuter le programme d installation et mettez le chemin d installation du r pertoire bin dans votre variable d environnement PATH 1 Ouvrez Gestion de l ordinateur 2 Dans l arborescence de la console cliquez avec le bouton droit sur Gestion de l ordinateur local puis cliquez sur Pr
87. n jms sender timeout hours 24 max number of xml message which still go into the prio queue max num msg 1 for pdf generation max num msg pdf 1 max size of xml messages which still go in to prio queue max size 1024 for pdf generation max size pdf 1024 4 2 2 4 formservice properties Stockage messageld prefix number Chiffre a 4 num ros plac devant le ID message des messages g n r s par le service formulaire Exemple de configuration file contains settings formservice of sM Client perfix for messagelds messageld prefix number 4444 4 2 2 5 repository properties Stockage ablage 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 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 Contient des documents qui d crivent les participants les messages et les droits participants list Contient la liste des participants actuels message list Contient la liste des messages actuels d crit les messages qu
88. n keycolumn VARCHAR 255 NOT NULL confValue VARCHAR 255 sedexId VARCHAR 255 NOT NULL domain id BIGINT 20 NOT NULL DEFAULT 0 PRIMARY key sedexId kevyeolumn domo dn in INSERT INTO smclient smMandant sedexId name active values vyvourSedexId default true INIST VIE dONERO oketnlig aepbice RO TONER sevice libel Cena ilo sedexid VALUES select id from domain where name like Tgmeliesnt Vereenegte Location C smeltentbase cenfig global config properttes yoursedexia INSERT INTO configuration VALUES contig locationt 00 Smelrentbase contiao conti ig properties yourSedexId select id from domain where name like smell DE INSERT INTO configuration VALUES message handler location C smelientbase contig message handler properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES repository lecation Cz smelientbas configs repository pr operties yourSedexId select id from domain where name like Usmelbirenia A TINSERIMNINILO NEO nf enen Eet VALUBS kormnssrvice locetiont 0e Smellenthase contio formservice properties yourSedexId select id from domain where name like smersrentbs De INSERT INTO configuration VALUES rules location Cs smelientbase contig miles mit ourse dexId select id from domain where name like smclient INSERT INTO configuration VALUES timeout times IIS voursedexid a selecrs i
89. nd lt useCase gt lt rule gt dr lage 4 7 Configuration du domaine eCH0058v4 Cette configuration est n cessaire uniquement pour recevoir ou envoyer les messages eCH0058v4 1 Ins rer le domaine eCH0058v4 dans la base de donn es insert into domain name values ech0058v4 2 D finition de l emplacement des fichiers de configuration Modifier d abord la requ te avec votre sedexld et l emplacement correct du fichier INSERT INTO configuration VALUES message handlers lecation C smelientbase contig message nandler ech0058v4 properties yourSedexId select id from domain where name like echO0O58v4 3 Un nouveau domaine peut aussi besoin de ses propres r pertoires c est pourquoi il ya un message handler properties par domaine ainsi le sM Client sait quel domaine un message appartient Ces r pertoires doivent tre cr s avant le d marrage du sM Client Ici seule la propri t outbox location diff re du message handler properties standard 4 Message handler ech0058v4 configuration 4 base directory for messages all directories below are relative to base directory base dir smclient interface C smclientbase interface location for sent files sent location sent location form messages to be send outbox location outbox location for incoming messages inbox location inbox location for deleted messages deleted location deleted location for exported mess
90. nux ou Unix sont pris en charge Il faut installer les composants suivants JDK 6 pour JBoss5 1 oder 7 adaptateur sedex ne fait pas partie int grante de la livraison du client sM JBoss ou Apache Tomcat MySQL Fichier WAR client sM Banque de donn es client sM Banc d essai fichier WAR Banc d essai banque de donn es Les versions support es sont list es dans le document Design technique 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 JDK 6 f r JBoss5 1 oder 7 e adaptateur sedex ne fait pas partie int grante de la livraison du client sM e JBoss ou Apache Tomacat e MySQL Les versions support es sont list es dans le document Design technique Il faut ensuite proc der aux configurations suivantes sur l installat
91. omatic Attention que MySQL et HornetQ soient toujours d marr s avant JBoss afin de garantir le bon fonctionnement du client sM Il est possible de determiner cette fonction via Registry et garantir ainsi une proc dure de d marrage correcte Dans la cl HKEY_LOCAL MACHINE SYSTEM CurrentControlSet Services JBOSS4JAVA6 Il faut changer DependOnService avec Modifiy Dans le Data Dialog la nouvelle valeur doit tre MySQL HornetQ Vous trouverez des informations supp mentairessur http support microsoft com kb 193888 5 7 1 Configuration Manuelle de HornetQ comme service Pour l installation de HornetQ en tant que service les pas suivants sont n cessaires 1 T l chargez JBoss Native pour la plateforme correspondante http www jboss org jbossweb downloads jboss native 2 Copiez jbosssvc exe du fichier zip et hornetq_service bat dans le r pertoire HORNETQ_HOME bin 3 Le fichier HORNETQ HOME bin hornetq_service bat doit tre modifi et le service doit tre nomm set SVCNAME HornetQ set SVCDISP HornetQ set SVCDESC hornetq 2 2 14 Final 4 Optionellement il est possible de configurer les param tres du log jbosssvc exe p 1 Starting SVCDISP gt run log call run bat lt hornetq 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 stop bat lt hornetq shutdown lock gt gt shutdown log 2 gt amp
92. ontr e correspondant au message sera appliqu e II faut donc que les r gles de test les moins sp cifiques soit plac es apr s les autres lt criteria gt peut v rifier les valeurs suivantes dans adapter lt messageType gt lt recipientId gt Toutes ces valeurs se r f rent la valeur correspondante dans le message Les combinaisons de valeurs suivantes sont possibles pour lt criteria gt Aucune gt r gle par d faut lt messageType gt lt recipientId gt lt messageType gt und lt recipientId gt Si aucune r gle par d faut n est utilis e il faut s assurer que les messages de mise jour soient d finis de mani re ce qu ils soient re us Exemple r gles adaptateur Voici quelques exemples d application des r gles adaptateur si plusieurs clients sM ou applications sont connect s un adaptaeur Cette r gle permet de saisir tous les messages de type 3001 envoy s au destinataire T6 900014 2 lt rule gt lt criteria gt lt recipientId gt T6 900014 2 lt recipientId gt lt messageType gt 3001 lt messageType gt lt criteria gt lt useCase gt adapter lt useCase gt lt rule gt Cette r gle permet de saisir tous les messages de type 3002 lt rule gt lt criteria gt lt messageType gt 3002 lt messageType gt lt criteria gt lt useCase gt adapter lt useCase gt lt rule gt Cette r gle permet de saisir tous les messages envoy s au destinataire T6 900014 1 lt rule gt lt criter
93. opri t s Sous l onglet Avanc sous Variables d environnement cliquez sur Param tres S lectionnez un utilisateur dans la liste Variables utilisateur pour Cliquez sur le nom Path de la variable utilisateur ou syst me que vous souhaitez modifier ou supprimer Cliquez sur Modifier pour modifier la valeur de la variable avec le nom Path Ajoutez la fin du champ valeur Variable value un point virgule puis le chemin du r pertoire bin de Ghostscript Par exemple C Program Files gs gs8 71 bin 8 Pour v rifier ouvrez une fen tre de commande D marrer gt Ex cuter cmd puis entrez la commande gswin32 Une fen tre de commande ghostscript doit s ouvrir 9 Red marrer le sM Client Windows 64 bits La derni re version peut tre t l charg depuis http www ghostscript com download Il faut employer au minimum la version 9 04 gs904w64 exe Ex cuter le programme d installation Puis mettez le chemin d installation du r pertoire bin dans votre variable d environnement PATH 1 Ouvrez Gestion de l ordinateur 2 Dans l arborescence de la console cliquez avec le bouton droit sur Gestion de l ordinateur local puis cliquez sur Propri t s Sous l onglet Avanc sous Variables d environnement cliquez sur Param tres S lectionnez un utilisateur dans la liste Variables utilisateur pour Cliquez sur le nom Path de la variable utilisateur ou syst me que vous souhaitez modifier ou supp
94. org apache log4 ConsoleAppender log4j appender console layout org apache log4j PatternLayout log4j appender console layout ConversionPattern X sedexId m n log4j appender R org apache log4j DailyRollingFileAppender log4j appender R File C smclientbase log 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 SX sedexId m n Dans le fichier log config on peut aussi configurer le niveau de log souhait Il est ici regl sur INFO Les valeurs possibles sont e TRACE e DEBUG e INFO e WARN e ERROR Le niveau TRACE produit une norme quantit de log et ne devrait pas tre utilis en production Le sM Client utilise le log du niveau DEBUG au niveau ERROR Il est possible de configurer le log au niveau DEBUG uniquement pour le sM Client Pour cela il faut ajouter la ligne suivante au fichier log comfig log4j logger ch admin smclient DEBUG et ou pour la validation des messages Les erreurs XML lors de la validation ne sont d taill es dans le log qu en mode DEBUG log4j logger ch admin smclient service MessageValidator DEBUG FOP Cr ation de PDF produit pour les messages ELM beaucoup d entr es dans le log et peut tre mis au niveau ERROR log4j logger org apache fop ERROR 4 2 4 2 Configurations en option Certaines autres configurations du clien
95. osend location Contient les messages qui chouent au moment de leur envoi failed transmit location Contient les messages qui chouent d s avant leur envoi receipt location Contient les quittances envoy es par le banc d essai pour v rification apr s l envoi 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 a celle du client tester testbed errortext Texte qui doit tre crit dans la confirmation de r ception m tier Exemple de configuration base directory for messages all directories below are relative to base directory base dir smclient interface C smclientbase testbed 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
96. poth se la structure LDAP suivante LDIF Utilisateur DN CN John Frei OU ZUR OU Accounts DC ctp DC com ObjectClass OrganizationalPerson CN John Frei Groupe DN CN SmClientAdmin OU Groups DC ctp DC com Member CN John Frei OQU ZUR OU Accounts DC ctp DC com Name smClientAdministrator Dans ce cas il faut utiliser la configuration suivante LDAP configuration optional idap provider url ldap hostname 3389 fauthentication type used to obtain user s roles should be simple authentication type simple bind credentials optional if not set than baseFilter userName baseCtxDN will be used bindDN CN Manager OU ZUR OU Accounts DC ctp DC com bindCredential secret from where to start search users baseCtxDN 0U ZUR OU Accounts DC ctp DC com base filter to search user in ldap baseFilter cn optional attribute containing user s language if not set default locale will be used languageAttributeID msExchUserCulture from where to start search roles rolesCtxDN 0U ZUR 0U Groups DC ctp DC com matehimg Filter for searching roles username will be substitute with login name roleFilter member cn username 0U ZUR OU Accounts DC ctp DC com roleAttributeID name AdminRoleMapper smClientAdministrator ActiveUserRoleMapper smClientActiveUser PassiveUserRoleMapper smClientPassiveUser 4 2 4 3 1 Configuration LDAP avec SSL Pour utiliser la connexion Id
97. r Si l authentification LDAP est utilis e il faut configur un r le en tant que SuperUser du client sM comme d crit au chapitre 4 2 4 3 Configuration LDAP Sinon il faut ajouter le r le SuperUser dans la base de don e 1 Cr ation du r le SuperUser INSERT INTO smRole name description values SuperUser USujoeice Deene lz 2 Cr ation d un super utilisateur insert into smUser username password firstname lastname defaultLanguage sedexId values SuperUser 2atHgjIcy5hGeeRwzY mh0 Super User rfe n ll ENEE RE from smUser where username SuperUser select id from smRole where name SuperUser 3 Maintenant l identification en tant que SuperUser est possible mot de passe SuperUser aucun mandant s lectionn 4 6 Configuration du domain eSchKG Cette configuration est n cessaire uniquement pour recevoir ou envoyer les messages eSchKG 1 Ins rer le domaine eschkg dans la base de donn es insert into domain name values eschkg 2 D finition de l emplacement des fichiers de configuration Modifier d abord la requ te avec votre sedexld et l emplacement correct du fichier INSERT INTO configuration VALUES message handler location C smclientbase config message handler eschkg properties yourSedexId select id from domain where name like eschkg 3 Un nouveau domaine a aussi besoin de ses propres r pertoires c est pourquoi il y a un message
98. r ation d un nouveau mandant Pour la cr ation d un nouveau mandant il faut avoir le r le SuperUser Dans le cas o aucun SuperUser n est encore present dans le syst me il faut en cr er un comme expliqu au chapitre 4 5 1 Activation de mandant multiple En tant que SuperUser les op rations suivantes sont possibles pour les mandants e Cr ation de mandant e Activation de mandants e D activation de mandants 1 En tant que SuperUser l utilisateur par d faut est SuperUser avec mot de passe SuperUser dans l interface utilisateur il est possible de cr er un nouveau mandant avec un administrateur Pour cela il faut remplir le formulaire ajouter un mandant 2 Ensuite il faut indiquer dans la base de donn e l emplacement des fichiers de configuration du nouveau mandant Il faut ici changer le chemin des diff rents fichiers et indiquer a la place de newMandantSedexld le m me idendifiant Sedex que dans l tape 1 INSERT INTO configuration VALUES config location 1C smelientbase config newMandant config properties newMandantSedexId select id from domain where name like smclient INSERT INTO configuration VALUES message handler location C smclientbase config_ newMandant message handler properties newMandantSedexId select id from domain where name like smclient INSERT INTO configuration VETUE SEC posttor election yn Gry et EE NewMandantry ce pository properties n
99. r des virgules Par d faut unread important Exemple filterfolders read unread important print message smaller Optionnel Les messages qui au format XML sont plus grand que cette valeur en Ko ne seront pas imprim s Valeur par d faut 2048 validate recipients message types Types de messages s par s par une virgule dont le recipientld doit tre v rifi s Chaque message appartenant au m me message group doit ainsi avoir le m me recipientld Par d faut tout les types de messages sont v rifi s pas de valeur Pour d sactiver ce contr le utiliser une valeur vide telle validate recipients message types should wait for envelope Si ce param tre est activ le sM client ne traitera les messages qu une fois l envelope sedex disponible par d faut inactif Limitations lors de la sauvegarde La fonction de backup int gr du sM Client n est pr vue que pour des petites quantit s de messages lt 10000 entr es dans la table Message autrement il est recommand d utiliser une solution de backup externe par example mysql dump Limitations lors de la sauvegarde avec plusieurs mandants e Il est possible de faire une sauvegarde simple de la base de donn e BD sans les processus avec les fichiers ainsi qu une sauvegarde compl te de la base BD avec les processus La restauration de la sauvegarde peut se faire par l administrateur correspondant au mandant
100. re d comprim l aide de Win Zip ou autres programmes similaires Il faut t l charger le fichier correct pour Tomcat et il faut change le nom du fichier en smclient war Ensuit le fichier WAR doit tre copi dans le dossier CATALINA HOME webapps Finalement on doit d marrer l application MySQL puis le serveur Tomcat Configurations des Logs La configuration des Logs est requise pour le support et est d crite dans le chapitre 4 2 4 1 1 Log 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 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 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 dossiers et les pourvoir des droits d criture et de lecture pour le client sM e Entr e message o Sous dossier pour chaque applica
101. rimer Cliquez sur Modifier pour modifier la valeur de la variable avec le nom Path Ajoutez la fin du champ valeur Variable value un point virgule puis le chemin du r pertoire bin de Ghostscript Par exemple C Program Files gs gs9 04 bin 8 Pour v rifier ouvrez une fen tre de commande D marrer gt Ex cuter cmd puis entrez la commande gswin32 dil Une fen tre de commande ghostscript doit s ouvrir Red marrer le sM Client Linux Installer le paquet ghostscript par exemple apt get install ghostscipt ou regarder les instructions d installations sur http www ghostscript com download gsdnid html 4 2 2 8 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 lt xml version 1 0 encoding UTE 8 gt lt triage xmlns xsi http www w3 0rg 2001 XMLSchema instance xsi noNamespaceSchemaLocation rules xsd gt lt rule gt GIE ES lt messageType gt 2003 lt messageType gt lt messageSubType gt 000101 lt messageSubType gt lt messageAction gt 1 lt messageAction gt Jeri ter a gt lt destinationFoldersct smclientbase interface inbox applicati on lt destinationFolder gt lt PDFGeneration boolean false pdfSplitting false gt lt useCase gt receive lt useCase gt lt rule gt lt rule gt lt criteria gt lt messageType gt 2015 lt messageType gt lt messageSubType gt 000101 lt
102. rin g lt destinationFolder gt lt useCase gt receive lt useCase gt lt rule gt 4 2 3 2 BSV Exemple de r gle pour les messages de monitoring BSV rules xml Pri re de modifier le destinationFolder selon votre installation locale et de cr er le r pertoire correspondant lt Siehe Kapitel 4 2 2 7 f r die komplette Konfiguration gt lt rule gt lt criteria gt lt messageType gt 2991 lt messageType gt lt cite gt lt destinationFolder gt C smclientbase interface inbox monitorin g lt destinationFolder gt lt useCase gt receive lt useCase gt lt rule gt 4 2 4 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 1 1 Log On peut configurer le log comme suit JAVA OPTS Dlog4j configuration file C smclientbase config log config Pour EAP6 Attention il ny a pas d espace entre und D dans la lighe suivante JAVA OPTS Dorg jboss as logging per deployment false Dlog4j configuration file C SedexGatewayProg AK config 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 log4j rootCategory INFO console R log4j appender console
103. rties pour la validation pour un type de message particulier true false Balise script La balise script comprent les attributs suivants Nom Description path Chemin absolu du script a ex cuter noPdfGeneration Optionnel false par d faut indique si le script n a pas besoin du fichier PDF Par d faut le fichier PDF est g n r process Optionnel receive par d faut indique si le script doit tre ex cut durant le processus de r ception d envoi ou les deux receive send both La balise script comprend ensuite 0 n l ments args les valeurs de tous ces l ments sont transmises au script Balise args Correspond un argument du script Pour plus de d tails concernant les arguments du script reportez vous la documentation fournie avec celui ci Balise export pdf splitting Red finit la valeur de message handler properties La balise export pdf splitting d finit si l exportation d un message group doit cr er plusieurs fichiers PDF un par message interne du message group ou un seul fichier PDF True L exportation du message group cr e un fichier PDF par message interne False L exportation du message group cr e un seul fichier PDF Groovy Script Le script doit impl menter l interface ch admin smclient service script GroovyScriptController Cette interface ne d finit qu une m thode String process ch admin smclient model Message msg File x
104. se config message handler properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES repository location C smclientbase config repository properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES formservice location C smclientbase config formservice properties yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES rules location C smclientbase config rules xml yourSedexId select id from domain where name like smclient INSERT INTO configuration VALUES timeout time 30 vourSedexId Les valeurs doivent correspondre a l installation client sM respective 6 Cr er le tableau smRole selon proc dure ci dessous EATE TABLE smRole id NUMBER 37 NOT NULL name VARCHAR 255 description VARCHAR 255 PRIMARY KEY id 7 Saisie des valeurs dans tableau smRole selon proc dure ci dessous ERT INTO smRole id name description values 1 Admin Minaistrator ERT INTO smRole id name description values 2 ActiveUser ive User Sender ERT INTO smRole id name description ues 3 PassiveUser Passive User Receiver ERT INTO smRole id name description values 3 SuperUser Super User 8 Cr er le tableau smUs
105. t lt rule gt lt criteria gt lt messageType gt elm lt messageType gt lt messageSubType gt qst lt messageSubType gt lt Criteria gt lt destinationFolder gt C smclientbase interface inbox elm lt dest inationFolder gt lt useCase gt receive lt useCase gt lt rule gt lt triage gt 4 9 Configuration sM Client Queue Pour la communication entre sM Client Core et sM Client Queue il faut effectuer la configuration suivante Les ports JMS JMX et RMI doivent tre configur s manuellement dans le fichier run bat run sh respectivement pour windows ou linux Voir aussi l assistant d installation Il est important que les ports JMS et JMX soient configur s de mani re identique entre sM Client Core et sM Client Queue Les sp cifications de m moires peuvent aussi tre r duites dans ce fichier de 1Go a 256Mo Les lignes suivantes sont a chang s SERRE SR RU TERZEROE E pore LOO EE EE Dcom sun management jmxremote port 3000 Dcom sun management jmxremote ssl false Dcom sun management jmxremote authenticate false Dcom sun management jmxremote local only true XX UseParallelGC XX AggressiveOpts XX UseFastAccessorMethods Xms256M Xmx256M picci one NE e Djeva util logging contig fvle CONEIG DIR logging properties gt Djava library path Dans cet example les ports et la m moire sont d finis de la mani re suivante e JMS Port 1100 e JMX Port 3000 sM Client Projekt Version
106. t 2012 von Cambridge Technology Partners 2014 94 95 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 Office Center 1 Postfach 89 CH 8058 Zurich Flughafen T l 41 0 43 456 2300 Fax 41 0 43 456 2301 Basel Henric Petri Strasse 6 CH 4051 Basel Tel 41 0 61 271 9140
107. t sM traite en une fois Par d faut 50 should message be validated Les messages doivent tre valid s selon le sch ma XML Voir aussi 4 2 2 6 balise message validation 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 backup fullDB enabled D finit s il faut faire un vidage complet de la banque de donn es lors de la sauvegarde On peut employer celui ci pour une restauration manuelle compl te Remarque Lors de la sauvegarde avec plusieurs mandants il faut prendre en compte les limitations list es ci dessous backupBatch Lieu o le fichier MySQLSmClientBackup bat pour Windows resp MySQLSmClientBackup sh pour Linux Dans le cas d une installation manuelle le fichier doit tre copi ici par l installateur inbox enabled D finit si l Inbox est active formservice enabled D finit si le service formulaires est actif LDAP enabled D finit si LDAP doit tre utilis pour la gestion des utilisateurs Si ceci est r gl sur true les configurations d crites au chapitre 4 2 5 doivent tre en outre faites filterfolders Optionnel Liste de filtres appliqu e l Inbox s par s pa
108. t sM sont en option et il ne faut y proc der qu en cas de besoin 4 2 4 2 1 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 2 2 Permettre l acc s Jboss en dehors de la machine locale Pour ce faire l adresse Bind doit tre modifi e Cela peut se faire de deux mani res Si vous d marrez le serveur manuellement run sh Linux resp run bat Windows peut tre d marr avec l argument b 0 0 0 0 p ex gt run bat b 0 0 0 0 S vous souhaitez toujours d marrer le serveur de cette mani re vous pouvez adapter l adresse dans JBoss_Home server default deploy jbossweb sar server xml lt Connector port 8080 address 0 0 0 0 maxThreads 250 maxHttpHeaderSize 81 92 emptySessionPath true protocol HTTP 1 1 enableLookups false redirectPort 8443 acceptCount 100 connectionTimeout 20000 disableUploadTimeout true gt Si l adresse Bind est sur 0 0 0 0 le serveur saisit tous les IP par lesquels la machine est appel e S il ne doit saisir qu un IP sp cifique celui ci peut tre configur 4 2 4 2 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 j
109. tailed tarled to send failed to transmit means that in the send the sedex client could not transmit the message tated transmin ocd onto ie tale geo transmit configuration of swissdec adapter working directory of swissdec adapter all directories below are relative to base directory base dir adapter C smclientbase adapterSwissdec base dir adapter VBOXSVR Temp directory for incoming messages adapter inbox location inbox otrectorv for technical receipts adapter receipt location adapter receipts directory for outgoing messages adapter outbox location outbox specific for swissdecadapter and ELM domain adapter failed receive failed adapter sent location sent depresse dota sith OCamVon ta Mle io tian mere configuration of sedex adapter base directory is taken from base dir adapter message handler properties smclient domain used for forwarding to commune directory for outgoing messages sedex adapter outbox location outbox onthe dem ali La table suivante d crit la correspondance entre la configuration du sM Client et du sdA sM Client Message handler elm properties Swissdec Adapter swissdecAdapter properties Dans le sM Client les r pertoires ci dessous sont relatifs a relativ zu base dir adapter sdA requiert des chemins absolus dans sa configuration adapter inbox location PATH_ELM_ IN released filesystem parent x
110. tance MySQL soit d j install e ou soit m me en cours Ne pas mettre de mot de passe pour MySQL Root Aucun raccourci n est g n r 6 VERIFICATION 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 6 1 Appel de la page de version On peut appeler la page de version du client sM a 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 suivi par une liste des fichiers de configuration d s la version 3 0 sM Client Projekt Version finale Installations Handbuch V rification de l Installation Se connecter SAA CILIENT Aide Version Page Current version of sM Client Release 3 0 0RC1 DATABASE PROPERTIES T6 900014 3 ctp mandant 1 Database properties OK CONFIGURATION FILES Property version is missing in var opt smclienti conf repository properties There are errors in configuration please check you configuration files repository properties lablage base dir var opt smclientl repos
111. tion m tier triage o Sous dossier pour la case postale e Sortie message o Sous dossiers pour chaque application m tier triage e Messages envoy s o Sous dossiers pour chaque application m tier triage e Messages ayant chou 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 Le stockage est est mis a disposition sur notre site web http sm client ctp consulting com Produktive Ablage ou Test Ablage pour les instances de test sedexID commengant par T et doit tre copi a l endroit correspondant d fini dans repository properties p ex C smclientbase interface repository 4 2 2 Configuration technique Vous trouverez la liste
112. tre galement cr s et remplis avec les valeurs correspondantes Il faut pour cela ex cuter le script ci apr s Mysql gt CREATE TABLE smRole E in ENEE Eet in Active User Sender in Passive User Receiver id BIGINT NOT NULL AUTO INCREMENT name VARCHAR 255 last ten tement SEELEN PRIMARY KEY id sert into smRole name description values Admin sert into smRole name description values ActiveUser de re sert into smRole name description values PassiveUser INSERT INTO smRole name description values SuperUser Super User CREATE TABLE smUser bs id BIGINT NOT NULL AUTO INCREMENT username VARCHAR 255 password VARCHAR 255 firstname VARCHAR 255 lastname VARCHAR 255 defaultLanguage VARCHAR 255 sedexId VARCHAR 255 PRIMARY KEY id insert into smUser username password firstname lastname defaultLanguage sedexId values Admin va 6 tAEewgFn0 t009ADB50 administrator administrator fa yOoursedexla i insert into smUser username password firstname lastname defaultLanguage sedexId values SuperUser 2atHgjIcy5hGeeRwzYt tmhQ Super User tie null CREATE TABLE smUser smRole SmUSe ri ICONTANO TANT DE EENEG ingert inco amuser smole smUser ic role ich valuss select ic from smUser where username Admin select id from smRole wher
113. uite m moriser le fichier dans le dossier JBoss Home lib endorsed Configuration de la m moire vive Afin d assurer un fonctionnement sans incidents il faut r gler le MaxPermSize sur 512Mo et la m moire principale maximale sur 1024Mo Il s agit des exigences minimales pour une installation simple 2048Mo si une grande quantit de messages est attendues Veuillez vous r f rer au manuel d expoitation pour les exigences d une installation pour plusieurs mandants domaines et ou utilisateurs 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 C smclientbase jboss 4 2 3 GA bin run bat Il faut pour cela modifier la ligne par Xms512m Xmx1024m XX MaxPermSize 512m set JAVA OPTS JAVA OPTS Xms512m Xmx1024m XX MaxPermSize 512m Pour Windows il est recommand d utiliser les m me valeurs pour MinHeapSize et MaxHeapSize pour viter le swapping de m moire par example set JAVA OPTS JAVA OPTS Xms1024m Xmx1024m XX MaxPermSize 512m Lors l utilisation de plusieurs mandants il faut allouer plus de m moire de mani re correspondante Voir aussi le manuel d expoitation chapitre 2 2 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 charge
114. y for one message Eype subtype gt 2 lt message type 2003 subType 000101 gt lt message validation gt false lt message validation gt lt script path src test resources test exception groovy noPdfGeneration true process receive gt 3 lt args gt EXCEPTION lt args gt lt args gt arg2 lt args gt erdipe lt script path src test resources test send groovy noPdfGeneration true process send gt 3 lt args gt default lt args gt Laros Conr ig argS gt det lt cspore pdi spilitet ing rale Expor e par Sp ire lt message gt lt processes gt Le script peut tre configur pour tous les messages 1 ou alors pour un type de message particulier 2 Seul un script par message est appliqu le sM Client recherche le script dans l ordre suivant jusqu trouver une correspondance 1 Pour le type et le sous type comme au point 2 ci dessus Dans cet exemple la validation est d sactiv pour les messages 2003 000101 2 Pour le type 3 Pour tout les messages comme au point 1 ci dessus 4 Pour le processus de r ception ou d envoi 3 Balise message La balise message comprend les attributs suivants Nom Description type Type de message sedex par example 2003 subT ype Optionnel Sous type de message selon le standard du sM Client par example 000101 Balise message validation Cette balise permet de changer la valeur d fini dans config prope

sM-Client Projekt

Contents

Download Pdf Manuals

Related Search

Related Contents