Application client SOAP request troubleshooting tips
Use this information to diagnose and troubleshoot problems with clients sending SOAP requests.
What kind of problem are you seeing?
- SOAPException: faultCode=SOAP-ENV:Client; msg=Error opening socket; java.net.ConnectException: Connection refused: connect
- javax.security.cert.CertPathBuilderException: No end-entity certificate matching the selection criteria can be found.
If none of these errors match the one you see:
- Browse the application server logs. Look up any error or warning messages in the message table.
View install_dir/server/SystemErr.log and SystemOut.log for clues. To learn more, see the viewing JVM logs information. For additional tips, see the UDDI, Web service, and SOAP component troubleshooting tips information.
IBM recommends using the High Performance Extensible Logging (HPEL) log and trace infrastructure . We view HPEL log and trace information using the logViewer .
If we do not see a problem that resembles ours, or if the information provided does not solve our problem, see the troubleshooting help from IBM information.
SOAPException: faultCode=SOAP-ENV:Client; msg=Error opening socket; java.net.ConnectException: Connection refused: connect
The most likely cause of this refused connection is that it was sent to the default port, 80, and an HTTP server is not installed or configured.
To verify this situation, send the message directly to the SOAP port; for example, to http://hostname:9080. If the message is sent correctly, there are two ways to resolve the problem:
- Continue specifying port 9080 on SOAP requests.
- If an HTTP server is not installed, install one and the associated plug-in component.
- If an HTTP server is installed:
- Regenerate the HTTP plug-in configuration in the administrative console by clicking Environment > Update WebServer Plugin, and restarting the HTTP server.
- If the problem persists, view the HTTP server access and error logs, as well as the plugin_install_root/logs/web_server/http_plugin.log file for more information.
javax.security.cert.CertPathBuilderException: No end-entity certificate matching the selection criteria can be found
This error usually indicates that new or updated security keys are needed. The security key files are:
- SOAPclient
- SOAPserver
- sslserver.p12
In an installed application, these files are located in the: install_dir/installedApps/application_name.ear/soapsec.war/key/ directory. After replacing these files, we must stop and restart the application.
(iSeries) In an installed application, these files are located in the: profile_root/installedApps/application_name.ear/soapsec.war/key/ directory.
(iSeries) After replacing these files, we must stop and restart the application. The profile_root variable refers to the profile_rootND/profiles/profile directory
To replace these files in a SOAP-enabled application that is not yet installed:
- Expand the application_name.ear file.
- Expand the soapsec.war file.
- Replace the security key files in the key/ directory.
- After we replace these files, install the application and restart the server.
For current information available from IBM Support on known problems and their resolution, see the IBM Support page.
IBM Support has documents that can save you time gathering information needed to resolve this problem. Before opening a PMR, see the IBM Support page.
Related:
Troubleshooting help from IBM View JVM logs Troubleshoot web services Use High Performance Extensible Logging to troubleshoot applications UDDI, web service, and SOAP component troubleshooting tips Application deployment troubleshooting tips