Troubleshooting
If the upgrade utility fails at any point during the upgrade, the database will be considered unusable. Failures could happen for a number of reasons. To understand the nature of the failure, click the View Log button for the module that failed in the VersionUpgradeEditor window.
Database Connection Failure
If the network connection to the database server is interrupted during the upgrade, it will fail and produce a message. The log file will indicate an error message relating to connectivity from the database driver.
Resolution
Restore the database from back-up and re-run the upgrade utility. Investigate network integrity between the utility execution machine and the database.
Incorrect Current System Version
If the current version of the database is not correctly set while logging in to the target environment the first time, then SQL scripts could fail to execute due to dependencies not being met. The log file will indicate a failure to execute SQL query or statement.
Resolution
Restore the database from the backup, recreate the environment in the utility with the correct current version, and re-run the upgrade utility.
Other Errors
Error information is captured in two primary locations. The first is in the database and is viewable within the utility, as explained in the Reviewing Results section.
If the utility produces a Java error, it will be captured in the utility logs. These are located in the <user_directory>\Oracle\oipa_utility\OIPAUtility\dev\var\log folder. On Windows Vista and newer machines, this directory is typically: C:\Users\<user_name>\AppData\Roaming\Oracle\oipa_utility\OIPAUtility\dev\var\log\.
If you are unable to determine the cause of an error, please contact Oracle Support as indicated in the Introduction section of this document, and be prepared to provide the log files mentioned above.