6 Updating the Oracle Unified Directory Software to 11g Release 2 PS1 (11.1.2.1)

This chapter covers a broad strategy for updating your directory service to the latest version, without service interruption, as well as the steps for updating an individual server instance.

The chapter covers the following topics:

6.1 What's New in Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1)

For more information, see "What's New in Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1)" in the Oracle Fusion Middleware Administrator's Guide for Oracle Unified Directory.

6.2 Starting Points for Oracle Unified Directory Update

The follows starting points are supported:

  • Oracle Unified Directory 11g Release 1 (11.1.1.5)

  • Oracle Unified Directory 11g Release 2 (11.1.2.0)

Note:

Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1) dsconfig and gicadm commands are not interoperable with Oracle Unified Directory 11g Release 1 (11.1.1.5) and Oracle Unified Directory 11g Release 2 (11.1.2.0).

6.3 Special Instructions for Updating to Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1)

The following components are not updated to the Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1) environment:

  • Global Index Catalogs configured using gicadm: You cannot update earlier versions of global index catalogs configuration. After updating to Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1), you must reconfigure global index catalogs using gicadm as described in the section "Configuring Global Index Catalogs by Using gicadm" in the Oracle Fusion Middleware Administrator's Guide for Oracle Unified Directory.

  • Oracle Directory Services Manager: You cannot update earlier versions of Oracle Directory Services Manager to Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1). You must update Oracle Directory Services Manager as described in Section 6.6, "Updating Oracle Directory Services Manager".

6.4 Updating a Directory Service Without Service Interruption

Updating a replicated Oracle Unified Directory topology involves updating the software for each server instance individually. Usually, however, you should be able to update an entire topology without any interruption in service. Because a particular server instance must be stopped during the update process, maintaining service during an update necessitates that you have alternative servers that can handle client requests while a particular server is down.

The strategy for maintaining service during an update depends on the specifics of your deployment.

If your deployment includes one or more proxy server instances that route client requests to the backend servers, you can safely take down one directory server at a time, and update that server instance. The proxy server will take care of rerouting 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 updated.

The following sections outline the steps to follow in each of the scenarios described previously:

6.4.1 Upgrading in a Topology That Includes a Proxy Server

The following diagrams show two replicated topologies that include replicated proxy servers. This section covers two scenarios:

  • The first topology assumes that the directory servers and replication servers (RS) are installed on the same host.

  • The second topology assumes that the directory servers and replication servers are installed on separate hosts.

Group 1 and Group 2 in these diagrams refer to configured replication groups. For more information, see "Replication Groups" in the Administration Guide for Oracle Unified Directory.

6.4.1.1 Replication Server and Directory Server 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 updated at the same time.

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

Topology with proxy servers - RS and DS on same hosts.

The update strategy in this topology would be as follows:

  1. Change the configuration of proxy server A so that no requests are routed to directory server A.

  2. Stop directory server A. The replication server running on this host is stopped at the same time.

  3. Update directory server A, following the steps in Section 6.5, "Updating an Existing Oracle Unified Directory Instance".

  4. Restart directory server A.

  5. Test that your directory service 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. Update proxy server A, following the steps in Section 6.5, "Updating an Existing Oracle Unified Directory Instance".

  10. Restart proxy server A.

  11. Repeat steps 8-10 for the remaining proxy servers in the topology.

6.4.1.2 Replication Server and Directory Server on Separate Hosts

If the replication server and the directory server are installed on separate hosts, the servers are stopped and updated in the sequence described here.

Figure 6-2 Replicated Topology With Proxy Servers - RS and DS on Separate Hosts

Surrounding text describes Figure 6-2 .

The update strategy in this topology would be as follows:

  1. Change the configuration of proxy server A so that no requests are routed to directory server A.

  2. Stop directory server A.

  3. Update directory server A, following the steps in Section 6.5, "Updating an Existing Oracle Unified Directory Instance".

  4. Restart directory server A.

  5. Test that your directory service 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. Update replication server 1, following the steps in Section 6.5, "Updating an Existing Oracle Unified Directory Instance".

  9. Restart replication server 1.

  10. Follow steps 1-9 for each replication group in the topology.

  11. Stop proxy server A.

  12. Update proxy server A, following the steps in Section 6.5, "Updating an Existing Oracle Unified Directory Instance".

  13. Restart proxy server A.

  14. Repeat steps 11-13 for the remaining proxy servers in the topology.

