8 Upgrading the Flat File Connector

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

  Post upgrade Steps

8.1 Preupgrade Steps

Preupgrade steps for the connector involves performing a reconciliation run to fetch records from the target system, defining the source connector in Oracle Identity Manager, creating copies of the connector if you want to configure it for multiple installations of the target system, and disabling all the scheduled jobs.

Perform the following preupgrade steps:

1. Perform a reconciliation run to fetch all latest updates to Oracle Identity Manager.
2. Perform the preupgrade procedure documented in Managing Connector Lifecycle in Oracle Fusion Middleware Administering Oracle Identity Manager.
3. Disable all the scheduled jobs.

8.2 Upgrade Steps

You must update the decode value for the code key Bundle Version in the Lookup.<Connector name>.Configuration (Target mode connector) and Lookup.<Connector name>.Configuration.Trusted lookup definition (Trusted mode connector) from "1.0.1115" to "12.3.0".

8.3 Post upgrade Steps

Post-upgrade steps involve uploading the new connector JAR to Oracle Identity Manager database.

1. Delete the 11g connector bundle jar -- org.identityconnectors.flatfile-1.0.1115.jar using DeleteJars utility.
2. Upload the new connector JAR (bundle/org.identityconnectors.flatfile-12.3.0.jar) to the Oracle Identity Manager database as follows:
   Run the Oracle Identity Manager Upload JARs utility to post the new connector bundle to the Oracle Identity Manager database. This utility is copied into the following location when you install Oracle Identity Manager:

   • For Microsoft Windows:

     OIM_HOME/server/bin/UploadJars.bat

   • For UNIX:

     OIM_HOME/server/bin/UploadJars.sh

   Note:

   Before you use this utility, verify that the WL_HOME environment variable is set to the directory in which Oracle WebLogic Server is installed.

   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, and the location from which the JAR file is to be uploaded. Specify 4 as the value of the JAR type.

3. Restart the Oracle Identity Manager.
4. Perform full reconciliation and delete reconciliation(if applicable).
5. If the connector is deployed on a Connector Server, then perform the following:
   1. Stop the connector server.
   2. Replace the existing bundle JAR file:
      • org.identityconnectors.flatfile-1.0.1115.jar with the new bundle JAR file org.identityconnectors.flatfile-12.3.0.jar.
   3. Start the connector server.