7 Upgrading the SAP SuccessFactors Connector

If you have already deployed the 11.1.1.5.0 version of the SAP SuccessFactors 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:

• 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:

• Upgrade Steps

• Postupgrade Steps

See Also:

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

7.1 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.

7.2 Postupgrade Steps

Upgrade steps involve uploading new connector JAR to the Oracle Identity Manager database.

Perform the following procedure:

1. If the connector is deployed on a Connector Server, then:

   1. Stop the connector server.

   2. Replace the existing jar org.identityconnectors.successfactors-1.0.11150.jar with org.identityconnectors.successfactors-12.3.0.jar.

      Note:

      Replace the existing bundle with new bundle in the Connector Server and also in the database bundle folder of Oracle Identity Manager.

   3. Start the connector server.

2. If the connector is not deployed on a Connector Server, then:

   1. Run the Oracle Identity Manager Delete JARs utility to delete the existing ICF bundle org.identityconnectors.successfactors-1.0.11150.jar from the Oracle Identity Manager database.

      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. Run the Oracle Identity Manager Upload JARs utility to post the ICF bundle org.identityconnectors.successfactors-12.3.0.jar. file to the Oracle Identity Manager database.

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

   Note:

   After completing the connector upgrade steps, ensure to delete the following Code Key and Decode entries in Lookup.SuccessFactors.Configuration and Lookup.SuccessFactors.Configuration.Trusted lookup definitions:

   • Code Key: Bundle Version

   • Decode: 1.0.1115

   Additionally, after completing the artifact level upgrade steps, ensure that you delete any attribute which reflects previous version of the connector from both target and trusted lookup configuration tables.

3. Restart Oracle Identity Manager.

   See Also:

   If you have configured the connector for multiple versions of target system, then refer to Configuring the Connector for Multiple Installations of the Target System for more information