Connector Code Files Changes

Managing Connector Lifecycle 6-39 1. Manually upload all the connector specific jars excluding common library files Common.jar, FAMILYCommon.jar, and icf-Common.jar present in the lib folder of the connector distribution bundle using UpdateJars utility available under OIM_HOMEserverbin to Oracle Identity Manager database. 2. Download common library Common.jar, FAMILYCommon.jar and icf-Common.jar from Oracle Identity Manager database using DownloadJar utility available under OIM_HOMEserverbin. 3. Extract MANIFEST.MF from the downloaded libraries. Compare this version of MANIFEST.MF with the version in MANIFEST.MF of the common libraries that is available as part of converged distribution bundle. If the distributed library version is higher than the one downloaded from Oracle Identity Manager database, then use the UploadJar utility available under OIM_HOMEserverbin to upload the common libraries to Oracle Identity Manager database.

6.8.2.4 Resource Object Changes

To update the resource bundles:

1. If there are any customization on the resource bundles such as adding new entries

to the connector resource bundles, the changes need to be applied on the resource bundles present in the resources folder of the connector distribution bundle. The existing resource bundles present in Oracle Identity Manager database can be downloaded using the DownloadResourceBundles utility available under OIM_HOMEserverbin.

2. Use DownloadResourceBundles utility available under OIM_HOMEserverbin

to delete all the resource bundles specific to the connector from Oracle Identity Manager database.

3. Use UploadResourceBundles utility available under OIM_HOMEserverbin to

upload all the resource bundles specific to the connector to Oracle Identity Manager database.

6.8.2.5 Process Form Changes

The Upgrade Connectors feature can run on a process form on which any combination of the following changes have been performed. In addition, an upgrade operation might involve any combination of the following changes to a process form. ■ Columns can be added, modified, or deleted. ■ Child forms can be added, modified, or deleted. ■ Pre-populate adapters can be added. ■ The name, mappings, order, and rule of existing pre-populate adapters can be modified. ■ The user can manually add the customizations to the active version if they wish to add certain fields to the new version that were present in the existing form. Note: ■ An upgrade operation works on only the active version of the process form. No changes are made to earlier versions. ■ The existing process form cannot be renamed. 6-40 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager ■ If the form attribute is retained and the corresponding connector objects, for example Lookup Definition and IT Resource Type Definition are removed to which this attribute has references, then you need to modify the form attribute properties by pointing it to the correct connector object. After the upgrade, the name of the process form is the version number of the upgraded connector.

6.8.2.6 Lookup Definition Changes

The Upgrade Connectors feature can run on a lookup definition on which any combination of the following changes have been made. In addition, an upgrade operation might involve any combination of the following changes to a lookup definition. ■ Lookup definitions can be added. ■ Existing lookup definitions can be retained or modified. During an upgrade operation, new entries in an existing lookup definition are appended after the existing entries.

6.8.2.7 Adapter Changes

The Upgrade Connectors feature can run on an adapter on which any combination of the following changes have been made. In addition, an upgrade operation might involve any combination of the following changes to an adapter. ■ New adapters can be added. ■ The custom adapters are retained as part of upgrade. If there are any customization on the default adapters, these changes need to be applied after upgrade as all the default adapters will be overwritten. ■ After applying the customization on the default adapters if there are any, the corresponding mapping for these adapters in Process Task, form field, and data object manager need to be verified for mapping.

6.8.2.8 Rule Changes

The Upgrade Connectors feature can run on a rule on which any combination of the following changes have been made. In addition, an upgrade operation might involve any combination of the following changes to a rule. ■ New rules can be added. ■ If there are any customizations in default Rules, these customizations need to be applied after the upgrade as all default Rules will be overwritten.

6.8.2.9 IT Resource Type Changes

The Upgrade Connectors feature can run on an IT resource type on which any combination of the following changes have been made. In addition, an upgrade Note: Existing lookup definitions are not deleted during an upgrade operation. Note: Existing adapters are not deleted during an upgrade operation.