Troubleshooting
Problem
The purpose of this document is to assist with troubleshooting connection or certificate related issues one might encounter when using the IBM Planning Analytics ODBC Data Connector.
Symptom
- Unable to connect to IBM Planning Analytics ODBC Data Connector
Resolving The Problem
When troubleshooting a connection or certificate problem with ODBICS, the following steps can be taken to understand and resolve the problem:
- Confirm certificate file location
- Review \odbcis\deployment\config.internal.json file
- Check http tlsCert and tlsKey parameters for certificate file location
- Ensure certificate files are in the expected format
- cert (must contain complete certificate chain in file in following order: server, intermediate, root)
- key file (must contain unencrypted private key)
- If you encounter any of the following errors in the odbcis.log, it would indicate a problem with the content of the certificate files:
- tls: private key does not match public key
- tls: failed to find any PEM data in key input
- cert (must contain complete certificate chain in file in following order: server, intermediate, root)
- Ensure that the service returns all expected certificates to the browser/client, and that the certificates are valid and resolve all warnings
- Using OpenSSL, execute the following command and review the output: openssl s_client -debug -showcerts -connect odbcis.host.com:5555
- Ensure all certificates are correctly returned in the output, if they are not, revisit your certificate file configuration
*Output below has been truncated to better demonstrate the relevant detail
- Ensure all certificates are correctly returned in the output, if they are not, revisit your certificate file configuration
- In a web browser, navigate to the URL of the service and view the certificate chain
- In PostMan, review the status of the connection after sending a request
- Using OpenSSL, execute the following command and review the output: openssl s_client -debug -showcerts -connect odbcis.host.com:5555
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSEAI8G","label":"Planning Analytics as a Service"},"ARM Category":[{"code":"a8m3p000000GoaLAAS","label":"Planning Analytics-\u003EPlanning Analytics as a Service Specific-\u003EODBC Data Connector (ODBCIS)"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
Modified date:
01 October 2024
UID
ibm17116632