A Troubleshooting the Oracle Access Manager Upgrade

If you encounter errors while upgrading Oracle Access Manager to 12c (12.2.1.3), review the following troubleshooting procedures.

• WebGates Configuration Fails during Authentication
  During authentication, WebGates configured with the user-defined parameter hmacEnabled=true in environments where the server-side globalHMACEnabled property is set to false, fails.
• Activation State is set as FAILED when Restarting the Admin Server
  After you upgrade the domain component configurations and start the Admin server, the activation state is set as FAILED.
• AMInitServlet Fails to Preload when Restarting OAM Managed Server
  After you upgrade the domain component configurations and start the OAM managed server, AMInitServlet fails to preload.
• CFGFWK-60928: Invalid Existing Node Manager Home Directory
  When you reconfigure the domain, an invalid existing node manager home directory error is displayed.
• File Not Found Exception when Starting the OAM Managed Server
  After you upgrade the domain component configurations and start the server a File Not Found exception is displayed.
• Internal Server Error: The Server Encountered an Unknown Error
  When you perform an upgrade and access a protected resource, an Internal Server Error is displayed.
• Invalid OAM Keystore Configuration: oam_admin Fails
  After you upgrade the domain component configurations and start the admin server, the oam_admin deployment state is displayed as fail.
• Upgrade Assistant Readiness Check Fails: Common Infrastructure Services (DEV_STB)
  When you reconfigure the domain, the upgrade assistant readiness check fails because of the common infrastructure services (DEV_STB).
• Upgrade Assistant Readiness Check Fails: Missing System and Object Privileges
  When you reconfigure the domain, the upgrade assistant readiness check fails because of missing system and object privileges for OPSS Schema (DEV_IAU).
• Upgrade Assistant Readiness Check Fails: Oracle WSM Datasource Connection Details
  When you reconfigure the domain, the upgrade assistant readiness check fails with the exception Failed to read the Oracle WSM datasource connection details.
• Readiness Check for OAM Configuration Upgrade Fails
  Before you run the readiness check for Oracle Access Manager for the first time, ensure that you have removed the IAMSuiteAgent security provider.
• Error When Starting SSL Enabled OAM Managed Server After Upgrade
  If SSL is enabled for Oracle Access Manager Managed Servers, the SSL port for the Administration Server must be changed manually before starting the servers.
• Readiness Check for OPSS Schema Fails
  When you upgrade Oracle Access Manager 11.1.2.3.0 environments that is upgraded from 11g Release 2 (11.1.2.1.0), the readiness check for Oracle Platform Security Services (OPSS) schema fails with the following exception”
• OAM Upgrade Fails With InvalidKeyException
  Oracle Access Manager upgrade fails with InvalidKeyException if Java JSE Policy is not upgraded.
• OWSM Error Messages in the Reconfiguration Logs
  During the Oracle Access Manager (OAM) upgrade, when you reconfigure the OAM domain, Oracle Web Services Manager (OWSM) error messages are seen in the reconfig logs.
• OAM Console Shows No Application Domains After Upgrade
  After you upgrade Oracle Access Manager (OAM) in an integrated setup where you have deployed Oracle Identity Manager, Oracle Access Manager, Oracle Unified Directory, and Oracle Adaptive Access Manager, when you search for application domains on OAM console, it shows no result.
• Troubleshooting Security Policy Issues When Upgrading