Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Related Documents

Documentation Accessibility

1 Overview of the Oracle Application Server Upgrade

1.1 The Oracle Application Server Upgrade Process

1.1.1 Upgrading a Distributed Environment

1.1.2 Upgrading a Non-Distributed Environment

1.2 The Middle Tier Upgrade Process

1.3 The Infrastructure Upgrade Process

1.4 OracleAS Upgrade Assistant Upgrade Paths

1.5 OracleAS Portal Repository Upgrade Paths

2 Planning an Upgrade

2.1 Oracle Application Server Compatibility

2.1.1 Compatibility Rules

2.1.2 Oracle Application Server Configuration Examples

2.1.2.1 Single Middle Tier and Single Infrastructure

2.1.2.2 Multiple Middle Tiers and Single Infrastructure

2.1.2.3 Multi-Platform Installations

2.1.3 Transitions Between Configurations

2.2 Determining an Upgrade Strategy

2.2.1 Upgrade Process Overview

2.2.1.1 Upgrade Tasks

2.2.1.2 Middle-Tier Components Upgraded by the Oracle Application Server Upgrade Assistant

2.2.1.3 Infrastructure Schemas Upgraded by Scripts

2.2.1.4 Manual Upgrade Tasks

2.2.2 Planning for System Downtime

2.2.2.1 How Long Will the Upgrade Take?

2.2.3 System Availability During Upgrade

2.2.4 Creating Backups

3 Upgrading the Middle Tier

3.1 Preparing to Upgrade: Common Requirements for All Components

3.1.1 Requirements for Installing an Oracle Application Server 10g (9.0.4) Middle Tier

3.1.2 Stopping Oracle Application Server Instances

3.1.3 Preparing to Upgrade a Middle Tier that Uses an Infrastructure

3.2 Preparing to Upgrade: Requirements for Specific Components

3.2.1 Preparing to Upgrade Oracle Application Server Wireless Middle Tiers

3.2.2 Optional: Increasing JVM Memory for Large OC4J Upgrades

3.3 Upgrading a Standalone OC4J Instance

3.4 Upgrading a Standalone OracleAS Web Cache Instance

3.5 Using the OracleAS Upgrade Assistant

3.5.1 Specifying Logging Behaviors for the OracleAS Upgrade Assistant

3.5.2 Starting the Infrastructure

3.5.3 Starting the OracleAS Upgrade Assistant To Use Multiple Oracle Universal Installer Inventory Locations

3.5.4 Performing an Upgrade with the OracleAS Upgrade Assistant (Graphical User Interface (GUI) Version)

3.5.5 Performing an Upgrade with the OracleAS Upgrade Assistant (Command-line Version)

3.6 Resolving Errors

3.6.1 Resolving Common Errors

3.6.1.1 Source Oracle Home Not Provided by OracleAS Upgrade Assistant

3.6.1.2 Upgrade Fails During OPMN, OC4J, or Oracle HTTP Server Upgrade

3.6.1.3 Upgrade Fails During OC4J Examination or Other Phase

3.6.1.4 Upgrade Fails During Extensive OC4J Upgrade

3.6.2 Examining the Log File

3.6.2.1 Recovering From Examination Failures

3.6.2.2 Recovering From Upgrade Failures

3.6.3 Reasons for Oracle Application Server Containers for J2EE Upgrade and Deployment Failures

3.6.3.1 Configuration Change Requirements

3.6.3.2 Application Deployment and J2EE Compliance Requirements

3.7 Restarting the OracleAS Upgrade Assistant

3.8 Completing the Upgrade

3.8.1 Completing the Oracle HTTP Server Upgrade

3.8.1.1 Manual Upgrade Tasks You May Need to Perform

3.8.2 Completing the Oracle Application Server Containers for J2EE (OC4J) Upgrade

3.8.2.1 Upgrading Oracle Application Server Java Authentication and Authorization Service (JAZN) LDAP Security Settings

