Tutorial: Upgrading WLI 8.1 or Higher and WLI 9.2 Application Source to WLI 10g Release 3 (10.3)

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Tutorial: Overview

This tutorial describes how to upgrade WLI 8.1 (Service Pack 4 or 5), WLI 9.2, and WLI 10.2 applications, to the Oracle WebLogic Integration 10g Release 3 (10.3) environment. This tutorial describes the upgrade scenario using a Process Application sample created in WebLogic Platform 8.1.

This section includes the following:

 

Tutorial Objective and Scope

You must have in depth knowledge of WebLogic Platform, in particular, WLI 8.1, WLI 9.2, and WLI 10.2. The objective of this tutorial is to help you upgrade your existing WLI applications to Oracle WebLogic Integration 10g Release 3 (10.3). The upgrade process does not alter the source application logic and intent in any manner. The process simply upgrades the application for use in the Oracle Workshop for WebLogic workspace.
Upgrading an application to WLI 10g Release 3 (10.3) involves the following steps:

 

Prerequisites

There are a few prerequisites for the smooth execution of this tutorial. For example, you require an application from the WLI 8.1 or WLI 9.2 release as the source for the upgrade exercise. The requirements for successful execution of the tutorial are as follows:

 

About the Import Wizard

The upgrade process from WLI 8.1 or WLI 9.2 to Oracle WebLogic Integration 10g Release 3 (10.3) is handled by an import wizard. The wizard does not alter the logic and intent of the existing WLI 8.1 or WLI 9.2 application, nor extract the application from any source repository. The wizard migrates the WLI 8.1 or WLI 9.2 source artifacts into the Oracle WebLogic Integration 10g Release 3 (10.3) source and project model. However, it retains the WLI 8.1 or WLI 9.2 Javadoc annotations as they do not require any special processing in Oracle WebLogic Integration 10g Release 3 (10.3). In addition, these annotations are retained to facilitate any manual processing that may be required after upgrading the application.

You can use the import wizard to do the following:

 

Creating the Source WLI 8.1 Application

For the purpose of this tutorial, you must first create a Request Quote application in the WebLogic Platform 8.1 Service Pack 5 release. Applications created using Service Pack 4 or 6 can also be upgraded using this tutorial.

To create the new application in WLI 8.1, complete the following steps:

  1. In WebLogic Workshop 8.1 select the File > New > Application... menu option. The New Application dialog box is displayed.
  2. In the left pane select Tutorial and in the right pane, select Tutorial: Process Application.
  3. In the Name: field, type the name sampleApp. The New Application dialog box is displayed as shown in Figure 1-1.
    4. Figure 1-1 Creating a New Application in WebLogic Platform 8.1


    Creating a New Application in WebLogic Platform 8.1

  4. Click Create.
  5. In the Application pane of WebLogic Workshop, navigate to view the sampleApp > sampleAppWeb > requestquote > services > AvailProcessor.jws web service file.
  6. Double-click the file to view its Source View in the adjacent pane, as shown in Figure 1-2.
    7. Figure 1-2 Viewing the Web Service Source


    Viewing the Web Service Source

  7. In the highlighted text (public interface Callback extends weblogic.jws.control.ServiceControl) of the source view, as shown in Figure 1-2, replace weblogic.jws.control.ServiceControl with com.bea.control.Control.
  8. At the beginning of the source file, replace import weblogic.jws.control.JwsContext with import com.bea.control.JwsContext.
    9. Note: The weblogic.jws.control.ServiceControl and the weblogic.jws.control.JwsContext are deprecated. You must replace these APIs in all the web services for an error-free upgrade to WLI 10g Release 3 (10.3).
  9. Complete step 5 to step 9 for the remaining two web services, PriceProcessor.jws and TaxCalc.jws.
  10. Save and close the application.

The application, sampleApp is ready for use. You can upgrade sampleApp using the Oracle Workshop for WebLogic 10g Release 3 (10.3) IDE.

 

Creating the Source WLI 9.2 Application

For the purpose of this tutorial, you must first create a Request Quote application in the WebLogic Integration 9.2 release. The primary goal of this task is to create an Application in WLI 9.2 and upgrade into the Oracle WebLogic Integration 10g Release 3 (10.3) release.

If you do not have an existing project in WLI 9.2, you need to create the new application in WLI 9.2. To do this, complete the following steps:

  1. In WebLogic Workshop 9.2 select the File > New > Project > WebLogic Integration > Process Application menu option. The Process Application dialog box is displayed as shown in Figure 1-3.
    2. Figure 1-3 Create a new Process Application


    Create a new Process Application

  2. Enter an EAR Project name, Web Project name and Utility Project name and click Finish to create the project.
  3. Alternatively you can skip the first two steps and select File > Import > Workshop 8.1 Application and click Next on the Import dialog box to import the 8.1 application into the workspace.
  4. Specify the path to the WLI 8.1 application on the Application Import dialog box, or the archive file, open the .work file and click Next to set upgrade preferences on the Source Upgrade dialog box. See Importing the Application Source for more details.
  5. Click Next to start the upgrade, and preview the pending upgrade actions on the Upgrade Preview dialog box. Click Finish on the Upgrade Preview dialog box to complete the project upgrade to WLI 9.2.
  6. Save and close the project. You have successfully imported an WLI 8.1 application into the WLI 9.2 workspace.

  Back to Top       Previous  Next