5 Upgrading Oracle Internet Directory Highly Available Environments

Describes the process of upgrading an Oracle Internet Directory highly available environment from 12c (12.2.1.3.0) to Oracle Internet Directory 12c (12.2.1.4.0).

Topics

About the Oracle Internet Directory Multinode Upgrade Process

Follow the steps in the task roadmap for upgrading Oracle Internet Directory highly available environments to 12c (12.2.1.4.0).

The steps you take to upgrade your existing domain will vary depending on how your domain is configured and which components are being upgraded. Follow only those steps that are applicable to your deployment.

Table 5-1 Tasks for Upgrading Oracle Internet Directory Highly Available Environments

Task Description

Required

If you have not done so already, review the introductory topics in this guide and complete the required pre-upgrade tasks.

See:

Required on OIDHOST1

Stop all servers and processes on OIDHOST1.

WARNING:

Failure to shut down your servers during an upgrade may lead to data corruption.

See Stopping Servers and Processes.

Required on OIDHOST1

In the case of a collocated installation, uninstall Oracle Fusion Middleware Infrastructure and Oracle Internet Directory 12c (12.2.1.3.0) from the existing Oracle home.

For a standalone installation, uninstall Oracle Internet Directory 12c (12.2.1.3.0) from the existing Oracle home.

See Uninstalling the Software.

Required on OIDHOST1

Install the product distributions on OIDHOST1.

You must install Oracle Fusion Middleware Infrastructure and Oracle Internet Directory 12c (12.2.1.4.0) in the existing Oracle home for collocated deployments.

In case of a standalone mode, you can install Oracle Internet Directory 12c (12.2.1.4.0) without Oracle Fusion Middleware Infrastructure. Additionally, you should also apply patch 32577294.

See Installing Oracle Internet Directory.

Required

Run a pre-upgrade readiness check

See Running a Pre-Upgrade Readiness Check.

Required

Shutdown OIDHOST2 or set it to read-only mode.

See Changing the Server Mode.

Required on OIDHOST1

Run the Upgrade Assistant (UA) on OIDHOST1 to upgrade the necessary schemas to 12c (12.2.1.4.0).

See Upgrading Product Schemas.

Required on OIDHOST1

Pack the domain

See Packing the domain on OIDHOST1.

Required on OIDHOST1

Start the servers in the following order:

  1. Start the Administration Server on OIDHOST1.

  2. Start the Managed Server on OIDHOST1.

  3. Start the Node Managers on OIDHOST1.

  4. Start the Oracle Internet Directory system component on OIDHOST1.

See Starting the Servers.

Required on OIDHOST2

Stop all managed servers on OIDHOST2.

WARNING:

Failure to shut down your servers during an upgrade may lead to data corruption.

See Stopping Servers and Processes.

Required on OIDHOST2

Uninstall Oracle Fusion Middleware Infrastructure and Oracle Internet Directory 12c (12.2.1.3.0) in the existing Oracle home.

See Uninstalling the Software.

Required on OIDHOST2

Install the product distributions on OIDHOST2.

You must install Oracle Fusion Middleware Infrastructure and Oracle Internet Directory 12c (12.2.1.4.0) in the existing Oracle home, for both standalone and collocated deployments.

See Installing Oracle Internet Directory.

Required on OIDHOST2

Replicate the domain configurations on OIDHOST2 using unpack commands.

This includes unpacking the domain on OIDHOST2.

See Replicating the Domain Configurations on OIDHOST2.

Required on OIDHOST2

Start the Oracle Internet Directory system component on OIDHOST2 from OIDHOST1.

See Starting the Servers.

Note:

Ensure that you start the OID server on OIDHOST2 from OIDHOST1.

From DOMAIN_HOME/bin directory on OIDHOST1, start oid2 instance by executing startComponent.sh script:

./startComponent.sh oid2

Execute the script from OIDHOST1 machine, where AdminServer is setup and not from OIDHOST2.

Packing the domain on OIDHOST1

Pack the upgraded domain configurations on OIDHOST1. You would later unpack these domain configurations on OIDHOST2.

Complete the following steps:
  1. On OIDHOST1, run the following command from the location $MW_HOME/oracle_common/common/bin to pack the upgraded domain:
    • On UNIX:

      sh pack.sh -domain=<Location_of_OID_domain> -template=<Location_where_domain_configuration_jar_to_be_created> -template_name="OID Domain" -managed=true

    • On Windows:

      pack.cmd -domain=<Location_of_OID_domain> -template=<Location_where_domain_configuration_jar_to_be_created> -template_name="OIDM Domain" -managed=true

  2. Copy the domain configuration jar file created by the pack command on OIDHOST1 to any accessible location on OIDHOST2.

Replicating the Domain Configurations on OIDHOST2

Replicate the domain configurations on OIDHOST2. This unpacking the domain configurations on OIDHOST2, which was packed in OIDHOST1.

Complete the following steps:
  1. In Packing the domain on OIDHOST1 section you copied the domain configuration jar file created by the pack command on OIDHOST1 to any accessible location on OIDHOST2.

    Go to this location on OIDHOST2.

  2. On OIDHOST2, run the following command from the location $MW_HOME/oracle_common/common/bin to unpack the domain:
    • On UNIX:

      sh unpack.sh -domain=<Location_of_OID_domain> -template=<Location_where_domain_configuration_jar_to_be_created> -overwrite_domain=true

    • On Windows:

      unpack.cmd -domain=<Location_of_OID_domain> -template=<Location_where_domain_configuration_jar_to_be_created> -overwrite_domain=true