This document describes the procedures required to upgrade your application environment to BEA WebLogic Integration 9.2 or 9.2 MP1 from:
BEA WebLogic Integration™ 8.1 SP4
BEA WebLogic Integration™ 8.1 SP5
BEA WebLogic Integration™ 8.1 SP6
BEA WebLogic Integration™8.5
BEA WebLogic Integration™8.5 SP5
BEA WebLogic Integration™8.5 SP6.
An application environment includes applications, the WebLogic domains in which they are deployed, and any application data associated with the domains. It may also include external resources, such as database servers, firewalls, load balancers, and LDAP servers.
Terminology Used in This Document
We recommend that, before proceeding, you familiarize yourself with the following terminology:
Compatibility—The capability of an application built using one release or service pack to run in another release or service pack, with or without rebuilding the application.
IDE—Integrated Development Environment. This refers to the BEA Workshop for WebLogic Platform development environment based on Eclipse, which is a development platform that blends open source and commercial software, and is standards-based.
The capability of an application deployed in one release or service pack to communicate with another application that is deployed in a different release or service pack.
The capability of BEA WebLogic Platform™ components to communicate with third-party software over standard protocols.
Table 1-1 does not provide a complete list of new features. It is a list of enhancements because of which, WebLogic Platform 8.1 applications will not be binary-compatible and will require automated or manual changes during an upgrade to WebLogic Integration 9.2 or 9.2 MP1.
Table 1-1 What's New that Impacts the Upgrade Process
The BEA Workshop for WebLogic Platform 9.2 IDE is now based on Eclipse 3.1.2, delivering a software development platform that blends open source and commercial software, and is standards-based. The IDE provides access to core Eclipse features, such as source editing, jUnit test integration, and refactoring. It also includes a robust tool set available from the Eclipse Web Tools Platform (WTP) 1.0 project, including server plug-ins for multiple runtimes. For more information about Eclipse 3.1.2 and Eclipse WTP 1.0, see http://www.eclipse.org.
In WebLogic Integration 9.2, the IDE delivers design views for developing JPDs. Additional design views to support Web Service and Java control development will be provided in later releases of WLI 9.2.
Note: In February 2005, BEA joined the Eclipse Foundation as a Strategic Developer and Board Member to further its commitment to open source and standards organizations.
Apache Beehive 2.0
BEA Workshop for WebLogic Platform 9.2 provides tools to make building applications with Apache Beehive 2.0 easier, including support for:
Java controls—based on Plain Old Java Objects (POJO) architecture.
NetUI—based on Struts, and including Page Flows and JSP tags.
Apache Beehive is an open-source programming model designed to simplify J2EE programming tasks and is built on J2EE and Struts.
BEA enhanced Beehive, which evolved from its BEA Workshop for WebLogic Platform product, to provide a simplified development model for all WebLogic applications. For more information about Apache Beehive, see http://beehive.apache.org.
The programming model for Web Services, EJBs, Java controls, and Java Page Flows uses the new J2SE 5.0 metadata annotation language (specified in JSR-175). In this programming model, you create a Java file that uses annotations to specify the structure and characteristics of the component. From these annotations, the compiler takes care of generating the required supporting artifacts, including Java source code, deployment descriptors, and so on.
EJB annotations as defined in EJBGen Reference in Programming WebLogic Enterprise JavaBeans.
Java control and NetUI (Page Flow) annotations as defined in Apache Beehive 2.0. For more information, see http://beehive.apache.org.
WebLogic-specific annotations to support security policy configuration, asynchronous failure and response, and conversational Web Service support. For more information, see Programming the JWS File in Programming Web Services for WebLogic Server.
WebLogic Server 9.2 offers the following enhancements to the structure of the WebLogic domain directory:
To improve configuration management and promote XML file validation, WebLogic Server supports the specification of domain configuration data in multiple files, including config.xml in the new <domain_name>/config directory. (Here, domain_name specifies the domain directory.) In previous releases, the config.xml file was the repository for all configuration information. In WebLogic Integration 9.2, new subdirectories of the config directory maintain configuration modules for diagnostic, JDBC, JMS, Node Manager, and security subsystems. Each configuration file adheres to an XML Schema definition.
Startup and shutdown scripts are maintained in the domain_name/bin directory. In previous releases, they were stored in the root directory of the domain.
In addition to the structural enhancements to the domain directory, WebLogic Server supports new utilities for managing changes to server configuration. These new tools enable you to implement a secure, predictable means for distributing configuration changes in a domain. For more information, see Understanding Domain Configuration.
The Upgrade Process
WebLogic Integration allows you to upgrade using any one of the following methods:
Single-Step—provides you the option to import the 8.x applications into the Eclipse workspace and then begin the upgrade process.
Multi-Step—provides you the option to first import the files, upgrade them (individually or by directory) and then cancel the upgrade process, if you would like to continue at a later point of time.
Upgrade from the command line—provides you the option to upgrade 8.x applications using an Ant task. In this method you use an 8.x work file as the source parameter and the Eclipse workspace as the destination parameter.
At a high-level, the steps involved in upgrading from WebLogic Integration 8.x to WebLogic Integration 9.2 or 9.2 MP1 are:
Use the Upgrade Wizard, or the upgradeStarter command or the upgrade Ant task to upgrade WebLogic Integration 8.x.
Use the WebLogic Upgrade Wizard to upgrade the domain. The Wizard updates the directory structure, and the following to WebLogic Integration 9.2 or 9.2 MP1:
Domain Database Tables
Custom Security Providers
For 9.2 MP1, run the upgrade tool to modify config.xml to point to 9.2.1 libraries.
Upgrade External resources such as Firewalls, Load Balancers, Databases, and LDAP servers. For example, Apache 1.3 should be upgraded to 2.0 and Oracle 8.1.7 should be upgraded to Oracle 9i to function with WebLogic Integration 9.2.
Check and compare the supported configurations for WebLogic Integration 9.x and 8.x and ensure that the configurations are upgraded to match version 9.x specifications.
Use the Application Upgrade tool to upgrade the Application Source. You can run the tool from the Eclipse IDE or the command line. The Eclipse plug-in is an extension to the BEA Workshop for WebLogic Platform framework. It updates the:
Application source code
WebLogic Integration 8.x artifacts such as JPD, DTF/XQuery, JCX Controls and JCS files to WebLogic Integration 9.2 standards. It changes all file extensions such as .jpd, .jpf, .app, .jcs, .jcx, and .jws to .java. It also updates all JPD, DTF, JCX, and JCS Annotations to the JSR 175 based Annotation model.
Optionally, upgrade XQuery 2002 files to XQuery 2004. You may require to update these files manually.
If required, you need to manually upgrade application components.
Ensure that WebLogic Integration 8.x application process instances are run to completion in the appropriate environment before they are used in WebLogic Integration 9.2 environment.
You need to recompile and redeploy the applications once the upgrade is complete.