This topic contains error messages that might result due
to SSL initialization problems and provides solutions to help you
troubleshoot these problems.
The following messages display as a result of initialization
problems:
- Message: SSL0100E: GSK could not initialize, <errorCode>
- Reason: Initialization failed when the SSL library returned an
unknown error.
- Solution: None. Report this problem to Service.
- Message: SSL0101E: GSK could not initialize, Neither the password
nor the stash file name was specified. Could not open key file.
- Reason: The stash file for the key database could not be found
or is corrupted.
- Solution: Use IKEYMAN to open the key database file and recreate
the password stash file.
- Message: SSL0102E: GSK could not initialize, Could not open
key file.
- Reason: The server could not open the key database file.
- Solution: Check that the Keyfile directive is correct and that
the file permissions allow the Web server user ID to access the file.
- Message: SSL0103E: Internal error - GSK could not initialize,
Unable to generate a temporary key pair.
- Reason: GSK could not initialize; Unable to generate a temporary
key pair.
- Solution: Report this problem to Service.
- Message: SSL0104E: GSK could not initialize, Invalid password
for key file.
- Reason: The password retrieved from the stash file could not open
the key database file.
- Solution: Use IKEYMAN to open the key database file and recreate
the password stash file. This problem could also result from a corrupted
key database file. Creating a new key database file may resolve the
problem.
- Message: SSL0105E: GSK could not initialize, Invalid label.
- Reason: Specified key label is not present in key file.
- Solution: Check that the SSLServerCert directive is correct, if
coded, and that the label is valid for one of the keys in the key
database.
- Message: SSL0106E: Initialization error, Internal error - Bad
handle
- Reason: An internal error has occurred.
- Solution: Report this problem to Service.
- Message: SSL0107E: Initialization error, The GSK library unloaded.
- Reason: A call to the GSKit function failed because the dynamic
link library unloaded (Windows only).
- Solution: Shut down the server and restart.
- Message: SSL0108E: Initialization error, GSK internal error.
- Reason: The communication between client and the server failed
due to an error in the GSKit library.
- Solution: Retry connection from the client. If the error continues,
report the problem to Service.
- Message: SSL0109E: GSK could not initialize, Internal memory
allocation failure.
- Reason: The server could not allocate memory needed to complete
the operation.
- Solution: Take action to free up some additional memory. Try reducing
the number of threads or processes running, or increasing virtual
memory.
- Message :SSL0110E: Initialization error, GSK handle is in
an invalid state for operation.
- Reason: The SSL state for the connection is invalid.
- Solution: Retry connection from the client. If the error continues,
report the problem to Service.
- Message: SSL0111E: Initialization error, Key file label not
found.
- Reason: Certificate or key label specified was not valid.
- Solution: Verify that the certificate name specified with the
SSLServerCert directive is correct or, if no SSLServerCert directive
was coded, that a default certificate exists in the key database.
- Message: SSL0112E: Initialization error, Certificate is not
available.
- Reason: The client did not send a certificate.
- Solution: Set Client Authentication to optional if a client certificate
is not required. Contact the client to determine why it is not sending
an acceptable certificate.
- Message: SSL0113E: Initialization error, Certificate validation
error.
- Reason: The received certificate failed one of the validation
checks.
- Solution: Use another certificate. Contact Service to determine
why the certificate failed validation.
- Message: SSL0114E: Initialization error, Error processing cryptography.
- Reason: A cryptography error occurred.
- Solution: None. If the problem continues, report it to Service.
- Message: SSL0115E: Initialization error, Error validating ASN
fields in certificate.
- Reason: The server was not able to validate one of the ASN fields
in the certificate.
- Solution: Try another certificate.
- Message: SSL0116E: Initialization error, Error connecting to
LDAP server.
- Reason: The Web server failed to connect to the CRL LDAP server.
- Solution: Verify that the values entered for the SSLCRLHostname
and SSLCRLPort directives are correct. If access to the CRL LDAP server
requires authentication, is the SSLCRLUserID directive coded and was
the password added to the stash file pointed to by the SSLStashfile
directive.
- Message: SSL0117E: Initialization error, Internal unknown
error. Report problem to service.
- Reason: Initialization error, Internal unknown error. Report
problem to service.
- Solution: Initialization error, Internal unknown error. Report
problem to service.
- Message: SSL0118E: Initialization error, Open failed due to
cipher error.
- Reason: Report problem to service.
- Solution: Report problem to service.
- Message: SSL0119E: Initialization error, I/O error reading
keyfile.
- Reason: I/O error trying to read SSL keyfile.
- Solution: Check the file permissions for keyfile.
- Message: SSL0120E: Initialization error, Keyfile has and invalid
internal format. Recreate keyfile.
- Reason: Initialization error, the keyfile has an invalid internal
format. Recreate the keyfile.
- Solution: Verify the keyfile is not corrupted.
- Message: SSL0121E: Initialization error, Keyfile has two entries
with the same key. Use Ikeyman to remove the duplicate key.
- Reason: The keyfile has two entries with the same key. Use Ikeyman
to remove the duplicate key.
- Solution: Use Ikeyman to remove the duplicate key.
- Message: SSL0122E: Initialization error, Keyfile has two entries
with the same label. Use Ikeyman to remove the duplicate label.
- Reason: The keyfile has two entries with the same label. Use Ikeyman
to remove the duplicate label.
- Solution: Use Ikeyman to remove the duplicate label.
- Message: SSL0123E: Initialization error, The keyfile password
is used as an integrity check. Either the keyfile has become corrupted
or the password is incorrect.
- Reason: The keyfile password is used as an integrity check. Either
the keyfile has become corrupted or the password is incorrect.
- Solution: Use Ikeyman to verify that the keyfile is valid, check
permissions on the stash file, verify passwords.
- Message: SSL0124E: SSL Handshake Failed, Either the default
key in the keyfile has an expired certificate or the keyfile password
expired. Use iKeyman to renew or remove certificates that are expired
or to set a new keyfile password.
- Reason: Either the default key in the keyfile has an expired certificate
or the keyfile password expired.
- Solution: Use iKeyman to renew or remove certificates that are
expired or to set a new keyfile password.
- Message: SSL0125E: Initialization error, There was an error
loading one of the GSK dynamic link libraries. Be sure GSK is installed
correctly.
- Reason: There was an error loading one of the GSK dynamic link
libraries. Be sure GSK is installed correctly.
- Solution: Verify GSK is installed and appropriate level for release
of IBM® HTTP Server.
- Message: SSL0126E: Handshake Failed, Either the certificate
has expired or the system clock is incorrect.
- Reason: Either the certificate expired or the system clock is
incorrect.
- Solution: Use the key management utility (iKeyman) to recreate
or renew your server certificate or change the system date to a valid
date.
- Message: SSL0127E: Initialization error, No ciphers specified.
- Reason: Initialization error, no ciphers specified.
- Solution: Report problem to service.
- Message: SSL0128E: Initialization error, Either the certificate
expired or the system clock is incorrect.
- Reason: Initialization error, no certificate.
- Solution: Report problem to service.
- Message: SSL0129E: Initialization error, The received certificate
was formatted incorrectly.
- Reason: The received certificate is formatted incorrectly.
- Solution: Use Ikeyman to validate certificates used for connection.
- Message: SSL0130E: Initialization error, Unsupported certificate
type.
- Reason: Unsupported certificate type.
- Solution: Check certificates that are used for this connection
in Ikeyman.
- Message: SSL0131I: Initialization error, I/O error during
handshake.
- Reason: I/O error during handshake.
- Solution: Check network connectivity.
- Message: SSL0132E: Initialization error, Invalid key length
for export.
- Reason: Invalid key length for export.
- Solution: Report problem to service.
- Message: SSL0133W: Initialization error, An incorrectly formatted
SSL message was received.
- Reason: An incorrectly formatted SSL message was received.
- Solution: Check client settings.
- Message: SSL0134W: Initialization error, Could not verify
MAC.
- Reason: Could not verify MAC.
- Solution: Report problem to service.
- Message: SSL0135W: Initialization error, Unsupported SSL protocol
or unsupported certificate type.
- Reason: Unsupported SSL protocol or unsupported certificate type.
- Solution: Check server ciphers and certificate settings.
- Message: SSL0136W: Initialization error, Invalid certificate
signature.
- Reason: Invalid certificate signature.
- Solution: Check certificate in Ikeyman.
- Message: SSL0137W: Initialization error, Invalid certificate
sent by partner.
- Reason: Invalid certificate sent by partner.
- Solution: If this occurs during an SSL Proxy connection, the remote
SSL server sent a bad certificate to IBM HTTP
Server. Check the certificate and certificate authority chain at the
other end of the SSL connection.
- Message: SSL0138W: Initialization error, Invalid peer.
- Reason: Invalid peer.
- Solution: Report problem to service.
- Message: SSL0139W: Initialization error, Permission denied.
- Reason: Permission denied.
- Solution: Report problem to service.
- Reason: If a System Authorization Facility (SAF) SSL keyring is
in use, the current user ID is not authorized to read the keyring.
- Solution: See the information about access to SAF keyrings in Performing required z/OS system configurations
- Message: SSL0140W: Initialization error, The self-signed certificate
is not valid.
- Reason: The self-signed certificate is not valid.
- Solution: Check the certificate in Ikeyman.
- Message: SSL0141E: Initialization error, Internal error -
read failed.
- Reason: Internal error - read failed.
- Solution: Report to service.
- Message: SSL0142E: Initialization error, Internal error -
write failed.
- Reason: Internal error - write failed.
- Solution: Report to service.
- Message: SSL0143I: Initialization error, Socket has been closed.
- Reason: Socket has been closed unexpectedly.
- Solution: Check the client and network. Report problem to service.
- Message: SSL0144E: Initialization error, Invalid SSLV2 Cipher
Spec.
- Reason: Invalid SSLV2 cipher spec.
- Solution: Check the SSLCipherSpec directive.
- Message: SSL0145E: Initialization error, Invalid SSLV3 Cipher
Spec.
- Reason: Invalid SSLV3 Cipher Spec.
- Solution: Check the SSLCipherSpec directive.
- Message: SSL0146E: Initialization error, Invalid security
type.
- Reason: Invalid security type.
- Solution: Report to service.
- Message: SSL0147E: Initialization error, Invalid security
type combination.
- Reason: Invalid security type combination.
- Solution: Report to service.
- Message: SSL0148E: Initialization error, Internal error -
SSL Handle creation failure.
- Reason: Internal error - SSL handle creation failure.
- Solution: Report to service.
- Message: SSL0149E: Initialization error, Internal error -
GSK initialization has failed.
- Reason: Internal error - GSK initialization has failed.
- Solution: Report to service.
- Message: SSL0150E: Initialization error, LDAP server not available.
- Reason: LDAP server not available.
- Solution: Check CRL directives.
- Message: SSL0151E: Initialization error, The specified key
did not contain a private key.
- Reason: The specified key did not contain a private key.
- Solution: Check the certificate in use in Ikeyman.
- Message: SSL0152E: Initialization error, A failed attempt
was made to load the specified PKCS#11 shared library.
- Reason: A failed attempt was made to load the specified PKCS#11
shared library.
- Solution: Check SSLPKCSDriver directive and file system.
- Message: SSL0153E: Initialization error, The PKCS#11 driver
failed to find the token specified by the caller.
- Reason: The PKCS#11 driver failed to find the token specified
by the caller.
- Message: SSL0154E: Initialization error, A PKCS#11 token is
not present for the slot.
- Reason: A PKCS#11 token is not present for the slot.
- Solution: Verify PKCS#11 directives.
- Message: SSL0155E: Initialization error, The password/pin
to access the PKCS#11 token is invalid.
- Reason: The password and pin to access the PKCS#11 token is invalid.
- Message: SSL0156E: Initialization error, The SSL header received
was not a properly SSLV2 formatted header.
- Reason: The SSL header received was not a properly SSLV2 formatted
header.
- Message: SSL0157E: Initialization error, The function call,
%s, has an invalid ID.
- Reason: The function call, %s, has an invalid ID.
- Solution: Report problem to service.
- Message: SSL0158E: Initialization error, Internal error -
The attribute has a negative length: %s.
- Reason: Internal error - The attribute has a negative length.
- Solution: Report problem to service.
- Message: SSL0159E: Initialization error, The enumeration value
is invalid for the specified enumeration type: %s.
- Reason: The enumeration value is invalid for the specified enumeration
type: %s.
- Solution: Report problem to service.
- Message: SSL0160E: Initialization error, The SID cache is
invalid: %s.
- Reason: The SID cache is invalid.
- Solution: Report problem to service.
- Message: SSL0161E: Initialization error, The attribute has
an invalid numeric value: %s.
- Reason: The attribute has an invalid numeric value: %s.
- Solution: Check SSL
directives.
- Message: SSL0162W: Setting the LD_LIBRARY_PATH or LIBPATH
for GSK failed.
- Reason: Could not update the environment for GSK libraries.
- Solution: Report problem to service.
- Message: SSL0163W: Setting the LIBPATH for GSK failed, could
not append /usr/opt/ibm/gskkm/lib.
- Reason: Could not append to LD_LIBRARY_PATH or LIBPATH for GSK
failed.
- Solution: Report problem to service.
- Message: SSL0164W: Error accessing Registry, RegOpenKeyEx/RegQueryValueEx
returned [%d].
- Reason: Error accessing registry.
- Solution: Check GSK installation and windows registry.
- Message: SSL0165W: Storage allocation failed.
- Reason: Storage allocation failed.
- Solution: Check memory usage, report problem to service.
- Message: SSL0166E: Failure attempting to load GSK library.
- Reason: Failure while attempting to load GSK library.
- Solution: Check the GSK installation.
- Message: SSL0167E: GSK function address undefined.
- Reason: GSK function address is undefined.
- Solution: Check the GSK installation and level.
- Message: SSL0168E: SSL initialization for server: %s, port:
%u failed due to a configuration error.
- Reason: Iinitialization for server: %s, port: %u failed due to
a configuration error.
- Solution: Check the SSL configuration.
- Message: SSL0169E: Keyfile does not exist: %s.
- Reason: Keyfile does not exist.
- Solution: Check to ensure the path that is provided to the KeyFile
directive exists, and is readable by the user that IBM HTTP
Server is running as.
- Message: SSL0170E: GSK could not initialize, no keyfile specified.
- Reason: Keyfile is not specified.
- Solution: Specify Keyfile directive.
- Message: SSL0171E: CRL cannot be specified as an option for
the SSLClientAuth directive on HPUX because the IBM HTTP
Server does not support CRL on HPUX.
- Reason: CRL cannot be specified as an option for the SSLClientAuth
directive on HPUX because IBM HTTP Server does not support
CRL on HPUX.
- Solution: Remove CRL directives.
- Message: SSL0172E: If CRL is turned on, you must specify an
LDAP hostname for the SSLCRLHostname directive.
- Reason: If CRL is turned on, you must specify an LDAP hostname
for the SSLCRLHostname directive.
- Solution: Specify SSLCRLHostname.
- Message: SSL0173E: Failure obtaining supported cipher specs
from the GSK library.
- Reason: Failure obtaining supported cipher specs from the GSK
library.
- Solution: Check the GSK installation, report problem to service.
- Message: SSL0174I: No CRL password found in the stash file:
%s.
- Reason: No CRL password is found in the stash file: %s.
- Solution: Check the stash file permissions, regenerate stash file.
- Message: SSL0174I: No CRYPTO password found in the stash file:
%s.
- Reason: No CRYPTO password is found in the stash file: %s.
- Solution: Check stash file permissions, regenerate stash file.
- Message: SSL0175E: fopen failed for stash file: %s.
- Reason: fopen failed for stash file.
- Solution: Check stash file permissions, regenerate stash file.
- Message: SSL0176E: fread failed for the stash file: %s.
- Reason: fread failed for the stash file.
- Solution: Make sure the stash file is readable by user IBM HTTP
Server is running as.
- Message: SSL0179E: Unknown return code from stash_recover(),
%d.
- Reason: Unknown return code from stash_recover(), %d.
- Solution: Check the stash file.
- Message: SSL0181E: Unable to fork for startup of session ID
cache.
- Reason: Unable to fork for startup of session ID cache.
- Solution: Check the location of sidd daemon, file permissions.
- Message: SSL0182E: Error creating file mapped memory for SSL
passwords.
- Reason: Error creating file mapped memory for SSL passwords.
- Solution: Report problem to service.
- Message: SSL0183E: Exceeded map memory limits.
- Reason: Exceeded map memory limits.
- Solution: Report problem to service.
- Message: SSL0184E: Could not find a password for the resource:
%s.
- Reason: SSL0184E: Could not find a password for the resource:
%s.
- Solution: Report problem to service, disable password prompting.
- Message: SSL0185E: ssl_getpwd() failed, unable to obtain memory.
- Reason: ssl_getpwd() failed, unable to obtain memory.
- Solution: Report problem to service, disable password prompting.
- Message: SSL0186E: Linked list mismatch.
- Reason: SSL0186E: Linked list mismatch.
- Solution: Report problem to service, disable password prompting.
- Message: SSL0186E: ssl_getpwd() failed, password exceeded
maximum size of 4095.
- Reason: ssl_getpwd() failed, password exceeded the maximum size
of 4095.
- Solution: The password must be smaller than 4K.
- Message: SSL0187E: It is invalid to enable password prompting
for the SSLServerCert directive without specifying a Crypto Card Token.
- Reason: It is invalid to enable password prompting for the SSLServerCert
directive without specifying a crypto card token.
- Solution: Specify a crypto card token or disable password prompting
for the SSLServerCert directive.
- Message: SSL0188E: SSL initialization for server: %s, port:
%u failed. SSL timeouts cannot be set in a virtualhost when the SSLCacheDisable
directive has not been specified globally.
- Reason: When the SSL session cache is being used, only the global
timeout settings apply because they are managed by the external session
cache daemon. See information about the SSLCacheDisable and SSLCacheEnable
directives in the information center topic entitled SSL directives.
- Solution: If separate SSL timeouts are required, disable use
of the session ID cache (SSLCacheDisable), otherwise make sure the
SSLV3Timeout and SSLV2Timeout directives are only set in the global
scope.