7 Upgrading the Google Apps Connector

If you have already deployed the 11.1.1.7.0 version of the Google Apps 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.

Note:

• If you have deployed the 11.1.1.6.0 or earlier version of the Google Apps connector, you must first upgrade the connector to version 11.1.1.7.0. See Upgrading the Connector in Oracle Identity Manager Connector Guide for Google Apps.

• Before you perform the upgrade procedure:

  • It is strongly recommended that you create a backup of the Oracle Identity Manager database and the connector JARs before you perform an upgrade operation. Refer to the database documentation for information about creating a backup.

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

1. Delete the existing ICF Bundle org.identityconnectors.googleapps-1.2.1.jar from the Oracle Identity Manager database using the Delete JARs utility using option-4 which is the designated option for the ICF bundle.

   When you run the Delete JARs 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 deleted, and the name of the JAR file to be removed. Specify 4 as the value of the JAR type.

2. Copy the latest ICF Bundle org.identityconnectors.googleapps-12.3.0.jar from the connector installation media to a local temporary folder.
3. Create a lib folder in the local temporary folder and copy all the Google Apps third-party JARs to the lib folder.
4. Perform the JAR file update on the ICF Bundle org.identityconnectors.googleapps-12.3.0.jar using the same "lib" folder.
   For example, jar uvf org.identityconnectors.googleapps-12.3.0.jar lib
5. Run the Oracle Identity Manager Upload JARs utility to post the latest ICF bundle org.identityconnectors.googleapps-12.3.0.jar file to the Oracle Identity Manager database.

   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.

6. Run the Connector Upgrade utility as described in Upgrading Connectors of Oracle Fusion Middleware Administering Oracle Identity Governance.
7. After upgrading the connector, in the Lookup.Configuration.GoogleApps lookup definition, a duplicate entry is created for the Bundle Version entry. Log in to Oracle Identity Manager Design Console and remove the Bundle Version entry corresponding to the old connector bundle.

See Also:

Downloading the Third-Party Libraries and Copying the Third-Party Libraries for details on the third-party JAR files that you need to copy