1 Oracle VM Manager Components

The applications necessary to run Oracle VM Manager are packaged in the ISO image. Some or all of the following applications may be installed on the host computer when you install Oracle VM Manager:

Oracle VM Manager

The Oracle VM Manager application.

Oracle Database 10g Express Edition (Oracle XE)

In a new installation, Oracle Database 10g Express Edition (Oracle XE) is installed. If you already have Oracle XE installed, the installation script prompts you to use the existing database instance, install a new one, or use an existing database in the local area network (LAN).

3 Installing Oracle VM Manager

If you want to install Oracle VM Manager in a virtualized environment, do not install it on Oracle VM Server (dom0) directly; install it into a guest virtual machine running on Oracle VM Server. An Oracle VM Manager template is available for this purpose at http://edelivery.oracle.com/oraclevm. See the Oracle VM Manager template readme document for installation instructions.

3.1 Installation Process

It takes approximately 5-15 minutes to complete the installation of Oracle VM Manager, depending on the performance of the Oracle VM Manager host, and the installation type you choose. To install Oracle VM Manager:

A new schema named OVS is created. If the OVS schema already exists, the data in it is deleted. Back up the database if you need to retain the data in the OVS schema. Oracle VM supports Oracle Database 10g Release 2, Oracle Database 11g, and Oracle XE.

Please enter the database hostname or ip address(Default: hostname):
Specify a port that will be used for the database listener [1521]
Please specify the database SID(Default: orcl)
Please enter the password for database account 'SYS':
Set default database schema to 'OVS'.
Please enter the password for account 'OVS':
Confirm the password:

If you already have Oracle XE installed on your computer, you are prompted to choose whether to use the existing database or a install a new one:

The installation process detected an existing XE database. Do you want to use it? [1|2|3]
1. Use existing Oracle XE database on localhost
2. Remove the Oracle XE database and install a new one
3. Use an existing Oracle database in my network

The installation process varies depending on your selection.

Enter 1 to use the existing Oracle XE database on the computer.

A new schema named OVS is created. If the OVS schema already exists, the data in it is deleted. Back up the database if you need to retain the data in the OVS schema.

Enter 2 to remove the database and install a new one. Enter y when prompted:

The existing Oracle XE database will be removed. Are you sure to continue?[y|n]

Enter 3 to use the existing database on the local area network (LAN).

A new schema named OVS is created. If the OVS schema already exists, the data in it is deleted. Back up the database if you need to retain the data in the OVS schema. You can also select the default tablespace for the OVS schema; the default tablespace is USERS.

Enter the HTTP port and the listener port to be used for Oracle XE. Press Enter to accept the default setting, or enter new port numbers.

Oracle Database 10g Express Edition Configuration
-------------------------------------------------
This will configure on-boot properties of Oracle Database 10g Express
Edition. The following questions will determine whether the database should
be starting upon system boot, the ports it will use, and the passwords that
will be used for database accounts. Press <Enter> to accept the defaults.
Ctrl-C will abort.
Specify the HTTP port that will be used for Oracle Application Express [8080]:
Specify a port that will be used for the database listener [1521]:

Enter a password to use for the SYS and SYSTEM accounts for Oracle XE.

Specify a password to be used for database accounts. Note that the same password will be used for SYS and SYSTEM. Oracle recommends the use of different passwords for each database account. This can be done after initial configuration:
Confirm the password:

The default setting is to start Oracle XE automatically on boot. Press Enter to enable the default setting, or enter n to start Oracle XE manually.

Do you want Oracle Database 10g Express Edition to be started on boot (y/n) [y]:

To access the Oracle XE configuration home page, go to:

http://127.0.0.1:8080/apex

Enter a password to use for the OVS account for the Oracle VM Manager database.

Set default database schema to 'OVS'.
Please enter the password for account 'OVS':
Confirm the password:

Note:

A valid password must comply with the following rules:

The password must begin with an uppercase or lowercase letter.

The password may include the following characters: numbers (such as 1, 2, 3, and so on), letters (from a to z, A to Z), and underscores (_).

Examples of valid passwords: Password01, Password_123, password.

After the database installation and/or configuration is complete, the installation script continues to install the Oracle VM Manager packages and OC4J.

3.2 Installing TightVNC for Non-Linux Users

To access virtual machines from within the Oracle VM Manager UI using the Console feature, you must first install TightVNC. The TightVNC Java applet enables non-Linux users to connect to a virtual machine's console. TightVNC must be installed on the Oracle VM Manager host. You can get the latest TightVNC package from:

If you are using Mozilla Firefox on Linux to log in to a virtual machine's console, you also need to install the Oracle VM Manager console plug in (ovm-console) on your computer. See the Oracle VM Manager User's Guide for information on how to install the plug in.

3.3 Installation Logs

If any errors occur during installation, check the Oracle VM Manager log files in the directory:

/var/log/ovm-manager

The following log files are located in this directory:

Table 2 Installation Log Files

Log Name

Description

ovm-manager.log

The Oracle VM Manager installation log.

db.log

The Oracle Database installation log. When you install Oracle VM Manager using an existing database, the log information is stored here.

oc4j.log

The OC4J installation log. When the oc4j.log file exceeds 10 MB, a new log file called oc4j.log.1 is generated. Subsequently, the oc4j.log is cleared to record new log information.

upgrade_oldversion_newversion.log

The Oracle VM Manager upgrade log.

