8 Upgrading the Oracle E-Business Suite HRMS Connectors

If you have already deployed the 11.1.1.5.0 version of this connector, then you can upgrade the connector to the current version 12.2.1.3.0.

Note:

• The connector upgrade from version 11.1.1.5.0 to 12.2.1.3.0 is only supported in the CI-based mode.

• Before you perform the upgrade, 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, first perform the upgrade procedure in a test environment.

• Preupgrade Steps

• Upgrade Steps

• Postupgrade Steps

8.1 Preupgrade Steps

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

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. See Managing Connector Lifecycle in Oracle Fusion Middleware Administering Oracle Identity Governance for more information.
3. If required, create the connector XML file for a clone of the source connector.
4. Disable all the scheduled jobs by stopping the scheduler service.

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.

• Production Environment

  Perform the upgrade procedure by using the silent mode.

See Managing Connector Lifecycle in Oracle Fusion Middleware Administering Oracle Identity Governance 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, and restarting Oracle Identity Manager.

1. Download the latest version of this connector from Oracle Technology Network and extract its contents to any directory on the computer hosting Oracle Identity Manager.
2. Run the Upload JARs utility to post the latest version of the connector bundle JAR file (org.identityconnectors.ebs-12.3.0.jar) from the /bundle directory of the installation media to the Oracle Identity Manager database.

   For Microsoft Windows:

   OIM_HOME/server/bin/UploadJars.bat

   For UNIX:

   OIM_HOME/server/bin/UploadJars.sh

   When you run the utility, you are prompted to enter the login credentials of the Oracle Identity Manager administrator, URL of the Oracle Identity Manager host computer, context factory value, type of JAR file being uploaded (specify the JAR type as ICFBundle, option 4), and the location from which the JAR file is to be uploaded.

3. Configure the upgraded IT resource of the source connector.
4. Restart Oracle Identity Manager. Alternatively, you can purge the cache for the changes to reflect in Oracle Identity Manager. See Purging Cache in Oracle Fusion Middleware Administering Oracle Identity Governance for more information about the PurgeCache utility.

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 (the one that you performed in Preupgrade Steps) are fetched into Oracle Identity Manager. From the next reconciliation run onward, the reconciliation engine automatically enters a value for the Latest Token attribute.

Before you perform lookup field synchronization, ensure to remove all preupgrade entries from the lookup definitions Oracle Identity Manager. After upgrade these values must be synchronized with the lookup fields in the target system.