|Oracle® Fusion Middleware SmartUpgrade User's Guide
11g Release 1 (11.1.1)
This chapter introduces the Oracle WebLogic Server SmartUpgrade software. It includes the following sections:
Oracle WebLogic Server SmartUpgrade is an Oracle JDeveloper extension and command-line utility that analyzes the applications you deployed previously on OC4J. It then offers advice and performs actions that can help you successfully redeploy the applications on Oracle WebLogic Server.
You can analyze an application archive, or you can analyze an application or project you have opened in Oracle JDeveloper. In addition, SmartUpgrade can analyze the OC4J server where you deployed your applications and provide advice on how to set up a similar configuration in Oracle WebLogic Server.
In addition to providing a comprehensive report with specific findings about each application, SmartUpgrade can also automate some of the upgrade tasks. For Web services applications, SmartUpgrade can upgrade your OC4J Web services automatically and optionally package the upgraded Web services as enterprise archives that can be deployed on Oracle WebLogic Server.
For Web-based applications, SmartUpgrade can generate specific types of artifacts that can speed up your application upgrade tasks.
Oracle WebLogic Server SmartUpgrade is one several Oracle software tools that can help you upgrade your entire Oracle Application Server or Oracle WebLogic Server environment to Oracle Fusion Middleware 11g.
As a result, you can use SmartUpgrade as part of an overall approach to upgrading your environment. Oracle recommends that you use SmartUpgrade in conjunction with the other upgrade-related Oracle Fusion Middleware documentation resources.
Refer to the following for more information:
For information about upgrading all the components of your application server and middleware environment, refer to the Oracle Fusion Middleware Upgrade Planning Guide.
For specific information about upgrading your Java EE applications and Oracle Application Server 10g environment to Oracle WebLogic Server, see the Oracle Fusion Middleware Upgrade Guide for Java EE.
After SmartUpgrade analyzes a selected enterprise archive or Oracle JDeveloper application or project, SmartUpgrade generates an application upgrade report. You can then browse the report to identify potential issues to address before you can deploy it on Oracle WebLogic Server. Each issue is referred to as a "finding."
Each finding is assigned various attributes, including the level of priority and complexity. The priority and complexity attributes can help you plan the work required to modify and redeploy an application on Oracle WebLogic Server.
The reason defines why the finding exists. It often identifies a particular element or attribute in the deployment descriptors of the application archive or in the configuration files of the OC4J server. It also identifies the dependency APIs used in the application, which need to be changed before the application can be deployed to Oracle WebLogic Server.
The advice identifies the actions you must take to resolve the issues identified in the finding. The advice often includes instructions or references to documentation that can help you modify the application or the Oracle WebLogic Server environment appropriately.
The implications of the finding. The implication is optional (not always shown) and indicates the differences in behavior (if any) that will be noticed in the upgraded application as a result of following the finding's advice.
In addition to the upgrade report, SmartUpgrade can optionally generate specific types of application artifacts, such as Oracle WebLogic Server deployment descriptors, data source configurations, and Web services.
Instead of reviewing the report findings and creating these artifacts yourself, you can use SmartUpgrade to generate the artifacts for you, which can save you time and effort when upgrading your applications for Oracle WebLogic Server.
For more information, see the following sections:
If you configure SmartUpgrade to generate artifacts for a typical Java EE application, then SmartUpgrade analyzes the OC4J deployment descriptors within the application and, for specific elements within the OC4J-specific deployment descriptor, generates sample files that contain the equivalent deployment descriptor elements that can be used to deploy the application on Oracle WebLogic Server.
You can then use the generated deployment descriptors as a starting point for creating the require Oracle WebLogic Server deployment descriptors for your upgraded application.
For more information, see Section 4.2, "Using Web Application Deployment Descriptor Artifacts Generated by SmartUpgrade".
SmartUpgrade makes it possible to quickly and efficiently upgrade and deploy your Web services to Oracle WebLogic Server, while preserving the existing URLs and interfaces with remote applications in your environment.
When you configure SmartUpgrade to generate artifacts for a Web services application, SmartUpgrade analyzes the OC4J Web services and performs three distinct tasks automatically:
Uses Oracle Weblogic Server service generation tools to generate the service skeleton artifacts for each WSDL in the application.
The skeleton includes:
A new set of value types or data transfer objects
A new service endpoint interface (SEI) and a skeleton Web service
Oracle WebLogic Server deployment descriptors
Provides the implementation of the skeleton Web service. This implementation is called "glue code" and is generated with required annotations supported by Oracle WebLogic Server.
As part of the implementation, dispatches requests to the original Web service implementation class, which is part of the OC4J application being upgraded. It performs this task by converting the new value types into the original value types.
SmartUpgrade ensures that the existing clients of the original OC4J Web services are not affected by the upgrade. The original WSDL contract is preserved and existing clients can continue to interoperate with the new Web service generated for Oracle WebLogic Server.
Note that the generated Web services glue code contains the required annotations.
For dedicated Web services applications, you can configure SmartUpgrade to package the generated Web services configuration into an archive that you can deploy directly to Oracle WebLogic Server.
For more information, see Section 4.3, "Using Web Services Artifacts Generated by SmartUpgrade".
Refer to the following resources for details:
For information on using the Oracle JDeveloper extension, see Chapter 2, "Using SmartUpgrade with Oracle JDeveloper".
For information about using the command-line interface, see Chapter 3, "Using the SmartUpgrade Command Line"
Refer to the following sections for more information about downloading and installing SmartUpgrade:
If you have previously installed SmartUpgrade Release 1.0, then you must remove the existing SmartUpgrade installation before you install SmartUpgrade Release 1.1.
To remove SmartUpgrade Release 1.0:
Stop Oracle JDeveloper.
Start Oracle JDeveloper.
You can obtain SmartUpgrade in one of two ways:
From the Oracle Fusion Middleware Companion CD-ROM, which is part of the Oracle Fusion Middleware CD-ROM pack
For example, to download and unpack the SmartUpgrade ZIP file from OTN:
Use your Web browser to navigate to the following URL on OTN:
Note that the first time you access OTN, you will have to register. Registration is free and provides you with access to all the resources on OTN.
Click the link to download Oracle WebLogic Server SmartUpgrade.
At the time this document was published, the SmartUpgrade download link was located under the Free Downloads image on the right side of the page.
Follow the instructions on the screen to download a ZIP file that contains all the required SmartUpgrade files.
Unpack the ZIP file in a temporary directory on your local disk.
Table 1-1 describes the contents of the ZIP file.
Table 1-1 Contents of the SmartUpgrade ZIP File
A text file that describes the files in the ZIP file.
A ZIP file containing the files required to use the SmartUpgrade command-line interface.
A text file that describes late-breaking information about this SmartUpgrade download.
A ZIP file containing the files required to install the SmartUpgrade Oracle JDeveloper extension.
To install the Oracle JDeveloper SmartUpgrade extension from the contents of the downloadable ZIP file:
Verify that you are currently running Oracle JDeveloper 11g.
If necessary, download and install Oracle JDeveloper 11g from the following location on OTN:
For Oracle JDeveloper installation instructions, refer to the Oracle Fusion Middleware Installation Guide for Oracle JDeveloper.
If you have previously installed SmartUpgrade Release 1.0, then deinstall Release 1.0, using the instructions in Section 1.6.1, "Deinstalling SmartUpgrade Release 1.0".
Start Oracle JDeveloper.
Click Next on the Welcome page of the Check for Updates wizard.
On the Source page, select Install From Local File.
Click Browse to locate and select the
jdeveloper_smartupgrade.zip file you obtained and unpacked in Section 1.6.2, "Obtaining the SmartUpgrade ZIP Files".
Click Finish to install the SmartUpgrade extension.
Restart Oracle JDeveloper.
After you restart Oracle JDeveloper, refer to Chapter 2, "Using SmartUpgrade with Oracle JDeveloper".
Note:Future updates to Oracle JDeveloper will be available by selecting one of the Search Update Centers options in the Check for Updates wizard as they are available.
When you install the SmartUpgrade Oracle JDeveloper extension, the files required to run the command-line interface are installed automatically.
If you do not install the Oracle JDeveloper extension, and you want to install only the SmartUpgrade command-line interface, you can do so from the contents of the downloadable ZIP file or the SmartUpgrade files available on the Oracle Fusion Middleware 11g Release 1 (126.96.36.199.0) Companion CD-ROM.
To install and configure the SmartUpgrade command-line interface without using Oracle JDeveloper:
Verify that you have installed and configured one of the following prerequisites:
For more information, refer to the following Web site for information on downloading the Java 1.6 Software Development Kit (SDK) or Java Runtime (JRE):
Apache Ant 1.7 is available is installed as part of any Oracle WebLogic Server 11g installation. You can also download it from the following URL:
Oracle includes the
smartupgrade.zip file as part of the SmartUpgrade download from the Oracle Technology Network (OTN), as well as on the Oracle Fusion Middleware 11g Release 1 (188.8.131.52.0) Companion CD-ROM.
Verify that the following files are unpacked into the directory:
For get started using the command-line interface, refer to Chapter 3, "Using the SmartUpgrade Command Line".
For the most up-to-date information about SmartUpgrade, including tutorials, data sheet, and the most recent version of this guide, refer to the Oracle Fusion Middleware Upgrade page on the Oracle Technology Netwwork (OTN):