On the Step 9: IT Resource Type Definition Mapping Summary page, a

Managing Connector Lifecycle 6-53 Figure 6–38 The Preupgrade Steps Page p. On the Step 13: Select Connector Objects to Be Upgraded page. Figure 6–39 shows the Select Connector Objects to Be Upgraded page of the Connector Management - Upgrading wizard: Figure 6–39 The Select Connector Objects to Be Upgraded Page Note: If the Connector Management - Upgrading wizard is opened by using Microsoft Internet Explorer, then all the fields and buttons on the Step 13: Select Connector Objects to Be Upgraded page might not be visible. There is no scroll bar available in the page. Therefore, maximize the window to display all the controls in the page. 6-54 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager q. After you review the information on the Connector Upgrade Status page, click Upgrade to start the upgrade process. Figure 6–40 shows the Connector Upgrade Status page of the Connector Management - Upgrading wizard: Figure 6–40 The Connector Upgrade Status Page Note down the process definition names and the corresponding process task names. These process tasks are not going to be used by Oracle Identity Manager anymore. Therefore, all their pending and rejected instances need to be canceled. Use cancelProcessTask utility available in OIM_HOMEserverbin. The utility takes the process definition name and the process task name as input. You need to run the utility for each process task. The Upgrade Connectors feature processes connector object mappings in the following manner: ■ If a new connector object is mapped to None, then the new connector object is inserted in the database. ■ A new resource object, process definition, or form replaces the old resource object, process definition, or form to which it is mapped. ■ The new names of the process form are converted into the old process form names. ■ If an old and a new lookup definition have the same name, then their contents are merged. ■ When the Upgrade Connectors feature tries to delete an object, which is not going to be used by upgraded version of connector, an exception is thrown if the instances of the object exists in Oracle Identity Manager database. Such an object is renamed and soft deleted so that it will not be used anymore by Oracle Identity Manager. 6. Perform the following steps: a. Change form names and form field column name references in the following objects: Managing Connector Lifecycle 6-55 – Lookup definitions – Process task literals – Adapter literals b. All the default adapters are overwritten. Therefore, if customer has done any customization, the changes need to be applied after connector upgrade. c. After the upgrade, contents of existing and new lookup definitions are merged. In these lookup definitions, you must manually delete entries that are not required. 7. Use the FVC Utility to update existing user data created through the connector. See Using the Form Version Control Utility in the Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager for information about using the FVC Utility. 8. Verify that all use cases specific to the target are working fine including provisioning and reconciliation. 9. Generate the XML file. This XML file contains details of the object definition changes from the source release to the target release. To generate this file: a. Log in to the Oracle Identity Manager Advance Administrative Console.

b. On the left pane, expand System Management, Deployment Manager and

then click Manage Connector. c. Use the Search feature to search for the connector. d. In the search results table, click the Export Silent Upgrade XML icon for the connector. e. Specify the location where you want the file to be saved. Silent Mode Upgrade in Staging and Production Environment Note: For an Oracle-released connector, see the connector guide for information about the changes to be made. Note: If the upgrade fails, then perform the following steps: 1. Look at the exception and take suitable action. 2. Restore the Oracle Identity Manager database and MDS. 3. Proceed for the upgrade. Note: You need to perform preupgrade and post upgrade steps while performing wizard mode upgrade. 6-56 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager To perform the silent mode upgrade on the production server: 1. Copy the XML file to the host computer of the Oracle Identity Manager installation on which you want to import the file. Alternatively, copy the XML file to a shared folder on another computer that can be accessed from the Oracle Identity Manager host computer. 2. Log in to the Oracle Identity Manager Advanced Administrative Console.

3. On the left pane, expand System Management , Deployment Manger, and then

click Manage Connector. 4. Use the Search feature to search for the source connector that you want to upgrade. 5. In the table of search results, click the Upgrade icon for the source connector. 6. On the Step 1: Select Connector XML to Upgrade page of the utility, enter the full path and name of the connector XML file for the source release in the Silent mode upgrade XML field. You can use the Browse option to navigate to the XML file. Figure 6–41 shows the Select Connector XML to Upgrade page of the Connector Management - Upgrading wizard: Caution: Before you import the XML file, verify that the source connector on the production server is the same as the source connector on the staging server. If there are differences in the source connector on the staging server and the production server, then the XML file is not correctly imported on the production server. Note: There will be only one XML file for both trusted source reconciliation and target resource reconciliation for all the converged connectors. If you have more than one XML file, that is one for trusted source reconciliation and another for target resource reconciliation, you need to select the XML file for target resource reconciliation. Refer the connector guide CI-XML for the XML file name.