IBM Support

Run-time error when JDBC driver files are found in old locations

Troubleshooting


Problem

In IBM Cognos Analytics, the JDBC driver (JAR) files must be located in the /drivers directory. If these files are found in the old locations, a run-time error occurs.

Environment

The old locations are:
<ca_location>/webapps/p2pd/WEB-INF/lib
<ca_location>/v5dataserver/lib

The Java Runtime Environment (JRE) used by Cognos Analytics places the <ca_location>/drivers folder at the end of the class path that Java uses to load the JAR files from. When the JRE attempts to load a  driver class name, it searches the class path for a JAR file that includes that class.

As of Cognos Analytics 11.0.5, when testing a data source connection in the administration component, an information message is displayed when a JDBC driver file was loaded from the deprecated location. If the driver was loaded from the <ca_location>/drivers folder, no message is displayed.

As of Cognos Analytics 11.0.6, an exception is thrown if a JDBC driver file was loaded from the old location.

If Cognos Analytics detects that a driver file is being loaded from the old folders, the administrator should remove the JAR files from those folders and ensure that the files are moved to the <ca_location>/drivers folder.

[{"Product":{"code":"SSTSF6","label":"IBM Cognos Analytics"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Administration and Configuration v11x","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"11.0","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
15 June 2018

UID

swg22001003