1. Copier ce fichier à la racine de l'application web contenant le service web à monitorer; décompresser l'archive; supprimer l'archive.

2. Vérifier que le fichier web.xml de cette application web déclare bien la servlet SOAPMonitorService
[Attention: si plusieurs applications web sont démarrées simultanément par le serveur d'applications (tomcat), il faut faire attention à ce que le port utilisé par le SOAPMonitorService soit unique pour chacune des applications]

Extrait web.xml :

<servlet>
<servlet-name>SOAPMonitorService</servlet-name>
<display-name>SOAPMonitorService</display-name>
<servlet-class>org.apache.axis.monitor.SOAPMonitorService</servlet-class>
<init-param>
<param-name>SOAPMonitorPort</param-name>
<param-value>5001</param-value>
</init-param>
<load-on-startup>100</load-on-startup>
</servlet>
 
<servlet-mapping>
<servlet-name>SOAPMonitorService</servlet-name>
<url-pattern>/SOAPMonitor</url-pattern>
</servlet-mapping>

3. Dans le répertoire où le fichier a été décompressé, lancer la commande (l'application web doit être démarrée par le serveur d'applications):

SOAPMonitor $(URL_PointAccesServiceWeb)

Remarque : pour lancer la commande, toutes les librairies axis doivent être dans le classpath.

Exemple : Si l'URL racine de mon application web est http://localhost:8080/MonSite et que le URL mapping de la servlet axis est /services/* (défaut; Cf. web.xml; => url-pattern du servlet-mapping d'AxisServlet), la commande est :

SOAPMonitor http://localhost:8080/MonSite/services

Si la commande s'exécute correctement, il est inscrit :
Processing file deploy-monitor.wsdd
<Admin>Done processing</Admin>

ainsi que la suite de la procédure.


4. Arrêter le serveur d'applications (tomcat). Editer le fichier de configuration server-config.wsdd se trouvant sous WEB-INF. Ajouter les lignes suivantes sous le tag ouvrant <service name="MonService" ...> du service à monitorer :

<requestFlow>
<handler type="soapmonitor"/>
</requestFlow>
<responseFlow>
<handler type="soapmonitor"/>
</responseFlow>


Sauvegarder le fichier.
Démarrer à nouveau le serveur d'applications (tomcat).

5. Ouvrir un navigateur web (le plugin java 1.3 (ou plus) doit être installé) et taper l'URL :
$(URL_MonSite)/SOAPMonitor

Exemple : http://localhost:8080/MonSite/SOAPMonitor

L'applet se charge et la boîte suivante s'affiche :

 


Remarque : si la barre de status n'indique pas [The SOAP Monitor is started] mais [The SOAP Monitor is unable to communicate with the server] alors plusieurs applications web sont démarrées et déclarent une servlet SOAPMonitorService sur le même port d'écoute.


6. Exécuter votre application utilisant le service web monitoré. Les messages s'affichent dans les fenêtres ad hoc.

 

Articles connexes