1
Migrating to Oracle9i Application Server, Release 1.0.2

This chapter provides an overview of the migration process. The topics are:

• Before Installing Oracle9i Application Server, Release 1.0.2

• Installing Oracle9i Application Server, Release 1.0.2

• Terminology In This Guide

• Updated Components

• Unchanged Components

• New Components

• How To Use This Guide

• Component Migration

Before Installing Oracle9i Application Server, Release 1.0.2

Prior to installing Oracle9i Application Server, Release 1.0.2, you must perform some preinstallation tasks for Oracle Forms Services, Oracle Reports Services, Oracle Discoverer 3i, and Oracle Database Cache.

Oracle Forms Services, Oracle Reports Services, and Oracle Discoverer 3i use Oracle 8.0.6 database libraries. To avoid any potential conflicts during installation of Oracle9i Application Server, Release 1.0.2, you must deinstall the current copies of these components from your system.

You must also deinstall Oracle8i Cache from your Oracle Internet Application Server, Release 1.0.1 Oracle home. Refer to "Preinstallation" for deinstallation instructions.

Deinstalling Components Using 8.0.6 Libraries

The following steps guide you through the process of deinstalling these components.

1. Back up any custom data and application files you have stored in OLD_HOME.

2. Back up OLD_HOME\6iServer\discwb33\util\pref.txt.

3. If you customized the XSL of Discoverer Viewer, back up any XSL or XML files you changed or added.

4. From the Windows NT Control Panel, open Services. Stop the following services:
   • Oracle Forms Server [Forms60Server]

   • Oracle Reports Server [REP60_hostname]

   • Oracle_Load_balancer_60_Client

   • Oracle_Load_balancer_60_Server

   • OracleDiscoverer3i

5. From the Windows NT Start Menu, point to Programs, then Oracle for Windows NT, and click Oracle Installer.

   Note: Do not click on Universal Installer. You cannot use Oracle Universal Installer to deinstall these components.

6. When Oracle Installer launches, the Software Asset Manager appears. Select all of the components in the rightmost window and click the Remove button.

7. Click the Yes button to confirm that you want to delete these components.

8. After deinstallation, click the Exit button to quit the installer.

You have successfully deinstalled Oracle Forms Services, Oracle Reports Services, and Oracle Discoverer 3i Viewer Edition.

Installing Oracle9i Application Server, Release 1.0.2

To successfully migrate your configuration, applications, and data from Oracle Internet Application Server 1.0.1 to Oracle9i Application Server 1.0.2, you must start by installing Release 1.0.2 into a new Oracle home.

For example, if you installed Oracle Internet Application Server 1.0.1 into d:\ias100, install Oracle9i Application Server 1.0.2 into d:\ias102.

Except where noted in the previous section, this guide is intended for users who have already installed Oracle9i Application Server Release 1.0.2.

Terminology In This Guide

This guide uses the terminology in Table 1-1.

Table 1-1 Oracle9i Application Server Migration Terminology

Term	Definition
OLD_HOME	The Oracle home for Oracle Internet Application Server 8i, Release 1.0.1.
NEW_HOME	The Oracle home for Oracle9i Application Server, Release 1.0.2

Note: Some Oracle9i Application Server components use the Oracle 8.0.6 library files and install into a different Oracle home. The value of NEW_HOME for these components is install_drive:\Oracle\806. The following components use the 8.0.6 libraries: Oracle Forms Services Oracle Reports Services Oracle Discoverer 3i

Updated Components

Oracle9i Application Server uses a new version of the following components. Components with a new version may require changes to application logic to reflect new and deprecated features.

Table 1-2 Updated Oracle9i Application Server Components  

