This chapter describes how to upgrade your Oracle Application Server 10g Oracle ADF environment to an equivalent environment in Oracle Fusion Middleware 11g.
Refer to the following sections for more information:
Task 1: Decide Upon an Oracle Fusion Middleware 11g Topology for Your ADF Applications
Task 2: Install and Configure a Oracle WebLogic Server Domain For Your ADF Applications
Before you begin the upgrade process, decide upon a topology for your new Oracle Fusion Middleware 11g environment.
For more information, see Section 3.1, "Information for Oracle ADF Users".
Before you upgrade to Oracle Fusion Middleware 11g, you must install an Oracle Fusion Middleware environment that is similar to the topology you set up for Oracle Application Server 10g.
Refer to the following sections for more information:
Oracle WebLogic Server is available as part of Oracle JDeveloper Studio. As a result, if you are using Oracle JDeveloper Studio as your integrated development environment (IDE), you can install Oracle WebLogic Server as part of the Oracle JDeveloper installation.
For complete instructions for installing and configuring Oracle WebLogic Server with Oracle JDeveloper Studio, see "Installing the Oracle JDeveloper Studio Edition" in Oracle Fusion Middleware Installation Guide for Oracle JDeveloper.
If you are not using Oracle JDeveloper for developing your applications, then you can install the Oracle WebLogic Server software and the Oracle Fusion Middleware Application Developer software suite.
The Application Developer installer allows you to install the software you need to configure a domain with the Java Required Files (JRF) and Oracle Enterprise Manager Fusion Middleware Control domain templates. For information about the JRF template, see Section 5.2.3, "Using the Java Required Files (JRF) Domain Template".
For information about installing and configuring the Oracle Fusion Middleware Application Developer software, see the Installation Guide for Application Developer.
When you configure Oracle WebLogic Server, you configure each domain using domain templates. One of the domain templates available with Oracle Fusion Middleware 11g is the Java Required Files (JRF) template.
The JRF template provides important Oracle libraries and other capabilities that support new versions of APIs that many OC4J applications depend upon.
For information on the types of APIs in the JRF template that are important to upgraded OC4J applications, see "APIs Available With the Java Required Files (JRF) Domain Template" in the Oracle Fusion Middleware Upgrade Guide for Java EE.
To create or extend a domain using the JRF template, refer to the following:
There are multiple ways to create a new Oracle WebLogic Server domain using the JRF template:
Install and configure a development domain using the Oracle JDeveloper 11g installer.
The resulting domain is automatically created using the JRF template.
Install and configure an Application Developer, Oracle SOA Suite, WebCenter, Oracle Identity Management, or Oracle Portal, Forms, Reports, and Discoverer domain.
When you configure any Oracle Fusion Middleware software suite, you have the option of selecting the JRF template while running the configuration tool.
For more information, refer to the appropriate Oracle Fusion Middleware installation guide.
To extend an existing domain with the JRF template, use one of the following methods:
Use the Oracle JDeveloper 11g installer.
In the Oracle JDeveloper installer, select a custom installation and select the ADF Runtime component. This step allows you to install the ADF runtime jar files and domain templates to the server environment.
For more information, see "Creating and Extending WebLogic Domains" in the Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.
Run the Oracle WebLogic Server configuration wizard from an Oracle SOA Suite, WebCenter, Oracle Identity Management, or Oracle Portal, Forms, Reports, and Discoverer Oracle home.
Select the options to extend the domain and select the JRF template when prompted with the list of available templates.
For more information, refer to the appropriate Oracle Fusion Middleware installation guide.
Use Oracle Enterprise Manager Fusion Middleware Control or the ApplyJRF WebLogic Scripting Tool (WLST) command to apply the JRF template to an existing WebLogic server instance.
For more information, see Section 17.3.1, "Applying Java Required Files to a Managed Server or Cluster," in the Oracle Fusion Middleware Administrator's Guide.
A version of Oracle JDeveloper 11g (11.1.1.0.x) was made available to Oracle customers before the release of Oracle Fusion Middleware 11g.
If you have already installed and configured an Oracle WebLogic Server domain using the Oracle JDeveloper 11g (11.1.1.0.x), then you should be aware that Oracle Fusion Middleware 11g and the new Oracle JDeveloper 11g (11.1.1.1.0) provides a newer version of the Oracle ADF runtime software.
To upgrade your existing Oracle WebLogic Server domain with the newer Oracle ADF 11g (11.1.1.1.0) runtime software:
Open the uninstaller for of the Oracle WebLogic Server instance you want to upgrade.
You can find the Oracle WebLogic Server uninstaller in the following location:
On UNIX systems:
WLS_HOME/wlserver_10.3/uninstall/uninstall.sh
On Windows systems:
WLS_HOME\wlserver_10.3\uninstall\uninstall.cmd
Note that on a headless server (such as a Linux or UNIX-based system), you may have to set the DISPLAY variable to an X Server like VNC or Xming.
Select JDeveloper 11g (11.1.1.0.x) Studio Edition 11.1.1.0.0.
Deselect everything under WebLogic Server.
Click Next to complete the uninstall. If you're interested you can click on the Details button to see what was uninstalled.
Open the JDeveloper 11.1.1.1.0 installer.
Select the Oracle WebLogic Server instance where you want to install the new version of the ADF runtime.
Deselect everything, and then select only Application Development Framework Runtime.
Note that this will also automatically select the JDeveloper and ADF folders.
To avoid class loading issues, rebuild all your EAR files.