W4 Connectors for Java - Manuel d`utilisation
Contents
1. W4 error occured Wrong actor or password Unable to login to W4 server OB N H Arr t et relance Le serveur de connecteurs peut actuellement tre arr t de trois mani res lorsque l on stoppe W4 Engine et que le serveur de connecteurs a t lanc initialement par W4 Engine c est dire que le param tre lt instance gt jconnector est positionn true en cliquant sur les boutons Normal Shutdown ou Shutdown Now dans le moniteur des connecteurs en ligne de commande via un appel au programme TWFconnectorClient avec les commandes shutdown OU shutdownNow Le serveur de connecteurs peut tre d marr de deux mani res lorsque l on d marre W4 Engine et que le param tre lt instance gt j connector est positionn true en ligne de commande via un appel au script manageServer bat shavec la commande start IMPORTANT L appel cette commande ne peut fonctionner que si le moteur W4 Engine a t d marr au moins une fois avec le param tre lt instance gt attachJVM positionn true dans le fichier mess En effet cela provoque la g n ration d un fichier indispensable au d marrage diff r du serveur de connecteurs 4 3 R cup ration des t ches perdues La r cup ration de t ches perdues peut prendre place dans un contexte tel que celui ci le moteur W4 Engine est d marr le serveur de connecteurs est d marr des t ches connecteurs sont r guli rement cr es et sont r a2. devez proc der ces op rations en utilisant le compte de w4adm Ce fichier permet de proc der une configuration plus fine du serveur En particulier il s agit des temps de lancement et d arr t Timeout to connect to w4 server default 30000 w4adm launch timeout 30000 Time to wait before each try to connect to w4 Engine default 1000 w4adm launch waittime 1000 Timeout to stop a connector default 10000 w4adm stop timeout 20000 Les param tres concernant le serveur de connecteurs sont les suivants w4adm launch timeout D lai total en ms pour se connecter au serveur W4 Engine d faut 30000 w4adm launch waittime Temps d attente en ms entre deux tentatives de connexion d faut 1000 w4adm stop timeout D lai en ms pour l arr t de chaque connecteur d faut 10000 m 17 Chapitre 3 Configuration 4 1 Gestion du serveur de connecteurs Ce chapitre d crit les outils et commandes n cessaires la gestion du serveur de connecteurs Le client TWFconnectorClient Un outil client a t ajout au package du serveur de connecteurs depuis sa version 5 0 Il s agit d un programme Java offrant principalement deux fonctionnalit s Possibilit s Les deux op rations r alisables par le TWFconnectorClient sont l arr t du serveur de connecteurs la r cup ration de t ches perdues apr s un arr t du serveur de connecteurs La syntaxe du programme TWFconnectorClient peut tre ob
3. fonctionnement W4 Connectors for Java Manuel d utilisation 6 12 Lorsqu une t che est cr e le scheduler service gestionnaire des t ches et des dossiers v rifie que cette t che n est pas destin e un acteur ayant le r le j connector Si ce test est vrai il envoie un message via socket IP au serveur de connecteurs Ce message contient l identifiant de la t che cr e celui de l acteur concern ses r les et ventuellement l adresse d un fichier g n r partir du template de l activit Le message est transmis au dispatcher du serveur de connecteurs Le dispatcher envoie le message vers les connecteurs en fonction de leurs r les Le dispatcher envoie ensuite le message aux connecteurs en deux phases Dans un premier temps il interroge chaque connecteur afin de savoir s il souhaite traiter ce message Cela se traduit concr tement par l appel de la m thode acceptMessage de chaque connecteur A charge chaque connecteur d explorer le message TWFmessage afin de d cider s il souhaite le traiter l usage veut qu un connecteur se base sur les r les contenus dans le message pour d cider de l accepter ou non Dans un deuxi me temps le dispatcher envoie une COPIE du message chaque connecteur qui a pr c demment d cid de l accepter Ainsi rien n emp che un m me message d tre trait par plusieurs connecteurs la fois pour peu que chacun l ait accept lors de la premi re phase Toutefois ce type de be
4. java_home param tre d instance W4 Engine 15 java_other_param param tre d instance W4 Engine 15 java_sleepTime param tre d instance W4 Engine 15 java_xms param tre d instance W4 Engine 15 java_xmx param tre d instance W4 Engine 15 java_xnoclassgc param tre d instance W4 Engine 15 jconnector_port param tre d instance W4 Engine 15 jconnector param tre d instance W4 Engine 15 16 20 JDK 10 11 JRE 10 11 W4 Connectors for Java Manuel d utilisation 32 33 Index launch timeout param tre d instance W4 Engine 16 launch waittime param tre d instance W4 Engine 16 LD_LIBRARY_PATH 19 LIBPATH 19 listener W4 Java Connectors 24 monitor bat W4 Java Connectors 22 Normal shutdown W4 Java Connectors 20 Normal shutdown W4 Java Connectors 24 PATH 19 peeker delay param tre W4 Java Connectors 28 peeker enabled param tre W4 Java Connectors 28 Pickup W4 Java Connectors 26 R pertoire pickup W4 Java Connectors 26 R le jconnector 7 11 12 21 R le XMLConnector 11 12 R le xmlConnector 28 Service scheduler W4 Engine 7 Shutdown now W4 Java Connectors 20 25 SocketServer W4 Java Connectors 7 stop timeout param tre d instance W4 Engine 16 Traces W4 Java Connectors 15 22 TWFconnectorClient W4 Java Connectors 18 20 21 TWFdispatcher W4 Java Connectors 7 Variable d environnement PATH 10 W4 Java Connectors r cup ration de t ches perdues 18 W4 Java Connectors arr t 18 19 20 W
5. pr alables IMPORTANT L installation du serveur de connecteurs doit s effectuer directement sur le serveur W4 Engine IMPORTANT Pour pouvoir lancer le programme d installation du serveur de connecteurs vous devez avoir install au pr alable un JDK ou un JRE de version 1 2 x ou ult rieure Ces produits sont disponibles aupr s de Sun Microsystems Une fois le JDK ou JRE install vous devez mettre a jour la variable d environnement PATH de telle sorte qu elle pointe sur JAVA_HOME bin ou JAVA_HOME repr sente le r pertoire d installation du JDK ou JRE IMPORTANT _ Utilisation sur IBM AIX Sur IBM AIX le JDK 1 2 x pr sente des dysfonctionnements Vous devez par cons quent utiliser une version 1 3 x ou ult rieure Or le JDK 1 3 x n cessite la version 4 3 3 ou ult rieure de IBM AIX 22 Installation IMPORTANT _ Sous Unix vous devez proc der ces op rations en utilisant le compte de w4adm Pour lancer le programme d installation ouvrez un shell 2 2 2 2 2 3 2 2 4 Placez vous dans le r pertoire du CD ROM contenant le serveur de connecteur r pertoire Setup connserv java contenant le fichier instal11Cs jar Lancez la commande suivante sous Windows install bat Lancez la commande suivante sous UNIX install sh NOTE Surles syst mes UNIX en cas de probl me de lecture d au type de syst me de fichiers choisi lors du montage du CD ROM une alternative consiste copier le fichier instal1Cs tar
6. sur le disque dur local cette archive contient une copie de tous les fichiers n cessaires l installation V rifier la version du JDK ou JRE Cette tape est transparente si la version du JDK ou JRE install e est bien gale ou sup rieure la 1 2 x Dans le cas contraire un message d erreur est lanc et l installation se termine Sp cifier le r pertoire W4Engine_Home Le programme d installation demande le r pertoire dans lequel W4 Engine est install Exemple C Program Files w4 S lectionner l instance W4 Engine d installation Le programme d installation demande sur quelle instance de W4 Engine le serveur de connecteurs doit tre install Vous pouvez s lectionner plusieurs instances S lectionner le type d installation NOTE Le programme d installation se compose de 3 tapes ind pendantes les unes des autres Si une erreur survient pendant l installation il est possible de relancer le programme d installation en ne s lectionnant que les tapes rejouer Les l ments suivants peuvent tre install s les fichiers concernant le serveur de connecteurs la cr ation de la langue XML de l acteur XMLAgent et des r les jconnector et XMLConnector 4 22 8 2 2 6 2 3 la mise jour du fichier de configuration du serveur W4 Engine W4Engine Home sys w4server cfg Cr er la langue XML l acteur XMLAgent les r les jconnector et XMLConnector Les connecteurs sont avant tout des acteu
7. 4 Java Connectors arr t imm diat 19 W4 Java Connectors classpath JAVA 15 W4 Java Connectors client TWFconnectorClient 18 W4 Java Connectors configuration 14 W4 Java Connectors connecteur XML 26 W4 Java Connectors console 22 W4 Java Connectors d lai d attente W4 Engine 15 W4 Java Connectors d marrage automatique 15 W4 Java Connectors d marrage ind pendant de W4 Engine 15 W4 Java Connectors fichiers journaux 22 W4 Java Connectors installation 10 W4 Java Connectors moniteur 20 22 W4 Java Connectors monitor bat 22 W4 Java Connectors monitor sh 22 W4 Java Connectors param tres pour la ligne de commande JAVA 15 W4 Java Connectors port de communication 15 W4 Java Connectors principe de fonctionnement 6 W4 Java Connectors programme TWFconnectorClient 20 21 W4 Java Connectors ramasse miettes JVM 15 W4 Java Connectors r cup ration des taches perdues 19 21 W4 Java Connectors relance 20 W4 Java Connectors taille maximale du heap 15 W4 Java Connectors taille minimale du heap 15 W4_ADM_DIR 20 w4 actor parametre W4 Java Connectors 28 w4 role param tre W4 Java Connectors 28 wfilib jar 20 XML langue W4 Java Connectors 11 12 XMLAgent acteur W4 Java Connectors 11 12 xmlAgent acteur W4 Java Connectors 27 XMLAgent W4 Java Connectors 7 xmlAgent W4 Java Connectors 24 xmlConnector properties 27 W4 Connectors for Java Manuel d utilisation 34 35 Index W4 CONNECTORS FOR JAVA MANU
8. EL D UTILISATION R f rence W4JC_USER_022 FR Pour toute remarque ou suggestion concernant ce document vous pouvez contacter le support technique W4 en pr cisant la r f rence du document par le service de traitement des dossiers Supportflow sur MyW4 com l adresse suivante http support myw4 com Par courrier lectronique support w4global com Par t l phone 33 0 820 320 762
9. Le programme d installation copie les fichiers suivants dans le r pertoire W4Engine_Home Sous le r pertoire connector java policy autorise le serveur de connecteurs et le moniteur ouvrir une socket manageServer bat permet l arr t relance du serveur de connecteurs manageServer sh version Unix monitor bat lance le moniteur du serveur de connecteurs monitor sh version Unix recoverTasks bat rejoue les t ches perdues du serveur de connecteurs recoverTasks sh version Unix r pertoire connector 1ib contient les librairies java n cessaires au fonctionnement du serveur de connecteurs parser jar jaxp jar saxon jar xalan jar xerces jar r pertoire connector 1lib int contient les connecteurs internes connector jar le kernel du serveur de connecteurs wfsocserver jar le listener r pertoire connector 1lib ext les connecteurs externes xmlConnector jar le connecteur XML r pertoire connector 1lib resources les fichiers de configuration connector properties le fichier de configuration du serveur de connecteurs xmlConnector properties le fichier de configuration du connecteur XML r pertoire connector xml le connecteur xml pickup les fichiers plac s dans ce r pertoire sont automatiquement analys s error r pertoire o sont d plac s les fichiers XML erron s qui ont plac s dans le pickup xs1 r pertoire contenant les feuilles de style associ es aux acteurs W4 r pertoir
10. State Total requests Running requests Errors encountered myConnector true 0 0 0 xmiAgent true a 0 0 TWwFdispatcher true 0 0 0 isocketServer true 1 0 0 Fig 5 2 Informations fournies par la console Pour chaque connecteur on obtient les informations suivantes son tat le nombre de messages trait s le nombre de messages en cours d ex cution le nombre d exceptions rencontr es Un connecteur qui n y figure plus a probablement t d truit par le serveur pour une op ration non conforme 525 Arr t du serveur IMPORTANT Aex cuteraucas ou le serveur W4 Engine n a pas r ussi arr ter le serveur de connecteurs Il y a deux mani res d arr ter le serveur de connecteurs avec la console Normal shutdown Le serveur de connecteurs va arr ter les connecteurs normalement a Shutdown now Le serveur de connecteurs s arr te sans tenir compte de l activit des connecteurs 4 6 1 6 2 Connecteur XML Ce chapitre d crit l utilisation du connecteur XML Ce connecteur est install par d faut avec le serveur de connecteurs Condition pr alable conna tre les API XML de W4 Pour tre en mesure d utiliser le connecteur XML il est n cessaire de conna tre les API XML de W4 Ces API sont d crites dans le Java Toolkit de W4 si vous utilisez un serveur W4 Engine ant rieur la version 03 00 00 ou dans le r pertoire WaEngine Home Docs fr java si vous utilisez un serveur W4 Engine dont la version
11. W4 CONNECTORS FOR JAVA Les prochaines mises jour de ce document seront disponibles sur www myw4 com W4 CONNECTORS FOR JAVA MANUEL D UTILISATION R f rence W4JC_USER_022 FR 2003 2010 W4 Tous droits r serv s L acquisition du pr sent document conf re un droit d utilisation incessible non exclusif et personnel et non un droit de propri t L utilisation la copie la reproduction et la distribution du pr sent document sont permises condition 1 que la mention de droits d auteur ci dessus figure sur toutes les copies et que cette mention de droits d auteur et la pr sente mention d autorisation apparaissent conjointement 2 que le pr sent document ne soit utilis qu des fins d information et non commerciales 3 que le pr sent document ne soit modifi de quelque mani re que ce soit Tous les produits et marques cit s sont la propri t de leurs titulaires respectifs Les informations contenues dans ce document pourront faire l objet de modifications sans pr avis Sommaire Vue d ensemble Principe de fonctionnement 6 Structure interne 7 Installation 10 Conditions pr alables 10 Installation 10 V rifier la version du JDK ou JRE 11 Sp cifier le r pertoire W4Engine_Home 11 S lectionner l instance W4 Engine d installation 17 S lectionner le type d installation 11 Cr er la langue XML l acteur XMLAgent les r les jconnector et XMLConnector 1 Mise jour du fichier de configuration
12. age collection w4adm java_xnoclassgc true W4 Connectors for Java Manuel d utilisation 14 Define minimum heap size w4adm java_xms 10m Define maximum heap size w4adm java xmx 100m W4 Engine timeout in seconds when waiting for connector server launch w4adm java sleepTime 30 Uncomment this line to activate the trace mod w4adm java_other param DWFTRACE ttall JAVA CONNECTOR PARAMETERS END Les param tres concernant le serveur de connecteurs sont les suivants w4adm attachJVM si true signifie que le serveur de connecteurs doit pouvoir tre lanc s par ment de W4 Engine Un fichier lt instance gt runSrv bat sera donc g n r par W4 Engine dans le r pertoire de journalisation de l instance concern e Ce dernier est construit partir des informations contenues dans w4server cfg ce qui signifie que s il doit tre r g n r apr s modification de la configuration W4 Engine devra tre red marr w4adm jconnector si true le serveur de connecteurs sera d marr automatiquement a chaque d marrage de W4 Engine et arr t a chaque arr t de W4 Engine w4adm jconnector port le port sur lequel la socket IP de communication est ouverte Valeur par d faut 7777 w4adm java_home chemin vers le JAVA_HOME En cas d utilisation d un JDK JRE 1 4 x un autre param tre doit tre ajout voir ci dessous w4adm java_classpath sp cifie le classpath JAVA qui sera utilis p
13. ar le serveur de connecteurs Ainsi si l on souhaite utiliser une librairie suppl mentaire pour l un des connecteurs on l ajoutera ici w4adm java_xnoclassgc true d sactive le ramasse miettes JVM false active le ramasse miettes JVM Valeur par d faut w4adm java_xms taille minimale du heap w4adm java_xmx taille maximale du heap w4adm java_sleepTime dur e en secondes durant laquelle W4 Engine attend le d marrage du serveur de connecteurs avant de le d clarer en timeout Valeur pas d faut 30 w4adm java_other param param tres additionnels qui seront ajout s a la ligne de commande JAVA On y trouvera en g n ral des param tres de JVM du type Dparam value Dans le fichier w4server cfg par d faut on peut trouver plusieurs exemplaires de cette ligne pour des usages divers sous forme de commentaires Si ce param tre figure plusieurs fois dans le fichier de configuration seule la derni re valeur sera prise en compte Il ne peut donc y en avoir qu une a un instant donn Il conviendra alors de concat ner ventuellement les valeurs sur un m me exemplaire de ce param tre IMPORTANT Nepas activer les traces en production 14 lt r lt 2 IMPORTANT Siles deux param tres jconnector et attachJVM valent false le serveur de connecteurs sera consid r comme non utilis par W4 Engine qui ne lui enverra aucune notification Fichier connector lib resources connector properties IMPORTANT _ Sous Unix vous
14. cher connecteur r partissant les notifications en provenance de W4 Engine vers les connecteurs suivant les crit res d finis dans la mod lisation de l activit concern e W4 XMLAgent connecteur XML interpr tant l API XML W4 Pour de plus amples informations veuillez consulter le chapitre suivant 6 Connecteur XML page 26 Si pour une quelconque raison un connecteur ne s initialise pas correctement par exemple s il fait appel une librairie externe qui n est pas trouv e ou rencontre un crash important durant son fonctionnement une librairie manquante ou une exception Java non trait e par le connecteur il sera d sactiv par le serveur de connecteurs mais les autres connecteurs continueront fonctionner Lorsque le dernier connecteur est d sactiv le serveur de connecteurs s arr te Ainsi lorsque W4 Engine cr e une t che destin e un connecteur une notification est envoy e au serveur de connecteurs Dans l hypoth se o le serveur de connecteurs ne serait pas lanc cet instant la t che resterait offerte et la notification ne serait pas relanc e ult rieurement par W4 Engine Il conviendra alors de relancer la notification manuellement Pour de plus amples informations veuillez consulter le chapitre suivant 4 3 R cup ration des t ches perdues page 21 9 Chapitre 1 Vue d ensemble Installation Ce chapitre d crit la proc dure d installation du serveur de connecteurs 21 Conditions
15. de W4 Engine sys w4server cfg 12 Journal de l installation 12 Fichiers cr s lors de l installation 73 Configuration Fichier sys w4server cfg 14 Fichier connector lib resources connector properties 16 W4 Connectors for Java Manuel d utilisation 4 Gestion du serveur de connecteurs s Le client TWFconnectorClient 18 Possibilit s 18 Pr alables 19 Codes d erreur 20 Arr t et relance 20 R cup ration des taches perdues 21 Monitoring du serveur de connecteurs gt Les journaux et traces 22 La console monitor bat ou monitor sh 22 Installation de la console sur un autre poste que le serveur W4 Engine 22 Lancement de la console 23 Configuration de la console 23 Informations fournies par la console 24 Arr t du serveur 24 Connecteur XML zs Condition pr alable conna tre les API XML de W4 26 Fonctionnalit s du connecteur XML 26 Arborescence 27 Configuration du connecteur XML 27 Utilisation des feuilles de styles XSL 28 5 Sommaire Chapitre 1 Vue d ensemble Ce chapitre d crit le fonctionnement du serveur de connecteurs Java Le serveur de connecteurs est livr avec un kit de d veloppement pour cr er de nouveaux connecteurs package java connector jar et avec le connecteur XML package java xmlConnector jar Principe de fonctionnement Le sch ma ci dessous d crit l int gration entre le serveur W4 Engine et le serveur de connecteurs We SG OIT CTO 17 ICIN CET Fig 1 1 Principe de
16. de recover se connecte W4 Engine en utilisant l API Java Il convient donc de configurer un environnement client E Les librairies W4 dll ou so doivent tre accessibles c est dire dans la variable d environnement PATH sous Windows LD_LIBRARY_PATH sous Solaris ou Linux LIBPATH sous AIX ou encore simplement sp cifi es a la commande j ava elle m me via le param tre Djava library path lt paths gt Chapitre 4 Gestion du serveur de connecteurs ua 4 2 Les librairies Java connector jaretwfjlib jar doivent tre disponibles dans le classpath de la commande j ava Dans le cas o le moteur cibl est en mode installation cloisonn e et que l on tente d y acc der en mode de communication local c est dire que l on ne sp cifie pas l option w4Server il convient de configurer la variable d environnement W4_ADM DIR de la mani re ad quate Codes d erreur Help Critical error occurred Unable to connect to W4 connector server Missing or wrong argument See help Unable to guess port from file lt instance name gt runSrv bat Check file or use port option 6 Unable to find file lt instance name gt runSrv bat in given log directory Check file and path or use port option 20 W4 error occurred unable to connect to W4 server Check server and instance Is W4 server running 21 W4 error occurred Given W4 actor has insufficient privileges Check that actor is able to reassign tasks 22
17. e le XML automatiquement cr e lors de l installation du serveur de connecteurs son mot de passe xmlAgent Comme tous les connecteurs le connecteur XML a le r le jconnector Il se voit galement assigner le r le xmlConnector qui lui est sp cifique Ses r les sont automatiquement cr s lors de l installation du serveur de connecteurs Configuration du connecteur XML pour l instance w4adm Cette configuration s effectue dans le fichier connector lib resources xmlConnector properties login of the w4 s actor w4adm w4 actor xmlAgent 1 59 ra V Zo 6 5 name of w4 s role w4adm w4 role xmlConnector enable or disable the xml peeker w4adm peeker enabled fals the peeker s delay milliseconds w4adm peeker delay 10000 pickup error xsl directories default is W4 HOME connector xml pickup error xsl w4adm pickUpDir C data w4adm pickup w4adm errorDir C data w4adm error w4adm xs1Dir C data w4adm xsl Les param tres w4adm w4 actor et w4adm w4 role s appuient sur la d finition de l acteur et des r les voqu s ci dessous w4adm w4 actor doit contenir le nom de l acteur affect au connecteur XML Si vous le modifiez il faudra galement modifier la d finition de l acteur xmlAgent dans l interface d administration de W4 accessible http SERVER_NAME W4Public Il en va de m me pour le r le xmlConnector Les param tres w4adm peeker enabled et w4adm peeker delay s appliquent la gestio
18. e connector docs la documentation 4 Configuration Ce chapitre d crit les param tres de configuration du serveur de connecteurs 31 Fichier sys w4server cfg w4adm w4adm w4adm w4adm w4adm D123D972E w4adm lockingDelay minute 1 w4adm in da da da li stanceHome c w4 tabaseServer vodka8i tabaseOwner w4 tabasePassword 7ieh censeKey 391FA756D1CD5B8244824049D82E T N E285853F3E12A462 Ma JAVA C tru w4adm tru w4adm W4 w4adm w4adm w4adm tru e sat e JC Con Je xPendingConnections 25 ONNECTOR PARAMETERS Generate lt instanceName gt runSrv bat in lt logDir gt when W4 Engine starts This file is used by start stop script manageServer sh and by recoverTasks sh tachJVM true Launch W4 connector server when W4 Engine starts onnector true nector server port onnector port 7777 Directory containing java binary java_home C Progra l Java j2re1 4 1 01 Directory containing W4 connector java packages java classpath C Program Files w4 connector lib saxon jar C Program Files w4 connector lib jaxp jar C Program Files w4 connector lib parser jar C Program Files w4 lib java wfjlib jar C Program Files w4 connector lib xalan jar C Program Files w4 connector lib xerces jar C Program Files w4 connector lib C Program Files w4 connector lib int connector jar e Disables the class garb
19. est sup rieure ou gale la 03 00 00 Fonctionnalit s du connecteur XML Le connecteur XML assure les fonctionnalit s suivantes gestion d un r pertoire pickup possibilit de placer des fichiers XML dans le r pertoire pickup qui seront automatiquement interpr t s interpr tation de messages XML en provenance d autres connecteurs comme le connecteur MOM possibilit d associer un message XML une feuille de style XSL 6 3 6 4 Arborescence E 9 connector H lib H mai G xml C1 error C2 pickup C xsl Fig 6 1 Arborescence Le r pertoire du connecteur XML est par d faut W4Engine Home connector xml ll contient 3 r pertoires pickup r pertoire dans lequel il est possible de d poser des fichiers XML qui seront automatiquement interpr t s error le connecteur XML y d place les fichiers XML en provenance du r pertoire pickup lorsqu une erreur intervient pendant leur interpr tation xs1 contient les feuilles de style associ es aux acteurs Configuration du connecteur XML L acteur xmlAgent L acteur xmlAgent est utilis par le connecteur XML pour passer les ordres sur le serveur W4 Engine contenus dans les fichiers d pos s dans le r pertoire pickup NOTE L acteur xmlAgent est automatiquement cr lors de l installation du serveur de connecteurs Il n y a que 3 points retenir de la d finition de l acteur xmlAgent son nom de connexion xmlAgent sa langu
20. ils de supervision du serveur de conncteurs Les journaux et traces Ils sont plac s dans les m mes r pertoires que ceux du serveur W4 Engine c est a dire sur plate forme Windows W4Engine Home adm 1og et UNIX var adm w4 1og Ces fichiers suivent la convention de nommage suivante System loget System tra La console monitor bat ou monitor sh La console du serveur de connecteurs permet de consulter en temps r el l activit des connecteurs Installation de la console sur un autre poste que le serveur W4 Engine Copier le fichier WaEngine Home connector lib int connector jar sur le poste cible Mettre jour la variable d environnement CLASSPATH du poste cible de sorte que CLASSPATH CLASSPATH connector jar sur Windows OU CLASS PATH CLASSPATH connector jar sur Unix 52 2 5 23 Lancer la commande java fr w4 connector monitor TWFmonitor Lancement de la console Sur Windows lancer monitor bat Sur Unix lancer monitor sh v rifier si le script est ex cutable Ces 2 fichiers de commandes sont situ s dans le r pertoire W4Engine Home connector Configuration de la console Renseignez les champs suivants pour configurer la console ES l 1x 3 server name localhost server port 7777 refresh rate secs 30 Connector ID State _ _ Totalrequests Running requests Errors encountered Fig 5 1 Configuration de la console Dans le champ server name entre
21. lis es par les connecteurs le serveur de connecteurs est stopp pour une quelconque raison des t ches connecteurs continuent tre cr es mais les connecteurs ne peuvent les r aliser on red marre le serveur de connecteurs les t ches connecteurs sont nouveau trait es mais celles cr es dans l intervalle restent en l tat on appelle le TWFconnectorClient comme suit java fr w4 connector TWFconnectorClient v cmd recover port 7777 w4Admin w4adm w4Pass admpass w4Server Punch w4Instance w4prod On consid re que les pr alables en termes de librairies pr sent s ci dessus sont remplis Cet appel va se connecter au serveur de connecteurs sur le port 7777 et obtenir sa date exacte de d marrage se connecter au moteur W4 Engine Punch en mode RPC sur l instance w4prod avec l utilisateur w4adm et le mot de passe admpass rechercher tous les acteurs W4 poss dant le r le j connector rechercher pour chacun de ces acteurs toutes les t ches l tat actif offert en cours ou suspendu cr es avant le red marrage du serveur de connecteurs pour chaque t che trouv e la r assigner au m me acteur afin de lancer une nouvelle notification au serveur de connecteurs NOTE desacteurs sur lesquels restreindre l op ration peuvent tre nomm ment sp cifi s sur la ligne de commande via l option w4Actors a 5 1 52 ozs 1 Monitoring du serveur de connecteurs Ce chapitre d crit les out
22. n du r pertoire pickup du connecteur XML Le param tre w4adm peeker enabled peut avoir 2 valeurs possibles true ou false S il est positionn false le d mon v rifiant l arriv e de nouveaux fichiers XML dans le r pertoire pickup est d sactiv S il est positionn true le d mon v rifiera la pr sence de fichiers XML dans le r pertoire pickup toutes les m millisecondes m tant d fini par le param tre w4adm peeker delay Utilisation des feuilles de styles XSL Il est possible d associer au connecteur XML une feuille de styles qu il devra appliquer avant de traduire les flux XML Cette feuille de styles doit tre plac e dans le r pertoire W4Engine_Home connector xml xs1 Cette feuille de style doit respecter la convention de nommage suivante nomDeLActeurXML xsl Si vous avez conserv l acteur xmlAgent sa feuille de style doit tre appel e xmlAgent xs1 2 Chapitre 6 Connecteur XML Illustrations Principe de fonctionnement 6 Configuration de la console 23 Informations fournies par la console 24 Arborescence 27 W4 Connectors for Java Manuel d utilisation 30 31 Illustrations ua Index attachJVM param tre d instance W4 Engine 15 16 20 Connecteur XML configuration W4 Java Connectors 27 Connecteur XML W4 Java Connectors 26 connector jar 20 dispatcher W4 Java Connectors 7 24 Fichier connector properties W4 Java Connectors 16 java_classpath param tre d instance W4 Engine 15
23. r le nom du serveur ou son adresse IP sur lequel s ex cute le serveur de connecteurs Dans le champ server port entrer le port utilis par le serveur de connecteurs Il s agit du m me num ro de port que celui pr cis dans le fichier de configuration w4server cfg Le champ refresh rate indique le taux de rafraichissement des informations fournies par la console M Pour lancer la console appuyez sur le bouton start Pour arr ter la console appuyez sur le bouton stop Le bouton refresh a pour effet non de lancer un rafraichissement des informations affich es mais de mettre jour la configuration de la console lorsqu elle est d j d marr e Ga N OTE Si aucun serveur de connecteurs ne tourne sur le serveur et le port indiqu s une fen tre contenant le message Connection refused connect apparait 524 Informations fournies par la console La console dresse la liste des connecteurs en cours d ex cution Par d faut les connecteurs suivants doivent apparaitre xmlAgent le connecteur XML listener le connecteur charg de la communication avec le serveur W4 Engine et avec les consoles dispatcher connecteur distribuant les messages du serveur W4 Engine vers les connecteurs charg s de leurs traitements RA Connector monitor 2 xj gt si Stop Refresh g Normal Shutdown D Shutdown Now f server name localhost server port lt 7777 refresh rate secsk 30 Connector ID
24. rs workflow Pour que le serveur W4 Engine et le serveur de connecteurs soient en mesure de les distinguer des autres acteurs workflow il faut que les acteurs connecteurs aient le r le jconnector Le programme d installation se charge de cr er ce r le L acteur XMLAgent qui a la langue xml et le r le XMLConnector sont d di s au connecteur XML NOTE Cette tape est effectu e sur chaque instance choisie pr c demment Mise jour du fichier de configuration de W4 Engine sys wAserver cfg Il s agit ici de l ajout de param tres de configuration Ces param tres sont d taill s ci dessous Rappelons qu il peut exister un serveur de connecteurs par instance W4 Engine NOTE Cette tape est effectu e sur chaque instance choisie pr c demment Le num ro de port de base est 7777 il est ensuite incr ment de 1 pour chaque instance Journal de l installation Une fois l installation termin e il est possible de consulter le journal de l installation stock dans le r pertoire temporaire de l utilisateur ayant le programme d installation le chemin complet est indiqu la fin de l installation Pour rep rer les ventuelles erreurs le visualiseur du journal fait figurer dans la marge une croix rouge NOTE Le serveur de connecteurs se lance et s arr te avec le serveur W4 Engine Pour que l installation soit donc prise en compte vous devez red marrer le serveur W4 Engine 24 Fichiers cr s lors de l installation
25. soin est tr s sp cifique et il est recommand de n avoir qu un seul connecteur qui r pond chaque message Les connecteurs re oivent le message et appellent des applications externes facultatif Il est important de noter que les connecteurs sont en mesure d interagir galement avec W4 Engine Les connecteurs terminent la t che workflow facultatif Le serveur de connecteurs est une entit ind pendante de W4 Engine bien que les connecteurs maintiennent une connexion permanente avec ce dernier Le serveur de connecteurs re oit des notifications en provenance de W4 Engine et en fonction de certains crit res manant de la mod lisation assigne la notification tel ou tel connecteur pour traitement Les crit res de mod lisation en question ne seront pas trait s dans le pr sent document qui se limite l administration du serveur m me plut t qu la r alisation de connecteurs Structure interne Le serveur de connecteurs est une application Java multi thread e On y trouvera un Thread principal repr sentant le noyau du serveur unThreadGroup d pendant de ce thread contenant tous les threads des connecteurs un Thread ind pendant par connecteur En standard 3 connecteurs sont livr s par WA SocketServer connecteur ouvrant la socket d coute IP sur le port sp cifi dans w4server cfg Toutes les notifications en provenance de W4 Engine sont transmises au connecteur TWFdispatcher TWFdispat
26. t host running the W4 server and wflistener port Defaults to localhost w4Admin lt actor gt W4 actor with enough rights to reassign tasks Defaults to w4adm w4Pass lt password gt password of W4 actor given with w4Admin Defaults to w4adm w4Actors lt actors gt comma separated list of W4 actor names Lost tasks will be recovered for these actors Defaults to all tasks for actors with jconnector role if no w4Actors specified Ex java fr w4 connector TWFconnectorClient v port 7777 cmd shutdown Ex java fr w4 connector TWFconnectorClient v cmd recover port 7777 w4Server myServer w4Instance w4prod w4Actors actorl my actor2 actor3 actor with comma actor5 Ainsi trois commandes sont disponibles m shutdown d clenche un arr t du serveur de connecteurs apr s que toutes les t ches connecteurs en cours ont t termin es ou que la dur e lt instance gt stop timeout est atteinte Pour plus de d tails sur ce param tre voir le chapitre 3 2 Fichier connector lib resources connector properties page 16 shut downNow provoque un arr t imm diat du serveur de connecteurs toutes les op rations en cours sont interrompues m me si elles ne sont pas termin es recover lance la r cup ration des t ches connecteurs perdues Voir le chapitre 4 3 R cup ration des t ches perdues page 21 Pr alables Il s agit d une application cliente part enti re qui dans le cas de la comman
27. tenue via la ligne de commande java cp lib int connector jar lib java wfjlib jar fr w4 connector TWFconnectorClient help o les chemins d acc s des librairies connector jar etwfjlib jar sont adapter Usage fr w4 connector TWFconnectorClient help v w4Instance lt W4 instance name gt port lt port gt logDir lt W4 log directory gt host lt host gt cmd lt shutdown shutdownNow gt fr w4 connector TWFconnectorClient help v w4Instance lt W4 instance name gt port lt port gt logDir lt W4 log directory gt host lt host gt cmd recover w4Server lt W4 Server gt w4Admin lt actor gt w4Pass lt password gt w4Actors lt actors gt fr w4 connector TWFconnectorClient help WA Mannactore far NVA KA jari iz A CES DER FRERES W4 Connectors for Java Manuel d utilisatiort 19 help print this screen v verbose mod w4Instance lt W4 instance name gt W4 instance name Defaults to w4adm port lt port gt specify W4 connector server port on lt host gt Overrides logDir parameter Defaults to 7777 logDir lt W4 log directory gt specify W4 log directory will be used to guess the W4 connector server port from runSrv bat host lt host gt host running the W4 connector server Defaults to localhost cmd lt shutdown shutdownNow recover gt command to send to W4 connector server Specific options for recover command w4Server lt W4 Server port g
Download Pdf Manuals
Related Search