Upgrading Oracle Unified Directory(OUD) Proxy From 11g To 12c

Below I am going to show you how to upgrade Oracle Unified Directory(OUD) in just a few simple steps. Note: If you are looking for, how to upgrade ODSM from 11g To 12cPS3(OUDSM) please click here. Why upgrade? Below are just a partial list of whats new.

1. Improved performance and scalability:
2. Enhanced security:
3. ODSM Rebranding: (ODSM -> OUDSM)
4. Support for TLS 1.2 Protocols and Cipher Suites:
5. Support for new log publishers that are configurable via OUDSM:
6. Support for WebLogic Scripting Tool provisioning commands:
7. Support for the Upgrade OUD Instance script:
8. Support for Oracle Fusion Middleware configuration tools:
9. And many more…

You can read the full list by clicking here It might be beneficial to glance thru the official Documentation. TIP: Before you start, please make sure to create a backup as thinks do happen and something can go wrong.

Pre-Requisite – Downloading the software

First, you need to download the latest Oracle Unified Directory(OUD) software, which is as of this writing – 12cPS3 (12.2.1.3.0). You can download the software here – scroll down to about the middle of the page (or you can download the file from Oracle OTN network / e-delivery). Next, we are going to extract the software. The download file will be called something like fmw_12.2.1.3.0_oud_Disk1_1of1.zip or V886447-01.zip (depending for wear you downloaded the file). You will now have an extracted file called fmw_12.2.1.3.0_oud.jar. Optional: If you are running OUD on Solaris it is good idea to just create a BE to be able to easily rollback. You do that by running the below

beadm create oud-pre-12c

TIP: Now is the time to disable any OUD alerts i.e. SMTP alerts, you can easily do so with the ODSM/OUDSM console.

Install Java 1.8 Pre-Requisite for 12c

Before you continue, we need to stop the OUD instance, you so by running the below.

/oud/Oracle/Middleware/asinst_1/OUD/bin/stop-ds

One of the OUD 12c requirements is to use Java 1.8. so we make sure to install and set java 1.8 as your OUD running envierment i.e set the JAVA_HOME. To install java 1.8 on Solaris just run the below (if you are on Lunix, just use apt-get, yum, dpkg,etc.. to install, or manual install).

pkg install --accept jdk-8

Note: Don’t run this while the instance is still up. as the existing 11g uses Java version 1.7 and this will change/update the default systems java version. TIP: Its a good idea to add/set the environment with the below updates. Add something like the below to your .bashrc to the OUD running user.

# Points to latest install
export ORACLE_HOME=/oud/Oracle/Middleware/Oracle_Home

export JAVA_HOME=/usr/java
export PATH=$PATH:/oud/Oracle/Middleware/asinst_1/OUD/bin:$ORACLE_HOME/oud/bin

Source in your new changes, then verify the proper java version is set, by running the below.

java -version
java version "1.8.0_152"
Java(TM) SE Runtime Environment (build 1.8.0_152-b16)
Java HotSpot(TM) 64-Bit Server VM (build 25.152-b16, mixed mode)

We are now ready to install / upgrade OUD from 11g to 12c.

Installing OUD 12c

Start by running the below.

java -jar fmw_12.2.1.3.0_oud.jar

TIP: The installer will launch a GUI, so you will need GUI or Xforwarding will work (and this is what I use), just ssh -X your OUD_host or ssh -Y OUD_host(depending in your OS) should do the trick. Skip Auto Updates. Set the Oracle Home. Oracle Home: /oud/Oracle/Middleware/Oracle_Home Something like the screen shot below. Click next, and you will get a summary screen, something like the below screen shot. Now, Just click install and wait for the installation to completed.

Post install modifications – Plus bug fixes.

Next, we need to run a small script to change Java path’s, which is done by running the script below. Note: If you are running OUD on Solaris, you will run in to the below bug which can easily be fixed. To fix the issue just modify the script – like the below, otherwise the script won’t completed. Script path: /oud/Oracle/Middleware/Oracle_Home/oud/bin/upgrade-oud-instances

    # line 25 (copy replace like the below)
    #version=$("$_java" -version 2>&1 | awk -F '"' '/version/ {print $2}')
    version=$("$_java" -version 2>&1 | awk -F\" '{print $2}')

Update Java path’s

Now, you are ready to run the script, an example is below (assuming your OUD path is /oud/Oracle/Middleware/asinst_1).

/oud/Oracle/Middleware/Oracle_Home/oud/bin/upgrade-oud-instances  -I /oud/Oracle/Middleware/asinst_1

Update / Remove old Java settings file

Next, we need to remove the old Java properties file, you do so by running the below.

rm /oud/Oracle/Middleware/asinst_1/OUD/lib/set-java-home

Note: The new location of the properties file is /oud/Oracle/Middleware/asinst_1/OUD/config/java.properties, if you make changes just make sure to run /oud/Oracle/Middleware/asinst_1/OUD/bin/dsjavaproperties for the changes to take effect. Finally we are almost done.

Upgrading the OUD Database

We now need to upgrade the OUD Database, you do that by running the below.

/oud/Oracle/Middleware/asinst_1/OUD/bin/start-ds --upgrade

Note: This might take a while depending on your directory (and group) sizes. Once this process is completed, you are finally ready to bring back online the OUD instance. Just start the OUD instance like normal by running the below.

/oud/Oracle/Middleware/asinst_1/OUD/bin/start-ds

Note: Remember to re-enable SMTP alerts (if disabled). Oracle OUD 11g to 12c Upgrade Documentation https://docs.oracle.com/middleware/12213/oud/OUDIG/updating-oracle-unified-directory-software.htm#OUDIG119 You might also like – Oracle ODSEE to OUD Directory Replication or Migration. Like what you’re reading? please provide feedback, any feedback is appreciated.