3.15. Troubleshooting

3.15.1. libaio Not Installed
3.15.2. bc Not Installed
3.15.3. Cannot Install Oracle XE
3.15.4. Cannot Create OVS Database Schema
3.15.5. Oracle Database Schema Exists
3.15.6. Oracle XE Listener Fails to Start
3.15.7. Installation Fails on Non-English Character Set
3.15.8. Installation Fails When Using an NIS-based oracle User Account

The section contains information on known issues you may encounter when installing Oracle VM Manager, and explains how to resolve them. You can find additional information on the following Oracle Support Web sites:

If you contact Oracle Support for assistance with an Oracle VM Manager installation, please include the installation logs. See Section 3.4.5, “Installation Logs” for information on log file names and locations.

3.15.1. libaio Not Installed

The following error is displayed during installation if the prerequisite libaio package is not installed:

libaio is not installed...

Workaround: Install the libaio package. For information on how to install libaio, see Section 3.3.2.5, “Prerequisite Packages”.

3.15.2. bc Not Installed

The following error is displayed during installation of the database if the prerequisite bc package is not installed:

Step 1 of 9 : Database ...
Installing Database ...
Retrieving Oracle Database 11g XE ...
Installing Oracle Database 11g XE ...
Configuring Oracle Database 11g XE ...
Failed to configure Oracle Database 11g XE
            
[...]

Starting Oracle Net Listener...Done
Configuring database...
Database Configuration failed.  Look into /u01/app/oracle/product/11.2.0/xe/config/log for details

Workaround: Install the bc package. For information on how to install bc, see Section 3.3.2.5, “Prerequisite Packages”.

3.15.3. Cannot Install Oracle XE

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

Failed: The database instance is not available.

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

Workaround: There are two workarounds to this issue.

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

    $ /etc/init.d/oracle-xe status

    If an Oracle XE 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 3.3.2.2, “Network” to configure the host name.

3.15.4. Cannot Create OVS Database Schema

You may encounter the following message:

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

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

Workaround: Possible workarounds for this issue are:

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

    $ /etc/init.d/oracle-xe status

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

  2. If you are installing into an existing Oracle XE database, make sure that you have entered the correct password for the SYS account.

  3. Reinstall Oracle VM Manager.

3.15.5. Oracle Database Schema Exists

If the installer fails after creating the Oracle Database OVS schema, but before the end of the installation process is complete, you may end up with a schema that cannot be overwritten when you attempt to perform the install again. To resolve this issue, you should drop the OVS schema, then continue with the reinstall again when you have resolved the install problem.

To drop the OVS schema, log into the Oracle Database as the sys or system user and perform the following steps:

$ sqlplus system/password
SQL> drop schema OVS;
SQL> exit;

The schema name used in this example uses the default schema name, OVS. If you used a custom schema name during the installation, you should replace OVS with the name of your schema. The name of your schema is located in the Oracle VM Manager configuration file located at:

/u01/app/oracle/ovm-manager-3/.config

3.15.6. Oracle XE Listener Fails to Start

The Oracle VM Manager installation may fail to start the Oracle XE listener. The Oracle XE listener may fail to start because the host name in the listener.ora file is not mapped to an IP address.

Workaround: Add the IP address and host name to the /etc/hosts file. See Section 3.3.2.2, “Network” to configure the host name. Alternatively, you can specify the IP address in the listener.ora file. The listener.ora file is located in the directory:

/usr/lib/oracle/xe/app/oracle/product/11.2.0/server/network/admin

Manually start the Oracle XE listener with the command:

# /usr/lib/oracle/xe/app/oracle/product/11.2.0/server/bin/lsnrctl start

3.15.7. 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/install-date.log for more detailed information.

Workaround: 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.

3.15.8. 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 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 ...

Workaround: Create a non-NIS-based oracle user account on the host computer and rerun the installer.