3.8.2.2 Upgrading JAZN Library Path Entries

3.8.2.3 Upgrading OC4J Instances Created by the Installer

3.8.2.4 Upgrading application.xml Entries

3.8.2.5 Upgrading the jms.xml File

3.8.2.6 Using the Compatibility Test Suite (CTS) Compatibility Flag for Backward Compatibility

3.8.2.7 Upgrade Considerations for Enterprise Java Beans

3.8.2.8 Upgrade Considerations for the OC4J Java Server Pages (JSP) Container

3.8.2.9 Considering JDK 1.4 Issues: Cannot Invoke Classes Not in Packages

3.8.2.10 Considering Modified Servlet APIs and Behavior

3.8.3 Completing the OracleAS Web Cache Upgrade

3.8.3.1 Enabling the webcached Executable to Run as The Root User

3.8.3.2 Upgrading an OracleAS Web Cache Cluster

3.8.3.3 Upgrading a Web Cache Cluster from Release 2 (9.0.2.x) to 10g (9.0.4)

3.8.4 Completing the OracleAS Portal Middle Tier Upgrade

3.8.4.1 Enabling OracleAS Portal for the Secure Sockets Layer (SSL) Protocol

3.8.4.2 Verifying Database Access Descriptor (DAD) Locations After Upgrade

3.8.4.3 Upgrading the Parallel Page Engine

3.8.4.4 Upgrading Portal Development Kit Services for Java (JPDK) Web Providers

3.8.4.5 Completing the mod_plsql Upgrade

3.8.4.6 Enabling Monitoring of a Release 2 (9.0.2) Portal Repository by the 10g (9.0.4) Oracle Enterprise Manager Application Server Control

3.8.4.7 Restoring Portal Tools (OmniPortlet and Web Clipping) Providers

3.8.5 Completing the Oracle Application Server Discoverer Viewer Upgrade

3.8.5.1 Upgrading the End User Layer

3.8.5.2 Upgrading Style Sheets

3.8.5.3 Upgrading the tnsnames.ora File

3.8.6 Completing the Oracle Application Server Reports Services Upgrade

3.8.6.1 Upgrading User-Defined OC4J Instances With Oracle Application Server Reports Services Deployments

3.8.7 Completing the Oracle Application Server Wireless Upgrade

3.8.7.1 Using the Oracle Application Server Wireless Notification Service Upgrade Script

3.8.7.2 Operating Oracle Application Server Wireless Release 2 (9.0.2) and 10g (9.0.4) Middle Tiers Together

3.8.7.3 Configuring Site-Level Drivers in a Mixed Mode Environment

3.8.8 Completing the Oracle Application Server Forms Services Upgrade

3.8.8.1 Upgrading the tnsnames.ora File

3.8.8.2 Upgrading Forms *.fmx Files

3.8.8.3 Upgrading User-defined Aliases for Oracle Application Server Forms Services Servlets

3.8.8.4 Upgrading forms90app.ear Deployed in User-defined OC4J Instances

3.8.8.5 Enabling the Oracle Application Server Forms Services Oracle Application Server Single Sign-On and Oracle Internet Directory Configuration

3.8.9 Upgrading the tnsnames.ora File

3.8.9.1 Append New and Changed Entries to the 10g (9.0.4) tnsnames.ora File

3.8.9.2 Copy the Oracle9iAS Release 2 (9.0.2) tnsnames.ora File to the 10g (9.0.4) Installation

3.9 Upgrading Oracle Application Server InterConnect

3.9.1 Installing and Upgrading Hub Components, Adapters, and Development Kit

3.9.2 Upgrading Metadata

3.9.3 Upgrading Management

3.9.4 Upgrading Oracle Workflow

3.10 Port Values and the portlist.ini File After Upgrade

3.11 Upgrading Application Server Clusters

3.12 Starting the Upgraded Middle Tier Instance

