Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Related Documents

Documentation Accessibility

1 Performing an Upgrade

1.1 The Forms and Reports Services Upgrade Process

1.1.1 An Overview of the Forms and Reports Upgrade Process

1.1.2 Before You Begin The Upgrade

1.1.2.1 Supported Upgrade Paths for Forms and Reports Services

1.1.2.2 Requirements for Upgrade

1.1.2.3 OracleAS Upgrade Assistant Forms and Reports Services Processing

1.2 Stopping OracleAS Instances

1.3 Using the OracleAS Upgrade Assistant

1.3.1 Specifying Logging Behaviors for the OracleAS Upgrade Assistant

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

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

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

2 Troubleshooting

2.1 Resolving Errors

2.1.1 Resolving Common Errors

2.1.1.1 Source Oracle Home Not Provided by OracleAS Upgrade Assistant

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

2.1.2 Examining the Log File

2.1.2.1 Recovering From Examination Failures

2.1.2.2 Recovering From Upgrade Failures

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

2.1.3.1 Configuration Change Requirements

2.1.3.2 Application Deployment and J2EE Compliance Requirements

2.2 Restarting the OracleAS Upgrade Assistant

3 Completing the Upgrade

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

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

3.1.2 Upgrading JAZN Library Path Entries

3.1.3 Upgrading OC4J Instances Created by the Installer

3.1.4 Upgrading application.xml Entries

3.1.5 Upgrading the jms.xml File

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

3.1.6.1 CTS Compatibility and OJMS

3.1.6.2 CTS Compatibility and JDBC

3.1.6.3 CTS Compatibility and the JAXP/XDK XML Parser

3.1.7 Upgrade Considerations for Enterprise Java Beans

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

3.1.8.1 Enabling Extra Imports

3.1.8.2 Setting Additional JSP Flags for Backward Compatibility

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

3.1.10 Considering Modified Servlet APIs and Behavior

3.1.10.1 Changes Relating to getRequestURI()

3.1.10.2 Filtering of Servlets That Are Forward or Include Targets

3.2 Completing the Oracle HTTP Server Upgrade

3.3 Completing the OracleAS Web Cache Upgrade

3.3.1 Enabling the webcached Executable to Run as The Root User

3.3.2 Upgrading an OracleAS Web Cache Cluster

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

3.4 Completing the Oracle Application Server Forms Services Upgrade

3.4.1 Upgrading the tnsnames.ora File

3.4.2 Upgrading Forms *.fmx Files

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

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

3.5 Completing the Oracle Application Server Reports Services Upgrade

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

3.5.2 Integrating OracleAS Reports Services with Oracle Enterprise Manager

3.5.3 Integrating Reports Services with OracleAS Portal

3.5.4 Integrating Reports Services with Oracle Internet Directory

3.6 Upgrading the tnsnames.ora File

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

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

3.7 Disabling Oracle Application Server Single Sign-On in the Upgraded Instance

3.7.1 Disabling Oracle Application Server Single Sign-On in the Oracle HTTP Server

3.7.2 Disabling Security Services in OracleAS Reports Services

3.7.2.1 Editing the Server Configuration Files

3.7.2.2 Editing the Servlet Properties File

3.7.3 Using OracleAS Forms Services Applications Without Single Sign-On

3.8 Port Values and the portlist.ini File After Upgrade

3.9 Upgrading Application Server Clusters

3.10 Starting the Upgraded Forms and Reports Services Instance

3.10.1 Resolving Oracle Call Interface Component Errors

3.11 Validating the Forms and Reports Services Upgrade

3.11.1 Verify Operation of Middle Tier Components

3.11.2 Check Significant URLs

3.12 Considerations for the Source Oracle Home After Upgrade

3.12.1 Decommissioning the Source Oracle Home

3.12.1.1 Preserving Application Files and Log Files

Index