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

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. Managing Connector Lifecycle 6-57 Figure 6–41 The Select Connector XML to Upgrade Page

7. Click Continue.

8. On the Step 12: Preupgrade Steps page, click Continue to proceed.

Figure 6–42 shows the Preupgrade Steps page of the Connector Management - Upgrading wizard: Figure 6–42 The Preupgrade Steps Page 9. On the Step 13: Select the Connector Objects to be Upgraded page, review the summary of the connector objects that you selected for upgrade. Figure 6–43 shows the Select the Connector Objects to be Upgraded page of the Connector Management - Upgrading wizard: 6-58 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager Figure 6–43 The Select the Connector Objects to be Upgraded Page

10. After you review the information on the page, click Upgrade to start the upgrade

process. The Connector Upgrade Status page shows the status at the end of a successful upgrade, as shown in Figure 6–44 : Figure 6–44 The Connector Upgrade Status Page

6.8.5.3 Postupgrade Procedure

The following sections describe procedures that you must perform after the upgrade operation: ■ Running the PurgeCache Utility ■ Running cancelProcessTask Utility ■ Running the FVC Utility Managing Connector Lifecycle 6-59 ■ Updating Access Policies ■ Updating Approval Policies ■ Configuring the IT Resource ■ Configuring the Scheduled Tasks ■ Other Postupgrade Steps Running the PurgeCache Utility When the upgrade is performed, there might be stale data in the cache, which is required to be purged. The PurgeCache utility purges the cache. See Purging the Cache on page 26-3 for information about purging the cache. Running cancelProcessTask Utility This utility is used for canceling the pending and rejected instances of a process task. If a process task of a process definition, which is there in the source connector and is not required in the target, then the process task will be soft deleted in the upgrade process. Oracle Identity Manager will not use such soft deleted task as part of provisioning work flow after upgrade. All the instances of such deleted process task, which are in pending and rejected status need to be canceled. The utility is available in OIM_HOMEserverbin. This utility will take the process task name and the corresponding process definition name as input. Running the FVC Utility Connector upgrade process creates the new process form versions. The account data created using the source connector will have an association with the source connector process form version. Therefore, after the upgrade, you need to run the FVC utility to update the new process form version which is created in upgrade process. Apart from this, FVC provides the feature to copy the old form field data to the new form fields. You can use the FVC Utility to copy process form data from the source release to the process form of the target release. You can also specify changes to be made to the resource data so that it is consistent with changes made in the process form of the target release. See Oracle Identity Manager Tools Reference for information about using this utility. Updating Access Policies In Oracle Identity Manager, an access policy is associated with a resource object. While creating an access policy, user would have provided the data for the process form attributes. As the part of connector upgrade, if there are changes in the form attributes, then you need to edit the access policy to check the data for the existing and the new fields. For example, if the connector upgrade adds a new process form attribute, you can provide the data for the new attribute by editing the access policy. Updating Approval Policies In Oracle Identity Manager, an approval policy is associated with a resource object. While creating a policy, user would have provided the data for the process form attributes. As the part of connector upgrade, If there are any change in the resource object names, then the user need to verify all the Approval Policies associated with the resources to modify the resource name to the new resource name. Configuring the IT Resource Verify that the IT resource instances have proper values after upgrade. 6-60 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager Configuring the Scheduled Tasks Set values for attributes of the scheduled tasks of the target release. For an Oracle-released target connector, see the connector guide for information about the scheduled task attributes. Update Adapters for Changes in IT Resource Type Definition Parameter If there are changes in the IT Resource Type Definition Parameter names, you need to update the custom adapters for the parameter changes. To do so: 1. Log in to Design Console. 2. Open the custom adapter using the adapter factory. 3. Go to the variable list and check if there are any variables of type IT Resource, as shown in Figure 6–45 : Figure 6–45 The Variable List Tab of the Adapter Factory Form 4. If there is a variable of IT Resource, then go to the task details and change the mapping of the IT Resource parameter mapping to the new target field if the parameter is changeddeleted. Figure 6–46 shows the Edit Adapter Factory Task Parameters dialog box that enables you to change the mapping of the IT Resource parameter mapping to the new target field: Managing Connector Lifecycle 6-61 Figure 6–46 The Edit Adapter Factory Task Parameters Dialog Box 5. If the adapter is mapped to the IT Resource Type Definition parameter, then you need to verify if the mapped parameter is not deleted. If the parameter is deleted, then you need to remap it to the correct parameter. To verify the adapter mappings: a. Verify the mapping for process task adapter as follows: i Log in to Design Console. ii Go to Process Definition. iii Click the task, and then click the Integration tab, as shown in Figure 6–47 : 6-62 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager Figure 6–47 The Integration Tab of the Editing Task Dialog Box iv Check if the adapter variable is mapped to the deletedmodified form attribute. If yes, remap such attributes to adapter variables. Repeat this step for all process tasks of all process definitions of the connector. Figure 6–48 shows the Editing Data Mapping for Variable dialog box that enables you to view and edit the adapter variable mapping to the form attribute: Figure 6–48 The Editing Data Mapping for Variable Dialog Box

b. Prepopulate adapter mappings as follows:

i Log in to Design Console. ii Go to Form Designer, Pre-Populate Adapters, as shown in Figure 6–49 : Managing Connector Lifecycle 6-63 Figure 6–49 The Pre-Populate Adapters Dialog Box iii Click Map to map adapter variable and check if any of the fields are mapped to the process data attributes. If it is mapped, then verify the process form attribute is not deleted as part of upgrade. If the process form attributes are deleted, then remap them to the correct form attribute data. Figure 6–50 shows the Map Adapter Variable dialog box: Figure 6–50 The Map Adapter Variable Dialog Box Other Postupgrade Steps Perform the following postupgrade steps:

1. Change form names and form field column name references in the following

objects: Note: Repeat the procedure for all the prepopulated fields of all the process forms of the connector. If there are any entity adapter, then check the adapter variables mapping for these adapters in Data Object Manager. Note: For an Oracle-released connector, see the connector guide for information about the changes to be made.