Upgrade Procedure Procedure to Upgrade a Connector

6-44 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager Wizard Mode Upgrade in Staging Environment To perform the wizard mode upgrade on the staging server: 1. Create a backup of the Oracle Identity Manager database. 2. Create Oracle Identity Manager metadata MDS backup. See MDS Utilities and User Modifiable Metadata Files in the Oracle Fusion Middleware Developers Guide for Oracle Identity Manager for information about the utilities that you can use to modify Oracle Identity Manager metadata. 3. Run the connector preupgrade utility. A validation script is provided with Oracle Identity Manager. This script performs the following functions: ■ Determines whether the connector that you want to upgrade has been defined in Oracle Identity Manager In other words, the script checks whether the connector XML stored in the database when the connector was installeddefined is consistent with the connector object definitions in the database. Apart from checking the consistency of the connector XML, it also checks whether the Connector XML is present in Oracle Identity Manager Database or not. If it is not present, then it displays the corresponding message to define the connector before proceeding with upgrade. Refer the Defining Connectors on page 6-11 to perform the procedure to define a connector. ■ Identifies the Oracle Identity Manager scheduled tasks that are currently running. You must disable all scheduled tasks that belong to the source connector before you proceed with the upgrade procedure. In addition, it is recommended to disable all other scheduled tasks before proceeding with the upgrade procedure. ■ Identifies the Attestation tasks associated with the resource object of the connector. You must complete all the attestation tasks that belong to the source connector before you proceed with the upgrade procedure. ■ Identifies all the pending requests associated with the resource objects of the connectors. You must either close or complete all the pending requests that belong to the source connector before you proceed with the upgrade procedure. To run the validation script: a. Ensure that Oracle Identity Manager is running. b. In a command window, change to the OIM_HOMEserverbin directory. c. Run the script as follows: For Unix: sh ConnectorPreUpgradeUtil.sh Note: You need to perform preupgrade and post upgrade steps while performing wizard mode upgrade. Managing Connector Lifecycle 6-45 For Windows: ConnectorPreUpgradeUtil.bat You will be prompted to provide the following details: – Enter Oracle Identity Manager administrators username: Enter the Oracle Identity Manger administrators username. – Enter Oracle Identity Manager administrators password: Enter the Oracle Identity Manger administrators password. – Enter t3 Oracle Identity Manager Server URL: Enter the Oracle Identity Manger server URL. For example, t3:hostname:hostport. – Enter OIM Database username: Enter the Oracle Identity Manager Databases username. – Enter OIM Database Password: Enter the password of the Oracle Identity Manager Database. – Enter the JDBC URL for the OIM Database: Enter the JDBC URL of the Oracle Identity Manager Database. For Example: jdbc:oracle:thin:HOST_NAME:DB_PORT:iamORACLE_SID After the successful login, you will be prompted to provide the following details: – Enter the connector name: Enter the connector name to be validated before upgrade. – Enter the connector version: Enter the connector version to be validated before upgrade. On successfully connecting to the Oracle Identity Manager database, a message is displayed. The output generated by the script is displayed in the command window and is also recorded in the OIM_HOMEserverbinvalidateUtil.log file. The action that you must take depends on the message generated by the script: ■ If the message states that the connector XML in the database is not consistent with the connector objects defined in the database, then perform the procedure described in the Defining Connectors on page 6-11 of the connector guide. ■ If the message states that the connector XML does not exists in Oracle Identity Manager database. Define a connector before upgrade., then perform the procedure described in the Defining Connectors on page 6-11 section of the connector guide before proceeding with upgrade ■ If the message contains the names of the scheduled tasks that are currently running, then you must disable all scheduled tasks. To disable a scheduled task, in the Advanced Administration, click System Management, search for scheduled jobs, and click the specific scheduled job, and then click Stop. ■ If the message contains the names of the Attestation Processes of which some attestation tasks associated with the resource object of the connector is pending, then you must complete all the attestation tasks belonging to the connector that you are upgrading before proceeding with the upgrade process. 6-46 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager ■ If the message contains the names of the pending requests associated with the resource object of the connector, then you must either close or complete all the pending requests belonging to the connector that you are upgrading before proceeding with the upgrade process. 4. Copy the JARs and the resource bundles to the specified directories. If the target release also contains new or updated JARs and resource bundles, then download the version of the jar to Oracle Identity Manager, check the version of the jar which is shipped with Oracle Identity Manager, compare these files and copy the JARs manually to their destination directories. For an Oracle-shipped connector, details of the destination directories are given in the connector guide. See the Connector Code Files Changes on page 6-38 for more information. 5. Use the Upgrade Connectors feature. a. Log in to the Oracle Identity Manager Advanced Administrative Console.

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

Manage Connector . c. Use the Search feature to search for the source connector that you want to upgrade. In the table of search results, click the Upgrade icon for the source connector. d. 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 Wizard mode upgrade XML field. You can use the Browse option to navigate to the XML file. Make sure that you select the correct target connector XML. Upgrade feature does not validate the XML for target version or for any other connector object details. Figure 6–29 shows the Select Connector XML to Upgrade page of the Connector Management - Upgrading wizard: 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-47 Figure 6–29 The Select Connector XML to Upgrade Page e. Click Continue. f. On the Step 2: Resource Object Mapping page, apply the following guidelines to map each new resource object with an existing resource object. Click Continue after you create each mapping. – The New Resource Object field shows the name of a resource object in the target release. From the Existing Resource Object list, select the resource object in the source release to which you want to map the resource object in the target release. There might be a change in resource object names. It is your responsibility to map the resource object properly. – If there are new resource objects that do not have a corresponding resource object in the source release, then select None from the Existing Resource Object list. This will happen only when the target connector versions add new resource objects that are not there in the source version. Figure 6–30 shows the Resource Object Mapping page of the Connector Management - Upgrading wizard: Note: If you are upgrading from an Oracle-released source connector to an Oracle-released target connector, then see the connector guide for information about the mappings that you must create.