A Troubleshooting the Oracle Identity Manager Upgrade

If you encounter errors while upgrading Oracle Identity Manager upgrade, review the following troubleshooting procedures.

• Reading CSF Key Fails when Running Upgrade Assistance (UA)
  During the Oracle Identity Manager 11g (11.1.2.3.0) to 12c (12.2.1.4.0) one-hop upgrade, when you run Upgrade Assistance (UA) in readiness mode, OIM fails to read the CSF key.
• Default Challenges Questions are not Updated After Upgrade
  After you upgrade Oracle Identity Manager 11g (11.1.2.3.0) to 12c (12.2.1.4.0) using one-hop, the default challenge questions are not updated. It still shows the old or existing challenge questions.
• Oracle Identity Manager Server Throws OutOfMemoryError
  When you start the servers post upgrade, OutOfMemoryError is thrown.
• Errors Encountered if OIM 11g (11.1.2.3.0) Setup with JMS Persistent Store is Database Based Instead of File Based
  In a ready-to-use OIM 11g (11.1.2.3.0) setup, JMS persistent store is typically file based. However, you can move the JMS persistent store to DB, if required.
• OIM Schema Upgrade Fails During One-Hop Upgrade
  The schema upgrade fails during the one-hop upgrade of Oracle Identity Manager if the OIM 11g (11.1.2.3.0) setup uses localhost to refer to the machine, instead of using the actual host name or IP address.
• Errors During Start/Stop of the Administration Server When Running the Domain Wiring Utility
  When you run the Domain Wiring utility during the one-hop upgrade process, you may encounter errors during the start/stop of the Administration Server.
• Connection Timeout Errors During Bootstrap
  When performing a one-hop upgrade, at bootstrap, you may encounter connection timeout errors. To prevent these errors, Oracle recommends you to complete the required performance tuning on the newly installed OIG 12c (12.2.1.4) setup.
• Failure in UPDATE_WORKFLOW_POLICIES Post-Bootstrap Task
  The UPDATE_WORKFLOW_POLICIES post-bootstrap task fails when you start the OIM Managed server after the upgrade.
• MDS Customizations are Removed After You Restart the OIM Managed Server of an Upgraded Setup
  If any MDS customizations are done after a successful upgrade to 12c (12.2.1.4.0) and if those customizations are lost after you restart the OIM Managed Server, you cannot recover the MDS changes. You have to do the MDS customizations again.
• OPatch Fails for not Finding the 'fuser' Command
  OPatch fails when it is unable to locate the fuser command.
• Administration Server Has a Slow Start After the Upgrade
  The Administration Server experiences a slow start after the upgrade.
• NPE Encountered on Starting OIM Server After Running the Upgrade Assistant
  A Null Pointer Exception (NPE) is encountered when starting the OIM server after running the Upgrade Assistant for upgrading the domain configuration.
• OIM Bootstrap Fails Due to the Presence of Custom Application JARs
  If there are any custom developed libraries or JARs placed inside the OIM_HOME, the OIM bootstrap fails during the upgrade to Oracle Identity Manager 12c (12.2.1.4.0).
• Incorrect Links in Password Reset Emails
  The OIG system generated password reset email has links in the applewebdata://<ANY_RANDOM_GUID>/null format, which is incorrect.
• Failure in the Compilation of BPEL Generated Classes From 11g in 12c
  Compilation of the generated BPEL classes from 11g fails in 12c if the class path setting is incorrect. Custom composites should have the dependent jars under BpelcClasspath to ensure that the composites are deployed successfully.
• User, Role, and Organization UDFs Missing After Upgrade from 11g to 12.2.1.x
  The User Defined Fields (UDFs) previously defined in the organization.xml and user.xml files are missing in the MDS storage, after the upgrade of Oracle Identity Manager from 11g (11.1.2.3) to 12c (12.2.1.x).