Chapter 6 Troubleshooting Oracle VM Installation or Upgrade
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:
-
My Oracle Support, http://support.oracle.com
-
Oracle Virtualization Forum, http://forums.oracle.com/forums/forum.jspa?forumID=823
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:
-
Advance to the Partitioning Type screen and then press F2 to enter the Advanced Storage Options screen.
-
Select the Add the FCoE SAN option and then select OK.
-
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_
for more detailed information.
id
/ovm-manager-3-install-date
.log
There are two workarounds to this issue.
-
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.
-
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_
for more detailed information.
id
/ovm-manager-3-install-date
.log
Possible workarounds for this issue are:
-
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.
-
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_
for more detailed information.
id
/ovm-manager-3-install-date
.log
To workaround this issue, set the character set to en_US.UTF-8:
-
Run the following command to check if the value of LANG is
en_US.UTF-8
:# env|grep LANG
-
If the character set is not
en_US.UTF-8
, change it toen_US.UTF-8
:# export LC_CTYPE="en_US.UTF-8"
-
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:
-
Identify the instance of Oracle VM Server that is in an erroneous state.
-
Shut down or live migrate the virtual machines running on the instance of Oracle VM Server.
-
Stop the instance of Oracle VM Server.
-
Ensure that no pending jobs exist in Oracle VM Manager.
-
Run the script to upgrade Oracle VM Manager.