3.12.1 Accessing the Web Clipping Test Provider Page (PDK 9.0.2.4.0 Only)

3.12.2 Accessing the OmniPortlet Test Provider Page (PDK 9.0.2.4.0 Only)

3.12.3 Updating the OracleAS Portal Provider Information

3.12.4 Refresh the Event/Parameter Passing Samples Provider

3.12.5 Resolving Oracle Call Interface Component Errors

3.13 Validating the Middle Tier Upgrade

3.13.1 Verify Operation of Middle Tier Components

3.13.2 Check Significant URLs

3.14 Considerations for the Source Oracle Home After Upgrade

3.14.1 Decommissioning the Source Oracle Home

3.14.1.1 Preserving Application Files and Log Files

3.14.2 Retaining the Source Home for Future Language Loading

3.14.3 Reverting to the Source Oracle Home: Resetting the Portal Service Monitoring Link

4 Upgrading the Metadata Repository

4.1 Understanding the Metadata Repository Upgrade Process

4.2 Preparing to Upgrade the Metadata Repository

4.2.1 Setting the Environment for Upgrading the Metadata Repository

4.2.2 Loading the DBMS_IAS_UPGRADE Package

4.2.3 Upgrading the Metadata Repository Container

4.2.3.1 Executing mrc.pl for New Schema Creation

4.2.3.2 Executing mrc.pl for Oracle Internet Directory Entry Update

4.2.3.3 Executing mrc.pl for New Schema Creation and Oracle Internet Directory Entry Update

4.2.3.4 Resolving Errors

4.3 Performing the Metadata Repository Upgrade

4.4 Executing Metadata Repository Upgrade Scripts

4.4.1 Executing the Process Connect Schema Upgrade Script

4.4.1.1 Verifying the Upgrade Results

4.4.2 Executing the Oracle Application Server Certificate Authority Schema Upgrade Script

4.4.2.1 Verifying the Upgrade Results

4.4.3 Executing the Oracle Ultra Search Schema Upgrade Script

4.4.3.1 Preparing to Upgrade the Oracle Ultra Search Schema

4.4.3.2 Upgrading the Oracle Ultra Search Schema

4.4.3.3 Configuring the Oracle Ultra Search Schema Metadata

4.4.3.4 Verifying the Upgrade Results

4.4.3.5 Resolving Errors

4.4.4 Upgrading Oracle Ultra Search from a Release 9.0.1 or 9.2 Database

4.4.5 Executing the Oracle Application Server Syndication Server Upgrade Script

4.4.5.1 Verifying the Upgrade Results

4.4.6 Executing the Oracle Application Server Web Services UDDI Registry Schema Upgrade Scripts

4.4.6.1 Upgrade Scenarios

4.4.6.2 Upgrading the UDDI Schema

4.4.6.3 Verifying the Upgrade Results

4.4.6.4 Resolving Errors

4.4.6.5 UDDI Registry Schema Post-Upgrade Task

4.4.6.6 Validating the UDDI Registry Schema Upgrade

4.4.7 Executing the Web Clipping Schema Upgrade Script

4.4.7.1 Verifying the Upgrade Results

4.4.8 Upgrading the Oracle Application Server Wireless Schema

4.5 Upgrading the OracleAS Portal Repository

4.5.1 Upgrading the Oracle9iAS Single Sign-On Server

4.5.2 Creating a Backup

4.5.3 Downloading the OracleAS Portal Repository Upgrade Patch

4.5.4 Using Oracle Universal Installer to Copy OracleAS Portal Upgrade Scripts to the Middle Tier Oracle Home

4.5.5 Assess Whether External Application ID Remapping is Necessary

4.5.6 Executing the OracleAS Portal Repository Upgrade Script

4.5.7 Examining the Log File

4.5.8 Completing the OracleAS Portal Repository Upgrade

4.5.8.1 Compile All Packages

4.5.8.2 Reconfiguring the OracleAS Portal for the Oracle Internet Directory

