How To Update Oracle ADF Runtime Libraries to Oracle Application Server 10g

An Oracle JDeveloper How To Document
Ralph Gordon
August 2004

Content

     Introduction
     Running the Oracle ADF Installer in JDeveloper 10g
     Manually Copying the Libraries to Oracle Application Server
     Conclusion

Introduction

Applications that you develop against the Oracle ADF runtime libraries in JDeveloper 9.0.5.x, such as those based on Oracle ADF Business Components, will utilize runtime libraries that do not match the libraries provided by Oracle Application Server 10g. Before you deploy and run your application, you must ensure that the Oracle ADF runtime libraries that reside on the target Oracle Application Server installation be the same version, or later, as the libraries that were used to develop the application in JDeveloper.

JDeveloper provides the Oracle ADF Runtime Installer to help update the Oracle ADF libraries on the Oracle Application Server installation. However, because the Oracle ADF Runtime Installer is designed to run on the same machine as the target Oracle Application Server installation, the error The selection is not an Oracle Application Server home directory. is reported when attempting to install the libraries from a separate machine.

Before performing any updates, verify that your application server is supported by JDeveloper 9.0.5. See the chart provided in the document at this link:

http://otn.oracle.com/products/jdev/collateral/papers/10g/as_supportmatrix.html

This document describes the how to update the Oracle ADF runtime libraries using the Oracle ADF Runtime Installer or, how to update the libraries manually, when you prefer not to install JDeveloper on the target Oracle Application Server machine.

Running the Oracle ADF Installer in JDeveloper 10g

Install JDeveloper on the same machine as the target Oracle Application Server installation and run the Oracle ADF Runtime Installer. The installer is available from the Tools menu in JDeveloper. Choose Oracle Application Server from the submenu. Instructions for running the installer are in the JDeveloper online documentation, or click Help in the installer.

In this case, because JDeveloper resides on the same machine as the Oracle Application Server installation, the Oracle ADF Runtime Installer can find Oracle Home and will automatically locate the Oracle ADF runtime libraries from JDeveloper.

Alternatively, you may map a local drive from a machine that already has JDeveloper installed to the target Oracle Application Server machine and run the Oracle ADF Runtime Installer. Use the mapped drive for the JDeveloper installation.

Note: It is important that the Oracle ADF runtime libraries that reside on the target Oracle Application Server installation be the same version, or later, as the libraries that were used to develop the application in JDeveloper. Be sure to install any maintenance releases of JDeveloper before you update the target environment libraries.

Manually Copying the Libraries to Oracle Application Server

Install JDeveloper on any machine, and then move the required Oracle ADF runtime libraries to the target Oracle Application Server machine.

It is important that the Oracle ADF runtime libraries that reside on the target Oracle Application Server installation be the same version, or later, as the libraries that were used to develop the application in JDeveloper. Be sure to install any maintenance releases of JDeveloper before you update the target environment libraries.

Note: This solution does not rely on the Oracle ADF Runtime Installer. Instead use the following list of runtime libraries to update the application server.

Before you install the Oracle ADF runtime libraries:

1. Optionally, create a backup directory of each directory that you plan to update (see the lists below).
2. Stop all OC4J instances, including the Enterprise Manager instance. Only after completing the installation should you restart the server.
3. If your application works with TopLink mapping objects, you must edit the <ORACLE_Home>/j2ee/home/config/application.xml file to include the following library paths:
   <library path="../../../jlib/ojmisc.jar" />
   <library path="../../../toplink/jlib/toplink.jar" />
   <library path="../../../toplink/jlib/antrl.jar" />

   Note that only TopLink users must edit the application.xml file on the server; other business services do not require this modification.

After you have completed the above steps, you must remove these four files from the existing Oracle Application Server installation in the OC4J root directory:

<ORACLE_Home>/BC4J/lib/datatags.jar
<ORACLE_Home>/BC4J/lib/bc4juixtags.jar
<ORACLE_Home>/BC4J/lib/bc4jhtml.jar
<ORACLE_Home>/BC4J/lib/bc4j_jclient_common.jar

Then you can copy the files shown in the following tables from the JDeveloper source location to the OC4J root directory.

Copy these ADF runtime libraries:

Copy this OJMisc runtime library:

Install these interMedia runtime libraries:

Copy these TopLink runtime libraries:

Copy these BC4J EAR application files:

Conclusion

In JDeveloper 10g, before you deploy your application, you must update the Oracle ADF runtime libraries on the Oracle Application Server machine from the correct JDeveloper installation. The Oracle ADF Runtime Installer, provided with JDeveloper, helps you automate the update process when you can run the installer on the same machine as the target Oracle Application Server installation. If you do not wish to install JDeveloper on the target Oracle Application Server machine, you can copy the Oracle ADF runtime libraries manually from any JDeveloper 9.0.5.x installation.

rrgordon v1.1 3-August-2004