Configuring Standalone OC4J 11g Technology Preview Release for ADF 11g Application Deployment

Abstract

This paper provides step-by-step instructions to configure OC4J Extended 11.1.1.0.0 Technology Preview release for ADF 11g Technology Preview application deployment.

Contents

1 Introduction

When building applications using JDeveloper 11g Technology Preview (build 4524) that leverage Oracle Application Development Framework 11g, as always you can run and debug them on the embedded OC4J server that accompanies JDeveloper 11g. However, if you want to deploy an ADF 11g application to an external OC4J instance, then you can either:

1. Run the JDEVHOME/jdev/bin/start_oc4j script to startup the embedded server in standalone mode that is pre-configured for ADF 11g deployment, or
2. Download the OC4J 11g Standalone Technology Preview release from here and then install the ADF 11g framework onto it.

2 Configuration Prerequisites

Prerequisites for configuring the standalone OC4J 11g Technology Preview distribution for ADF 11g application deployment:

• Download the OC4J 11g Technology Preview distribution (oc4j_11110_preview.zip) from here.
• Download the JDeveloper 11g Technology Preview ("Studio Edition") from here.

Furthermore, the instructions below assume you have:

• Unzipped the JDeveloper 11g Technology Preview into the C:\jdev11gtp directory
• Unzipped the OC4J 11g Standalone Technology Preview into the C:\oc4j11gtp directory

If you have unzipped these distributions into directories of a different name, you'll need to modify the instructions below accordingly.

3 Configuration Steps

To configure the standalone OC4J 11g Technology Preview installation in C:\oc4j11gtp for ADF 11g application development, perform the following steps:

1. Run the ADF Runtime Installer inside JDeveloper 11g

   • From the JDeveloper 11g main menu, select Tools | ADF Runtime Installer > Standalone OC4J

     The ADF Runtime Installer for Standalone OC4J wizard appears.

   • On Step 2 of 4, enter C:\oc4j11gtp for the OC4J root directory name, and click (Next>)
   • On Step 3 of 4, select the Install a new version of the ADF runtime option, and click (Next>)
   • On Step 4 of 4, click (Finish)
   • When the "ADF Runtime Installer" HTML document summarizing the installation steps performed appears in a JDeveloper 11g editor, ignore the several "Input File doesn't exist" errors that appear there.

2. Copy Additional Required Libraries from JDeveloper 11g Directory to OC4J 11g Standalone Directory

   set JDEVHOME=C:\jdev11gtp
set OC4JHOME=C:\oc4j11gtp
copy %JDEVHOME%\bc4j\lib\bc4j-svc-client.jar   %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\bc4j\lib\bc4j-svc-share.jar    %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\bc4j\lib\bc4j-svc.jar          %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\jlib\resourcebundle.jar        %OC4JHOME%\jlib
copy %JDEVHOME%\BC4J\lib\adfdeployrt.jar       %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\adfideutils.jar       %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\adflibrary.jar        %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\adfrcutils.jar        %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\adfsharembean.jar     %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\bc4jsyscat.jar        %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\bc4jwizard.jar        %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\connmbean.jar         %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\db-ca.jar             %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\groovy-all-1.0.jar    %OC4JHOME%\BC4J\lib
copy %JDEVHOME%\BC4J\lib\mod-bc4jimdomains.jar %OC4JHOME%\BC4J\lib

3. Update ADF Shared Library Definitions in OC4J 11g Standalone Directory

To update the ADF shared library definitions in the OC4J 11g standalone directory, to the following:

• Make a backup copy of the server.xml file in the C:\oc4j11gtp\j2ee\home\config directory

