IBM Support

Mustgather: how to troubleshoot SSL connection problems from the Web Utilities plugin or other steps

Troubleshooting


Problem

You use the steps of the UrbanCode Deploy Web Utilities plugin to make an HTTPS connection to a remote server. Or you use some other step (such as a Groovy step) to make an HTTPS connection to a remote server. The connection fails with a SSLHandshakeException. How can you get more information about the reason for the failure?

Diagnosing The Problem

If you are using the Web Utilities plugin or a Groovy step or any other plugin that runs on Groovy, you can enable SSL traces by adding the following line:

-Djavax.net.debug=ssl:handshake:verbose

to the file:

<agent>/conf/plugin-javaopts.conf

Then execute the failing step once more.

The generated trace will contain the following relevant sections:

  • ClientHello: shows the SSL Handshake request sent by the Groovy run-time of the UrbanCode Deploy step
  • ServerHello: shows the SSL Handshake response sent by the remote server you are attempting to connect to.

Resolving The Problem

Open the failing process execution request and click on Download All Logs.

Collect the generated archive and provide it to UrbanCode Support.

If possible/applicable, enable the same trace on the server you are attempting to connect to, and provide the server side trace as well.

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS4GSP","label":"IBM UrbanCode Deploy"},"Component":"agent","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

ucd

Document Information

Modified date:
29 August 2018

UID

ibm10729675