You are here

Oracle VM Manager Installation

This guide describes how to plan for, install, update, maintain and recover Oracle VM Manager 3.0+, 3.2+, and 3.3+. Author: Roddy Rodstein.


Oracle VM Manager Introduction

At Oracle OpenWorld 2007, Oracle announced its entry into the x86 server virtualization market with the first release of Oracle VM. The first release of Oracle VM was actually version 2.1 because of Larry Ellison's aversion to using 1.0 for Oracle product releases to help drive early adoption. As of this writing, there has been a total of 14 major Oracle VM Releases.
 


 

 

Oracle VM Manager Hardware and Software Requirements

Oracle VM Manager resource requirements can be tested with the Oracle VM Manager user interface (UI) page response times. For example, if the Oracle VM Manager user interface is or becomes painfully slow, or if you experience page timeouts, adding memory and CPUs should speed up the user interface, and eliminate page timeouts.

 


Oracle VM Manager Inter Component Communication and Data Exchange

The Oracle VM Manager GUI, the Oracle Database repository and the WebLogic server running Oracle VM Manager can be on different hosts throughout your enterprise. Understanding Oracle VM Manager intra component communication and data exchange will help configure firewalls in order to allow Oracle VM Manager to operate in your enterprise. During the Oracle VM Manager installation, the default communication ports for each component will be selected and assigned. If the default ports are modified be sure to use the new port assignments when you configure your firewalls.
 


 

Download the Oracle VM Manager Installation Media

The Oracle VM Media Pack is available at the Oracle Software Delivery Cloud - Oracle Linux and Oracle VM portal. Access to the Oracle Software Delivery Cloud requires an Oracle.com user account and password. If you do not already have an Oracle.com user account, visit the Oracle Software Delivery Cloud, portal click the Sign In / Register link or button to create an Oracle.com account.

 


 

Oracle VM Manager Prerequisite Packages

Oracle VM Manager 3.x has a total of two operating system prerequisite packages, libaio 0.3.104 or above, which is only necessary with the Oracle XE Database, and unzip 3.3.2.4.2 or above. To check if a Linux host has the libaio and unzip packages, as root, type “ rpm -qa libaio unzip” as shown in the next example. # rpm -qa libaio unzip unzip-5.52-3.el5 libaio-0.3.106-5 libaio-0.3.106-5

 


 

The Oracle VM Manager Host /etc/hosts Requirements

All Oracle technology products, including Oracle VM Manager, rely on a properly formatted /etc/hosts file. The hostname in the /etc/hosts file must be associated with the server's public IP address. The next example shows the proper syntax for an Oracle Linux 5 /etc/hosts file. Note that the localhost entries are on one line, and the IP address with the long and short names are on the next line.

 


 

The Oracle VM Manager Host NTP Requirements

With Oracle VM, accurate time is essential to maintain system stability due to time-sensitive cluster transactions between Oracle VM Manager and the Oracle VM Servers. Without accurate time, Oracle VM clusters can be brought to a complete standstill.

 

 


 

 

SELinux and Oracle VM Manager

Security Enhanced Linux (SELinux) is a default Linux feature that offers mandatory access controls using Linux kernel security modules (LSM) along with user-space tools. Security Enhanced Linux is not supported with Oracle VM Manager, and if enabled, Security Enhanced Linux will break Oracle VM Manager.

 
 

 

Disable IPv6

Even if IPv6 is not being used, IPv6 can still cause problems such a duplicate addresses with Oracle VM Manager (WebLogic). For example, IPv6 uses a dual stack protocol format that runs IPv4 and IPv6 at the same time. IPv6 creates an IPv6 interface for each IPv4 interface. WebLogic and many other Oracle technologies see the IPv6 interfaces as duplicate address. If IPv6 is not being used, a best practice is to disable IPv6.

 

 


Oracle VM Manager Environment Configuration Script

