9 Migrating Oracle9iAS CC from Release 2.0.5.1 to 2.0.6

The previous release (2.0.5.1) of Oracle9i Application Server Certified Configuration (Oracle9iAS CC) installed the Oracle9i Application Server product under fixed directories. You can use the tools that are part of this release (2.0.6) of Oracle9i Application Server Certified Configuration to migrate a release 2.0.5.1 environment to a 2.0.6 environment, that adheres to the Oracle Outsourcing standards.

You can perform the migration in the same system or from one system to another. If you are migrating within the same system, verify that the services in the source instance remain shutdown throughout the entire cloning process. Once you verify that the cloning process is complete, you can remove the source instance. The migration tool does not apply any Oracle9i Application Server product patches during the process of migration, the product version remains the same.

The Oracle9iAS CC migration tool does not take care of migrating the customer database for Oracle9iAS Portal and Oracle Internet File System (Oracle9iFS) (if available). Ensure that you migrate the customer database for Oracle Portal or Oracle9iFS, using the appropriate tools, prior to migrating Oracle9iAS CC.

This chapter contains the following sections:

Prerequisites
Prepare the Oracle9iAS CC Release 2.0.5.1 Image
Extracting the Image in the Target System
Clone the Extracted Image
Postmigration

Prerequisites

Perform a full system backup before migration.

Prepare the Oracle9iAS CC Release 2.0.5.1 Image

Follow the following procedure to prepare the image on the Oracle9iAS CC release 2.0.5.1 system:

Shutdown all the Oracle9iAS CC components.

Refer to "Starting and Stopping Oracle9iAS Services" in Appendix A for instructions on how to stop the Oracle9iAS CC components and their sequence of shutdown for a two-tier deployment.
Install the Oracle9iAS CC Utility Pack components from the stage area as root user. Perform this step on database-tier and middle-tier in a two-tier deployment.
```
# ./install.sh -cdzeroonly
```
Relocate the data files from /data/<sid> directory to /data/<sid>/data01, /data/<sid>/data02 and /data/<sid>/data03 directories. This step is required in the database-tier machine or in infrastructure database Oracle home in the two-tier deployment.

Note:
The relocation step relocates only the existing data files, index files, and log files. It does not create any new files.

Run the following script as the user that owns the infrastructure database Oracle home.
```
$ cd /admin/mwcc/clone/scripts
$ relocate_datafiles.sh
```
The subsequent steps list out the high level steps to complete the cloning. For detailed instructions refer to Chapter 8, " Cloning".
Create stage area of the Oracle homes by running prepare_to_clone.sh script as root user.
```
# cd /admin/mwcc/clone/scripts
# ./prepare_to_clone.sh
```
This step should be performed in the following sequence for a two-tier deployment:
- Infrastructure database Oracle home on the database-tier systemInfrastructure mid-tier Oracle home on the middle-tier systemOracle9i Application Server mid-tier Oracle home on the middle-tier system
Specify the stage area where the image will be created, and specify the Oracle homes from the list returned by the script for which you want to create the image.

Extracting the Image in the Target System

Use the following procedure to make the stage area where you created the source Oracle9iAS CC release 2.0.5.1 image:

Install the Oracle9iAS CC Utility Pack components from the stage area as root user. Perform this step on the database-tier and middle-tier in a two-tier deployment, and on the single-tier machine in a single-tier deployment.
```
# ./install.sh -cdzeroonly
```
Run extract.sh to extract the image as the root user:
```
# cd /admin/mwcc/clone/scripts
# ./clone_extract.sh
```
Extract the Oracle homes in the following order for a two-tier deployment:
- Infrastructure database Oracle home on the db-tier systemInfrastructure mid-tier Oracle home on the middle-tier systemOracle9i Application Server mid-tier Oracle home on the middle-tier system

Clone the Extracted Image

To clone or reconfigure each Oracle home run the following script as the root user:

# cd /admin/mwcc/clone/scripts
# ./clone_extract.sh

For a two-tier deployment, run the reconfiguration script to reconfigure each Oracle home in the following order:

Customer database should be cloned, up, and running. Use the Oracle9i Certified Configuration tools to reconfigure it.
Infrastructure database Oracle home on the database-tier system.
Infrastructure mid-tier Oracle home on the middle-tier system.
Oracle9i Application Server mid-tier Oracle home on the middle-tier system.

Verify that all the processes are up and running after you finish cloning. Make sure that all your applications are accessible on the target system.

Postmigration

Complete the post cloning instructions in the Postcloning Steps section of Chapter 8, " Cloning".

If you migrate a standalone J2EE and Web Cache instance (without Infrastructure), you need to create a symbolic link from the old Oracle home to the new Oracle home. Refer to bug 2973460 for details.