6
Migrating Distributed Configurations

This chapter provides instructions on, migrating an instance that is associated with an infrastructure, migrating Oracle9iAS clusters, and using the emctl switch utility to activate Oracle Enterprise Manager in the Oracle Home of your choice.

It is expected that you already know:

• How the clustered architecture works.

• The functionality and expected behavior of the configuration you are migrating.

• How to create and manage clusters. You can use Oracle Enterprise Manager or the dcmctl utility to do this.

  See Also: Oracle9i Application Server Administrator's Guide.

  Notes: You cannot create a cluster that combines Oracle9iAS Release 2 (9.0.2) instances with Oracle9iAS Release 2 (9.0.3) instances. You can use Oracle Enterprise Manager to manage one of the instances, not both. See "Considerations for Using Oracle9iAS Release 2 (9.0.2) and (9.0.3) Together" .

Migrating an Instance Associated with an Infrastructure

Infrastructure 9.0.2 enables you to use clustering. It must be installed and configured before you install Oracle9iAS Release 2 (9.0.3). If Infrastructure 9.0.2 is on the same computer as Oracle9iAS Release 2 (9.0.3), it will be associated automatically.

If it is on a different computer, you must associate Oracle9iAS Release 2 (9.0.3) with Infrastructure 9.0.2.

See Also: Oracle9i Application Server Administrator's Guide, Chapter 10, "Reconfiguring the Application Server".

Migrating a Clustered Instance

Perform the steps below to migrate a cluster.

1. Determine the instance name of the instance to migrate.
   1. cd ORACLE_HOME_1/dcm/bin

   2. dcmctl listinstances

2. Go to the source instance and stop all processes there.

3. Go to the target instance and stop all processes there.

4. Access the Migration Assistant directory:

   cd ORACLE_HOME_2/migration/

5. Start the Migration Assistant with one of the following commands:

   GUI version:

   ./MigAssistant.sh (UNIX)

   ./MigAssistant.bat (Windows)

   Command-line version:

   ./MigAssistantCmd.sh (UNIX)

   ./MigAssistantCmd.bat (Windows)

6. Follow the instructions in Chapter 5, "Using the Migration Assistant".

7. Start Oracle Enterprise Manager with the command:

   cd ORACLE_HOME_2/bin/emctl start

   where ORACLE_HOME_2 is the location of the active Oracle home.

8. Use a browser to display the Oracle9iAS Instance Home Page.

9. Start the target instance.

10. Follow the steps in "Verifying Migration Results".

11. Create a cluster.

12. Join the migrated instance to the cluster.

13. Install and join additional instances to the cluster.

14. If you used the mod_oc4j.conf file to route requests to OC4J instances in the Release 2 (9.0.2) cluster, do the following:
    1. Edit mod_oc4j.conf in one of the instances and look at the Oc4jMount directives.

    2. Change the instance names to the name of the Release 2 (9.0.3) instance.

    3. If the cluster names are different from those used in the Release 2 (9.0.3) instance, change them to the names used in the 9.0.3 instance.

    4. Copy the mount points (the Oc4jMount directive settings), to the mod_oc4j.conf files in the remaining Release 2 (9.0.3) instances.

15. If you performed step 13, verify that requests with URL patterns specified in the Oc4jMount directives are routed to the named instances.

16. Perform post-migration maintenance to the source environment, as needed, such as removing the migrated instance from the infrastructure and farm.

    See Also: Oracle9i Application Server Administrator's Guide

Activating Oracle Enterprise Manager

Oracle Enterprise Manager can be active in only one Oracle Home. Follow the instructions below to switch the active home.

1. Issue this command:

   emctl switch home

   A dialog with a drop-down list of homes displays. Select the home to activate.

2. Copy the file below to the Oracle home you activated.

   ORACLE_HOME/sysman/j2ee/config/jazn-data.xml

3. Edit the jazn-data.xml file, removing the block shown below:

   <user>

   <name>test</name>

   <credentials>/78TLB5pR2Y=</credentials>

   </user>

4. Start Oracle Enterprise Manager in the active home with this command:

   emctl start