Configuring a 2:nd OC4J Instance for ADF use within an Oracle Application Server

When you setup a second OC4J instance within an Oracle Application Server 10.1.3 it won't have the ADF Libraries configured, this means that if you deploy an ADF application to this instance, it won't work. Further, there is no option neither within JDeveloper nor with the ADF Installer to configure this second instance for use with ADF, so what to do in this situation? Answer: You'll just have to do some manual configuration.

Assuming that you have created the 2:nd OC4J instance by using the createInstance command, you then need to update the files server.xml and application.xml for this instance with some additional configuration before starting it.

Both of these files are located in the directory:

 <ORCALE_AS_HOME>/j2ee/<INSTANCE_NAME>/config

Open them with your favourite editor.

Add the following entries:

server.xml
==========

<shared-library name="oracle.expression-evaluator" version="10.1.3" library-compatible="true">
 <code-source path="../../../jlib/commons-el.jar"/>
 <code-source path="../../../jlib/oracle-el.jar"/>
 <code-source path="../../../jlib/jsp-el-api.jar"/>
</shared-library>

<shared-library name="adf.oracle.domain" version="10.1.3" library-compatible="true">
 <code-source path="../../../BC4J/lib"/>
 <code-source path="../../../jlib/commons-cli-1.0.jar"/>
 <code-source path="../../../mds/lib/concurrent.jar"/>
 <code-source path="../../../mds/lib/mdsrt.jar"/>
 <code-source path="../../../jlib/xmlef.jar"/>
 <code-source path="../../../jlib/commons-el.jar"/>
 <code-source path="../../../jlib/oracle-el.jar"/>
 <code-source path="../../../jlib/jsp-el-api.jar"/>
 <code-source path="../../../BC4J/jlib/adfmtl.jar"/>
 <code-source path="../../../BC4J/jlib/adfui.jar"/>
 <code-source path="../../../BC4J/jlib/jdev-cm.jar"/>
 <code-source path="../../../BC4J/jlib/adf-connections.jar"/>
 <code-source path="../../../BC4J/jlib/dc-adapters.jar"/>
 <code-source path="../../../ord/jlib/ordim.jar"/>
 <code-source path="../../../ord/jlib/ordhttp.jar"/>
 <code-source path="../../../jlib/ojmisc.jar"/>
 <code-source path="../../../lib/xsqlserializers.jar"/>
 <import-shared-library name="oracle.xml"/>
 <import-shared-library name="oracle.jdbc"/>
 <import-shared-library name="oracle.cache"/>
 <import-shared-library name="oracle.dms"/>
 <import-shared-library name="oracle.toplink"/>
 <import-shared-library name="oracle.sqlj"/>
 <import-shared-library name="oracle.ws.core"/>
 <import-shared-library name="oracle.ws.client"/>
 <import-shared-library name="oracle.xml.security"/>
 <import-shared-library name="oracle.ws.security"/>
 <import-shared-library name="oracle.ws.reliability"/>
 <import-shared-library name="oracle.jwsdl"/>
 <import-shared-library name="oracle.http.client"/>
</shared-library>

<shared-library name="adf.generic.domain" version="10.1.3" library-compatible="true">
 <code-source path="../../../BC4J/jlib/bc4jdomgnrc.jar"/>
 <code-source path="../../../BC4J/lib"/>
 <code-source path="../../../jlib/commons-cli-1.0.jar"/>
 <code-source path="../../../mds/lib/concurrent.jar"/>
 <code-source path="../../../mds/lib/mdsrt.jar"/>
 <code-source path="../../../jlib/xmlef.jar"/>
 <code-source path="../../../jlib/commons-el.jar"/>
 <code-source path="../../../jlib/oracle-el.jar"/>
 <code-source path="../../../jlib/jsp-el-api.jar"/>
 <code-source path="../../../BC4J/jlib/adfmtl.jar"/>
 <code-source path="../../../BC4J/jlib/adfui.jar"/>
 <code-source path="../../../BC4J/jlib/jdev-cm.jar"/>
 <code-source path="../../../BC4J/jlib/adf-connections.jar"/>
 <code-source path="../../../BC4J/jlib/dc-adapters.jar"/>
 <code-source path="../../../ord/jlib/ordim.jar"/>
 <code-source path="../../../ord/jlib/ordhttp.jar"/>
 <code-source path="../../../jlib/ojmisc.jar"/>
 <code-source path="../../../lib/xsqlserializers.jar"/>
 <import-shared-library name="oracle.xml"/>
 <import-shared-library name="oracle.jdbc"/>
 <import-shared-library name="oracle.cache"/>
 <import-shared-library name="oracle.dms"/>
 <import-shared-library name="oracle.toplink"/>
 <import-shared-library name="oracle.sqlj"/>
 <import-shared-library name="oracle.ws.core"/>
 <import-shared-library name="oracle.ws.client"/>
 <import-shared-library name="oracle.xml.security"/>
 <import-shared-library name="oracle.ws.security"/>
 <import-shared-library name="oracle.ws.reliability"/>
 <import-shared-library name="oracle.jwsdl"/>
 <import-shared-library name="oracle.http.client"/>
</shared-library>

<application name="bc4j" path="../../../BC4J/redist/bc4j.ear" start="true" />

application.xml
===============

<imported-shared-libraries>
 <import-shared-library name="adf.oracle.domain"/>
</imported-shared-libraries>

Please also verify that the file jdev-cm.jar exists in the location pointed by the line:

 <code-source path="../../../BC4J/jlib/jdev-cm.jar"/>

If this file does not exists there, just copy it from your JDeveloper installation to this location.

When you now start the 2:nd instance you will be able to deploy ADF applications also to this instance.