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. 

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.

 

 

Issue/Introduction

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