4 Upgrading Oracle VM Manager

If you are using an earlier release of Oracle VM Manager you can upgrade it to Release 2.2. During the upgrade, the database and the Oracle VM Manager application are updated.

Oracle VM Manager is backwardly compatible with previous Oracle VM Server releases. To make sure you are not using a newer version of Oracle VM Server that cannot be managed Oracle VM Manager, you should upgrade Oracle VM Manager to Release 2.2 before you upgrade your Oracle VM Servers to Release 2.2.

If you have multiple Oracle VM Servers in a server pool, first upgrade the Oracle VM Servers which do not function as the Server Pool Master. The last Oracle VM Server in the server pool to be upgraded should be the Server Pool Master.

5 Starting and Stopping Oracle VM Manager

To start or stop Oracle VM Manager, as the root user, use the commands:

/sbin/service oc4j [start|stop|status]

Alternatively, you can use the commands:

/etc/init.d/oc4j [status|start|stop]

For example, to start Oracle VM Manager:

# /sbin/service oc4j start

Note:

If you chose to start Oracle XE manually during the installation, start Oracle XE before you start Oracle VM Manager.

To stop Oracle VM Manager:

# /sbin/service oc4j stop

To check the status of Oracle VM Manager:

# /sbin/service oc4j status

You can also use the Services dialog to start and stop Oracle VM Manager (OC4J). From the Applications menu, select System Settings > Server Settings > Services. Or by running the following command in a terminal to use display Services dialog:

# /usr/bin/system-config-services

In the Service Configuration dialog, select oc4j to check the status, and start or stop it.

6 Uninstalling Oracle VM Manager

Before uninstalling Oracle VM Manager, you may want to back up Oracle VM Manager. For information on how to back up and restore Oracle VM Manager, see the Oracle VM Manager User's Guide.

Are you sure you want to uninstall Oracle VM Manager ?[y|N] (Default=N):

The following message is displayed, which confirms that the uninstallation process has completed successfully:

Oracle VM Manager was removed.

7 Enabling or Disabling SSL

If Oracle VM Manager is the only application running on the OC4J instance, you can enable or disable SSL (HTTPS) after installation with the SSL configuration script:

sh /opt/ovs-manager-2.2/bin/config_https.sh [enable|disable]

For example, to enable SSL, enter:

# sh /opt/ovs-manager-2.2/bin/config_https.sh enable

And to disable SSL, enter:

# sh /opt/ovs-manager-2.2/bin/config_https.sh disable

If there are other applications running on the OC4J instance, you should perform the following to enable or disable SSL. Before configuration, make sure that the you set the PATH environment variable to include the JDK bin directory.

To enable SSL with standalone OC4J:

Create a keystore file.

A keystore file is created during the installation, even if you do not select SSL during the installation. You can reuse this keystore file, or generate a new one. They syntax for creating a keystore file is:

OC4J now listens for both SSL requests (port 4443 in the example) and non-SSL requests (port 8888).

You can access Oracle VM Manager from either http://hostname:8888/OVS or https://hostname:port/OVS. You can switch off HTTP or HTTPS by removing the corresponding entry in the server.xml file and restarting OC4J.

8 OC4J Admin User Password Change

To change the password for the oc4jadmin user account, log in to the OC4J user interface with the URL:

http://127.0.0.1:8888/em

You must log in to this web site on the local host; you cannot access it remotely.

9 Troubleshooting

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:

9.2 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 /var/log/ovm-manager/db.log for more detailed information.

Workaround: There are two workarounds to this issue.

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.

Make sure the computer's host name matches the host name in the /etc/hosts file. Use the following command to check the host name:

$ hostname

Use the following command to check the host name in the /etc/hosts file:

$ vi /etc/hosts

For example, if the computer's host name is hostname01.example.com, and the IP address is 10.1.1.1, the corresponding item in the /etc/hosts file must be:

10.1.1.1 hostname01.example.com hostname01

9.3 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 /var/log/ovm-manager/db.log for more detailed information.

Workaround: Possible workarounds for this issue are:

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.

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

Reinstall Oracle VM Manager.

9.4 Cannot Start OC4J Instance

You may encounter a message stating that the OC4J instance cannot be started. You can check the OC4J log file at /var/log/ovm-manager/oc4j.log for detailed information. If you cannot solve the problem using the information contained in the log file, reinstall Oracle VM Manager with the following procedure:

Uninstall Oracle VM Manager.

Before reinstalling Oracle VM Manager, shut down all OC4J processes. Use the following command to check the status of OC4J:

# ps -ef | grep oc4j

If OC4J is running, run the following command to stop it:

# pkill -f -9 oc4j

Reinstall Oracle VM Manager.

9.5 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. Alternatively, you can specify the IP address in the listener.ora file. The listener.ora file is located in the directory:

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

Workaround: 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 to en_US.UTF-8:

# export LC_CTYPE="en_US.UTF-8"

Reinstall Oracle VM Manager.

10 Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Deaf/Hard of Hearing Access to Oracle Support Services

To reach Oracle Support Services, use a telecommunications relay service (TRS) to call Oracle Support at 1.800.223.1711. An Oracle Support Services engineer will handle technical issues and provide customer support according to the Oracle service request process. Information about TRS is available at http://www.fcc.gov/cgb/consumerfacts/trs.html, and a list of phone numbers is available at http://www.fcc.gov/cgb/dro/trsphonebk.html.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.