6.4.2 Upgrading in a Topology That Does Not Include a Proxy Server

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

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.

Group 1 and Group 2 in this diagram refer to configured replication groups. For more information, see "Replication Groups in the Administration Guide for Oracle Unified Directory.

Figure 6-3 Replicated Topology Without Proxy Servers

Surrounding text describes Figure 6-3 .

The update strategy in this topology would be as follows:

  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 updated at the same time.

  3. Update directory server A, following the steps in Section 6.5, "Updating an Existing Oracle Unified Directory Instance".

  4. Restart directory server A.

  5. Test that your directory service 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. Update directory server B, following the steps in Section 6.5, "Updating an Existing Oracle Unified Directory Instance".

  9. Follow steps 1-8 for each replication group in the topology.

6.5 Updating an Existing Oracle Unified Directory Instance

You can update all Oracle Unified Directory server instances that are associated with a specific ORACLE_HOME directory by installing the updated software version over the existing ORACLE_HOME.

To update an existing Oracle Unified Directory installation, follow these steps:

  1. Download the latest Oracle Unified Directory version from OTN or Oracle Software Delivery Cloud.

    For more information, see Section 2.1, "Obtaining the Software".

  2. Stop any Oracle Unified Directory server instances that are associated with the ORACLE_HOME directory that you are upgrading.

    Unix

    $ instance-dir/OUD/bin/stop-ds

    Windows

    instance-dir\OUD\bat\stop-ds.bat

    Servers in the topology that are associated with a different ORACLE_HOME will not be updated and do not need to be stopped.

  3. Follow the steps outlined in Section 2.2, "Installing Oracle Unified Directory".

    Where you are required to specify an installation location, enter the same OUD Base Location Home and Oracle Home Directory (ORACLE_HOME) that you specified for the original installation.

    For more information about these directories, see Section 1.4, "Understanding the Installation Directories".

    The installer recognizes an existing installation and updates the relevant binary files. Do not recreate the server instances.

  4. For Microsoft Windows, you must manually copy the start-ds.bat file (located at INSTALL_DIR\bat\start-ds.bat) and replace the start-ds.bat file of the instances that needs to be upgraded.

  5. Upgrade any Oracle Unified Directory server instances that are associated with the ORACLE_HOME directory:

    Unix

    $ instance-dir/OUD/bin/start-ds --upgrade

    Windows

    instance-dir\OUD\bat\start-ds.bat --upgrade

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

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

6.6 Updating Oracle Directory Services Manager

When you update the Oracle Unified Directory software, the Oracle Directory Services Manager (ODSM) binaries are also updated to version 11.1.2.1.

ODSM 11.1.2.1 is compatible with Oracle WebLogic Server 10.3.5 or 10.3.6, and with the Oracle Application Development Framework 11.1.1.6.

Note:

You must restart the Oracle WebLogic Server after updating the Oracle Unified Directory software.

Upgrading your Oracle WebLogic Server installation is optional. To update Oracle WebLogic Server from 10.3.5 to 10.3.6, download the WebLogic Server 10.3.6 update installer and follow the steps in Section 2.3.1.1, "Installing Oracle WebLogic Server". You must stop all WebLogic domains before upgrading the WebLogic software. For more information, see the Upgrade Guide for Oracle WebLogic Server.

You must update your Oracle Application Development Framework to 11.1.1.6 for ODSM 11.1.2.1 to function correctly. To update Oracle Application Development Framework, from 11.1.1.5 to 11.1.1.6, download Oracle Application Development Framework and follow the steps in the Oracle Fusion Middleware Installation Guide for Application Developer. Note that, even if you have not upgraded the WebLogic software, you must stop the WebLogic domains before you upgrade the Application Development Framework. For more information about upgrading the Oracle Application Development Framework, see the Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF.