Aller au contenu
Modifié par Julien EYMERY le 2015/09/02 10:00
Afficher les derniers auteurs
1 (((
2 == Création, édition du fichier de redirection du point d'accès d'un service web ==
3 )))
4 (((
5 === [Axis1 / jusqu'à Adélia Studio 11 inclus] ===
6 )))
7
8 Contexte C Windows :
9 . Créer (ou éditer) un fichier "cfgWebServices.ini" dans un répertoire se trouvant dans le PATH
10 . Créer un label [cWebServices]
11 . Sous ce label, créer une entrée pour le service web à monitorer :
12
13 {{hardis-panel}}
14 NomAdeliaServiceWeb~=URLremappée du service web
15 {{/hardis-panel}}
16
17 Contexte Java : Créer un fichier "cfgWebServices.properties" dans un répertoire se trouvant dans le CLASSPATH ou dans WEB-INF\classes (pour une webapp)
18 . créer une entrée pour le service web à monitorer :
19
20 {{hardis-panel}}
21 NomAdeliaServiceWeb~=URLremappée du service web
22 {{/hardis-panel}}
23
24
25
26 Exemple :
27 Monitorer la consommation du service web de nom Adélia GESTIONCHAINES (Cf. base de connaissance).
28 On suppose que le nom réel du service web est "GestiondesChaines" et que son point d'accès (URL) est [[http://www.monsite.fr:80/adelia/services/GestiondesChaines>>url:http://www.monsite.fr:80/adelia/services/GestiondesChaines]]
29
30 Créer une entrée pour GESTIONCHAINES dans le fichier CfgWebServices.ini (ou CfgWebServices.properties) permet de modifier le point d'accès du service web à consommer. Le but de la manoeuvre est de modifier le point d'accès pour monitorer, sur la machine où s'exécute le programme de consommation (localhost), les messages envoyés et reçus par ce programme avec le service web.
31 Pour cela on modifie l'URL en précisant par exemple localhost:NumPortLocal
32
33 NumPortLocal est un numéro de port local TCP non encore utilisé libre par la machine. Nous prendrons de façon arbitraire la valeur de 5000 pour le port local.
34 Soit une redirection d'URL vers [[http://localhost:5000/adelia/services/GestiondesChaines>>url:http://localhost:5000/adelia/services/GestiondesChaines]]
35
36
37
38 {{code title="CfgWebServices.ini" language="none"}}
39 [cWebServices]
40 GESTIONCHAINES=http://localhost:5000/adelia/services/GestiondesChaines
41 {{/code}}
42
43 (((
44 === [Axis2 / à partir d'Adélia Studio 12] ===
45 )))
46
47 . Créer (ou éditer) un fichier "cfgWebServices.xml" dans un répertoire se trouvant
48 - dans le PATH (contexte C)
49 - dans le CLASSPATH (contexte client java)
50 - dans WEB-INF\classes (contexte d'une webapp)
51 . Créer un élément <Service> et son élément fils <AdeliaName> précisant le nom Adélia du service à monitorer
52 . Créer un autre élément fils <Epr> précisant l'URL remappée du service web
53
54
55 {{code language="none"}}
56 <Configuration>
57 ...
58 <Service>
59 <AdeliaName>NomAdeliaServiceWeb</AdeliaName>
60 <Epr>URLremappée du service web</Epr>
61 </Service>
62 ...
63 </Configuration>
64 {{/code}}
65
66
67
68 Exemple :
69 Monitorer la consommation du service web de nom Adélia GESTIONCHAINES (Cf. base de connaissance).
70 On suppose que le nom réel du service web est "GestiondesChaines" et que son point d'accès (URL) est [[http://www.monsite.fr:80/adelia/servaxis2/GestiondesChaines>>url:http://www.monsite.fr:80/adelia/servaxis2/GestiondesChaines]]
71
72 Créer une entrée pour GESTIONCHAINES dans le fichier cfgWebServices.xml permet de modifier le point d'accès du service web à consommer. Le but de la manoeuvre est de modifier le point d'accès pour monitorer, sur la machine où s'exécute le programme de consommation (localhost), les messages envoyés et reçus par ce programme avec le service web.
73 Pour cela on modifie l'URL en précisant par exemple localhost:NumPortLocal
74
75 NumPortLocal est un numéro de port local TCP non encore utilisé libre par la machine. Nous prendrons de façon arbitraire la valeur de 5000 pour le port local.
76 Soit une redirection d'URL vers [[http://localhost:5000/adelia/servaxis2/GestiondesChaines>>url:http://localhost:5000/adelia/servaxis2/GestiondesChaines]]
77
78
79
80 {{code title="cfgWebServices.xml" language="none"}}
81 <Configuration>
82 ...
83 <Service>
84 <AdeliaName>GESTIONCHAINES</AdeliaName>
85 <Epr>http://localhost:5000/adelia/servaxis2/GestiondesChaines</Epr>
86 </Service>
87 ...
88 </Configuration>
89 {{/code}}
90
91
92
93 (((
94 == Utilisation de TcpMon ==
95 )))
96
97 a. Exécuter la commande suivante
98 java -classpath "%ADELIWS%\javarun\axis.jar" org.apache.axis.utils.tcpmon
99
100 b. La fenêtre suivante s'ouvre
101
102 [[image:tcpmon1.png]]
103
104
105 c. Saisir la valeur 5000 dans le champ "Listen Port #", [Port de re-direction pour le monitoring]
106 Saisir les informations correpondant au point d'accès réel du service web pour le champ "Act as a...", "Listener"
107 Dans notre cas :
108 . Target hostname ~= [[www.monsite.fr>>url:http://www.monsite.fr]]
109 . Target port # ~= 80
110
111 puis appuyer sur le bouton [Add]
112
113
114 d. Cliquer sur l'onglet [Port 5000] nouvellement créé
115
116 [[image:tcpmon2.png]]
117
118 e. Cocher, [Xml Format] et [Numeric]
119
120
121 f. Exécuter le programme de consommation du service web puis retourner dans TcpMon, les messages échangés sont consignés dans le panneau supérieur (envoi) et dans le panneau inférieur (réception).
122 Le panneau supérieur montre l'en-tête HTTP et le message SOAP envoyés vers le service web. Le message SOAP (XML) contient principalement la définition des paramètres d'entrée.
123 Le panneau inférieur montre l'en-tête HTTP et le message SOAP retournés par le service web vers le client. Le message SOAP (XML) contient principalement le(s) résultat(s) retourné(s) par le service web.
124
125
126 g. N'oubliez pas de supprimer ou de modifier le fichier CfgWebServices.ini (ou .properties) ou encore cfgWebServices.xml pour un retour à la normale
127 (((
128 == (% style="line-height: 1.5;" %)Articles connexes(%%) ==
129 )))
130
131 Les articles connexes apparaissent ici en fonction des étiquettes que vous avez sélectionnées. Cliquez pour modifier la macro et ajouter ou modifier des étiquettes.
132
133 {{liveData sort="doc.date:desc" source="liveTable" properties="doc.title,doc.date,doc.author" description="Recently updated" limit="5" filters="tag=service" sourceParameters="translationPrefix=platform.index."}}{{/liveData}}
134