Oracle® Web Services Manager Upgrade Guide 10g Release 3 (10.1.3.3.0) Part Number E10095-01 |
|
|
View PDF |
This chapter describes how to upgrade to (Oracle WSM) 10g Release 3 (10.1.3.1.0).
This chapter includes the following sections:
You can install Oracle WSM 10g Release 3 (10.1.3.1.0) as part of the Oracle Application Server10g Release 3 (10.1.3.1.0) installation, or you can install Oracle WSM as a standalone installation. In either situation, because only upgrading production installations is supported, you must pick one of the Advanced installation options. If you are installing Oracle WSM as part of Oracle Application Server, then see Oracle Application Server Installation Guide for your platform for more information. If you are installing Oracle WSM as a standalone installation, then see Oracle Web Services Manager Installation Guide for more information.
When you install Oracle WSM 10g Release 3 (10.1.3.1.0), note the following:
Oracle WSM 10g Release 3 (10.1.3.1.0) must be installed in an entirely new directory on the same computer that Oracle WSM 10g Release 2 (10.1.2) is installed. Do not install Oracle WSM 10g Release 3 (10.1.3.1.0) into the directory where Oracle WSM 10g Release 2 (10.1.2) is installed.
If you are installing Oracle WSM as a standalone installation, first install Oracle Application Server 10g Release 3 (10.1.3.1.0) and select the option to install the J2EE Server only. Then install Oracle WSM. During the Oracle WSM installation, you are prompted to provide information about the Oracle Application Server. You must provide the details for the newly installed Oracle Application Server10g Release 3 (10.1.3.1.0).
Before you perform the migration, complete the following tasks:
Start the Oracle Application Server.
Verify that the ORACLE_HOME environment variable points to Oracle Client.
Verify that the TNS Listener is running.
Complete the following procedure to migrate your files and data from Oracle WSM 10g Release 2 (10.1.2) to Oracle WSM 10g Release 3 (10.1.3.1.0).
Note:
Once you execute the command to migrate your files and data, you will not be able to use Oracle WSM 10g Release 2 (10.1.2) with the migrated data.Note:
Migration is only supported on the Microsoft Windows 32-bit and Linux x86 platforms.To migrate Oracle WSM 10g Release 2 (10.1.2)
Locate the /owsm/ OWSM403To10131Migration.zip file on Disk 3 of the Oracle Application Server 10g Release 3 (10.1.3) Patch Set 3 (10.1.3.3.0) media. Extract the files into the ORACLE_HOME directory where you installed Oracle WSM 10.1.3.1.0.
From the command prompt, navigate to the ORACLE_HOME/owsm/bin directory. ORACLE_HOME is the directory where you installed Oracle WSM 10.1.3.1.0.
Execute the following command:
ORACLE_HOME/owsm/bin/wsmadmin migrate OWSM_10.1.2_dir
The variable OWSM_10.1.2_dir is the directory where Oracle WSM 10.1.2 is installed. You will be prompted to provide the OC4J Administrator password and the Oracle WSM 10.1.2 Database password.
See the Oracle Web Services Manager Deployment Guide for more information about the wsmadmin commands.
Restart the Oracle Application Server.
Your Oracle WSM system is now successfully migrated to Oracle WSM 10g Release 3 (10.1.3.1.0).
Perform the following post-migration tasks to complete the upgrade.
You do not have to reregister any gateways or agents that were registered with the Oracle WSM Policy Manager prior to the upgrade to Oracle WSM 10g Release 3 (10.1.3.1.0).
You must reinstall and redeploy your Oracle WSM 10g Release 2 (10.1.2) agents after you upgrade to Oracle WSM 10g Release 3 (10.1.3.1.0). If you plan to apply the Oracle WSM10g Release 3 (10.1.3.3.0) patch, then you should postpone upgrading your agents until after you apply the patch.
Oracle WSM 10g Release 2 (10.1.2) custom policy steps are migrated to Oracle Web Services Manager 10g Release 3 (10.1.3.1.0) during the migration step.
When you upgrade to Oracle WSM 10g Release 3 (10.1.3.1.0), you need to reconfigure any proxy servers. See Chapter 2, "Implementing Your Web Services Manager Deployment" in Oracle Web Services Manager Deployment Guide for more information.
You will not be able to use existing transport security configurations that were created before the upgrade procedure. Any configuration to ensure transport security between the Oracle WSM 10g Release 2 (10.1.2) components are lost during the upgrade to Oracle WSM 10g Release 3 (10.1.3.1.0). Therefore, you will need to reconfigure transport security between the different Oracle WSM components in your deployment after upgrading to Oracle WSM 10g Release 3 (10.1.3.1.0). See the Oracle Web Services Manager Deployment Guide for information about securing components in Oracle WSM 10g Release 3 (10.1.3.1.0).
After you have successfully upgraded to Oracle WSM 10g Release 3 (10.1.3.1.0), you need to remove the following Oracle products:
Oracle Application Server 10g Release 2 (10.1.2)
Oracle WSM10g Release 2 (10.1.2)
This is performed in two separate steps. Use Oracle Universal Installer to uninstall Oracle Application Server. Then manually delete the ORACLE_HOME directory in which Oracle WSM10g Release 2 (10.1.2) is installed.
After you migrate to Oracle WSM 10g Release 3 (10.1.3.1.0), Oracle WSM points to the Oracle WSM 10g Release 2 (10.1.2) Database. Therefore, the database created during the installation of Oracle WSM 10g Release 3 (10.1.3.1.0) is not needed, and you may delete the database.
This section describes the strategy for upgrading Oracle WSM 10g Release 2 (10.1.2) in a distributed environment to Oracle WSM 10g Release 3 (10.1.3.1.0).
The first computer that must be upgraded is the computer where the Oracle WSM Policy Manager is located. See "Planning the Upgrade from Oracle WSM 10g Release 2 (10.1.2) to Oracle WSM 10g Release 3 (10.1.3.1.0)" , for more information about why you need to first upgrade Oracle WSM Policy Manager.
For example, one computer, Computer A, is running the Oracle WSM Policy Manager, Oracle Web Services Manager Monitor, and the Web Services Manager Control. The Oracle Web Services Manager Gateway is deployed separately, on a second computer, Computer B.
In this scenario, because the Oracle WSM Policy Manager is installed on Computer A, you need to upgrade Computer A to Oracle WSM 10g Release 3 (10.1.3.1.0) first. See Chapter 3, "Upgrading Oracle Web Services Manager" to see how to perform this procedure. After completing the migration for Computer A, you need to perform the same procedure on Computer B to upgrade Oracle WSM 10g Release 3 (10.1.3.1.0).
Follow the steps in Chapter 4, "Patching Oracle WSM" to patch the Oracle WSM 10g Release 3 (10.1.3.1.0) system to Oracle WSM 10g Release 3 (10.1.3.3.0).