Troubleshooting
Problem
IBM web server plug-in provides the connection between the web server and the IBM WebSphere Application Server. With Apache based web servers other than IHS, the IBM web server plug-in requires the LD_LIBRARY_PATH environment variable to contain the location of the IBM Global Security Kit (GSKit) libraries to create secure connections (HTTPS) to the application servers.
Without the GSKit libraries, the IBM web server plug-in is unable to initialize SSL, and only HTTP connections to the WebSphere Application servers are available.
If another IBM product installed an older level of GSKit in the /usr directory, handshake failures occur if the older libraries are loaded.
Symptom
During web server start-up, errors indicating failures are logged in the plug-in log file (http_plugin.log):
ERROR: lib_security: loadSecurityLibrary: Failed to load gsk library from opt/IBM/WebSphere/Plugins/gsk8/gsk8_64
ERROR: ws_transport: transportInitializeSecurity: Unable to load security library
ERROR: ws_server: serverAddTransport: Failed to initialize security
ERROR: ws_server: serverAddTransport: HTTPS Transport is skipped
If an older level of the GSkit library is present in the /usr directory, plug-in connection handshake failures occur with GSK_ERROR_BAD_PEER related messages.
[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"ARM Category":[{"code":"a8m50000000CcwBAAS","label":"WebSphere HTTP Plugin-\u003EPLG.General"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"All Versions"}]
Log InLog in to view more of this document
This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.
Was this topic helpful?
Document Information
Modified date:
11 September 2025
UID
swg21600618