> Installation Guide > Upgrading AquaLogic Data Services Platform Applications To Version 2.5

Installation Guide

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

Upgrading AquaLogic Data Services Platform Applications To Version 2.5

The basic migration path for BEA AquaLogic Data Services Platform 2.0.n application and projects is straightforward. This section provides instructions for such upgrades including:

 

Platform Installation and Configuration

Prior to installing AquaLogic Data Services Platform, a supported version of WebLogic Platform 8.1 must be installed and configured properly. See Supported Configurations in AquaLogic Data Services Platform Release Notes for versions supported by this release.

 

AquaLogic Data Services Platform 2.5 Installation and Deployment

In order to upgrade an application created under AquaLogic Data Services Platform 2.0x or 2.1 you must first install AquaLogic Data Services Platform 2.5. In a production environment, that installation must be completed for each WebLogic Platform 8.1 domain that you are using with AquaLogic Data Services Platform.

AquaLogic Data Services Platform 2.5 Installation

Follow the appropriate preparation, installation, and post-installation steps described in other sections of this document starting with Installation Prerequisites.

 

AquaLogic Data Services Platform Upgrade Options

There are a several of steps to take when upgrading to the latest version of AquaLogic Data Services Platform.

Upgrading Applications Created Under Earlier Versions to 2.5

Applications can be upgraded through WebLogic Workshop or using the AquaLogic Data Services Platform 2.5 Convert utility.

Using Workshop to Upgrade Older AquaLogic Data Services Platform Applications

After you have installed AquaLogic Data Services Platform 2.5 you need to upgrade several JAR files in your existing AquaLogic Data Services Platform applications in order to deploy those applications under AquaLogic Data Services Platform 2.5. In WebLogic Workshop the update process is semi-automatic. When you open your application in WebLogic Workshop you will get a message indicated that some AquaLogic Data Services Platform JAR files are out-of-date and asking if you want to update your application.

Choose Yes to update the files. This will automatically cause your application to be built or rebuilt.

Note: If you choose No, your 2.0 application will not be updated and you will not be able to deploy it under AquaLogic Data Services Platform 2.5.

Using the Convert Utility to Upgrade Applications Created Under Previous Versions

If your AquaLogic Data Services Platform 2.0 or 2.1 application is already packaged in an EAR file you can use a command-line utility to upgrade the EAR to AquaLogic Data Services Platform 2.5. The utility inspects the EAR file for out-of-date copies of the following:

If pre-AquaLogic Data Services Platform 2.5 versions of these files are found, they are replaced with 2.5 versions.

Upgrading EAR Files on Windows

To upgrade a Windows-based AquaLogic Data Services Platform 2.0 or 2.1 EAR file to AquaLogic Data Services Platform 2.5 using the Convert migration utility following these steps:

  1. Back up your EAR file.
  2. Open a command window using Window's Run command.
  3. Set the WebLogic Server environment, if it is not already set on your system:
    4. <WL_HOME>\server\bin\setWLSEnv.cmd
  4. Run the Convert command-line utility on your EAR file. For example:
    5. <WL_HOME>\liquiddata\bin\convert.cmd myEAR.ear

Upgrading EAR Files on UNIX Systems

To upgrade a UNIX-based AquaLogic Data Services Platform 2.0 EAR file to AquaLogic Data Services Platform 2.5 using the Convert migration utility following these steps:

  1. Back up your EAR file.
  2. Set the WebLogic Server environment, if it is not already set on your system:
    3. <WL_HOME>/server/bin/setWLSEnv.sh
  3. Run the Convert command-line utility on your EAR file. For example:
    4. <WL_HOME>/liquiddata/bin/convert.sh myEAR.ear

Upgrading Projects Created Under 2.0 to 2.5

Versions of AquaLogic Data Services Platform prior to version 2.1 managed functions returning sequences by generating additional "arrayOf" types (.xsd schema files) adjacent to the original schema files. For example, when a data service was created around an XMLtype of customer (customer.xsd) an XML type arrayOfcustomer (arrayOfCustomer.xsd) was created automatically. Applications calling functions returning sequences could then utilize the arrayOf type.

This approach to handling functions returning sequences has been deprecated. Instead, functions returning sequences of records are handled by converting each item in the sequence into a service data object (SDO). With AquaLogic Data Services Platform 2.1 and later, Java arrays of SDO are supported. (For details on SDO and handling of sequence SDOs see the Application Developer's Guide.)

If your AquaLogic Data Services Platform project was created using a version of AquaLogic Data Services Platform prior to 2.1 you have a choice:

You can access the Migrate Data Services Project option by right-clicking on your AquaLogic Data Services Platform project (see Figure 5-3).

Note: As always, it is recommended that you back up your application or project before attempting a migration.
Note: After migrating projects, existing Java mediator client code that relied upon the "ArrayOf" types will need to use a sequence of SDO objects instead of the ArrayOf SDO object.
Figure 5-3 Upgrade Data Services Project Option

Upgrade Data Services Project Option

Note: Migration of projects to AquaLogic Data Services Platform 2.5 are not reversible.

  Back to Top       Previous  Next