• Edit the server.xml file in the C:\oc4j11gtp\j2ee\home\config directory to make the following changes:

  • Delete all of the contiguous lines in the file shown here:

       <shared-library name="adf.oracle.domain" version="11.1.1" library-compatible="true">
     <!-- etc. -->
   </shared-library>
   <shared-library name="adf.generic.domain" version="11.1.1" library-compatible="true">
     <!-- etc. -->
   </shared-library>

  • Replace the deleted lines with the following lines:

     <shared-library name="oracle.expression-evaluator" version="11.1.1" library-compatible="true">
      <code-source path="${oracle.home}/jlib/commons-el.jar"/>
      <code-source path="${oracle.home}/jlib/oracle-el.jar"/>
      <code-source path="${oracle.home}/jlib/jsp-el-api.jar"/>
   </shared-library>
   <shared-library name="adf.oracle.domain" version="11.1.1" library-compatible="true">
      <import-shared-library name="sun.jaxb"/>
      <import-shared-library name="oracle.xml"/>
      <import-shared-library name="oracle.jdbc"/>
      <import-shared-library name="oracle.gdk"/>
      <import-shared-library name="oracle.cache"/>
      <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"/>
      <import-shared-library name="oracle.expression-evaluator"/>
      <code-source path="${oracle.home}/BC4J/lib"/>
      <code-source path="${oracle.home}/jlib/commons-cli-1.0.jar"/>
      <code-source path="${oracle.home}/mds/lib/concurrent.jar"/>
      <code-source path="${oracle.home}/mds/lib/mdsrt.jar"/>
      <code-source path="${oracle.home}/jlib/share.jar"/>
      <code-source path="${oracle.home}/jlib/regexp.jar"/>
      <code-source path="${oracle.home}/jlib/xmlef.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/adfmtl.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/adfui.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/adf-connections.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/dc-adapters.jar"/>
      <code-source path="${oracle.home}/ord/jlib/ordim.jar"/>
      <code-source path="${oracle.home}/ord/jlib/ordhttp.jar"/>
      <code-source path="${oracle.home}/jlib/ojmisc.jar"/>
      <code-source path="${oracle.home}/jlib/commons-collections.jar"/>
      <code-source path="${oracle.home}/j2ee/home/lib/adflogginghandler.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/jdev-cm.jar"/>
      <code-source path="${oracle.home}/lib/xsqlserializers.jar"/>
      <code-source path="${oracle.home}/jlib/resourcebundle.jar"/>
      <import-shared-library name="oracle.ws.jaxrpc"/>
      <import-shared-library name="oracle.fabric"/>
      <import-shared-library name="oracle.fabric.interceptors"/>
   </shared-library>
   <shared-library name="adf.generic.domain" version="11.1.1" library-compatible="true">
      <import-shared-library name="sun.jaxb"/>
      <import-shared-library name="oracle.xml"/>
      <import-shared-library name="oracle.jdbc"/>
      <import-shared-library name="oracle.gdk"/>
      <import-shared-library name="oracle.cache"/>
      <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"/>
      <import-shared-library name="oracle.expression-evaluator"/>
      <code-source path="${oracle.home}/BC4J/jlib/bc4jdomgnrc.jar"/>
      <code-source path="${oracle.home}/BC4J/lib"/>
      <code-source path="${oracle.home}/jlib/commons-cli-1.0.jar"/>
      <code-source path="${oracle.home}/mds/lib/concurrent.jar"/>
      <code-source path="${oracle.home}/mds/lib/mdsrt.jar"/>
      <code-source path="${oracle.home}/jlib/share.jar"/>
      <code-source path="${oracle.home}/jlib/regexp.jar"/>
      <code-source path="${oracle.home}/jlib/xmlef.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/adfmtl.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/adfui.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/jdev-cm.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/adf-connections.jar"/>
      <code-source path="${oracle.home}/BC4J/jlib/dc-adapters.jar"/>
      <code-source path="${oracle.home}/ord/jlib/ordim.jar"/>
      <code-source path="${oracle.home}/ord/jlib/ordhttp.jar"/>
      <code-source path="${oracle.home}/jlib/ojmisc.jar"/>
      <code-source path="${oracle.home}/jlib/commons-collections.jar"/>
      <code-source path="${oracle.home}/j2ee/home/lib/adflogginghandler.jar"/>
      <code-source path="${oracle.home}/lib/xsqlserializers.jar"/>
      <code-source path="${oracle.home}/jlib/resourcebundle.jar"/>
      <import-shared-library name="oracle.ws.jaxrpc"/>
      <import-shared-library name="oracle.fabric"/>
      <import-shared-library name="oracle.fabric.interceptors"/>
   </shared-library>

• Save your changes

4 Starting Up the Standalone OC4J 11g for ADF Deployment

After completing the above steps, you should be able to target this standalone instance of the OC4J 11g Technology Preview release for ADF 11g application deployment and testing. We recommend starting the server with the following command line:

C:\> cd oc4j11gtp\j2ee\home
C:\oc4j11gtp\j2ee\home> java -XX:MaxPermSize=256m -jar oc4j.jar

Revision History