1
Migrating to Oracle9i Application Server Release 1.0.2

This book explains the migration steps for each Oracle Internet Application Server component that existed in Release 1.0.0.

Contents

• 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 pre-installation tasks for Oracle Database Cache and Oracle Discoverer 3i. Refer to the pre-installation sections in the following chapters for specific pre-installation instructions:

• Chapter 9, "Oracle Discoverer 3i Migration"

• Chapter 10, "Oracle Database Cache Migration"

Installing Oracle9i Application Server Release 1.0.2

To successfully migrate your configuration, applications, and data from Oracle Internet Application Server 1.0.0 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.0 into /disk1/ias100, install Oracle9i Application Server 1.0.2 into /disk1/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 from Table 1-1.

Table 1-1 Oracle9i Application Server Migration Terminology

Term	Definition
OLD_HOME	The value of ORACLE_HOME for Oracle Internet Application Server 1.0.0.
NEW_HOME	The value of ORACLE_HOME for Oracle9i Application Server 1.0.2.

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.0 Version	9i AS 1.0.2 Version	Requires Migration?
Oracle HTTP Server Apache HTTP Server mod_perl JDK mod_ssl	1.3.9 1.21 1.1.8 2.6.2	1.3.12 1.22 1.2.2 2.6.4	yes yes yes yes
PL/SQL Gateway (formerly mod_plsql)	2.6	3.0	yes
PL/SQL Server Pages	8.1.6.1	8.1.7	yes
Oracle BC4J	3.1.1.0	3.1.1.1	yes
OracleJSP	1.0	1.1	yes
Oracle8i JVM (also known as Oracle JServer)	8.1.6.1	8.1.7	yes
Oracle Form Services	6.0.8.8	6.0.8.11	yes
Oracle Report Services	6.0.8.8	6.0.8.11	no
Oracle Portal (formerly Oracle WebDB)	2.2	3.0	yes
Oracle Database Cache (formerly Oracle8i Cache)	1.0.0	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.0. 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 Perl Interpreter	5.005_03	no
Apache JServ	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 Chapter 7, "Oracle8i JVM Migration" for more information.

How To Use This Guide

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

• Pre-migration: 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.0 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. To migrate:

• Oracle HTTP Server, see Chapter 2, "Oracle HTTP Server Migration"

• Apache JServ, see Chapter 2, "Oracle HTTP Server Migration"

• PL/SQL Gateway, see Chapter 3, "PL/SQL Gateway Migration"

• PL/SQL Server Pages, see Chapter 4, "PL/SQL Server Pages Migration"

• Oracle BC4J, see Chapter 5, "Oracle BC4J Migration"

• OracleJSP, see Chapter 6, "OracleJSP Migration"

• Oracle8i JVM, see Chapter 7, "Oracle8i JVM Migration"

• Oracle Form Services, see Chapter 8, "Oracle Form Services Migration"

• Oracle Discoverer 3i Viewer and User Editions, see Chapter 9, "Oracle Discoverer 3i Migration"

• Oracle Portal has upgrade scripts that assist in migrating this component. The scripts and further migration instructions are available from http://otn.oracle.com/products/iportal.

• Oracle Database Cache, see Chapter 10, "Oracle Database Cache Migration"

• Oracle Enterprise Manager, see Appendix B, "Configuration Assistant Operations" in Oracle Enterprise Manager Configuration Guide in the documentation library. Specifically, follow the tasks under "Upgrade a Release 2.0 or 2.1 Repository to a Release 2.2 Repository."