The createOracle.sh is on the Oracle VM Manager ISO file, and should be used to setup the oracle user account, the /u01 directory and iptables for an Oracle VM Manager installation. The createOracle.sh script must be run as root. The createOracle.sh will perform the following tasks: Creates the dba group Creates the oracle user and adds the oracle user to the dba group Creates the /u01 directory Configures the /etc/security/limits.conf file Opens the required ports in iptables by editing the /etc/sysconfig/iptables file


 

 
 

Oracle VM Manager runInstaller.sh Script Tips & Tricks

Applicable for all Oracle VM Releases The Oracle VM Manager runInstaller.sh script has several handy options. The options can be listed by typing: # ./runInstaller.sh --help Oracle VM Manager Release 3.3.1 Installer Usage: runInstaller.sh [options] options -h, --help Shows this message -c, --config Use specified config file to do install -u, --uuid Manager UUID (install using the provided manager UUID) -i, --installtype Install type : Install, Uninstall, Upgrade -y, --assumeyes Automatically answer yes on Continue? questions -n, --noprereq Ignore prerequisite checks -k, --cleanup Clean up temporary config file after installation
 


 

Oracle VM Manager 3.3 and Above Installation

The next example shows how to perform a Oracle VM Manager 3.3 and Above installation using the runInstaller.sh script with no options. A default Oracle VM Manager installation is an all-in-one installation with Oracle MySQL Enterprise Edition v5.6, WebLogic 11g, and the Oracle VM Manager applications. A Oracle VM Manager installation with MySQL is fully supported for production environments.

 

 

Oracle VM Manager 3.3 and Above Uninstallation

The ability to quickly rebuild, remove and restore Oracle VM Manager is an essential Oracle VM lifecycle operation. If the goal of an Oracle VM Manager uninstall is to start over without the need to preserve previous Oracle VM server pools, simply uninstall and reinstall Oracle VM Manager. If the goal is to recover Oracle VM Manager, with previous Oracle VM server pools, reset or uninstall and reinstall Oracle VM Manager using the UUID restore switch. A UUID Oracle VM Manager installation can be done with or without an Oracle VM Manager Database repository schema backup and restore operation. If the intent is to restore Oracle VM Manager database schema, an Oracle VM Manager uninstall may not be necessary.


Oracle VM 3.2 Manager Simple Installation

The next example shows how to perform a Oracle VM Manager 3.2.x Simple installation using the runInstaller.sh script with no options. A Oracle VM Manager 3.2 Simple installation is an all-in-one installation with Oracle MySQL Enterprise Edition v5.5, WebLogic 11g, and the Oracle VM Manager applications. A Oracle VM Manager 3.2 Simple installation is fully supported for production environments.


 

Oracle VM Manager 3.2 Simple Uninstallation

The ability to quickly rebuild, remove and restore Oracle VM Manager is an essential Oracle VM lifecycle operation. If the goal of an Oracle VM Manager uninstall is to start over without the need to preserve previous Oracle VM server pools, simply uninstall and reinstall Oracle VM Manager. If the goal is to recover Oracle VM Manager, with previous Oracle VM server pools, reset or uninstall and reinstall Oracle VM Manager using the UUID restore switch. A UUID Oracle VM Manager installation can be done with or without an Oracle VM Manager Database repository schema backup and restore operation.
 


 

Oracle VM Manager 3.2 Custom Installation

The next example shows how to perform a Oracle VM Manager 3.2 Custom installation. A Oracle VM Manager Custom installations will install WebLogic 11g with the Oracle VM Manager applications using an existing local or remote Oracle 11g Standard or Enterprise Edition database and/or a RAC database.
 


 

Oracle VM Manager 3.2 Custom Uninstallation

The ability to quickly rebuild, remove and restore Oracle VM Manager is an essential Oracle VM lifecycle operation. If the goal of an Oracle VM Manager uninstall is to start over without the need to preserve previous Oracle VM server pools, simply uninstall and reinstall Oracle VM Manager. If the goal is to recover Oracle VM Manager, with previous Oracle VM server pools, reset or uninstall and reinstall Oracle VM Manager using the UUID restore switch.


 

 

