8.11 Eliminating ObjectNotFound Exceptions and Restoring the Oracle VM Manager Database

When you run the pre-upgrade validation script for the Oracle PCA Controller Software, the management nodes are scanned for ObjectNotFoundException errors. If any such exceptions are found, the script reports a failure, indicating that the appliance is not eligible for the new software version. You must make sure that all issues related to an ObjectNotFoundException are resolved before you attempt to update the Controller Software.

Depending on the current software release running on the appliance, there are different ways to restore the system to an eligible state. These instructions apply to any situation where restoring the Oracle VM Manager database is required.

Oracle PCA Release 2.2.x or Older

If Oracle PCA is running a Controller Software older than Release 2.3.1 then the Oracle VM version is 3.2.x. Select the most appropriate of these two options:

  • restore the Oracle VM Manager database from a backup without ObjectNotFound exceptions

  • regenerate the Oracle VM Manager database

If a recent backup exists that meets the requirements, restoring that backup is the preferred method. However, it is possible that the most recent acceptable backup is too outdated and does not contain critical configurations, such as tenant groups and custom networks. If you implemented significant changes in your environment after the time of the backup, then regenerating the database is probably more efficient.

For information about Oracle PCA backup and restore operations, refer to Section 1.6, “Oracle Private Cloud Appliance Backup”.

For instructions to regenerate the Oracle VM Manager database, refer to the support note with Doc ID 2224820.1.

Oracle PCA Release 2.3.1 or Newer

If Oracle PCA is running a Controller Software Release 2.3.1 or newer, then the Oracle VM version is 3.4.x. In this configuration the backup mechanism verifies that no ObjectNotFound exceptions are present, otherwise the backup fails. Consequently, the latest backup is always a good restore point if there is a problem with the Oracle VM Manager database.

Do not attempt to restore the database based on the instructions in the Oracle VM documentation. The Oracle PCA configuration with its management node cluster and ZFS storage requires very specific steps to restore the database. Please contact Oracle for assistance. A product specialist can execute the restore procedure documented in the support note with Doc ID 2261284.1.