A
Migration Notes

This appendix provides basic information about migrating or upgrading from a previous version of Oracle9i Developer Suite. The following topics are included:

Oracle9i Developer Suite

Oracle9i JDeveloper

Oracle9i Reports Developer

Oracle9i Discoverer Administrator

Oracle9i Warehouse Builder

Oracle9i Clickstream Intelligence Builder

Oracle9i Forms Developer

Oracle9i Software Configuration Manager

Oracle9i Designer

Additional Documentation

A.1 Oracle9i Developer Suite

The former version of Oracle9i Developer Suite Release 2 is Oracle Internet Developer Suite version 1.0.2.4.x. Oracle9i Developer Suite uses new versions of all components, as listed in Table A-1.

Table A-1 Updated Oracle9i Developer Suite Components

Component	Release 1 Version 1.0.2.4.1	Release 2 Version
Oracle9i JDeveloper (including Oracle9i Business Intelligence Beans, and UIX and Bali subcomponents)	3.2.3	9.0.2.x
Oracle9i Reports Developer	6i Release 2	9.0.2.x
Oracle9i Discoverer Administrator (formerly Discoverer Administration Edition; including Oracle9i Discoverer Desktop)	4.1.37	9.0.2.x
Oracle9i Warehouse Builder	2.1.1.34.11 & 9.0.2.56.0	9.0.2.x
Oracle9i Clickstream Intelligence Builder	-	9.0.2.x
Oracle9i Forms Developer	6i Release 2, Patch 4a	9.0.2.x
Oracle9i Software Configuration Manager (formerly Oracle Repository)	6i Release 4	9.0.2.x
Oracle9i Designer	6i Release 4	9.0.2.x

To successfully migrate from Oracle Internet Developer Suite version 1.0.2.x to Oracle9i Developer Suite Release 2 (9.0.2) on the same machine, you must install Release 2 into a new Oracle Home. See Section 2.6, "Coexistence" for information about installing Oracle9i Developer Suite Release 2 over the former version.

After installing Oracle9i Developer Suite Release 2 and performing the required postinstallation tasks, refer to the following subsections for migration information about each component.

A.2 Oracle9i JDeveloper

See the topic "Ways to migrate projects to Oracle9i JDeveloper" of the Welcome to Oracle9i JDeveloper book in the online help system.

A.3 Oracle9i Reports Developer

• If you want to reuse the 6i Reports server persistent file and server configuration file, copy the following files:

  For Windows:

  • %6i_ORACLE_HOME%\reports60\server\<report_server_name>.ora

    to

    %ORACLE_HOME%\reports\conf\<report_server_name>.ora

  • %6i_ORACLE_HOME%\reports60\server\<report_server_name>.dat

    to

    %ORACLE_HOME%\reports\server\<report_server_name>.dat

  For UNIX:

  • $6i_ORACLE_HOME/reports60/server/<report_server_name>.ora

    to

    $ORACLE_HOME/reports/conf/<report_server_name>.ora

  • $6i_ORACLE_HOME/reports60/server/<report_server_name>.dat

    to

    $ORACLE_HOME/reports/server/<report_server_name>.dat

• After opening a .rdf file from an earlier version of Oracle Reports, you must recompile the PL/SQL.

• If you have installed a version of Oracle Discoverer from Oracle9iAS version 1.0.x, you will have Visibroker 3.4 running on your machine. Oracle9iAS Reports Services requires Visibroker 4.5, which cannot be run simultaneously with Visibroker 3.4. If you plan to install Oracle9iAS Reports Services from Oracle9iAS Release 2 (9.0.2) onto the same machine with your older version of Oracle Discoverer, you must first shut down Visibroker 3.4. After installation, if you need to run your older version of Oracle Discoverer, you must manually stop Visibroker 4.5 and start Visibroker 3.4. Note that, when you have taken this action, you are effectively disabling the Oracle9iAS Release 2 Reports Services component until you return to running Visibroker 4.5.

A.4 Oracle9i Discoverer Administrator

Oracle9i Discoverer Administrator is formerly Oracle Discoverer Administration Edition.

If you have Discoverer Administration Edition Release 4.1 installed on your machine, you need to upgrade the Release 4.1 End User Layer (EUL) to the version in this release of Oracle9iDS before you can use Oracle9i Discoverer Administrator to perform administration tasks.

The upgrade process is a simple process which copies the EUL tables from your current version of Discoverer, and recreates them as Oracle9i EUL tables. The upgrade process is gradual and non-destructive--allowing existing users to continue working with Discoverer Release 4.1 during upgrading.

For instructions on upgrading the EUL, see Chapter 24 "Upgrading to Discoverer Version 9.0.2" of the Oracle9i Discoverer Administrator Administration Guide in the Oracle9i Developer Suite Documentation Library.

A.5 Oracle9i Warehouse Builder

For instructions on upgrading metadata from an earlier version of Warehouse Builder, see Chapter 3 "Upgrading Metadata from Warehouse Builder 2.x to Oracle9i Warehouse Builder" of the Oracle9i Warehouse Builder Configuration Guide in the Oracle9i Developer Suite Documentation Library.

A.6 Oracle9i Clickstream Intelligence Builder

This is the first release of Oracle9i Clickstream Intelligence Builder. There are no migration instructions.

A.7 Oracle9i Forms Developer

Review the guide Oracle9i Forms Developer and Forms Services: Migrating Forms Applications from Forms6i in the Oracle9i Developer Suite Documentation Library.

A.8 Oracle9i Software Configuration Manager

Oracle9i Software Configuration Manager is formerly Oracle Repository.

• If you are migrating from a pre-6i repository:

1. Install Oracle9iDS using the Rapid Application Development or Complete install option.

2. Next, follow the instructions for installing a new repository in the Oracle SCM Repository Installation Guide (available on the Oracle9i Developer Suite Product CD).

3. Lastly, follow the instructions for migrating data from an existing pre-6i repository to a new one in the Oracle SCM Repository Installation Guide (available on the Oracle9i Developer Suite Product CD).

• If you are upgrading from a release 6i repository:
  • Follow the instructions for upgrading a release 6i repository in the Oracle SCM Repository Installation Guide (available on the Oracle9i Developer Suite Product CD).

A.9 Oracle9i Designer

• If you are migrating from a pre-6i repository:

1. Install Oracle9iDS using the Rapid Application Development or Complete install option.

2. Next, follow the instructions for installing a new repository in the Oracle SCM Repository Installation Guide (available on the Oracle9i Developer Suite Product CD).

3. Lastly, follow the instructions for migrating data from an existing pre-6i repository to a new one in the Oracle SCM Repository Installation Guide (available on the Oracle9i Developer Suite Product CD).

• If you are upgrading from a release 6i repository:
  • Follow the instructions for upgrading a release 6i repository in the Oracle SCM Repository Installation Guide (available on the Oracle9i Developer Suite Product CD).

A.10 Additional Documentation

All components have online help that is installed with the product. Some components provide additional documentation that is available on the Oracle9i Developer Suite Documentation Library CD-ROM.

For information on viewing and installing the Oracle9i Developer Suite Documentation Library, see Appendix C, "Installing the Documentation Library".

For documentation updates, white papers, or other collateral, please visit the Oracle Technology Network at

http://otn.oracle.com