Skip Headers
Oracle® Application Server TopLink Getting Started Guide
10g Release 2 (10.1.2)
Part No. B15902-01
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

3 Migrating to 10g Release 2 (10.1.2)

For users that have not previously migrated to Release 2 (9.0.3), this chapter describes how to migrate existing 2.x, 3.x and 4.x projects to Oracle Application Server TopLink 10g Release 2 (10.1.2). This chapter includes the following sections:

Upgrading OracleAS TopLink Mapping Workbench Projects

Use the following procedures to upgrade your project from a previous version of the OracleAS TopLink Mapping Workbench.

From Release 2 (9.0.3)

Open and save the project with 10g Release 2 (10.1.2).


Note:

In Release 2 (9.0.4), enhancements to the OracleAS TopLink Mapping Workbench included a significant reduction of XML files. If you are using the OracleAS TopLink Mapping Workbench with a source control management (SCM) system in Release 2 (9.0.3) projects, many files in the SCM will no longer be valid in 10g Release 2 (9.0.4.x) /10g Release 2 (10.1.2).

From Version 4.x

Use the "Package Rename" procedures and open the project with 10g Release 2 (10.1.2).

From Version 3.6

Use the "Package Rename" procedures and open the project with 10g Release 2 (10.1.2).

From Versions 2.x, 3.0 or 3.5

If you are migrating an OracleAS TopLink Mapping Workbench project from a version prior to version 3.6, contact Oracle Support Services support for assistance at OracleMetaLink.

http://metalink.oracle.com


Note:

The Default Null value for object type mappings was expanded (starting with version 4.6) to differentiate between default and null values. If your 3.6 project contains object type mappings ensure that the default and null values are set properly on the mapping's General tab. For more information, see the Oracle Application Server TopLink Mapping Workbench User's Guide.


Note:

If you receive ClassNotFound exceptions after you migrate a project, ensure the JDBC_CLASSPATH variable does not include any Java classes for your persistent business objects. Paths for persistent business objects are set within an OracleAS TopLink Mapping Workbench project. For more information on how to set up a path for a project, see the Oracle Application Server TopLink Mapping Workbench User's Guide.

Also check your project classes for any references to legacy OracleAS TopLink classes.


Package Rename

Beginning with Release 2 (9.0.3), the base package for the entire structure became oracle.toplink. To upgrade existing application source code which refers to OracleAS TopLink API packages and existing OracleAS TopLink Mapping Workbench projects previous to Release 2 (9.0.3), you must use the Package Rename tool.

Use the Package Rename tool on your:

The Package Rename tool works on plain text files and must not be used with binary files such as jar files.

Running the Package Rename Tool

Use this procedure to upgrade your existing pre-Release 2 (9.0.3) application source code and OracleAS TopLink Mapping Workbench projects to version 10g Release 2 (10.1.2).

  1. At the command prompt, execute the packageRename.cmd/sh program located in the ORACLE_HOME/toplink/bin directory. You need to specify three parameters on the command line:

    • the complete directory path that contains the Java source code of your existing project

    • the complete directory path that will contain the upgraded 10g Release 2 (10.1.2) project

    • the name of a log file. If no file is specified, the logging messages will print to standard output.

  2. Press Enter and the Package Rename tool will upgrade your project. The Package Rename tool requires approximately 15 minutes for a 1MB file. Larger files may require additional time.

  3. Repeat this procedure for your:

    • Source code

    • Configuration files

    • OracleAS TopLink Mapping Workbench project files (*.mwp*.xml)

Name Changes

Table 3-1, Table 3-2, Table 3-3 and Table 3-4 identify the name changes between version 4.x and 10g Release 2 (10.1.2).

Table 3-1 New Package Names

Version 4.x Release 2 (9.0.3) 10g Release 2 (9.0.4) and 10g Release 2 (10.1.2)
com.webgain.integrator oracle.toplink oracle.toplink
com.webgain.workbench oracle.toplink.workbench oracle.toplink.workbench
com.webgain.openapi. foundation oracle.toplink.uitools oracle.toplink.uitools

Table 3-2 New Class Names

Version 4.x Release 2 (9.0.3) 10g Release 2 (9.0.4) and 10g Release 2 (10.1.2)
WDIException.java TopLinkException.java TopLinkException.java

Table 3-3 New JAR/WAR Names

Version 4.x Release 2 (9.0.3) 10g Release 2 (9.0.4) and 10g Release 2 (10.1.2)
wdiall.jar toplink.jar toplink.jar
wdi.jar tl_core.jar not applicable
wdisdk.jar tl_sdk.jar not applicable
wdisdkxerces.jar tl_sdkx.jar not applicable
wditools.jar tl_tools.jar not applicable
wdix.jar tl_x.jar not applicable
wdiwasx.jar tl_wasx.jar not applicable
wdiwlsx.jar tl_wlsx.jar not applicable
workbench.jar workbench.jar toplinkmw.jar
TopLinkWebClient.war tl_webclient.war toplinkwc.war
wdidemo.jar tl_demo.jar not applicable
wdidemoui.jar tl_tour.jar not applicable

Table 3-4 New XML/DTD Files

Version 4.x Release 2 (9.0.3) 10g Release 2 (9.0.4) and 10g Release 2 (10.1.2)
wdi-ejb-jar.xml toplink-ejb-jar.xml toplink-ejb-jar.xml
wdi-was-ejb-jar_45.dtd toplink-was-ejb-jar_903.dtd toplink-was-ejb-jar_904.dtd
wdi-wls-ejb-jar_40.dtd toplink-wls-ejb-jar_903.dtd toplink-wls-ejb-jar_904.dtd

Updating Sessions XML Files

OracleAS TopLink 10g Release 2 (10.1.2) is backward compatible with previous releases however, you must update the DOCTYPE headers for the Sessions XML files to read as follows:

Table 3-5 Sessions.xml

DocType DTD Used From the Classpath
"-//Oracle Corp.//DTD TopLink for JAVA 4.0//EN" sessions_4_0.dtd
"-//Oracle Corp.//DTD TopLink for JAVA 4.5//EN" sessions_4_5.dtd
"-//Oracle Corp.//DTD TopLink Sessions 9.0.4//EN" sessions_9_0_4.dtd

Table 3-6 WAS toplink-ejb-jar.xml

DocType DTD Used From the Classpath
"-//Oracle Corp.//DTD TopLink 4.5 CMP for WebSphere//EN" toplink-was-ejb-jar_903.dtd
"-//Oracle Corp.//DTD TopLink CMP WebSphere 9.0.4//EN" toplink-was-ejb-jar_904.dtd

Table 3-7 WLS toplink-ejb-jar.xml

DocType DTD Used From the Classpath
"-//Oracle Corp.//DTD TopLink 4.0 CMP for WebLogic//EN" toplink-wls-ejb-jar_903.dtd
"-//Oracle Corp.//DTD TopLink CMP WebLogic 9.0.4//EN" toplink-wls-ejb-jar_904.dtd