1. Configuring the Oracle Internet Directory Application
  2. Upgrading the Oracle Internet Directory Connector

8 Upgrading the Oracle Internet Directory Connector

If you have already deployed the 11.1.1.5.0 version of the Oracle Internet Directory connector, then you can upgrade the connector to version 12.2.1.3.0 by uploading the new connector JAR files to the Oracle Identity Manager database.

  • If you have deployed the 9.0.4.14 or earlier version of the Oracle Internet Directory connector, you must first upgrade the connector to version 11.1.1.5.0. See Upgrading the Connector in Oracle Identity Manager Connector Guide for Oracle Internet Directory.

  • Before you perform the upgrade procedure:

    • It is strongly recommended that you create a backup of the Oracle Identity Manager database. Refer to the database documentation for information about creating a backup.

    • As a best practice, perform the upgrade procedure in a test environment initially.

The following sections discuss the procedure to upgrade the connector:

See Also:

Upgrading Connectors in Oracle Fusion Middleware Administering Oracle Identity Manager for detailed information on these steps

8.1 Preupgrade Steps

Preupgrade steps involve performing a reconciliation run, defining the source connector, and disabling all the scheduled tasks.

Perform the following preupgrade steps:

  1. Perform a reconciliation run to fetch all latest updates to Oracle Identity Manager.
  2. Define the source connector (an earlier release of the connector that must be upgraded) in Oracle Identity Manager. You define the source connector to update the Deployment Manager XML file with all customization changes made to the connector.
  3. If required, create the connector XML file for a clone of the source connector.
  4. Disable all the scheduled tasks.

8.2 Upgrade Steps

This is a summary of the procedure to upgrade the connector for both staging and production environments.

Depending on the environment in which you are upgrading the connector, perform one of the following steps:

  • Staging Environment

    Perform the upgrade procedure by using the wizard mode.

    Note:

    Do not upgrade IT resource type definition. In order to retain the default setting, you must map the IT resource definition to "None".

  • Production Environment

    Perform the upgrade procedure by using the silent mode.

See Managing Connector Lifecycle in Oracle Fusion Middleware Administering Oracle Identity Manager for detailed information about the wizard and silent modes.

8.3 Postupgrade Steps

Postupgrade steps involve uploading new connector JARs, configuring the upgraded IT resource of the source connector, updating the Connector Server JARs, configuring the latest token and sync token values of the scheduled job, and deleting duplicate entries for lookup definitions.

Perform the following postupgrade steps:

  1. Upload new connector JARs as follows:
    1. Run the Upload JARs utility ($ORACLE_HOME/bin/UploadJars.sh) for uploading connector JARs.
    2. Upload bundle/org.identityconnectors.ldap-12.3.0.jar as ICFBundle.
    3. Upload OID-oim-integration.jar and TrustedUserIdTransformation.jar as JavaTask.
  2. Replicate all changes made to the Form Designer of the Design Console in a new UI form as follows:
    1. Log in to Oracle Identity System Administration.
    2. Create and activate a sandbox.
    3. Create a new UI form to view the upgraded fields.
    4. Associate the newly created UI form with the application instance of your target system. To do so, open the existing application instance for your resource, from the Form field, select the form (created in Step 2 c) and then save the application instance.
    5. Publish the sandbox.
  3. Configure the upgraded IT resource of the source connector.
  4. If you are using the Connector Server, update the Connector Server JARs as follows:
    1. Navigate to the bundles directory in your Connector Server directory, and replace the existing connector server bundle JAR with the new JAR.
    2. Restart the Connector Server.
  5. Configure the Latest Token and Sync Token values for the following scheduled jobs:
    For OID:

    • OID Connector User Search Reconciliation

    • OID Connector User Sync Reconciliation

    • OID Connector Trusted User Reconciliation

    For OUD, ODSEE, and LDAPv3-compliant directory server:

    • LDAP Connector User Search Reconciliation

    • LDAP Connector User Sync Reconciliation

    • LDAP Connector Trusted User Reconciliation

    After upgrading the connector, you can perform either full reconciliation or incremental reconciliation. This ensures that records created or modified since the last reconciliation run are fetched into Oracle Identity Manager. From the next reconciliation run onward, the reconciliation engine automatically enters a value for the Latest Token and Sync Token attributes.
  6. If any of the previous connector artifacts are retained after a successful upgrade operation, then log in to Oracle Identity Manager Design Console and delete duplicate entries for the following lookup definitions:

    • Lookup.LDAP.Configuration

    • Lookup.LDAP.Configuration.Trusted

    • Lookup.LDAP.OUD.Configuration

    • Lookup.LDAP.OUD.Configuration.Trusted

See Also: