IBM Support

Troubleshoot Planning Analytics ODBC Connector Connections and SSL Certificates

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
    • image-20240212121424-12
  • Ensure certificate files are in the expected format
    • cert (must contain complete certificate chain in file in following order: server, intermediate, root)
      image-20240212115108-4
    • key file (must contain unencrypted private key)
      image-20240212120737-8
    • 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
  • 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
        image-20240212122324-15
    • In a web browser, navigate to the URL of the service and view the certificate chain
      image-20240212121750-13
    • In PostMan, review the status of the connection after sending a request
      image-20240212121846-14

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"}]

Document Information

Modified date:
01 October 2024

UID

ibm17116632