onsdag, maj 31, 2006

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.

JDeveloper Release 9.0.4.3 Out

The 9.0.4.3 maintenance release is now out. For information of bugs fixed in this release, please refer to:

http://www.oracle.com/technology/products/jdev/htdocs/904/9043_fix_list.html

It can be downloaded from OTN at the URL:

http://www.oracle.com/technology/software/htdocs/jdevlic.html?http://otn.oracle.com/software/products/jdev/htdocs/soft9043.html


For reference, here is the current list of the latest releases of the JDeveloper versions:

9.0.4.3
9.0.5.2
10.1.2.1
10.1.3 SU3