Chapter 6 Troubleshooting Oracle VM Installation or Upgrade

Table of Contents

This chapter gives you details on troubleshooting problems with installing Oracle VM.

This chapter contains information on known issues you may encounter when installing Oracle VM, and explains how to resolve them. If you contact Oracle Support for assistance with an Oracle VM Manager installation, please include the installation logs. See Section 4.3.3, “Installation Logs” for information on log file names and locations.

For additional troubleshooting information, see the following Oracle support sites:

6.1 Troubleshooting Oracle VM Server Installation or Upgrade

6.1.1 FCoE SAN not Listed as Available Drive

If you are attempting to install Oracle VM Server into a Fiber Channel over Ethernet (FCoE) SAN that the installer does not list, you must manually rediscover the FCoE SAN. Start the Oracle VM Server installation program and complete the following steps:

  1. Advance to the Partitioning Type screen and then press F2 to enter the Advanced Storage Options screen.

  2. Select the Add the FCoE SAN option and then select OK.

  3. On the Add the FCoE SAN screen, select the NIC that is connected to the FCoE SAN, deselect the Use DCB option, and then select OK.

The installer connects to the FCoE SAN and returns to the Partitioning Type screen. Continue with the installation of Oracle VM Server as described in Section 2.1.2, “Installing Oracle VM Server From a DVD-ROM”.

6.1.2 Oracle VM Server Cluster Configuration Warning After Upgrade

In some cases, after upgrading Oracle VM Server, you can encounter warning messages that indicate the cluster service for the server pool is not running. An example of the warning message is as follows: 

OVMEVT_003500D_003 Active data was not found. Cluster service is probably not running.

To resolve this issue, refresh the affected server pool and the file system.

6.2 Troubleshooting Oracle VM Manager Installation or Upgrade

6.2.1 libaio Not Installed

The following error is displayed during installation of Oracle VM Manager if the prerequisite libaio package is not installed: 

libaio is not installed...

To fix this error, install the libaio package. For information on how to install libaio, see Section 4.2.2.3, “Prerequisite Packages” in the Oracle VM Installation and Upgrade Guide.

6.2.2 Cannot Install MySQL

The Oracle VM Manager installer may fail to install MySQL and displays the message: 

Failed: The database instance is not available.

You can check the log file at /tmp/ovmm-installer.selfextract_id/ovm-manager-3-install-date.log for more detailed information.

There are two workarounds to this issue.

  1. Make sure that MySQL is not installed, or has installed correctly. Use the following command to check the status: 

    $ service ovmm_mysql status

    If MySQL is running, run the Oracle VM Manager installation script to uninstall it, and reinstall Oracle VM Manager.

  2. Make sure the computer's host name matches the host name in the /etc/hosts file. See Section 4.2.2.5, “Network” to configure the host name.

6.2.3 Cannot Create OVS Database Schema

The Oracle VM Manager install may fail and display the following message: 

Creating the Oracle VM Manager database schema ... Failed.

You can check the log file at /tmp/ovmm-installer.selfextract_id/ovm-manager-3-install-date.log for more detailed information.

Possible workarounds for this issue are:

  1. Make sure that MySQL has installed correctly. Use the following command to check the status: 

    $ service ovmm_mysql status

    If MySQL is running, run the Oracle VM Manager installation script to uninstall it, and reinstall Oracle VM Manager.

  2. Reinstall Oracle VM Manager.

6.2.4 Installation Fails on Non-English Character Set

If the operating system is a non-English character set or language, the Oracle VM Manager installer may display the following error: 

Update default password failed.

Oracle VM Manager only supports the English language and character set.

You can check the log file at /tmp/ovmm-installer.selfextract_id/ovm-manager-3-install-date.log for more detailed information.

To workaround this issue, set the character set to en_US.UTF-8:

  1. Run the following command to check if the value of LANG is en_US.UTF-8: 

    # env|grep LANG

  2. If the character set is not en_US.UTF-8, change it to en_US.UTF-8: 

    # export LC_CTYPE="en_US.UTF-8"

  3. Reinstall Oracle VM Manager.

6.2.5 Installation Fails When Using an NIS-based Oracle User Account

If the oracle user account is created using NIS-based authentication (Network Information Services), the Oracle VM Manager installation fails during the prerequisite check, and the following error is displayed: 

Verifying installation prerequisites ...
hardnofiles should be set to 8192 but was 0
Configuration verification failed ...

Or the installation may pass prerequisite check, but may fail later during the installation of the Application Development Framework: 

Retrieving Oracle Application Development Framework (ADF) ...
Unzipping Oracle ADF ...
Installing Oracle ADF ...
Installing Oracle ADF Patch...

To workaround this issue, disable ypbind service and create a non-NIS-based oracle user account using createOracle.sh on the host computer and rerun the installer: 

# /sbin/service ypbind stop
# service ypbind status
ypbind is stopped
# ./createOracle.sh
# ./runInstaller.sh

6.2.6 Upgrading Oracle VM Manager from Release 3.2.10 to Release 3.4.x Fails

In some cases, it is not possible to successfully upgrade Oracle VM Manager from Release 3.2.10 to Release 3.4.x and the installer output indicates a failure running the ovm_preUpgrade script, as in the following example: 

# ./runInstaller.sh

Oracle VM Manager Release 3.4.x Installer

Oracle VM Manager Installer log file:
/var/log/ovmm/ovm-manager-3-install-yyyy-mm-dd-xxxxxx.log

Verifying upgrading prerequisites ...

Starting Upgrade ...

Reading database parameters from config ...

Verifying configuration ...

Upgrading from version 3.2.10 to version 3.4.x

Running ovm_preUpgrade script, please be patient this may take a long time
...
time_stamp: All jobs in the job log will now be deleted.
time_stamp: Deleting 183 jobs before upgrade.
time_stamp: 183 jobs have been deleted.
4 jobs are still in the job log.

Failure running the ovm_preUpgrade script, upgrade cannot continue!

This failure occurs because an instance of Oracle VM Server is in an erroneous state. As a result, automatic discovery jobs fail and then re-occur. These automatic discovery jobs prevent the ovm_preUpgrade script from running successfully.

To work around this issue, do the following:

  1. Identify the instance of Oracle VM Server that is in an erroneous state.

  2. Shut down or live migrate the virtual machines running on the instance of Oracle VM Server.

  3. Stop the instance of Oracle VM Server.

  4. Ensure that no pending jobs exist in Oracle VM Manager.

  5. Run the script to upgrade Oracle VM Manager.

Copyright © 2011, 2022 Oracle and/or its affiliates. All rights reserved. Legal Notices