Skip Headers
Oracle® Web Services Manager Upgrade Guide
10g Release 3 (10.1.3.3.0)

Part Number E10095-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

2 Planning the Oracle Web Services Manager Upgrade

This chapter provides information you need to plan your upgrade and an overview of the upgrade procedure to Oracle WSM 10g Release 3 (10.1.3.3.0).

This chapter includes the following topics:

Understanding the Upgrade to Oracle WSM 10.1.3.3

To upgrade your Oracle WSM 10g Release 2 (10.1.2) system to Oracle WSM 10g Release 3 (10.1.3.3.0), you must first upgrade the 10.1.2 system to 10.1.3.1.0. You will be instructed to install Oracle WSM 10g Release 3 (10.1.3.3.0), then run a migration tool which will migrate the 10.1.2 data and files to 10.1.3.1.0. After the migration, there are a few post-migration tasks that must be performed to complete the upgrade to 10.1.3.1.0.

Once your system is upgraded to 10.1.3.1.0, you will be instructed to apply the Oracle Application Server 10g Release 3 (10.1.3) Patch Set 3 (10.1.3.3.0) patch. This will upgrade your system to Oracle WSM 10g Release 3 (10.1.3.3.0).

Note:

In this guide, reference is made to two Oracle WSM releases with similar release numbers, 10g Release 3 (10.1.3.1.0) and 10g Release 3 (10.1.3.3.0). Please note the difference as you read through this guide.

Oracle WSM Upgrade Paths

The following are the supported Oracle WSM 10g upgrade paths:

The supported upgrade platforms are Microsoft Windows 2000 SP4 on Microsoft Windows 32-bit and Redhat Linux AS 3.0 on Linux x86.

Note:

Only upgrades of production installations of Oracle WSM are supported.

Server Agents Installed on Third-Party Application Servers

Oracle WSM 10g Release 3 (10.1.3.1.0) server agents are supported on the following application servers:

The Oracle WSM 10g Release 3 (10.1.3.1.0) server agents will work with the upgraded Oracle WSM 10g Release 3 (10.1.3.3.0) components. However, a patch to Oracle WSM 10g Release 3 (10.1.3.3.0) for these third-party agents is not available at this time.

System Requirements

Refer to Oracle Web Services Manager Installation Guide for the system requirements to upgrade to Oracle WSM 10g Release 3 (10.1.3.3.0).

Supported Databases

The upgrade procedure only supports the Oracle Database 10g. If you are running an Oracle9i Database Server, you must upgrade the database to Oracle Database 10g before upgrading to Oracle WSM 10g Release 3 (10.1.3.1.0). See the Oracle Web Services Manager Deployment Guide for more information about the databases supported by Oracle WSM 10g Release 3 (10.1.3.1.0).

Oracle WSM 10g Release 3 (10.1.3.1.0) does not support migration of Oracle Lite database.

Planning the Upgrade from Oracle WSM 10g Release 2 (10.1.2) to Oracle WSM 10g Release 3 (10.1.3.1.0)

To plan the upgrade from Oracle WSM 10g Release 2 (10.1.2) to Oracle WSM 10g Release 3 (10.1.3.1.0), you need to understand the new functionality of the Oracle WSM 10.1.3.1.0 Policy Manager. The Oracle WSM 10.1.3.1.0 Policy Manager can determine the version of the requesting Oracle Web Services Manager Gateway (gateway). This changes the way in which the Oracle WSM 10.1.3.1.0 Policy Manager responds to requests from a gateway.

The following section describes how the Oracle WSM 10g Release 3 (10.1.3.1.0) Policy Manager responds to requests from Oracle WSM Gateways.

How the Oracle WSM 10g Release 3 (10.1.3.1.0) Policy Manager Responds to Gateway Requests

The Oracle WSM 10.1.3.1.0 Policy Manager differentiates between requests from an Oracle WSM 10.1.2 gateway and an Oracle WSM 10.1.3.1.0 gateway. When a gateway requests a service, the Oracle WSM 10.1.3.1.0 Policy Manager first determines the version of the requesting gateway. If the requesting gateway is an Oracle WSM 10.1.2 gateway, the Oracle WSM 10.1.3.1.0 Policy Manager sends a text password back to the Oracle WSM 10.1.2 gateway. If the requesting gateway is an Oracle WSM 10.1.3.1.0 gateway, the Oracle WSM 10.1.3.1.0 Policy Manager sends an obfuscated password back to the Oracle WSM 10.1.3.1.0 gateway. However, the Oracle WSM gateway does not determine the version of the Oracle WSM Policy Manager.

Therefore, you may want to upgrade all Oracle WSM 10.1.2 Policy Managers in your deployment to Oracle WSM 10.1.3.1.0 first, before you upgrade the Oracle WSM 10.1.2 gateways. By doing so, your gateways continue to function and service is not interrupted because of a mismatch in versions of the Oracle WSM Policy Manager and the gateways.

Because the number of gateways in your Oracle WSM deployment is always greater than the number of Oracle WSM Policy Managers, it is also easier to upgrade the Oracle WSM Policy Managers first. You can migrate the gateways later, at your convenience.

If you are upgrading an Oracle WSM 10.1.2 installation that has been deployed in a distributed environment, see "Upgrading from a Distributed Environment" for an example of how you can perform this procedure.

Backing up Your Existing Oracle WSM Data

You must back up your existing Oracle WSM 10g Release 2 (10.1.2) data before upgrading to Oracle WSM 10g Release 3 (10.1.3.3.0). In the event of an error when migrating from Oracle WSM 10.1.2 to Oracle WSM 10.1.3.1.0, you will be able to recover your data.

Overview of the Upgrade Procedure

The following is an overview of the steps to upgrade Oracle WSM 10g Release 2 (10.1.2) to Oracle WSM 10g Release 3 (10.1.3.3.0):

  1. Install Oracle WSM 10g Release 3 (10.1.3.1.0).

    You can install Oracle WSM 10g Release 3 (10.1.3.1.0) in one of the following ways:.

    • You can install Oracle WSM as part of the Oracle Application Server 10g Release 3 (10.1.3.1.0) installation. For more information, see Oracle Application Server Installation Guide for your platform.

    • You can install Oracle WSM as a standalone product. For more information, see Oracle Web Services Manager Installation Guide

  2. Migrate Oracle WSM 10g Release 2 (10.1.2) to Oracle WSM 10g Release 3 (10.1.3.1.0). The migration tool migrates properties files, configuration files, and updates the database schema and, if necessary, it updates the data.

  3. Perform the post-migration tasks.

  4. Apply Oracle Application Server 10g Release 3 (10.1.3) Patch Set 3 (10.1.3.3.0).

The chapters that follow describe these steps in further detail.