6 Upgrading the Oracle Unified Directory Software

You can upgrade an Oracle Unified Directory to the latest version without a service interruption. It also describes how to upgrade an individual directory server instance and Oracle Unified Directory Services Manager.

Topics:

6.1 About Starting Points for an Oracle Unified Directory Upgrade

In this release, Oracle Unified Directory 12c (12.2.1.4.0) can be upgraded to 14c (14.1.2.1.0) release. The upgrade procedures in this guide explain how to upgrade an existing Oracle Unified Directory 12c (12.2.1.4.0) to Oracle Unified Directory 14c (14.1.2.1.0).

6.2 Prerequisites for Oracle Unified Directory Upgrade

Before you begin to upgrade Oracle Unified Directory 12c (12.2.1.4.0), you must stop the servers and back up your current environment.

You must complete the following prerequisites for upgrading to the Oracle Unified Directory 14c (14.1.2.1.0) environment:

Note:

This applies only to collocated installations and does not apply to standalone OUD 14.1.2.1.0 installations.
  • Apply the ADF patch (search for Bug ID 37376076 at https://support.oracle.com) manually using OPatch to the OUD 14.1.2.1.0 ORACLE_HOME before performing the reconfiguration step.
  • Apply the one-off EM patch (search for Bug ID 37476292 at https://support.oracle.com) manually using OPatch to the OUD 14.1.2.1.0 ORACLE_HOME before performing the reconfiguration step.
  1. Stop all the Directory Server instances and domains where Oracle Unified Directory Services Manager (OUDSM) is installed, depending upon the domain configuration.

    Stop the Standalone Oracle Unified Directory Server

    If you have installed Oracle Unified Directory in a Standalone Oracle Unified Directory Server (Managed independently of WebLogic server) mode, stop all the Directory Server instances using the stop-ds command.

    Unix
    ORACLE_HOME/INSTANCE_NAME/OUD/bin/stop-ds

    Windows

    ORACLE_HOME\INSTANCE_NAME\OUD\bat\stop-ds.bat

    Stop the Collocated Oracle Unified Directory Server

    If you have installed Oracle Unified Directory in a Collocated Oracle Unified Directory Server (Managed through WebLogic server) mode, complete the following steps:

    1. Stop the OUD instance by running the following command from command line interface.

      Unix

      DOMAIN_HOME/bin/stopComponent.sh INSTANCE_NAME

      Windows

      DOMAIN_HOME\bin\stopComponent.bat INSTANCE_NAME
    2. Stop the node manager.

      Unix

      DOMAIN_HOME/bin/stopNodeManager.sh

      Windows

      DOMAIN_HOME\bin\stopNodeManager.cmd
    3. Stop the Oracle WebLogic Administration Server.

      Unix

      DOMAIN_HOME/bin/stopWebLogic.sh

      Windows

      DOMAIN_HOME\bin\stopWebLogic.cmd
  2. Create a complete backup of your pre-upgrade environment before you begin an upgrade.

    Note:

    Oracle recommends that you create a complete backup of your pre-upgrade environment before you begin an upgrade. Upgrades cannot be reversed. In most cases, if an error occurs, you must stop the upgrade and restore the entire environment from backup and begin the upgrade process from the beginning.
    1. Back up the Oracle Home (ORACLE_HOME). For example:

      Unix

      tar -cf oracle_home_backup_06052017.tar ORACLE_HOME/*

      Windows

      jar cMf oracle_home_backup_06052017.jar ORACLE_HOME\*
    2. If your Oracle Unified Directory instance (OUD_INSTANCE) resides outside the Oracle Home (ORACLE_HOME), then you must back up the instance directory. For example:

      Unix

      tar -cf oud_instance_backup_06052017.tar oud_instance/*

      Windows

      jar cMf oracle_home_backup_06052017.jar ORACLE_HOME\*
    3. If your Java Development Kit (JDK) resides inside the Oracle Home (ORACLE_HOME), then you must move it to another location before you perform an upgrade.

6.3 Upgrading a Directory Server Without Service Interruption

Upgrading a replicated Oracle Unified Directory topology involves upgrading the software for each server instance individually. The strategy for maintaining service during an upgrade depends on the specifics of your deployment, but usually, you can upgrade an entire topology without any interruption in service.

Because a particular directory server instance must be stopped during the upgrade process, maintaining service during an upgrade requires alternative servers that can handle client requests while a particular server is down.

If your deployment includes one or more proxy server instances that route client requests to the back-end servers, you can safely take down one directory server at a time and upgrade that server instance. The proxy server will reroute client requests to ensure uninterrupted service. Upgrading the proxy server instance requires more than one proxy server instance with the same configuration.

If your deployment does not include a proxy server, you must configure your client applications to send requests to an alternative server while a specific directory server instance is being upgraded.

The following sections outline the steps to follow for each of these topologies:

6.3.1 Upgrading a Topology That Includes a Proxy Server

Review these topics for the various topologies with the directory servers and replication servers either installed on the same host or different hosts.

Various topologies are possible as explained in the following topics:

6.3.1.1 About Topology with the Replication Servers and Directory Servers on the Same Host

In this topology, the directory servers and replication servers are installed on the same host.

If a single host contains both a replication server and a directory server, and those servers are associated with the same ORACLE_HOME directory, the servers are stopped and upgraded at the same time.

In the following figure, Group 1 and Group 2 refer to configured replication groups. For more information about replication groups, see About Replication Groups in Administering Oracle Unified Directory.

Figure 6-1 Replicated Topology with Proxy Servers - RS and DS on the Same Host

Topology with all servers installed on the same host.
6.3.1.2 Upgrading a Topology with the Replication Servers and Directory Servers on the Same Host

To upgrade a topology with the directory servers and replication servers installed on the same host:

  1. Change the configuration of proxy server A so that client requests are not routed to directory server A.
  2. Stop directory server A. The replication server running on this host is stopped at the same time.
  3. Upgrade directory server A, following the steps in Upgrading an Existing Oracle Unified Directory Server Instance.
  4. Restart directory server A.
  5. Test that your directory server is working properly before upgrading successive servers.
  6. Repeat steps 1-5 for each directory server in that replication group.
  7. Follow steps 1-6 for each replication group in the topology.
  8. Stop proxy server A.
  9. Upgrade proxy server A, following the steps in Upgrading an Existing Oracle Unified Directory Server Instance.
  10. Restart proxy server A.
  11. Repeat steps 8-10 for the remaining proxy servers in the topology.
6.3.1.3 About Topology with Replication Servers and Directory Servers on Different Hosts

In this topology, the directory servers and replication servers are installed on different hosts. In the following figure, Group 1 and Group 2 refer to configured replication groups. For more information about replication groups, see About Replication Groups in Administering Oracle Unified Directory.

Figure 6-2 Replicated Topology with Proxy Servers - RS and DS on Different Hosts

Topology with all servers installed on different hosts.
6.3.1.4 Upgrading a Topology with Replication Servers and Directory Servers on Different Hosts

To upgrade a topology with the directory servers and replication servers installed on different hosts:

  1. Change the configuration of proxy server A so that requests are not routed to directory server A.
  2. Stop directory server A.
  3. Upgrade directory server A, following the steps in Upgrading an Existing Oracle Unified Directory Server Instance.
  4. Restart directory server A.
  5. Test that your directory server is working properly before upgrading successive servers.
  6. Repeat steps 1-5 for each directory server in that replication group.
  7. Stop replication server 1.

    The replication mechanism ensures that directory servers A and B now connect to replication server 2.

  8. Upgrade replication server 1, following the steps in Upgrading an Existing Oracle Unified Directory Server Instance.
  9. Restart replication server 1.
  10. Follow steps 1-9 for each replication group in the topology.
  11. Stop proxy server A.
  12. Upgrade proxy server A, following the steps in Upgrading an Existing Oracle Unified Directory Server Instance.
  13. Restart proxy server A.
  14. Repeat steps 11-13 for the remaining proxy servers in the topology.

6.3.2 Upgrading a Topology That Does Not Include a Proxy Server

In a topology that does not include any proxy server instances, you must upgrade your client applications so that they point to an alternative directory server each time you take a directory server down for an upgrade.

The following diagram shows a replicated topology that does not include a proxy server. This topology assumes that the directory servers and replication servers are installed on the same ORACLE_HOME directory.

In this diagram, Group 1 and Group 2 refer to configured replication groups. See About Replication Groups in Administering Oracle Unified Directory.

Figure 6-3 Replicated Oracle Unified Directory Topology Without Proxy Servers

Replicated topology without a proxy server.

To upgrade a topology that does not include a proxy server:

  1. Change your client application configuration so that applications do not access directory server A directly.
  2. Stop directory server A. The replication server on this host is stopped and upgraded at the same time.
  3. Upgrade directory server A, following the steps in Upgrading an Existing Oracle Unified Directory Server Instance.
  4. Restart directory server A.
  5. Test that your directory server is working properly before upgrading successive servers.
  6. Change your client application configuration so that applications do not access directory server B directly.
  7. Stop directory server B.
  8. Upgrade directory server B, following the steps in Upgrading an Existing Oracle Unified Directory Server Instance.
  9. Follow steps 1-8 for each replication group in the topology.

6.4 Upgrading an Existing Oracle Unified Directory Server Instance

You can upgrade all Oracle Unified Directory server instances that are associated with a specific ORACLE_HOME directory.

Note:

To upgrade an existing Oracle Unified Directory server instance:

  1. Ensure that you have completed the steps described in Prerequisites for Oracle Unified Directory Upgrade.
  2. Uninstall Product Distributions.
    1. Uninstall Oracle Unified Directory.
    2. Uninstall Oracle Fusion Middleware Infrastructure.
  3. Install Oracle Unified Directory 14c (14.1.2.1.0).
    1. Download the latest Oracle Unified Directory version from the Oracle Software Delivery Cloud.
    2. Navigate to the directory where you downloaded the 14c (14.1.2.1.0) product distribution.
    3. Install Oracle Unified Directory 14c (14.1.2.1.0).
      Your Oracle Unified Directory 14c (14.1.2.1.0) installation depends on your existing 12c (12.2.1.4.0) installation. If your existing installation is a standalone configuration, then you must install Oracle Unified Directory 14c (14.1.2.1.0) in a standalone mode. Similarly, if you have installed a collocated configuration in 12c (12.2.1.4.0), then you must install Oracle Unified Directory 14c (14.1.2.1.0) in a collocated mode. See Installing Oracle Unified Directory.
  4. Before you start the OUD server, you must upgrade all files having references to old JDK location.
    1. Upgrade the JDK location in an existing Domain Home.

      You’ll likely be required to upgrade the location of JDK in the following files:

      • (UNIX) DOMAIN_HOME/bin/setNMJavaHome.sh

        (Windows) DOMAIN_HOME\bin\setNMJavaHome.cmd

      • (UNIX) DOMAIN_HOME/nodemanager/nodemanager.properties

        (Windows) DOMAIN_HOME\nodemanager\nodemanager.properties

      • (UNIX) DOMAIN_HOME/bin/setDomainEnv.sh

        (Windows) DOMAIN_HOME\bin\setDomainEnv.cmd

    2. Upgrade the JDK Location in an existing OUD Instance Home.

      You’ll likely be required to upgrade the location of JDK in the following files:

      Note:

      During the upgrade from 12c (12.2.1.4.0) to 14c (14.1.2.1.0), ensure that the JDK location is set correctly to JDK 17 Home, excluding the JRE folder location. For instance: default.java-home=<JDK 17 HOME>, which could be default.java-home=/opt/14c_installs/jdk-17.0.13.
      • (UNIX) OUD/config/java.properties

        (Windows) OUD\config\java.properties

  5. Run the following command from Oracle Unified Directory 14c ORACLE_HOME to upgrade the OUD 12c (12.2.1.4.0) server instance.
    ./upgrade-oud-instances --instancePath oud-base-location/12cPS4INSTANCE_NAME

    Note:

    The OUD 12c (12.2.1.4.0) instance path must be provided as an argument to this command.
  6. Run the --upgrade command to upgrade the OUD (12.2.1.4.0) server instance.
    • (UNIX) $ instance-dir/OUD/bin/start-ds --upgrade
    • (Windows) instance-dir\OUD\bat\start-ds.bat --upgrade

    Caution:

    If the server instance has large static groups or many total members in all static groups, upgrading the instance to 14c (14.1.2.1.0) can take some time. Therefore, avoid ending the upgrade (such as using Ctrl-C to end the process) before it is finished. Ending the upgrade early can leave the server instance in an undetermined state.

    The output of the start-ds --upgrade command is logged in the INSTANCE_PATH/logs/server.out directory.

  7. Restart the server instances that you stopped in Step 1.
    • (UNIX) $ instance-dir/OUD/bin/start-ds
    • (Windows) instance-dir\OUD\bat\start-ds.bat

    Note:

    In case the upgrade scenario is different from the one described above.

    Note that the ORACLE_HOME for 12c (12.2.1.4.0) is different from the Oracle Home for 14c (14.1.2.1.0). So if you want to retain the ORACLE_HOME directory for 12c (12.2.1.4.0), you can run the upgrade-oud-instance script from the Oracle 12c (12.2.1.4.0) home. This script upgrades the install path of each instance to point to the new Oracle 14c Home.

    (UNIX) $ Oracle12cPS4Home/oud/bin/upgrade-oud-instances --instancePath=oud-base-location/12cPS3INSTANCE_NAME

    (Windows) Oracle12cPS4Home\oud\bat\upgrade-oud-instances.bat --instancePath=oud-base-location/12cPS3INSTANCE_NAME

    • You must set the JAVA_HOME environment variable to Java 8 before executing the script.

    • The script takes the backup of the modified files (install.path, set-java-home, java.properties) in their respective directories.

    • The list of instances that are successfully upgraded is displayed in the console. However, those failed instances are available in the following logs.

      On UNIX and Linux systems:

      Main log: /tmp/preUpgradeActions-<timestamp>.log

      Instance log: instance-dir/OUD/logs/preUpgradeActions-<timestamp>.log

      On Windows systems:

      Main log: <Temp_dir>\preUpgradeActions-<timestamp>.log

      Instance log: instance-dir\OUD\logs\preUpgradeActions-<timestamp>.log

6.4.1 Enabling SCIM and Data REST APIs for an Upgraded 14.1.2.1.0 OUD Instance

You can enable the SCIM and Data REST APIs for upgraded 14.1.2.1.0 OUD instances to perform the REST API operations.

OUD exposes SCIM/Data REST interface through the HTTP and HTTPS connection handlers. You can enable these handlers either during an OUD instance set up or through dsconfig for an existing instance.

However, if during the OUD instance set up the LDAPS port is not configured, then you would not be able to set up the HTTPS port. In this scenario, you need to ensure that the configurations for cn=JKS,cn=Key Manager Providers,cn=config and cn=JKS,cn=Trust Manager Providers,cn=config are enabled, which in turn requires you to create keystore and truststore.

Enabling SCIM/Data REST for an Upgraded 14.1.2.1.0 OUD Instance with LDAPS Not Configured

While setting up the OUD instance if you have not configured the LDAPS port, then perform the following steps to enable support for SCIM/ Data REST API:

  1. Create keystore to configure cn=JKS,cn=Key Manager Providers,cn=config. See Using JKS Key Manager Provider in Administering Oracle Unified Directory.
  2. Create truststore to configure cn=JKS,cn=Trust Manager Providers,cn=config. See Using the JKS Trust Manager Provider in Administering Oracle Unified Directory.
  3. Run the following dsconfig commands to enable cn=JKS,cn=Key Manager Providers,cn=config and cn=JKS,cn=Trust Manager Providers,cn=config configurations:
    dsconfig set-key-manager-provider-prop \
    --provider-name "JKS" \
    --set enabled:true \
    --set "key-store-type:JKS" \
    --set "key-store-file:config/jks-keystore" \
    --set "key-store-pin-file:config/jks-keystore.pin” \ 
    --hostname localhost \
    --port 1444 \
    --portProtocol LDAP \
    --bindDN "cn=Directory Manager" \
    --bindPasswordFile /home/oracle/pwd.txt \
    --no-prompt
    dsconfig set-trust-manager-provider-prop \
    --provider-name "JKS" \
    --set enabled:true \
    --set "trust-store-type:JKS" \
    --set "trust-store-file:config/jks-truststore" \
    --hostname localhost \
    --port 1444 \
    --portProtocol LDAP \
    --bindDN "cn=Directory Manager" \
    --bindPasswordFile /home/oracle/pwd.txt \
    --no-prompt
  4. Run the dsconfig command-line utility with create-connection-handler subcommand as follows to create the connection handlers:

    Setting Up HTTP Port:

    dsconfig create-connection-handler \
    --handler-name "HTTP Connection Handler" \
    --type http \
    --set enabled:true \
    --set listen-port:1080 \
    --hostname localhost \
    --port 1444 \
    --portProtocol LDAP \
    --bindDN "cn=Directory Manager" \
    --bindPasswordFile /home/oracle/pwd.txt \ 
    --no-prompt

    Setting Up HTTPS Port:

    dsconfig create-connection-handler \
    --handler-name "HTTPS Connection Handler" \
    --type http \
    --set enabled:true \
    --set listen-port:1081 \
    --set use-ssl:true \
    --set trust-manager-provider:JKS \
    --set key-manager-provider:JKS \ 
    --hostname localhost \
    --port 1444 \
    --portProtocol LDAP \
    --bindDN "cn=Directory Manager" \
    --bindPasswordFile /home/oracle/pwd.txt \
    --no-prompt
  5. Configure the REST endpoints as follows:
    1. Enable the Token Generator endpoint.
      dsconfig set-end-point-prop \
      --point-name 'Token Generator' \
      --set enabled:true \ 
      --hostname localhost \
      --port 1444 \
      --portProtocol LDAP \
      --trustAll \
      --bindDN "cn=Directory Manager" \
      --bindPasswordFile /home/oracle/pwd.txt \
      --no-prompt
    2. Enable the REST Server extension.
      dsconfig set-extension-prop \
      --Extension-name 'REST Server' \
      --set enabled:true \ 
      --hostname localhost \
      --port 1444 \
      --portProtocol LDAP \
      --trustAll \
      --bindDN "cn=Directory Manager" \
      --bindPasswordFile /home/oracle/pwd.txt \
      --no-prompt
    3. Enable the directory endpoint.
      dsconfig set-directory-end-point-prop \
      --set enabled:true \ 
      --hostname localhost \
      --port 1444 \
      --portProtocol LDAP \
      --trustAll \
      --bindDN "cn=Directory Manager" \
      --bindPasswordFile /home/oracle/pwd.txt \
      --no-prompt
  6. Restart the OUD instance.

Enabling SCIM/Data REST for an Upgraded 14.1.2.1.0 OUD Instance with LDAPS Configured

While setting up the OUD instance if you have configured the LDAPS port, then run the dsconfig command-line utility to configure the connection handlers to expose the SCIM/Data REST interface.

  1. Run the dsconfig command-line utility with create-connection-handler subcommand as follows to create the connection handlers:

    Setting Up HTTP Port:

    dsconfig create-connection-handler \
    --handler-name "HTTP Connection Handler" \
    --type http \
    --set enabled:true \
    --set listen-port:1080 \ 
    --hostname localhost \
    --port 1444 \
    --portProtocol LDAP \
    --bindDN "cn=Directory Manager" \
    --bindPasswordFile /home/oracle/pwd.txt \
    --no-prompt

    Setting Up HTTPS Port:

    dsconfig create-connection-handler \
    --handler-name "HTTPS Connection Handler" \
    --type http \
    --set enabled:true \
    --set listen-port:1081 \
    --set use-ssl:true \
    --set trust-manager-provider:JKS \
    --set key-manager-provider:JKS \ 
    --hostname localhost \
    --port 1444 \
    --portProtocol LDAP \
    --bindDN "cn=Directory Manager" \
    --bindPasswordFile /home/oracle/pwd.txt \
    --no-prompt
  2. Configure the REST endpoints as follows:
    1. Enable the Token Generator endpoint.
      dsconfig set-end-point-prop \
      --point-name 'Token Generator' \
      --set enabled:true \ 
      --hostname localhost \
      --port 1444 \
      --portProtocol LDAP \
      --trustAll \
      --bindDN "cn=Directory Manager" \
      --bindPasswordFile /home/oracle/pwd.txt \
      --no-prompt
    2. Enable the REST Server extension.
      dsconfig set-extension-prop \
      --Extension-name 'REST Server' \
      --set enabled:true \ 
      --hostname localhost \
      --port 1444 \
      --portProtocol LDAP \
      --trustAll \
      --bindDN "cn=Directory Manager" \
      --bindPasswordFile /home/oracle/pwd.txt \
      --no-prompt
    3. Enable the directory endpoint.
      dsconfig set-directory-end-point-prop \
      --set enabled:true \ 
      --hostname localhost \
      --port 1444 \
      --portProtocol LDAP \
      --trustAll \
      --bindDN "cn=Directory Manager" \
      --bindPasswordFile /home/oracle/pwd.txt \
      --no-prompt
  3. Restart the OUD instance.

6.4.2 Verifying the Oracle Unified Directory Server Instance Upgrade

After completing all the upgrade steps, verify that the upgrade was successful by checking that the Oracle Unified Directory Server version has been properly upgraded.

To verify the version of the Oracle Unified Directory Server instance, run the start-ds command.

$OUD_INSTANCE_HOME/OUD/bin/start-ds -s | grep 'Oracle Unified Directory'

The following shows an example of the result after running the command:

Oracle Unified Directory 14.1.2.1.0

Verify that the upgraded version matches the latest version number for that Oracle Unified Directory Server.

6.5 Upgrading Oracle Unified Directory Services Manager

Consider these topics if you run Oracle Unified Directory Services Manager on Oracle WebLogic Server to manage Oracle Unified Directory.

Note:

If your Instance Home or Domain Home contains both OUD and OUDSM, you must review both Upgrading an Existing Oracle Unified Directory Server Instance and Upgrading Oracle Unified Directory Services Manager.

6.5.1 OUDSM Version Requirements

The version of Oracle Unified Directory Services Manager (OUDSM) described in this guide is 14c (14.1.2.1.0). When you upgrade the Oracle Unified Directory software to 14c (14.1.2.1.0), OUDSM is also upgraded to this release.

Note:

The 14c (14.1.2.1.0) OUDSM upgrade is supported only for expanded domains and not for compact domains. To determine if a domain is compact, check the following file: DOMAIN_HOME/init-info/config-groups.xml.

Locate the following tag:

<config-groups topology-profile="Compact" xmlns="http://xmlns.oracle.com/weblogic/config-groups">

If the tag specifies Compact as shown above, then you cannot upgrade the domain.

Several requirements for using OUDSM with Oracle Unified Directory include:

  • You can use OUDSM 14c (14.1.2.1.0) to manage only Oracle Unified Directory 14c (14.1.2.1.0).

  • You cannot use OUDSM 14c (14.1.2.1.0) to manage previous versions of Oracle Unified Directory, Oracle Internet Directory, or Oracle Virtual Directory. Similarly, you cannot use versions of OUDSM shipped with Oracle Internet Directory or Oracle Virtual Directory to manage any versions of Oracle Unified Directory.

Note:

After you upgrade Oracle Unified Directory, you might encounter problems while trying to access the upgraded version of OUDSM on your browser. This problem usually occurs if you used your browser to access an earlier version of OUDSM.

Therefore, to access the upgraded version of OUDSM, first clear your browser's cache and cookies.

6.5.1.1 Upgrading Multiple Instances of OUDSM

If you have multiple instances of OUDSM in your replication topology, consider the following requirements:

  • If you upgrade one OUDSM instance to 14c (14.1.2.1.0), you must upgrade all OUDSM and replicated instances.

  • If you upgrade OUDSM to 14c (14.1.2.1.0), Oracle Unified Directory must be the same version. An upgraded OUDSM version is not supported with earlier versions of Oracle Unified Directory.

6.5.2 Stopping the Administration Server

You must stop the Administration Server (the 12.2.1.4.0 WebLogic domain used for OUDSM)

To stop the Administration Server, run the stopWebLogic script from the 12.2.1.4.0 DOMAIN_HOME:

  • UNIX

    DOMAIN_HOME/bin/stopWebLogic.sh
  • Windows

    DOMAIN_HOME\bin\stopWebLogic.cmd
When prompted, enter your user name and password.

6.5.3 Creating a Complete Backup

Before you start an upgrade, back up the Oracle home (ORACLE_HOME) and the domain directory (DOMAIN_HOME) that includes the WebLogic domain used for 12.2.1.4.0 OUDSM.

To create a backup copy of the domain directory:

  1. Back up the Oracle home (ORACLE_HOME).

    Example:

    (UNIX) tar -cf oracle_home_backup_06052017.tar ORACLE_HOME/*
    (Windows) jar cMf oracle_home_backup_06052017.jar ORACLE_HOME\*
    
  2. Back up the Administration Server domain used for OUDSM.

    For example:

    UNIX

    tar -cf domain_home_backup_06052017.tar DOMAIN_HOME/*

    Windows

    jar cMf domain_home_backup_06052017.jar DOMAIN_HOME\*
  3. Verify that the backed up versions of the domain are complete.
If upgrade fails for any reason, you must copy all files and directories from the backup directory into the original domain directory to ensure that the domain is returned entirely to its original state before upgrade.

6.5.4 Uninstalling the 12c (12.2.1.4.0) Product Distributions

Uninstall the Oracle Unified Directory and Oracle Fusion Middleware Infrastructure before upgrading your existing Oracle Unified Directory Services Manager 12c (12.2.1.4.0)

This is the start of your topic.

6.5.5 Installing the 14c (14.1.2.1.0) Product Distributions

Install the collocated 14c (14.1.2.1.0) Oracle Unified Directory before upgrading your existing Oracle Unified Directory Services Manager 12c (12.2.1.4.0).

  1. Download the latest Oracle Unified Directory version from the Oracle Software Delivery Cloud.
  2. Navigate to the directory where you downloaded the 14c (14.1.2.1.0) product distribution.
  3. Install Oracle Fusion Middleware Infrastructure 14c (14.1.2.1.0).
  4. Install Oracle Unified Directory 14c (14.1.2.1.0).

6.5.6 Reconfiguring the 14c (14.1.2.1.0) Product Distributions

You must reconfigure the OUDSM 12c (12.2.1.4.0) domain before starting the Administration Server.

  1. Navigate to the Upgrade directory: <14c_ORACLE_HOME>/oracle_common/upgrade/bin
  2. Run Readiness Check: /ua -readiness
  3. Select Domain Based, so that you can verify both the schema and the configuration simultaneously.
  4. Configure the database as follows:
    • Choose Oracle as the Database Type.
    • Provide the necessary schema details to proceed with the readiness check.
  5. Invoke Upgrade Assistant (UA): <14c_ORACLE_HOME>/oracle_common/upgrade/bin/ua
  6. Select Domain Based schema upgrade.
  7. Select Oracle DB and connect using the FMW user credentials.
  8. Complete the schema upgrade by entering the required information following the on-screen prompts.
  9. Execute reconfiguration (reconfig.sh): <14c_ORACLE_HOME>/oracle_common/common/bin/reconfig.sh -log=reconfig.log

6.5.7 Starting the Administration Server

After a successful upgrade, restart all processes and servers, including the Administration Server and any Managed Servers.

To start the Administration Server, use the startWebLogic script from the 14.1.2.1.0 Domain home:

  • UNIX

    DOMAIN_HOME/bin/startWebLogic.sh
  • Windows

    DOMAIN_HOME\bin\startWebLogic.cmd
When prompted, enter your user name and password.

6.5.8 Verifying the OUDSM Upgrade

You can verify the OUDSM upgrade by accessing the OUDSM interface and checking the version number.

To verify that the OUDSM upgrade was successful, perform the following steps:

  1. Open a browser, and access OUDSM using the following URL format:

    http://host:port/oudsm

    where the host and port correspond to the Administration Server on which OUDSM is deployed. The default admin port is 7001.

  2. When the login page appears, navigate to the bottom right pane and click About.

    The About Oracle Unified Directory Services Manager page is displayed.

  3. Verify that the version number of the upgraded OUDSM version matches the latest version number.

6.6 What to Do If the Upgrade Process Fails

If any step in the upgrade process fails, then terminate the upgrade process and restore the environment to its original state using the backup files you created in Prerequisites for Oracle Unified Directory Upgrade.