Troubleshoot WSRP
We can troubleshoot WSRP using different methods such as logging and tracing, debugging, and monitoring.
- Set traces and using the portal run time log file for WSRP diagnosis
- Debugging and monitoring the WSRP protocol flow
- Monitoring WSRP messages between the Consumer and Producer using TCPMon
Set traces and using the portal run time log file for WSRP diagnosis
We can diagnose problems that might occur during the use of WSRP. To do so, we set WSRP-specific traces and enable run time logs for the Consumer, Producer, and administration components of the WSRP implementation. Use the administration portlet Enable Tracing.
We can enable the following trace loggers for the WSRP implementation:
Component Trace string Administration com.ibm.wps.command.wsrp.*=all
com.ibm.wps.wsrp.cmd.*=allcom.ibm.wps.wsrp.common.*=all
com.ibm.ws.websvcs.trace.MessageTrace=allConsumer com.ibm.wps.wsrp.consumer.*=all
com.ibm.wps.wsrp.common.*=all
com.ibm.ws.websvcs.trace.MessageTrace=allProducer com.ibm.wps.wsrp.producer.*=all
com.ibm.wps.wsrp.common.*=all
com.ibm.ws.websvcs.trace.MessageTrace=allxmlaccess com.ibm.wps.command.xml.*=all
com.ibm.wps.wsrp.common.*=all
com.ibm.ws.websvcs.trace.MessageTrace=all
Debugging and monitoring the WSRP protocol flow
We can trace SOAP messages that are exchanged between a consumer and a producer. To do so, we use a monitor or sniffer application to capture network traffic between the two points. You can use the utility TCPMon that is shipped with the WebSphere Application Server. As an alternative, most AIX or Linux operating systems provide suitable utilities, for example, tcpdump. We can run tcpdump on either side and record network traffic that is captured by a network interface. There are also free tools available.
Monitoring WSRP messages between the Consumer and Producer using TCPMon
We can use the TCPMon tool to monitor the WSRP messages between the Consumer and Producer. For information about how to do so, read the WebSphere Application Server Information Center topic about Tracing web services messages. The TCPMon application uses the man-in-the-middle approach. TCPMon listens on a TCP port, logs the HTTP or SOAP traffic, and forwards the request to the designated server and TCP port. Therefore, we must redirect the communication from the Consumer to the TCPMon application and have TCPMon forward the request to the producer.
If we already have a Producer configuration on the Consumer portal, we can modify the host and port for each WSRP end point address URL to monitor. We can change the WSRP endpoint address URLs that the Consumer uses to communicate with the integrated Producer. To do so, we can use either the portal administration user interface or the XML configuration interface.
Alternatively, to debug a certain scenario, we can also create a new Producer definition on the Consumer with a WSDL containing WSRP endpoint address URLs that point to the TCPMon host and port.
In WebSphere Portal, we can manipulate the WSDL contents by adding URL parameters to the WSDL URL.
After you redirect the traffic, configure the TCPMon tool to listen on the port that you specified on the Consumer side to communicate with the Producer portal. Also, set the target port to the actual port values of the Producer WSRP interfaces. For the WebSphere Portal Producer, these target ports are the ports that the WSDL file contains when you request the WSDL file without the port parameter.
To run the TCPMonitor tool, follow the instructions that are given in the WebSphere Application Server information center under Tracing SOAP messages with tcpmon.
Parent topic: Reference for using WSRP with the portal
Related information