Identification et résolution des incidents WSRP
Vous pouvez traiter des incidents relatifs à WSRP à l'aide de différentes méthodes telles que la consignation et la fonction de trace, le débogage et la surveillance.
Définition de traces et utilisation du fichier journal d'exécution du portail pour le diagnostic WSRP
Vous pouvez diagnostiquer les problèmes qui peuvent se poser pendant l'utilisation de WSRP. Pour ce faire, vous définissez des traces spécifiques à WSRP et activez des journaux d'exécution pour les composants Consommateur, Producteur et Administration de l'implémentation WSRP. Pour ce faire, utilisez le portlet d'administration Activation de la trace.
Vous pouvez activer les journaliseurs de trace suivants pour l'implémentation WSRP :
| Composant | Chaîne de trace |
|---|---|
| Administration | com.ibm.wps.command.wsrp.*=all com.ibm.wps.wsrp.cmd.*=allcom.ibm.wps.wsrp.common.*=allcom.ibm.ws.websvcs.trace.MessageTrace=all |
| Consommateur | com.ibm.wps.wsrp.consumer.*=allcom.ibm.wps.wsrp.common.*=allcom.ibm.ws.websvcs.trace.MessageTrace=all |
| fournisseur | com.ibm.wps.wsrp.producer.*=allcom.ibm.wps.wsrp.common.*=allcom.ibm.ws.websvcs.trace.MessageTrace=all |
| XMLAccess | com.ibm.wps.command.xml.*=allcom.ibm.wps.wsrp.common.*=allcom.ibm.ws.websvcs.trace.MessageTrace=all |
Débogage et suivi du flux du protocole WSRP
Vous pouvez suivre les messages SOAP échangés entre un Consommateur WSRP et un Producteur WSRP. Pour ce faire, utilisez un moniteur ou une application de détection pour intercepter le trafic réseau entre les deux points. Vous pouvez utiliser l'utilitaire TCPMon livré avec WebSphere Application Server. En guise d'alternative, la plupart des systèmes d'exploitation AIX® ou Linux™ comportent des utilitaires adaptés, par exemple, tcpdump. Vous pouvez exécuter tcpdump d'un côté ou de l'autre et enregistrer le trafic réseau intercepté par une interface réseau. Des outils gratuits sont aussi disponibles.
Suivi des messages WSRP entre le consommateur et le fournisseur à l'aide de TCPMon
Vous pouvez utiliser l'outil TCPMon pour le suivi des messages WSRP entre le Consommateur et le Producteur. Pour plus d'informations sur cette méthode, consultez la rubrique du Centre de documentation WebSphere® Application Server concernant le traçage des messages des services Web. L'application TCPMon utilise l'approche dite de "l'homme au milieu". TCPMon est à l'écoute sur un port TCP, consigne le trafic HTTP ou SOAP, et réachemine la requête au serveur et au port TCP désignés. Vous devez par conséquent rediriger la communication du Consommateur vers l'application TCPMon et laisser TCPMon réacheminer la requête vers le Producteur WSRP.
Si vous disposez déjà d'une configuration Producteur sur votre portail Consommateur, vous pouvez modifier l'hôte et le port pour chaque URL d'adresse de noeud final WSRP que vous voulez surveiller. Vous pouvez modifier les URL d'adresses de noeud final WSRP utilisées par le Consommateur pour communiquer avec le Producteur intégré. Pour ce faire, vous pouvez utiliser l'interface utilisateur d'administration du portail ou bien l'interface de configuration XML.
Sinon, pour le débogage d'un scénario spécifique, vous pouvez aussi créer une définition de Producteur sur le Consommateur, avec un WSDL contenant des URL d'adresse de noeud final WSRP pointant vers l'hôte et le port TCPMon.
Dans HCL Portal, vous pouvez manipuler les contenus WSDL en ajoutant des paramètres d'URL à l'URL WSDL.
Après avoir redirigé le trafic, configurez l'outil TCPMon afin qu'il se mette à l'écoute du port spécifié côté Consommateur pour la communication avec le Producteur. Définissez également le port cible d'après les valeurs de port réelles des interfaces WSRP du fournisseur. Dans le cas du Producteur HCL, il s'agit des ports qui figurent dans le fichier WSDL lorsque ce fichier est réclamé sans le paramètre port.
Pour exécuter l'outil TCPMonitor, suivez les instructions fournies dans le centre d'aide WebSphere® Application Server sous Suivi des messages SOAP avec tcpmon.