Oracle VM Manager 3.0.1 up to 3.1.1 Production Installation

The next example shows how to perform a Oracle VM Manager Production installation (Oracle VM Relase 3.0.1 up to 3.1.1). A Oracle VM Manager Production installations will install WebLogic 11g with the Oracle VM Manager applications using an existing local or remote Oracle 11g Standard or Enterprise Edition database and/or a RAC database. Oracle VM Release 3.0.1 up to 3.1.1 use the word Production for a local or remote Oracle 11g Standard or Enterprise Edition database and/or a RAC database installation.


 

Oracle VM Manager 3.0.1 up to 3.1.1 Production Uninstallation

The ability to quickly rebuild, remove and restore Oracle VM Manager is an essential Oracle VM lifecycle operation. If the goal of an Oracle VM Manager uninstall is to start over without the need to preserve previous Oracle VM server pools, simply uninstall and reinstall Oracle VM Manager. If the goal is to recover Oracle VM Manager, with previous Oracle VM server pools, reset or uninstall and reinstall Oracle VM Manager using the UUID restore switch.
 


 

 

 

Oracle VM Manager 3.0.1 up to 3.1.1 Demo Installation

The next example shows how to perform a Demo Oracle VM Manager 3.0.1 up to 3.1.1 installation. Please note that a Demo installation is not supported by Oracle Enterprise Manager or Oracle support due to the use of the Oracle 11g XE Database. The Oracle 11g XE Database is a free unsupported release of the Oracle Database.


 

Oracle VM Manager 3.0.1 up to 3.1.1 Demo Uninstallation

The ability to quickly rebuild, remove and restore Oracle VM Manager is an essential Oracle VM lifecycle operation. If the goal of an Oracle VM Manager uninstall is to start over without the need to preserve previous Oracle VM server pools, simply uninstall and reinstall Oracle VM Manager. If the goal is to recover Oracle VM Manager, with previous Oracle VM server pools, reset or uninstall and reinstall Oracle VM Manager using the UUID restore switch.
 


 

Oracle VM Manager Post Installation Checklist

After installing Oracle VM Manager, please review and complete the following tasks on the post-installation checklist.
 
 


 

1. Download and Install the Oracle VM Manager Utilities

The Oracle VM utilities (My Oracle Support Patch 13602094) are an Oracle VM Manager add-on that provide a command line interface for Oracle VM Manager. The Oracle VM utilities allows Oracle VM Manager administrative tasks to be performed from the command line or executed using scripts.
 
 



 

2. VMPinfo3 Installation for Diagnostic Capture & Troubleshooting

VMPinfo3 is a modified version of sosreport for Oracle VM that bundled with Oracle VM 3.2 and above. VMPinfo3 is a set of tools with a command line interface that use the Oracle VM API to collect log files and troubleshooting information from Oracle VM Server pools. VMPinfo3 runs from the Oracle VM Manager host and collects and consolidates log files from each Oracle VM Server managed by Oracle VM Manager.
 


 

3. Patch Oracle VM Manager

Even after a fresh installation of Oracle VM Manager, if a patch update is available, a best practice is to patch Oracle VM Manager before using Oracle VM Manager to avoid previously patched bugs. When updating Oracle VM, Oracle VM Manager must be updated first, followed by the Oracle VM Servers managed by Oracle VM Manager. As of this writing (11-13-2013), there are three Oracle VM Manager patch updates; Oracle VM Manager Release 3.0.3.546, Oracle VM Manager Release 3.1.1.625, and Oracle VM Manager Release 3.2.6.726.
 


 

4. Create Oracle VM Manager Admin Users

A best practice is to create an individual user account for each administrator that access Oracle VM Manager. Oracle VM Manager has two default administrative user accounts; the admin user account and the weblogic user account (lowercase). The passwords for the admin and the weboigic accounts are set during the Oracle VM Manager installation.
 


 