4.5.8.3 Starting all Middle Tiers That Use The Upgraded Portal Instance

4.5.8.4 Rebuilding the Oracle Text (formerly InterMedia Text) Indexes

4.5.8.5 Turning On Session Store Look-Up in Oracle9iAS Portal 9.0.2.6 Upgrades

4.5.8.6 Understanding OracleAS Portal Usage Changes

4.5.8.7 Understanding Changes to the Portlet Repository

4.5.8.8 Refreshing the OmniPortlet and Web Clipping Providers

4.5.9 Accessing the Upgraded OracleAS Portal

4.6 Upgrading Schemas in Customer Databases

4.6.1 Upgrading the Oracle Application Server Discoverer End User Layer Schema

4.6.2 Upgrading the OracleAS Portal Schema

4.7 Activating 10g (9.0.4) Functionality for UDDI Applications

5 Upgrading the Identity Management Services

5.1 Upgrading Identity Management

5.1.1 Identity Management Configuration Overview

5.1.2 Understanding the Identity Management Upgrade Processes

5.1.2.1 The Identity Management Upgrade Process

5.1.3 Using Oracle Universal Installer to Upgrade Identity Management

5.1.3.1 Upgrading a Non-Distributed Identity Management Configuration

5.1.3.2 Upgrading a Distributed Identity Management Configuration

5.2 Performing an Oracle Internet Directory Multi-Master Replication Upgrade

5.2.1 Upgrading Oracle Internet Directory on One Replica

5.2.2 Upgrading Oracle Internet Directory on Multiple Replicas Simultaneously

5.3 Upgrading Oracle Internet Directory v. 9.2.0.x to 10g (9.0.4)

5.4 Performing Infrastructure Post-Upgrade Tasks

5.4.1 Completing the Oracle Internet Directory Upgrade

5.4.1.1 Applying Patches for Portal 9.0.2.2.14 and 9.0.2.3

5.4.1.2 Reconfigure the OracleAS Portal Instances for the Oracle Internet Directory Server

5.4.1.3 Refreshing the Delegated Administration Services (DAS) URL Cache

5.4.1.4 Recommended Performance Enhancement Tasks

5.4.2 Completing the Oracle Application Server Single Sign-On Upgrade

5.4.2.1 Re-configuring the Oracle Application Server Single Sign-On Middle Tier

5.4.2.2 Configuring Third-party Authentication

5.4.2.3 Installing Customized Pages in the Upgraded Server

5.4.2.4 Converting External Application IDs

5.4.2.5 Setting Up OracleAS Single Sign-On Replication

5.4.2.6 Upgrading the OracleAS Single Sign-On Server with a Customized Middle Tier

5.4.2.7 Troubleshooting Wireless Voice Authentication

5.4.2.8 Installing Languages in the OracleAS Single Sign-On Server

5.4.2.9 Re-Registering OracleAS Portal with the Upgraded OracleAS Single Sign-On Server

5.4.2.10 Re-Registering mod_osso with the Upgraded OracleAS Single Sign-On Server

5.4.2.11 Using an Upgraded Identity Management Configuration with Oracle9iAS Discoverer Release 2 (9.0.2)

5.4.3 Completing the Oracle Application Server Wireless Upgrade

5.4.3.1 Upgrading Wireless User Accounts in Oracle Internet Directory

5.4.3.2 Adding Unique Constraint on the orclWirelessAccountNumber Attribute in Oracle Internet Directory

5.4.3.3 Disabling Oracle Application Server Wireless Upgrade Triggers in the Infrastructure Repository

5.4.3.4 Activating All Oracle Application Server Wireless 10g (9.0.4) Features

5.4.3.5 Assigning Change Password Privilege to OracleAS Wireless

5.4.3.6 Specifying URL Query Parameters for Wireless Services That Use the HTTP Adapter

5.5 Decommissioning the Release 2 (9.0.2) Oracle Home

