Replicating Between Oracle Directory Server Enterprise Edition and Oracle Unified Directory

Oracle Unified Directory 11g Release 1 (11.1.1) provides a mechanism to replicate data between Oracle Directory Server Enterprise Edition and Oracle Unified Directory. The main purpose of this replication gateway is to enable migration from Oracle Directory Server Enterprise Edition to Oracle Unified Directory.

For a comprehensive overview of the replication gateway and its use in a topology that includes both Oracle Directory Server Enterprise Edition and Oracle Unified Directory servers, see Chapter 4, Overview of the Replication Gateway, in Oracle Fusion Middleware Deployment Planning Guide for Oracle Unified Directory.

Setting up replication between these two disparate topologies involves three steps:

• Migrating the Oracle Directory Server Enterprise Edition schema and configuration to the Oracle Unified Directory server.

• Initializing the Oracle Unified Directory server with the data from the Oracle Directory Server Enterprise Edition server.

• Configuring replication between the Oracle Directory Server Enterprise Edition server and the Oracle Unified Directory server.

The following procedures describe each step. These procedure assume that you have the following:

• An installed and running Oracle Directory Server Enterprise Edition server.

  The Oracle Unified Directory replication gateway supports the DS6–mode password policy only. If your Oracle Directory Server Enterprise Edition instance is using a DS5–mode password policy, you must upgrade it.

• An installed and running Oracle Unified Directory directory server.

  The Oracle Unified Directory server must be configured without any suffixes.

To Migrate the Oracle Directory Server Enterprise Edition Schema and Configuration

Before You Begin

This procedure describes various options of the ds2oud command. You can run the ds2oud command completely interactively by just typing ds2oud on the command line. In interactive mode, the command prompts you for the required responses. For more information about the ds2oud command, see ds2oud in Oracle Fusion Middleware Command-Line Usage Guide for Oracle Unified Directory.

1. On the Oracle Unified Directory directory server, run the ds2oud --diagnose command, providing the connection details of the Oracle Directory Server Enterprise Edition server.

   This command assesses the Oracle Directory Server Enterprise Edition server instance and informs you whether any of the server configuration must be migrated to the Oracle Unified Directory server.

   $ ds2oud --diagnose -D "cn=directory manager" -j pwdfile -h host1.example.com -p 1389

2. Run the ds2oud command with one or more of the migration options to migrate the schema, the server configuration, or both.

   To migrate the schema and the configuration parameters:

   $ ds2oud --migrateAll \
     -D "cn=directory manager" -j pwdfile -h host1.example.com -p 1389 \
     --oudBindDN "cn=directory manager" --oudBindPasswordFile pwdfile \
     --oudHostname localhost --oudAdminPort 4444 --oudPort 1389

   You are prompted for additional information relating to the Oracle Unified Directory configuration. This command creates a compatible configuration on the Oracle Unified Directory directory server.

To Initialize the Oracle Unified Directory with Oracle Directory Server Enterprise Edition Data

1. On the Oracle Directory Server Enterprise Edition server, run the following command to export the data set:

   $ dsadm export -f opends-export dsee-instance-path baseDN exportedLDIFPath

   where exportedLDIFPath is the path of the resulting LDIF file that contains the replicated data.

2. On the Oracle Unified Directory server, prepare the server to be initialized. For example:

   $ dsreplication pre-external-initialization -h localhost -p 4444 --adminUID admin \
     --adminPassword password -baseDN dc=example,dc=com -X -n --noPropertiesFile

3. Copy the LDIF file that was generated in step 1 to a directory that is accessible by the Oracle Unified Directory servers.
4. On the Oracle Unified Directory server, import the LDIF data, as follows:

   $ import-ldif -h localhost -p 4444 \
     -D "cn=admin,cn=Administrators,cn=admin data" -w password \
     --includeBranch dc=example,dc=com --ldifFile exportedLDIFPath \
     --clearBackend --trustAll --noPropertiesFile

5. On the Oracle Unified Directory server, run the post–initialization script, for example:

   $ dsreplication post-external-initialization -h localhost -p 4444 --adminUID admin \
     --adminPassword password --baseDN dc=example,dc=com -X -n --noPropertiesFile

To Configure Replication Between Oracle Directory Server Enterprise Edition and Oracle Unified Directory

1. Install and configure the replication gateway, as described in Chapter 5, Setting Up the Replication Gateway, in Oracle Fusion Middleware Installation Guide for Oracle Unified Directory.
2. To test that replication is working correctly, modify at least one entry on each Oracle Directory Server Enterprise Edition server and check the modification on the Oracle Unified Directory server.