Event Handlers Upgrade Overview

Upgrading Oracle Identity Manager Environment 13-9 ■ All credentials are moved to the CSF Store. ■ Vacation rules for each Oracle Identity Manager 9.1 proxy user is automatically created. ■ Custom jars Located at OIM_HOMEJavaTasks, OIM_HOMEScheduleTask, and OIM_HOMEThirdParty and custom resource bundles stored in the file system folder in Oracle Identity Manager 9.1 are move to Oracle Identity Manager 11g schema. ■ The ALL USERS role cannot be assigned to the XELSYSADM user. Oracle recommends that you do not have resources or entitlements in target applications granted due to the ALL USERS role.

13.2 Prerequisites

You must complete the following prerequisites before upgrading to the Oracle Identity Manager 11g environment: ■ Backing Up the Oracle Identity Manager 9.1 Database ■ Running Pending Transaction Report Utility ■ Running OSI Data Upgrade Utility ■ Running Schedule Task to Process the Audit Messages ■ Emptying JMS queues ■ Circular Dependencies for Approval Workflow

13.2.1 Backing Up the Oracle Identity Manager 9.1 Database

Ensure that you back up your existing Oracle Identity Manager database. For more information see: ■ Oracle9i Backup and Recovery Documentation Online Roadmap ■ Oracle Database Backup and Recovery Basics 10g Release 2 10.2 ■ Oracle Database Backup and Recovery Reference 11g Release 1 11.1

13.2.2 Running Pending Transaction Report Utility

You must run the pending transaction report utility to analyze your Oracle Identity Manager 9.1 before you start the upgrade process. You must download the pending transaction report utility as described in the note 1316738.1 note at https:support.oracle.com and complete the following steps: 1. Set the environment variables as shown in Table 13–6 : Table 13–6 Environment Variables Environment Variable Values MW_HOME Specify the path of the Oracle Identity Managers Middleware home. The following example shows the full path: oracleMiddleware WL_HOME Specify the path of the Oracle WebLogic Server home. The following example shows the full path: oracleMiddlewarewlserver_10.3 13-10 Oracle Fusion Middleware Upgrade Guide for Oracle Identity Management 2. Run generatePendingTransactionReport.bat Located at MW_ HOME\Oracle_IDM1\server\bin for Windows or generatePendingTransactionReport.sh Located at MW_HOMEOracle_ IDM1serverbin for UNIX and provide the following details: ■ jdbc url [hostname:portname:sid] ■ Oracle Identity Manager schema username ■ Oracle Identity Manager schema password ■ Directory where you save the reports. The pending transaction report utility generates a report which includes the following details: ■ Pending Recon: This includes all events that are deferred to a later date. ■ Pending Request: This includes all requests including self registration pending approval. ■ JMS Queues: This includes all messages, which are in unprocessed state. A JMS message is submitted in case of off-line provisioning. So this report will provide details of the entire pending provisioning task including task, which are initiated in offline mode. The following are the pending transactions which can exist in your environment: ■ All pending recon events generated in OIM 9.1 must be processed. Failed events will not be upgraded, if left unaddressed. ■ All pending approval tasks generated in Oracle Identity Manager 9.1 must be processed. Pending approval tasks will not be upgraded, if left unaddressed. Ensure that these reach a final state before the Upgrade. ■ Scheduled task execution history in Oracle Identity Manager 9.1 will not be upgraded. Ensure that you finish all pending scheduled tasks and there is no scheduled task running during the upgrade period. ■ Any asynchronous audit processing must be processed in Oracle Identity Manager 9.1 before upgrading to Oracle Identity Manager 11g. ■ All JMS queues should be empty. JMS messages in regular or error queues will not be migrated in Oracle Identity Manager 11g. Wait for all JMS messages to be consumed, take proper manual actions for JMS error messages and clean all JMS tables before upgrading to Oracle Identity Manager 11g. For more information, see Emptying JMS queues . JAVA_HOME Specify the path of the Java home. The following example shows the full path: MW_HOMEjdk160_24 XEL_HOME Specify the path of the Oracle Identity Manager server home. The following example shows the full path: oracleMiddlewareOracle_IDM1server Table 13–6 Cont. Environment Variables Environment Variable Values