Domain Utility JDBC error: "Failed to get an instance of the JDBC database driver:" or "ClassNotFoundException"

Domain Utility JDBC error: "Failed to get an instance of the JDBC database driver:" or "ClassNotFoundException"

book

Article ID: KB0071591

calendar_today

Updated On:

Products Versions
TIBCO Administrator -
Not Applicable -

Description

Description:
Using Domain Utility to perform operations generates the error, "Failed to get an instance of JDBC database driver" or "ClassNotFoundException".
Symptoms:
While using Domain Utility the following exception is seen: 
 
"java.lang.Exception: Failed to get an instance of the JDBC database driver:<JDBC_Driver>"
e.g.  java.lang.Exception: Failed to get an instance of the JDBC database driver:oracle.jdbc.driver.OracleDriver
 
While using Domain Utility to create new Domain, clicking "Test Connection" when configuring Database displays:
 
"java.lang.ClassNotFoundException: <JDBC_Driver>"
e.g. java.lang.ClassNotFoundException: oracle.jdbc.driver.OracleDriver


Cause:
The errors indicate that the Domain Utility is unable to locate the corresponding JDBC driver. Example: For " java.lang.Exception: Failed to get an instance of the JDBC database driver:oracle.jdbc.driver.OracleDriver",  ojdbc#.jar or a JAR file containing Oracle Thin Drivers is missing.

Similar error may happen if other databases (SQL Server, MySQL, PostgreSQL etc) is used and the related JDBC driver is missing. 

Issue/Introduction

Domain Utility JDBC error: "Failed to get an instance of the JDBC database driver:" or "ClassNotFoundException"

Resolution

run the traDBConfig utility to specify the driver classpath so that the TIBCO Runtime Agent utilities know which driver to use and where the driver is located.

Note:

 

  • Make sure the driver classpath in DomainUtility.tra are correctly set and rerun the Domain Utility.
  • For details using traDBConfig, refer to the TIBCO Runtime Agent Documentation: Upgrading to Runtime Agent -->Chapter 1 Upgrading to Release 5.x : Configuring Vendor-supplied Database Drivers.