By Dana Singleterry on Jan 04, 2009

The process of successfully deploying a 11g ADF BC application to Tomcat 6.x has created a buzz in the JDeveloper forums and there appears to be some confusion as to the best approach. This blog entry documents one approach and includes the basic steps required to deploy and run a simple application that uses ADF BC/ADF Faces and ADF binding on Tomcat 6.x.

Note that this is not the official documentation but simply an approach I took to successfully complete the task at hand.

Required Downloads:
Download Tomcat 6.x.
Download JDeveloper 11g.
Download Oracle XE or some other database.
Download Application Workspace TomcatADFApp.zip.
Download database schema soademo.dmp.

High level steps for your Fusion Web Application:
1. Create a Fusion Web Application.
2. Create Business Components from tables. Ensure you create the application module.
3. Edit the default deployment profile.
4. In the WEB-INF/lib Filters of the deployment profile, deselect all libraries.
5. For the Platform in the deployment profile, select Tomcat 6.x as the Default Platform.
6. Ensure that your Application Module uses a Datasource Connection. Not a url connection string.
7. You will need to add a context.xml with your datasource connection details.
8. JPSFilter detail in your web.xml will need to be commented out.
9. Security detail in your adf-config.xml will need to be commented out.
10. Right click on your Viewcontroller and select deploy from context. Deploy to war.

Please

Install the soademo schema in your database.
1. Create a database user with id/pwd of soademo/oracle.
2. Download soademo.dmp.
2. Run imp soademo.dmp using your schema credentials of soademo/oracle.

High level steps for your Tomcat Application Server Configuration:
1. Create a Datasource connection on Tomcat. Modify server.xml and context.xml in your %CATALINA_HOME%/conf folder.
2. Copy the following libraries from your JDeveloper install to the %CATALINA_HOME%/lib folder.
adf-controller-api.jar
adf-controller-rt-common.jar
adf-controller.jar
adf-faces-databinding-rt.jar
adf-pageflow-dtrt.jar
adf-pageflow-fwk.jar
adf-pageflow-impl.jar
adf-pageflow-rc.jar
adf-richclient-api-11.jar
adf-richclient-impl-11.jar
adf-share-base.jar
adf-share-ca.jar
adf-share-support.jar
adflibfilter.jar
adflogginghandler.jar
adfm.jar
adfmweb.jar
cache.jar
commons-el.jar
db-ca.jar
dms.jar
dvt-faces.jar
dvt-jclient.jar
dvt-utils.jar
fmw_audit.jar
identitystore.jar
inspect4.jar
javatools-nodeps.jar
javax.management.j2ee_1.0.jar
jewt4.jar
jmxframework.jar
jmxspi.jar
jps-api.jar
jps-common.jar
jps-ee.jar
jps-internal.jar
jps-unsupported-api.jar
jsf-api.jar
jsf-ri.jar
jstl.jar
mdsrt.jar
ojdbc6.jar
oracle-el.jar
oraclepki.jar
org.apache.commons.beanutils_1.6.jar
org.apache.commons.collections_3.1.jar
org.apache.commons.logging_1.0.4.jar
osdt_cert.jar
osdt_core.jar
share.jar
standard.jar
trinidad-api.jar
trinidad-impl.jar
wls-api.jar
xercesImpl.jar
xmlef.jar
xmlparserv2.jar
3. Start up Tomcat and take your application war file and drop it in the %CATALINA_HOME%/webapps folder to auto deploy.
4. The application can be accessed through the url: http://localhost:yourAppServerport/TomcatADFApp/faces/OEView.jspx

For another perspective on setting up ADF Faces based JSF Runtime environment in Tomcat 6, please visit Terry Chos’s blog.

For details on how to configure Tomcat 6.x for ADF and deploy a 11g Release 1(11.1.1.1.0) ADF application to Tomcat please follow the forum post and solution on Oracle’s Technology Network forum for JDeveloper & ADF.