Oracle® Application Server 10g Upgrading from Release 1 (1.0.2.2.x) to 10g (9.0.4)
10g (9.0.4) Part No. B13674-02 |
|
![]() |
![]() |
This chapter introduces the components and functionality involved in the upgrade from Oracle9iAS Release 1 (1.0.2.2.x) to Oracle Application Server 10g (9.0.4), and highlights some usage changes in components in the new release.
It contains these sections:
This section describes the upgrade process, beginning with the installation of Oracle Application Server 10g (9.0.4), and discusses alternatives to upgrading manually.
Upgrading to Oracle Application Server 10g (9.0.4) consists of these steps:
If you plan to use Infrastructure services, install the Oracle Application Server 10g (9.0.4) Infrastructure installation type.
Install the Oracle Application Server 10g (9.0.4) middle tier of your choice (J2EE & Web Cache, Portal and Wireless, Business Intelligence and Forms).
Important considerations for installation and upgrade:
Review carefully the Oracle Application Server 10g Installation Guide, Chapter 3, "Compatibility with Other Versions", and Chapter 4, "Requirements" to ensure that all requirements are met for your configuration.
If you are installing a Portal and Wireless middle tier, and intend to upgrade Oracle9iAS Wireless to Oracle Application Server Wireless, perform the installation within the sequence of steps in Section 5.3, "Preliminary OracleAS Wireless Upgrade Tasks". Those steps recommend backups of the middle tier and Infrastructure installations at certain junctures. In particular, do not configure the Wireless component during the installation.
Perform the upgrade steps in this guide for the components you want to use in Oracle Application Server 10g (9.0.4).
The procedure presented in this guide for upgrading middle tier instances from Oracle9iAS Release 1 (1.0.2.2.x) to Oracle Application Server 10g (9.0.4) is manual, with the exception of a few scripts for certain components. However, if you are upgrading from an Oracle9iAS Release 1 (1.0.2.2.x) Core installation to a Oracle Application Server 10g (9.0.4) J2EE and Web Cache installation type, it might be worthwhile to install the intermediate release, Oracle9iAS Release 2 (9.0.2), and use the Migration Assistant (provided in Oracle9iAS Release 2 (9.0.2)) and the Upgrade Assistant (provided in 10g (9.0.4)) to automate part of the upgrade. The majority of the configuration for Oracle HTTP Server, Oracle9iAS Containers for J2EE, and Oracle9iAS Web Cache is automated by the Assistants.
This alternative is probably worthy of consideration if you have an extensively customized Oracle HTTP Server, since the httpd.conf
file is large (and thus time-consuming and error-prone to upgrade manually).
All upgrade and installation documentation from prior releases is available on Oracle Technology Network. The upgrade documentation, Migrating from Oracle9iAS Release 1 (1.0.2.2.x) to Release 2 (9.0.2) and Upgrading to 10g (9.0.4) describes in detail the processing performed by the Migration Assistant and the Upgrade Assistant. Reviewing this documentation should inform your choice of upgrade method.
Before performing any of the installations, review the installation documentation for the release you are installing to ensure that coexistence and other requirements for your particular configuration are met.
The steps in the partially automated upgrade process are as follows:
Install the Oracle9iAS Release 2 (9.0.2) middle tier on the same computer as the Oracle9iAS Release 1 (1.0.2.2.x) middle tier.
Follow the instructions in Migrating from Oracle9iAS Release 1 (1.0.2.2.x) to Release 2 (9.0.2) in the Release 2 (9.0.2) documentation library. The Oracle9iAS Migration Assistant, described in the guide, automates much of the Oracle HTTP Server, Oracle9iAS Containers for J2EE, and Oracle9iAS Web Cache upgrades.
After using the Migration Assistant, perform any manual tasks necessary to complete the upgrade of these components. The tasks are documented in Migrating from Oracle9iAS Release 1 (1.0.2.2.x) to Release 2 (9.0.2)
If you plan to use Infrastructure services in 10g (9.0.4), install the Oracle Application Server 10g (9.0.4) Infrastructure.
Install the Oracle Application Server 10g (9.0.4) middle tier on the same computer as the Oracle9iAS Release 2 (9.0.2) middle tier.
Follow the instructions in Upgrading to 10g (9.0.4) in the 10g (9.0.4) documentation library. The OracleAS Upgrade Assistant, described in the guide, automates much of the Oracle HTTP Server, Oracle9iAS Containers for J2EE, and Oracle9iAS Web Cache upgrades.
After using the Upgrade Assistant, perform any manual upgrade tasks necessary to complete the upgrade of each component. The tasks are documented in Upgrading to 10g (9.0.4) in the Oracle Application Server 10g (9.0.4) documentation library.
Some components are common to Oracle9iAS Release 1 (1.0.2.2.x) and the Oracle Application Server 10g (9.0.4); others have been deprecated or renamed. As a prelude to the upgrade discussion, it is useful to compare the two releases to identify usage changes and highlight benefits of upgrading. Table 1-1 identifies the Oracle9iAS Release 1 (1.0.2.2.x) components and summarizes their disposition in Oracle Application Server 10g (9.0.4), providing a reference to the information about the changes to the component in the new release.
Table 1-1 Components in Release 1 (1.0.2.2.x) and 10g (9.0.4)
Component in Release 1 (1.0.2.2.x) | Component in 10g (9.0.4) | Description | For more information, see: |
---|---|---|---|
Oracle HTTP Server (based on the Apache HTTP Server v. 1.3)
Available in Core, Minimal, Standard and Enterprise Editions |
Oracle HTTP Server (based on the Apache HTTP Server v. 1.3.28)
Available in J2EE & Web Cache, Portal & Wireless, and Business Intelligence and Forms Editions |
Oracle HTTP Server is the web server component of the Oracle Application Server that services HTTP and HTTPS requests from the Internet. | Section 1.2.1, "Changes in the Oracle HTTP Server"
and |
Oracle9iAS Containers for J2EE (OC4J)
Available in Core Edition |
Oracle Application Server Containers for J2EE (OC4J)
Available in J2EE & Web Cache, Portal & Wireless, and Business Intelligence and Forms Editions |
OC4J is the J2EE container for Oracle Application Server. It was introduced in Oracle9iAS Release 1 (1.0.2.2). | Section 1.2.2, "Changes in Oracle Application Server Containers for J2EE (OC4J)"
|
Oracle9iAS Web Cache
Available in Core Edition |
Oracle Application Server Web Cache
Available in J2EE & Web Cache, Portal & Wireless, and Business Intelligence and Forms Editions |
Oracle Application Server Web Cache is a content-aware server accelerator, or reverse proxy server, that improves the performance, scalability, and availability of Web sites that run on Oracle Application Server. | Section 1.2.3, "Changes in Oracle Application Server Web Cache"
|
Oracle9iAS Single Sign-On | Oracle Application Server Single Sign-On
|
OracleAS Single Sign-On is a component of Oracle Application Server that provides a framework for secure single sign-on; allowing users to log in to multiple Web-based applications, such as expense reporting, e-mail, and benefits information, using a single username and password. | Section 1.4, "Accessing OracleAS Single Sign-On Upgrade Documentation". |
Oracle9iAS Portal | Oracle Application Server Portal
Available in Portal & Wireless and Business Intelligence and Forms Editions |
OracleAS Portal is a Web-based application for building and deploying portals. It provides a secure, manageable environment for accessing and interacting with enterprise software services and information resources. | Section 1.5, "Accessing OracleAS Portal Upgrade Documentation". |
Oracle9iAS Wireless | Oracle Application Server Wireless
Available in Portal & Wireless and Business Intelligence and Forms Editions |
OracleAS Wireless is the wireless and voice platform of Oracle Application Server. It enables development and deployment of wireless browsing applications, voice applications, asynchronous applications, J2ME applications, and notifications. Wireless is also the voice and wireless platform for the mobile extensions of the Oracle E-Business Suite, the wireless and voice components of the Oracle Collaboration Suite, and the foundation for custom and partner wireless and voice solutions. |
|
Oracle Enterprise Manager Client | Oracle Enterprise Manager Application Server Control in Oracle Enterprise Manager 10g | The Oracle Enterprise Manager Client is the first tier in the three-tiered architecture of the Oracle Enterprise Manager. The second tier is the Oracle Management Server, and the third consists of managed nodes containing databases and other services.
The Oracle Enterprise Manager Application Server Control in Oracle Enterprise Manager 10g is the graphical interface for managing and monitoring application server components. |
|
Oracle Enterprise Java Engine | This functionality replaced by Oracle Application Server Containers for J2EE. | Oracle Enterprise Java Engine is a server environment that supports Enterprise Java Beans, CORBA, and database stored procedures. |
|
Oracle9iAS Discoverer | Oracle Application Server Discoverer
Available in Business Intelligence and Forms Editions |
OracleAS Discoverer is an ad-hoc query analysis tool. Since Oracle9iAS Release 2 (9.0.2), it has integrated with Oracle Enterprise Manager to perform various functions supported by Enterprise Manager and Oracle Portal. OracleAS Discoverer is available as a deployed application in the OC4J BI FORMS stack.
In Oracle Application Server 10g (9.0.4), Discoverer services are managed by Oracle Process Manager and Notification Server (OPMN). |
Section 1.2.4, "Changes in Oracle Application Server Discoverer"
|
The Oracle HTTP Server has undergone significant change since Release 1 (1.0.2.2.x). In addition to the changes in the base product (Apache HTTP Server version 1. 3 to 1.3.28), the configuration files have been restructured to conform to the OHS SMI requirements, the mod_ssl
module has been replaced with a new Oracle module, mod_ossl
, new Oracle modules have been added and out-of-date modules removed, and SSL certificates have been replaced with Oracle wallets.��The configuration of OHS is very sophisticated because, in addition to the general server configuration directives, each module has its own set of directives. In addition, virtual hosts can be set up, each of which has its own complete set of configuration directives. All of this is customizable, so upgrade is a complicated task.
Specific changes to the Oracle HTTP Server main configuration file and its widely used modules are summarized in Table 1-2.
Table 1-2 Changes in the Oracle HTTP Server Functionality and Usage
Area of Change | Release 1 (1.0.2.2.x) Usage/Behavior | 10g (9.0.4) Usage/Behavior |
---|---|---|
mod_jserv , JServ servlet container
|
These components enabled users to run servlets and Java Server Pages. | OC4J is the J2EE-compliant servlet engine. mod_jserv /Jserv is disabled by default. All applications using JServ should be upgraded to OC4J.
See: Section 3.1.2, "Upgrading from JServ to the OC4J 10g (9.0.4) Servlet Environment" |
mod_oprocmgr | This module managed the start/stop/restart and monitoring of JServ processes. | Oracle Process Manager and Notification Server (OPMN) performs the equivalent functionality in managing OC4J processes. mod_oprocmgr is not loaded by the LoadModule directive in httpd.conf , and all configuration related to it is ignored in server operations.
|
mod_ssl | This module is based on the OpenSSL toolkit. | mod_ssl is replaced by mod_ossl , which is based on the Oracle security stack. Secure Sockets Layer (SSL) certificates must be converted to Oracle wallets.
|
mod_onsint
|
Not present. | This module communicates with OPMN, facilitating its management of OHS. |
mod_wchandshake
|
Not present. | This module performs the handshake between OracleAS Web Cache and the Oracle HTTP Server. |
httpd.conf
|
Main server configuration file, with some Oracle-specific customizations. | The following changes have been made to this file:
|
The differences between the OC4J container in Oracle Application Server 10g (9.0.4) and the OC4J container shipped with Oracle9iAS Release 1 (1.0.2.2.x) are summarized in Table 1-3.
Table 1-3 Changes in the OC4J Functionality and Usage
The differences between the Oracle9iAS Web Cache and OracleAS Web Cache are in the areas of:
DTDs
Names of elements in configuration files
The differences between the Oracle9iAS Discoverer and OracleAS Discoverer are in the areas of the Discoverer client and the Discoverer C++ server.
In Oracle9iAS Release 1 (1.0.2.2.x), the Discoverer client was plugged into the Oracle HTTP Server configuration files. In Oracle Application Server 10g (9.0.4), it is a deployed application in the OC4J Business Intelligence and Forms stack.
In Oracle9iAS Release 1 (1.0.2.2.x), the Discoverer C++ server was self-controllable via Visibroker Gatekeeper. In Oracle Application Server 10g (9.0.4), it is OPMN-controllable via Visibroker Gatekeeper.
The differences between the Oracle9iAS Forms Services and OracleAS Forms Services are in the areas of servlet container configuration, method of configuration, and deployment methods available.
In Oracle9iAS Release 1 (1.0.2.2.x), In Oracle9iAS Release 1 (1.0.2.2.x), Forms Services may have required manual configuration of the Oracle HTTP Server and JServ servlet container files. The Oracle Application Server 10g (9.0.4) installer automatically configures the Oracle HTTP Server and the OC4J servlet container for Forms Services. If additional customization of these is required, it can be done with the graphical user interface of Oracle Enterprise Manager 10g. In addition, key OracleAS Forms Services configuration files (formsweb.cfg
, default.env
) can also be edited using Oracle Enterprise Manager 10g.
In Oracle Application Server 10g (9.0.4), OracleAS Forms Services uses the Forms Listener Servlet architecture for deployment of Forms applications. The following deployment modes are not available: character mode; client/server; the Forms CGI; and the Forms Server (also known as the Forms Listener).
The differences between Oracle Reports and OracleAS Reports Services are itemized in Table 1-4. The changes between the releases are also discussed thoroughly in:
Oracle9i Reports Obsolescense Plan: Oracle9i Reports Statement of Direction at:
http://otn.oracle.com/products/reports/pdf/movingto9i.pdf
Statement of Direction: Oracle Application Server Reports Services 10g (9.0.4) at:
http://otn.oracle.com/products/reports/10g/SOD_Reports.html
Table 1-4 Changes in the OracleAS Reports Services Functionality and Usage
Area of Change | Release 1 (1.0.2.2.x) Usage/Behavior | 10g (9.0.4) Usage/Behavior |
---|---|---|
Reports Server architecture | See:
|
Scalable, flexible architecture for the distribution and automated management of report generation engines on the same server and across multiple servers. For more information, see:
|
Web client choices | Servlet and CGI implementation | Servlet, JSP, or CGI implementation. For more information, see:
|
High availability | No high availability features | Numerous high availability features keep the middle tier running even when particular servers or components fail. For more information, see:
|
Starting and stopping | Command line or Windows service. See:
|
Oracle Process Manager and Notification Server (OPMN). See:
|
Reports Services configuration | Reports server configuration:
Reports web client configuration:
|
All configuration files are in XML format. See:
|
Reports destination configuration | No destination configuration available | Supports default and custom destinations. See:
|
Security | Provides functionality for:
See:
|
Provides functionality for application server level (single sign-on or non-single-sign-on) access to reports and data:
See: Securing OracleAS Reports Services Configuring and Administering OracleAS Single Sign-On Deploying Reports in OracleAS Portal |
Configuring Reports server clusters | Master-slave clustering architecture. See:
|
Peer-level clustering support. See:
|
Deploying and running report requests | Mechanism to deploy and run paper-based reports. See:
|
Mechanism to deploy paper and Web reports. Support is also provided to run these reports through pluggable engines. Usage of key-map file is changed. See:
|
Batch registration of reports in OracleAS Portal | Unavailable | See: |
Oracle Reports Web Service | Unavailable | Web Services interface through which external applications can submit a job. See:
|
Advance distributions | Builder distribution | Advance distribution and bursting capabilities, which can also be used with customer destinations.
See: Advance Distribution Bursting and Distributing a Report
|
Event-driven publishing | Unavailable | Reports can be run automatically in response to an event in the database, such as the insertion of a record or the change of a value.
See:
|
DISPLAY environment variable dependency (UNIX) | DISPLAY must be set on UNIX systems | Not necessary to have the DISPLAY environment variable or a valid printer defined at runtime. See:
|
Managing and monitoring OracleAS Reports Services Services | Unavailable | Oracle Enterprise Manager 10g provides managing and monitoring services for OracleAS Reports Services. See:
|
Reports Web Cartridge | See:
|
Reports Web Cartridge |
Configuring and using the pluggable data source | Unavailable | Pluggable data sources are supported. See:
JDBC Data Source Example
XML Data Source Example
Text Data Source Example
|
Report using Oracle Express Data | Unavailable | OLAP-based built-in data source. See: |
Printing on UNIX with Oracle Reports |
|
OracleAS Reports Services provides a rich set of features out of the box for printing on various platforms. See:
|
PDF in Oracle Reports | Supported | Supports PDF 1.4, and is capable of generating high resolution PDF reports on all platforms. The PDF features supported by Oracle Reports include:
See:
|
Oracle9i JDeveloper integration | Unavailable |
|
Command-line options and report-related environment variables | See:
|
See:
|
JSP Web-based reports | Unavailable | See the tutorial at: |
Depending on the Release 1 (1.0.2.2.x) installation type you are upgrading, or the components you will use in the upgraded instance, you may use some or all of the chapters in this guide. Review, understand, and perform the steps in Section 1.1, "The Oracle9iAS Release 1 (1.0.2.2.x) to Oracle Application Server 10g (9.0.4) Upgrade Process", paying particular attention to installation requirements that apply to the configuration you are upgrading. The Oracle Application Server 10g Installation Guide, used in conjunction with this guide, provides complete information on compatibility and installation requirements.
References to other Oracle documentation may be necessary as you use this guide (lengthy configuration instructions for components are not replicated here). Ensure that you have access to all of the books in Related Documents. All of the documents are available on the Oracle Technology Network (OTN).
The upgrade documentation for OracleAS Single Sign-On is not included in this guide. It is provided in the OracleAS Single Sign-On Upgrade Patch, which is available on Oracle MetaLink (you need a MetaLink user ID and password to obtain the patch). Follow these instructions to download the patch:
The upgrade documentation for OracleAS Portal is not included in this guide. It is provided in the Portal Center on Oracle Technology Network. Follow these instructions to access the OracleAS Portal upgrade documentation:
Access the URL:
Click the 9.0.4 link in the Upgrade Targets section.
The 9.0.4 information page appears.
Read these sections:
Generic Upgrade Information
Version 3.0.9 to 9.0.4