Resolution:
Description:
=========

Domain Utility fails with "AESDKJ-0000 java.lang.NoClassDefFoundError: oracle/dms/instrument/ExecutionContextForJDBC" error while doing any operation (like Add Machine) on a domain having Oracle database backend.


Environment:
===========
TIBCO Runtime Agent (TRA) 5.x.x
TIBCO Administrator 5.x.x
Oracle Database version 10.x


Symptoms:
========
The domainutility.log shows the following exception:

2011 Feb 21 10:59:16:619 GMT -0800 DU Error [DomainUtility] AESDKJ-0000 java.lang.NoClassDefFoundError: oracle/dms/instrument/ExecutionContextForJDBC
    at oracle.jdbc.driver.PhysicalConnection.&ltinit>(PhysicalConnection.java:340)
    at oracle.jdbc.driver.T2CConnection.&ltinit>(T2CConnection.java:131)
    at oracle.jdbc.driver.T2CDriverExtension.getConnection(T2CDriverExtension.java:77)
    at oracle.jdbc.driver.OracleDriver.connect(OracleDriver.java:767)
    at java.sql.DriverManager.getConnection(DriverManager.java:582)
    at java.sql.DriverManager.getConnection(DriverManager.java:185)
    at com.tibco.administrator.domain.DomainConfiguration.a(DomainConfiguration.java:1716)
    at com.tibco.administrator.domain.DomainConfiguration.createDbDomainFiles(DomainConfiguration.java:1169)
    at com.tibco.administrator.domain.DomainConfiguration.joinDomain(DomainConfiguration.java:1060)
    at com.tibco.administrator.du.task.addmachine.JoinDomainTask.joinDomain(JoinDomainTask.java:255)
    at com.tibco.administrator.du.task.addmachine.JoinDomainTask.execute(JoinDomainTask.java:219)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
    at java.lang.reflect.Method.invoke(Method.java:597)
    at com.tibco.administrator.wizard.progress.Trampoline.invoke(Trampoline.java:96)
    at com.tibco.administrator.wizard.progress.BusyWait.run(BusyWait.java:267)
    at java.lang.Thread.run(Thread.java:662)
Caused by: java.lang.ClassNotFoundException: oracle.dms.instrument.ExecutionContextForJDBC
    at java.net.URLClassLoader$1.run(URLClassLoader.java:202)
    at java.security.AccessController.doPrivileged(Native Method)
    at java.net.URLClassLoader.findClass(URLClassLoader.java:190)
    at java.lang.ClassLoader.loadClass(ClassLoader.java:307)
    at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:301)
    at java.lang.ClassLoader.loadClass(ClassLoader.java:248)


Cause:
=====
The "tibco.class.path.extended" variable in the domainutility.tra file does not contain a reference to the path containing dms.jar.


Resolution:
==========
The class "oracle/dms/instrument/ExecutionContextForJDBC" is present in the dms.jar file which is part of "OC4J" package under Oracle installation. Add the location of dms.jar file to the tibco.class.path.extended variable in domainutility.tra to resolve this issue.