A Upgrade Notes

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

Section A.1, "Oracle Developer Suite"
Section A.2, "Oracle10g JDeveloper"
Section A.3, "Oracle Business Intelligence Beans"
Section A.4, "Oracle Reports Developer"
Section A.5, "Oracle Business Intelligence Discoverer Administrator"
Section A.6, "Oracle Forms Developer"
Section A.8, "Additional Documentation"

A.1 Oracle Developer Suite

The previous versions of Oracle Developer Suite were Oracle Developer Suite 10g (9.0.4), Oracle 9iDS Developer Suite Release 2 (9.0.2), and Oracle Internet Developer Suite version 1.0.2.4.x. Oracle Developer Suite 10g (10.1.2.0.2) uses new versions of all components, as listed in Table A-1.

Table A-1 Updated Oracle Developer Suite Components

Component	Release 1 Version 1.0.2.4.1	Release 2 (9.0.2) Version	10g (9.0.4) Version	10g (10.1.2.0.2) Version
Oracle JDeveloper (including Oracle Business Intelligence Beans, and UIX and Bali subcomponents)	3.2.3^Foot 1	9.0.2.x	9.0.4.x	10.1.2.1.0
Oracle Reports Developer	6i Release 2	9.0.2.x	9.0.4.x	10.1.2.0.2
Oracle Business Intelligence Discoverer Administrator (formerly Discoverer Administration Edition) including Oracle Business Intelligence Discoverer Desktop	4.1.37	9.0.2.39	9.0.4.x
Oracle Warehouse Builder	2.1.1.34.11 & 9.0.2.56.0	9.0.2.x	N/A^Foot 2	N/A^Foot 3
Oracle Forms Developer	6i Release 2, Patch 4a	9.0.2.x	9.0.4.0.4	10.1.2.0.2
Oracle Designer	6i Release 4	9.0.2.80.11	9.0.4.x	10.1.2.0.2

^Footnote 1Oracle9i Business Intelligence Beans was first released in Oracle9iDS Release 2 (9.0.2)
^Footnote 2Oracle9i Warehouse Builder Release 2 (9.0.4) is now available separately from Oracle Developer Suite.
^Footnote 3Oracle9i Warehouse Builder Release 2 (9.0.4) is now available separately from Oracle Developer Suite.

Some components were also released individually. For example, Oracle9i JDeveloper was released as version 9.0.3, after the release of Oracle9i Developer Suite Release 2 (9.0.2). The version history for each component is documented in the component's specific instructions in this guide, and also in the component's release notes.

To successfully migrate from Oracle Internet Developer Suite version 1.0.2.x to Oracle Developer Suite 10g (10.1.2.0.2), you must install Oracle Developer Suite into a new Oracle home. See Section 2.7, "Coexistence in One Oracle Home" for information about installing Oracle Developer Suite over the former version.

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

A.2 Oracle10g JDeveloper

You can migrate user settings from the production release of JDeveloper 9.0.2 or JDeveloper 9.0.4 to JDeveloper 10.1.2.1.0. Your system settings, libraries, and connections will be migrated.

Oracle does not support direct migration from version 3.2.3 to 10.1.2.1.0.

A.2.1 Migrating JDeveloper User Settings from Release 9.0.2 to Release 10.1.2

Note:

Any time you use the following procedure to migrate user settings from another installation of JDeveloper, you lose any settings that you have made in the current installation.

To migrate your user settings:

Start JDeveloper from a command line or shell prompt with the -migrate flag:

jdev -migrate

JDeveloper displays the Migrate User Settings dialog.
Select a version of JDeveloper to migrate.

If the Version dropdown list is empty, click Browse to search for a version. Select the directory previous_install_home\jdev\system (for Windows) or previous_install_home/jdev/system (for Linux and Solaris), where previous_install_home is the home directory of the JDeveloper installation from which you want to migrate.
Select the settings and customizations you want to migrate. Oracle recommends that you select all the options.
Click OK. JDeveloper migrates your user settings.

A.2.2 Additional Migration Issues

For more information about migration issues, see the topic "Ways to Migrate to Oracle10g JDeveloper" in the JDeveloper online help section Getting Started with JDeveloper.

A.3 Oracle Business Intelligence Beans

If you are upgrading OracleBI Beans from a previous release, then you must migrate existing OracleBI Beans projects from the previous release. For information on migrating, see Appendix E, "Migrating Existing BI Beans Projects".

A.4 Oracle Reports Developer

If you want to reuse the 6i Reports server persistent file and server configuration file, you can copy them to the Oracle Reports Server 10g 10.1.2.0.2 (Reports Server) directory. Reports Server will automatically convert your 6i files to the Reports Server 10g 10.1.2.0.2 format. To do this, copy the following files:

For Windows:
- 6i_oracle_home\reports60\server\report_server_name.ora
  
  to
  
  10g_oracle_home\reports\conf\report_server_name.ora
- 6i_oracle_home\reports60\server\report_server_name.dat
  
  to
  
  10g_oracle_home\reports\server\report_server_name.dat
For Linux and Solaris:
- 6i_oracle_home/reports60/server/report_server_name.ora
  
  to
  
  10g_oracle_home/reports/conf/report_server_name.ora
- 6i_oracle_home/reports60/server/report_server_name.dat
  
  to
  
  10g_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.

A.5 Oracle Business Intelligence Discoverer Administrator

If you have an earlier version of Discoverer Administrator (formerly Discoverer Administration Edition) on your computer, you need to upgrade the End User Layer before you can use Oracle Business Intelligence Discoverer Administrator to perform administration tasks (unless you have version 10.1.2.0.0 or later, in which case no EUL upgrade is required).

To upgrade an EUL, follow the instructions in Chapter 24 "Upgrading from earlier versions of Discoverer" of the Oracle Business Intelligence Discoverer Administrator Administration Guide in the Oracle Developer Suite Documentation Library.

A.6 Oracle Forms Developer

Review the guide Oracle Forms Migrating Forms Applications From Forms 6i in the Oracle Developer Suite Documentation Library.

A.7 Oracle SCM Repository

If you are upgrading from a release 6i or later repository, follow the instructions for upgrading a release 6i or later repository in the Oracle SCM Repository Installation Guide, which is available from the Start menu of the SCM client.

A.8 Additional Documentation

All components have online help that is installed with the product. Some components provide additional documentation that is available on the Oracle Developer Suite Documentation Library CD-ROM or, for the DVD, from the subdirectory /doc_library. For information on viewing and installing the Oracle Developer Suite Documentation Library, see Appendix C, "Installing the Documentation Library".

For release notes and further component-specific information on postinstallation and configuration tasks, refer to the release notes and the component-specific administration or configuration guide in the documentation library.

For Windows users, you can access release notes and Getting Started information from the Start Menu as follows:

Start > Programs > Oracle Developer Suite - DevSuiteHome > Release Notes
Start > Programs > Oracle Developer Suite - DevSuiteHome > Documentation > Getting Started

You can also point your browser to the file

DevSuiteHome/doc/welcome/index.htm.

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

http://www.oracle.com/technology/.