Oracle9i Application Server

Migrating from Oracle9i Application Server 1.0.2.0

Release 1.0.2.1 for Sun SPARC Solaris

March 2001

Part No. A88779-01

This document guides you through the process of migrating from Oracle9i Application Server Release 1.0.2.0 to Release 1.0.2.1.

1.0 Preinstallation Tasks

You must perform the following tasks before installing Oracle9i Application Server 1.0.2.1.

1.1 Reviewing the Latest Product Information

Before installing Oracle9i Application Server Release 1.0.2.1, review the Release Notes and latest Release Notes Addendum. You can find the latest Release Notes Addendum on OTN at

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

1.2 Backing up Configuration and Data Files

Make backup copies of the following files and directories before installing Oracle9i Application Server.

The ORACLE_HOME/panama directory.
Changed files in the ORACLE_HOME/ifs1.1/settings directory and changed Oracle Internet File System configuration files stored in other directories.

To maintain your current configuration settings you will need to restore these files after installing Oracle9i Application Server 1.0.2.1.

2.0 Installing Oracle9i Application Server 1.0.2.1

Install Oracle9i Application Server 1.0.2.1 into the same Oracle home as the 1.0.2.0 installation. You must follow all of the preinstallation and postinstallation tasks from the Oracle9i Application Server Installation Guide before completing the migration tasks in Section 3.0, "Manually Migrating Components" of this guide.

See Also:
Oracle9i Application Server Installation Guide

3.0 Manually Migrating Components

Some components require additional postinstallation tasks you must perform to successfully complete the migration from Oracle9i Application Server, Release 1.0.2.0. This section describes the postinstallation tasks for the following components:

3.1 Components Migrated During Installation

Installing Oracle9i Application Server 1.0.2.1 automatically migrates some components. There are no additional migration steps for the following components:

Oracle9iAS Database Cache
Oracle9iAS Developer Kits
Oracle9iAS Forms Services
Oracle9iAS Reports Services
Oracle9iAS Web Cache
Oracle Enterprise Java Engine
Oracle Enterprise Manager
Oracle HTTP Server powered by Apache

3.2 Oracle9iAS Discoverer

The following sections describe tasks you must perform to successfully migrate Oracle9iAS Discoverer.

Note:
The Oracle9i Application Server 1.0.2.1 installation uses the machine name for the Discoverer Services instance name.

Using Discoverer 3i and Oracle9iAS Discoverer Simultaneously

Discoverer 3i users can still use the older version after installing Oracle9i Application Server.

See Also:
Oracle9i Application Server Release Notes for further instructions on using both Discoverer versions.

Using Only Discoverer 3i

If you have customized Oracle Discoverer 3i Viewer and do not want to use any of the new functionality in Oracle9iAS Discoverer, then perform the following tasks:

Open ORACLE_HOME/6iserver/discwb4/html/disco4iv.xml in a text editor.
Change the value of the xml_version parameter to viewer33.
Change the value of the xsl_path parameter to the location of the disco3iv.xsl. The default path is ORACLE_HOME/Apache/Apache/htdocs/disco3iv/html/disco3iv.xsl.

Migrating Configuration Information to Oracle9iAS Discoverer

If you have customized Oracle Discoverer 3i Viewer by modifying the default configuration files, you have two migration paths to choose from. Follow the instructions below appropriate for the changes to your old configuration files.

If you have only changed style.xsl and want to use the new functionality, then perform the following tasks:
1. Backup ORACLE_HOME/6iserver/discwb4/html/style.xsl.
2. Copy ORACLE_HOME/6iserver/discwb33/html/style.xsl over ORACLE_HOME/6iserver/discwb4/html/style.xsl.
If you have changed other configuration files, not including style.xsl, and want to use the new functionality, then perform the following tasks:
1. Identify which configuration files in ORACLE_HOME/6iserver/discwb33/html/ were modified.
2. For each file identified in the previous step, make the same changes to the corresponding file in ORACLE_HOME/6iserver/discwb4/html/. Do not replace the files in discwb4 with their counterparts in discwb33.

Migrating Preferences to Oracle9iAS Discoverer

To continue using Discoverer 3i Server preference settings with Oracle9iAS Discoverer, you must copy ORACLE_HOME/6iserver/discwb33/util/pref.txt over ORACLE_HOME/6iserver/discwb4/util/pref.txt and then add lines to describe new preferences. Refer to the Oracle9iAS Discoverer Release Notes on Oracle9i Application Server Disk 1 for more information on these additions.

Note:
You will have to reset user preferences, such as the default end user layer, using the Discoverer Options dialog.

Upgrading the End User Layer

If you have already installed a previous version of Oracle Discoverer, you must use Oracle Discoverer Administration Edition, Release 4.1 to upgrade the End User Layer. If you do not upgrade the End User Layer, users will not be able to use Oracle9iAS Discoverer.

Oracle Discoverer Administration Edition is shipped as part of Oracle9i Developer Suite.

See Also:

http://otn.oracle.com/products/ids for more information on Oracle9i Developer Suite.

Oracle Discoverer Installation and Upgrade Guide which is packaged with Oracle Discoverer Administration Edition.

3.3 Oracle9iAS Portal

The following sections describe tasks you must perform to successfully migrate Oracle9iAS Portal.

Correcting jserv.properties

After installing Oracle9i Application Server 1.0.2.1, you must remove two lines from jserv.properties. The path to this file is ORACLE_HOME/Apache/Jserv/etc/jserv.properties.

Remove the following lines:

wrapper.classpath=ORACLE_HOME/portal30/bibeans/jewt-opt-4_0_15.zip
wrapper.classpath=ORACLE_HOME/portal30/bibeans/share-opt-1_1_4.zip

Upgrading the Oracle9iAS Portal Repository

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

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

3.4 Oracle9iAS Wireless

For information on upgrading Oracle9iAS Wireless, see Section 1.3 in the Oracle9iAS Wireless Configuration Guide in the Oracle9i Application Server Documentation Library.

3.5 Oracle Business Components for Java

After installing Oracle9i Application Server 1.0.2.1, you must remove duplicate and obsolete lines from jserv.properties. The path to this file is ORACLE_HOME/Apache/Jserv/etc/jserv.properties.

Remove only one occurrence of the following duplicate lines:

wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/ordvir817.zip
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/ordim817.zip
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/ordhttp.zip
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/jboremote.zip
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/jboorasql.zip
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/jndi.jar
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/jbomt.zip
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/javax_ejb.zip
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/jdev-rt.zip
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/jbohtml.zip
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/connectionmanager.zip

Remove the following obsolete lines:

wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/oraclexmlsql.jar
wrapper.classpath=ORACLE_HOME/Apache/Apache/htdocs/OnlineOrders_html
wrapper.classpath=ORACLE_HOME/Apache/Apache/htdocs/OnlineOrders_html/Onl
ineOrders.jar
wrapper.classpath=ORACLE_HOME/Apache/BC4J/lib/jbodatum12.zip

Note:
Only remove lines with "OnlineOrders" and not lines with "onlineorders".

3.6 Oracle Internet File System

The following steps describe tasks you must perform to successfully migrate Oracle Internet File System.

Stop Oracle Internet File System with the ORACLE_HOME/ifs1.1/bin/ifsstop command.
Restore the Oracle Internet File System configuration files backed up in Section 1.2, "Backing up Configuration and Data Files" to their original locations.
Start Oracle Internet File System with the ORACLE_HOME/ifs1.1/bin/ifsstart command.