MustGather: Problems with the Web services gateway
 Technote (FAQ)
 
Problem
Contains MustGather information for Web services gateway problems with the WebSphere® Application Server Web services component. Gathering this information before calling IBM support will help familiarize you with the troubleshooting process and save you time.
 
Solution
Problems with the Web services gateway

If you have already contacted support, continue on to the component-specific MustGather information. Otherwise, click: MustGather: Read first for all WebSphere Application Server products.

MustGather information for Web services gateway:

  1. Identification of your environment - client and server platform and software
  2. Description of your problem, including any errors.
  3. Description of the steps taken to reproduce your problem, if the problem can be recreated.
  4. Identification of your gateway version (see Section A. )
  5. Identification of the WebSphere Application Server version (V4 or V5?)
  6. For WebSphere Application Server V5, provide the size and date of the following .jar files in your $WAS_HOME/lib directory:

    wsif.jar
    wsdl4j.jar
    qname.jar
    activation.jar
    jrom.jar
    mail.jar

    soap.jar (in the installedApps/<node_name>/wsgw.ear file)
    uddi4j.jar

    Is your axis.jar file in the $WAS_HOME/lib directory? (Normally in WebSphere/Appserver/lib directory).
  7. A list of all the fixes that you have applied.
  8. The TCPMON trace - requests and responses, both into and out of the gateway.
  9. The WebSphereTrace - immediately before and immediately after the failure (see Section B. below).
  10. All error logs - SystemOut.log, SystemErr.log, and trace.log.
  11. Identification of the transport that is used by your client and your target service.

    For example: Axis, Apache soap
  12. A screen capture of service development (see Section C. below).
  13. A screen capture of any Web services gateway administrative tool graphical user interface errors.
  14. The text of the gateway Web Services Definition Language (WSDL) and the target WSDL.
  15. Identification of any generic or deployed classes (on gateway service deployment)
  16. The source code, if a problem exists with a filter or exception handler.
  17. The database (for example: DB2®, Cloudscape) and version that you are using


Sections:
  1. To find your gateway version:
    Go to: http://<server>/WSGW and select product id. On V5.02 or later, select about on the main administrative panel.
  2. To identify the trace string to use for gateway tracing:

    For WebSphere Application Server V4:
    com.ibm.wsgw.*=all=enabled

    For WebSphere Application Server V5:com.ibm.wsgw.*=all=enabled:org.apache.wsif.*=all=enabled

    For WebSphere Application Server V6:com.ibm.ws.webservices.*=all=enabled:com.ibm.ws.sib.*=all=enabled:org.apache.wsif.*=all=enabled

    The tcpmon utility is found in the org.apache.axis.utils package(download) (within the axis.jar file) and provides an invaluable method of monitoring the contents of Network Deployment response messages. To use this utility, you must modify your target destination to a different port value on the local machine on which the tcpmon utility can listen. Having intercepted each request or response message, the tcpmon utility then forwards the message on to its correct destination.

    To run the tcpmon utility from the command line:

    java -cp YourAxisJarClassPath/axis.jar org.apache.axis.utils.tcpmon [TcpmonListenPort targetHost targetPort]

    For example:

    java -cp YourAxisJarClassPath/axis.jar org.apache.axis.utils.tcpmon 8091
    TargetHostName.uk.ibm.com 80

  3. To obtain a screen capture of service deployment, go to the main administrative panel, select services list > required service.


Follow instructions to send diagnostic information to IBM support.

For a listing of all Technotes, downloads, and educational materials specific to the Web services component, search the WebSphere Application Server support site.

 
Related information
Ten Steps to Getting Support
 
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Web Services (for example: SOAP or UDDI or WSGW or WSIF)
Operating system(s): HP-UX
Software version: 4.0
Software edition:
Reference #: 1159216
IBM Group: Software Group
Modified date: Feb 28, 2005