Component	iAS 1.0.1 Version	9iAS 1.0.2 Version	Requires Migration?
PL/SQL Gateway (formerly mod_plsql)	2.6	3.0	yes
PL/SQL Server Pages	8.1.6.1	8.1.7	yes
Oracle Business Components for Java	3.1	3.2	yes
Oracle8i JVM (also known as Oracle JServer)	8.1.6.1	8.1.7	yes
Oracle Forms Services	6.0.8.9	6.0.8.11	yes
Oracle Reports Services	6.0.8.9	6.0.8.11	no
Oracle Portal (formerly Oracle WebDB)	2.2	3.0	yes
Oracle Database Cache (formerly Oracle8i Cache)	1.0.1	1.0.2	yes
Oracle LDAP Developer's Kit	2.0.6	2.1.1	no
Oracle XML Developer's Kit	1.0.2	1.0.2	no
Oracle Database Client Developer's Kit	8.1.6.1	8.1.7	no
Oracle Advanced Security	8.1.6.1	8.1.7	no
Oracle Enterprise Manager	2.1	2.2	yes

Unchanged Components

Some Oracle9i Application Server components use the same version as Oracle Internet Application Server Release 1.0.1. Any existing applications will work with this release, however configuration and environment information may need updating because of the new Oracle home.

Table 1-3 Unchanged Oracle9i Application Server Components

Component	9i AS 1.0.2 Version	Requires Migration?
Oracle HTTP Server Apache HTTP Server mod_perl Perl Interpreter mod_ssl Apache JServ JDK	1.3.12 1.22 5.005_03 2.6.4 1.1 1.2.2	yes no no yes no yes
OracleJSP	1.1	yes
Oracle Discoverer Viewer and User Editions	3.3.57	yes

New Components

With Oracle9i Application Server Release 1.0.2, you have a choice in deploying Java servlets. The Oracle Servlet Engine in Oracle8i JVM supports the Sun Microsystems Java Servlet Specification version 2.2 whereas Apache JServ supports the version 2.0 specification.

Customers who want to make use of new servlet features introduced by the version 2.2 specification can migrate their existing servlets to Oracle Servlet Engine applications.

See Also: Chapter 7, "Oracle8i JVM Migration"

How To Use This Guide

Each of the following chapters will address the following migration issues:

• Premigration: These are instructions for what you need to do before migrating the component. These steps will help prevent conflicts in configuration files.

• Environment: These are changes to environment variables used by the component between the two versions. These steps will ensure that your applications refer to the proper executables, libraries, and configuration parameters.

• Configuration: These are changes to configuration files. These steps will update the new configuration files so your customizations in release 1.0.1 will still work in release 1.0.2.

• Application Logic: These are changes you must make to your applications to either use new functionality or remove deprecated functionality.

• Tools: These are changes in the command line and GUI tools for the components.

Component Migration

Refer to the following chapters and resources for detailed migration information for each component.

• For Oracle HTTP Server migration, refer to Chapter 2, "Oracle HTTP Server Migration".

• For PL/SQL Gateway migration, refer to Chapter 3, "PL/SQL Gateway Migration".

• For PL/SQL Server Pages migration, refer to Chapter 4, "PL/SQL Server Pages Migration".

• For Oracle Business Components for Java migration, refer to Chapter 5, "Oracle Business Components for Java Migration".

• For OracleJSP migration, refer to Chapter 6, "OracleJSP Migration".

• For Oracle8i JVM migration, refer to Chapter 7, "Oracle8i JVM Migration".

• For Oracle Forms Services migration, refer to Chapter 8, "Oracle Forms Services Migration".

• For Oracle Discoverer 3i migration, refer to Chapter 9, "Oracle Discoverer 3i Migration".

• Oracle Portal uses an upgrade script for migration. The script and further migration instructions are available at

  http://otn.oracle.com/products/iportal
  
  

• For Oracle Database Cache migration, refer to Chapter 10, "Oracle Database Cache Migration".

• For Oracle Enterprise Manager migration, refer to Appendix B, "Configuration Assistant Operations" in Oracle Enterprise Manager Configuration Guide in the Oracle9i Application Server Documentation Library. Follow the tasks under "Upgrade a Release 2.0 or 2.1 Repository to a Release 2.2 Repository."