Oracle VM Manager Log Files and Log File Analysis

When things go wrong with Oracle VM Manager, being able to quickly determine the root cause of an issue can eliminate or reduce down time. An effective way to identify problems with Oracle VM Manager is to analyze the WebLogic application logs on the Oracle VM Manager host.
 
 




Restore Oracle VM Manager

The ability to quickly restore Oracle VM Manager is an essential Oracle VM lifecycle operation. If the goal is to start over without the need to preserve previous Oracle VM server pools, an Oracle VM Manager Database repository reset or an Oracle VM Manager uninstall and reinstall will provide a clean, new Oracle VM Manager setup. If the goal is to recover Oracle VM Manager on the same host, while preserving previous Oracle VM server pools, reset the Oracle VM Manager Database repository.
 


 

Oracle VM Manager Restore Roadmap

1) Oracle VM Manager Hosts: As root, access the Oracle VM Manager host, and stop the ovmm and ovmcli services: # service ovmm stop # service ovmcli stop 2) Oracle VM Manager host: Reset the Oracle VM Manager Database Repository. As root, access the Oracle VM Manager host, and drop the Oracle VM Manager Database Repository: # cd /u01/app/oracle/ovm-manager-3/bin/ # sh ./ovm_upgrade.sh --deletedb --dbuser=ovs --dbpass=PASSWORD --dbhost=localhost --dbport=49500 --dbsid=ovs Note: Substitute PASSWORD with the admin password.
 


 

Oracle VM Manager Backups

Before upgrading Oracle VM Manager, a best practice is to backup the Oracle VM Manager configuration file as well as the Oracle VM Manager Database repository. To be able to restore Oracle VM Manager from backup, a backup of the Oracle VM Manager configuration file and the Oracle VM Manager Database repository is required.
 


 

Backup Oracle VM Manager Configuration File

The Oracle VM Manager configuration file “.config ” is located on the Oracle VM Manager host(s) in the /u01/app/oracle/ovm-manager-3/ directory. The next example shows the syntax of the Oracle VM Manager .config file.
 


 

 

 

MySQL Enterprise Edition Database Repository Backup

Starting with Oracle VM Manager Release 3.2.1 and above, simple MySQL Oracle VM Manager installations are automatically backed up within the /u01/app/oracle/mysql/dbbackup directory every 24 hours using the MySQL Enterprise Backup utility.
 


 

 

Backup Oracle VM Manager Configuration File

The exp utility can be run in one of three modes: interactive dialogue, controlled through bypassed parameters and parameter file controlled. For the sake of brevity, we will use the interactive dialogue mode to do a full Oracle VM Manager 11g Standard or Enterprise Edition Database repository backup.
 


 

 

 

How to Backup an Oracle 11g Express Database Repository

The exp utility can be run in one of three modes: interactive dialogue, controlled through bypassed parameters and parameter file controlled. For the sake of brevity, we will use the interactive dialogue mode to do a full Oracle VM Manager 11g Standard or Enterprise Edition Database repository backup.


 

 

Appendix

The Oracle VM Manager Installer and the oracle-rdbms-server-12cR1-preinstall RPM and soft nofile settings

If the oracle-rdbms-server-12cR1-preinstall RPM is part of your standatrd OS install you'll run into an issue with the Oracle VM Manager installer complaining about the wrong soft nofile settings. The oracle-rdbms-server-12cR1-preinstall RPM makes a file named "/etc/security/limits.d/oracle-rdbms-server-12cR1-preinstall.conf" that overrides the limits.conf setting.


 

 
Document Created: 09/19/11
Last Update: 9/7/15
 
Copyright © 2015 Mokum Solutions, Inc. All rights reserved.
Distribution of the Oracle Cloud Cookbook or derivative of the work in any form is prohibited unless prior permission is obtained from the copyright holder.