Upgrading Oracle Internet Directory Highly Available Environments

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.4.0) to Oracle Internet Directory 14c (14.1.2.1.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 14c (14.1.2.1.0).
Completing the Pre-Upgrade Tasks for OID Multi-Node Upgrade
Packing the domain on OIDHOST1
Pack the upgraded domain configurations on OIDHOST1. You would later unpack these domain configurations 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.

Parent topic: In-Place Upgrade of Oracle Internet Directory

About the Oracle Internet Directory Multinode Upgrade Process

Follow the steps in the task roadmap for upgrading Oracle Internet Directory highly available environments to 14c (14.1.2.1.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

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: Introduction to Upgrading Oracle Internet Directory to 14c (14.1.2.1.0) Pre-Upgrade Requirements
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.4.0) from the existing Oracle home. For a standalone installation, uninstall Oracle Internet Directory 12c (12.2.1.4.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 14c (14.1.2.1.0) in the existing Oracle home for collocated deployments. In case of a standalone mode, you can install Oracle Internet Directory 14c (14.1.2.1.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 14c (14.1.2.1.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: Start the Administration Server on OIDHOST1. Start the Managed Server on OIDHOST1. Start the Node Managers on OIDHOST1. 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.4.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 14c (14.1.2.1.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.
Required Replicate the domain configurations on OIDHOST2 using `pack` and `unpack` commands.	This includes packing the domain on OIDHOST1 and unpacking it on OIDHOST2. See Replicating the Domain Configurations on OIDHOST2.
Required Start the servers in the following order: Start the Administration Server and the Managed Servers on OIDHOST1. Start the Node Managers on OIDHOST1 and OIDHOST2. Start the Oracle Internet Directory system component on OIDHOST1. Start the Oracle Internet Directory system component on OIDHOST2 from OIDHOST1.	See Starting the Servers. Note: The OID servers should be started serially (and not simultaneously). 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.

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.4.0) from the existing Oracle home.

For a standalone installation, uninstall Oracle Internet Directory 12c (12.2.1.4.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 14c (14.1.2.1.0) in the existing Oracle home for collocated deployments.

In case of a standalone mode, you can install Oracle Internet Directory 14c (14.1.2.1.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 14c (14.1.2.1.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:

Start the Administration Server on OIDHOST1.
Start the Managed Server on OIDHOST1.
Start the Node Managers on OIDHOST1.
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.4.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 14c (14.1.2.1.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.

Required

Replicate the domain configurations on OIDHOST2 using pack and unpack commands.

This includes packing the domain on OIDHOST1 and unpacking it on OIDHOST2.

See Replicating the Domain Configurations on OIDHOST2.

Required

Start the servers in the following order:

Start the Administration Server and the Managed Servers on OIDHOST1.
Start the Node Managers on OIDHOST1 and OIDHOST2.
Start the Oracle Internet Directory system component on OIDHOST1.
Start the Oracle Internet Directory system component on OIDHOST2 from OIDHOST1.

See Starting the Servers.

Note:

The OID servers should be started serially (and not simultaneously).

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.

Parent topic: Upgrading Oracle Internet Directory Highly Available Environments

Completing the Pre-Upgrade Tasks for OID Multi-Node Upgrade

Ensure that Oracle Internet Directory (OID) is integrated with Oracle WebLogic Server in the existing 12c (12.2.1.4.0) deployment.

All of the nodes in a OID high availability setup must be registered with WebLogic server using opmnctl registerinstance command.

If WebLogic Server was not installed in 12c (12.2.1.4.0), then install Oracle WebLogic Server, create a domain by selecting the Enterprise Manager template, and then register all of the OID nodes using the opmnctl registerinstance command. The upgrade process should be carried out on the AdminServer machine.

Parent topic: Upgrading Oracle Internet Directory Highly Available Environments

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:

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
Copy the domain configuration jar file created by the pack command on OIDHOST1 to any accessible location on OIDHOST2.

Parent topic: Upgrading Oracle Internet Directory Highly Available Environments

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:

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.
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

Parent topic: Upgrading Oracle Internet Directory Highly Available Environments