Debugging SOAP errors

The best practice for troubleshooting SOAP errors is to start a new client connection process with a dedicated log file associated with it. Opening a new client connection process allows you to isolate any faulty client traffic from your regular client traffic.

  1. To set up your system to debug SOAP traffic, do one of the following:
  • Start HTTP debugging for the entire system. Type the following command on a single line in the sm.ini file and then save the file.

    debughttp:1

    Debug parameters in the sm.ini file affect all Service Management processes and the log files record all send/receive messages. This method is not recommended for a busy server however, since you have to restart the server for the debugging parameter to take effect.
  • Start a separate client connection process to troubleshoot your SOAP errors. Type the following command in the operating system command line:

    sm -httpPort:unique portnumber -sslConnector:0 -debughttp:1
    -log:../logs/debug.log


    where

    -httpPort identifies a port where Web Services clients can connect
    -log defines a path to store the logs for this process

    Normally, all client connection processes for a particular Service Management installation use the parameter values listed in the sm.ini file. This means that all client connections share the same log file specified in the sm.ini file. By starting a new client connection process with a different log parameter value, you can isolate the logs for a particular group of clients. Choose a port number that is not likely to be used by any other process.
  1. Recreate the error.
  2. Review the http.log, sm.log and log files from the Web Services consumer or publisher that Service Management is communicating with and server, and client log files for information about the SOAP error. The HTTP log is in the server's RUN folder. The server logs are in the path you specified with the log parameter. The client logs are located in the following paths:
  • For a Web Services client, see your Web Services client log
  • For a Web client, see the log filed specified in the log.properties file on the web tier system
  • For a Windows client, see the .log on the Windows client system