5.5.1 Deinstalling Oracle9iAS Release 2 (9.0.2) and Deleting the Source Oracle Home

5.5.2 Relocating Data, Control, and Log Files

5.6 Validating the Identity Management Upgrade

5.6.1 Executing the utlrp.sql Utility

5.6.2 Checking for Invalid Database Objects

5.6.3 Testing Oracle Application Server Single Sign-On Connectivity

A Component Upgrade Process Reference

A.1 Middle Tier Upgrade Processes

A.1.1 The Oracle Process Manager and Notification Server (OPMN) Upgrade Process

A.1.1.1 Oracle Process Manager and Notification Server (OPMN) Upgrade Items

A.1.2 The Instance Configuration Data Upgrade Process

A.1.2.1 Instance Configuration Upgrade Items

A.1.3 The Oracle Application Server Containers for J2EE (OC4J) Upgrade Process

A.1.3.1 OC4J Upgrade Items

A.1.4 The Oracle HTTP Server Upgrade Process

A.1.4.1 OHS Upgrade Items

A.1.5 The Oracle Application Server Web Cache Upgrade Process

A.1.5.1 Oracle Application Server Web Cache Upgrade Items

A.1.6 The mod_plsql Upgrade Process

A.1.6.1 mod_plsql Upgrade Items

A.1.7 The Oracle Enterprise Manager Upgrade Process

A.1.7.1 Oracle Enterprise Manager Upgrade Items

A.1.8 The Oracle Application Server Web Services UDDI Registry Upgrade Process

A.1.8.1 Oracle Application Server Web Services UDDI Registry Upgrade Items

A.1.9 The Oracle Ultra Search Upgrade Process

A.1.9.1 Oracle Ultra Search Upgrade Items

A.1.10 The OracleAS Portal Middle Tier Upgrade Process

A.1.10.1 OracleAS Portal Upgrade Items

A.1.11 The Oracle Application Server Wireless Upgrade Process

A.1.11.1 Upgrade of Oracle Application Server Wireless Middle Tiers and Wireless Schema

A.1.11.2 Oracle Application Server Wireless Upgrade Items (List A)

A.1.11.3 Oracle Application Server Wireless Upgrade Items (List B)

A.1.12 The Oracle Application Server Forms Services Upgrade Process

A.1.12.1 Oracle Application Server Forms Services Upgrade Items (List A)

A.1.12.2 Oracle Application Server Forms Services Upgrade Items (List B)

A.1.12.3 Oracle Application Server Forms Services Upgrade Items (List C)

A.1.13 The Oracle Application Server Discoverer Upgrade Process

A.1.13.1 Oracle Application Server Discoverer Upgrade Items

A.1.14 The Oracle Application Server Reports Services Upgrade Process

A.1.14.1 Oracle Application Server Reports Services Upgrade Items

A.2 Infrastructure Upgrade Processes

A.2.1 The Identity Management Upgrade Process

A.2.2 The Metadata Repository Container Schema Upgrade Process

A.2.3 The Process Connect Upgrade Process

A.2.4 The Oracle Application Server Certificate Authority Upgrade Process

A.2.5 The Oracle Ultra Search Schema Upgrade Process

A.2.5.1 Oracle Ultra Search Schema Upgrade Items

A.2.6 The OracleAS Portal Schema Upgrade Process

A.2.6.1 OracleAS Portal Schema Upgrade Items

A.2.7 The Oracle Application Server Syndication Server Schema Upgrade Process

A.2.7.1 Oracle Application Server Syndication Server Schema Upgrade Items

A.2.8 The Oracle Application Server Web Services UDDI Registry Schema Upgrade Process

A.2.8.1 Oracle Application Server Web Services Schema Upgrade Items

A.2.9 The Web Clipping Upgrade Process

A.2.9.1 Web Clipping Schema Upgrade Items

A.2.10 The Oracle Application Server Wireless Schema Upgrade Process

B Files Reference

Index