4.3 Installing Oracle VM Manager

It takes approximately 8-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.

Before you begin the installation, download the Oracle VM Manager software from:

http://edelivery.oracle.com/oraclevm

More information on obtaining the software is covered in Section 1.2, “Getting Installation ISOs and Packages”.

Once you have downloaded the Oracle VM Manager installation ISO you must either burn it to DVD-ROM and mount the DVD on the target host (see Section 1.3, “Installation From Bootable Physical Media”); or copy the ISO to the target host and perform a loopback mount of the ISO (see Section 1.4, “Loopback ISO Mounts”).

4.3.1 Configuring the Environment Before Installation

Oracle VM Manager requires a system user named oracle, a group called dba, and a /u01 directory with specific permissions on installation folders. The Oracle VM Manager installation media includes a shell script, createOracle.sh, that automatically configures the environment. This script does the following:

Note

You must use the bash login shell with the oracle user to install Oracle VM Manager.

The createOracle.sh script does the following:

  • Creates the required operating system user, oracle, and groups, dba.

    Note

    The script does not set a password for the oracle user as a security measure. Because the user does not have a password, it is not possible to log in as the oracle user. If you want to allow login access, you must set the password manually.

  • Creates the /u01 directory, if it does not already exist, and sets permissions on required installation folders.

    Note

    The /u01 directory must exist before you can install Oracle VM Manager. This directory must also have 2.4 GB of space available.

  • Sets the required parameters in the /etc/security/limits.conf file on a Linux system.

  • Opens the required ports in the /etc/sysconfig/iptables file on a Linux system.

Note

You should run the createOracle.sh script if you are installing Oracle VM Manager on the system for the first time. You do not need to run this script if you are reinstalling Oracle VM Manager on the same system.

To run createOracle.sh and configure the environment, do the following:

  1. Mount the Oracle VM Manager installation media. See Section 1.3, “Installation From Bootable Physical Media” or Section 1.4, “Loopback ISO Mounts”.

  2. Change directory to the mount point, for example:

    # cd /mnt/cdrom
  3. As the root user, run createOracle.sh

    # ./createOracle.sh
Important

The createOracle.sh script does not automatically enable the iptables service. You should manually confirm that the iptables service is enabled.

Manually Setting Up the Oracle User

To install Oracle VM Manager, you must have an oracle user that is a member of a group named dba and which has the correct security limits set.

The environment configuration script automatically creates and configures the oracle user. As an alternative to using the script, you can set up the oracle user with the following commands:

  • If the oracle user does not exist on the Oracle VM Manager host, enter the following commands as the root user to create the user, create the group, add the user to the group, and set the user's password:

    # groupadd dba
    # useradd -g dba oracle
  • If the oracle user already exists, add it to the dba group using the following command:

    # usermod -g dba oracle
  • The oracle user must also have a hard nofiles and soft nofiles minimum of at least 8192, as well as some other security limits set. To set these, edit the /etc/security/limits.conf file to include the following:

    oracle       hard    nofile  8192
    oracle       soft    nofile  8192
    oracle       soft    nproc   4096
    oracle       hard    nproc   4096
    oracle       soft    core    unlimited
    oracle       hard    core    unlimited

4.3.2 Running the Oracle VM Manager Installer

To install Oracle VM Manager, change directory to the mount point where you have either mounted the DVD-ROM or where you have mounted the ISO file and start the installation by running the runInstaller script as the root user:

Important

Please ensure that you have met the requirements outlined in Section 4.2, “Minimum Hardware and Software Requirements” before running the runInstaller.sh script. The runInstaller.sh script attempts to check that these requirements are met before running and may exit if a requirement is not met. It is possible to disable prerequisite steps by running the script with the -n or --noprereq option, as described in Section 4.6, “Oracle VM Manager Installation Script (runInstaller.sh)”.

# cd /mnt/ovm
# ./runInstaller.sh

Substitute /mnt/ovm with the path to the mount point where the DVD-ROM or ISO image file is mounted on your own system.

A set of installer options are displayed:

Please select an installation type:
   1: Install
   2: Upgrade
   3: Uninstall
   4: Help

At the command prompt, enter 1 to perform the installation. If you already have Oracle VM Manager installed and want to upgrade it, select 2 to Upgrade. If you already have Oracle VM Manager installed and want to remove it, select 3 to Uninstall.

See Section 4.3.2.1, “Installation” for information on installing Oracle VM Manager.

See Section 4.5, “Uninstalling Oracle VM Manager” for information on uninstalling Oracle VM Manager, and its components such as MySQL, Oracle WebLogic Server, ADF and Java.

Upgrading Oracle VM Manager is discussed in Chapter 5, Upgrading Oracle VM.

4.3.2.1 Installation

The Installation option installs MySQL Enterprise Edition, MySQL Enterprise Edition Backup, Oracle WebLogic Server, Oracle Application Development Framework (ADF), Java, and Oracle VM Manager on the local system. The following example shows the installation process.

Note

If you have an existing MySQL installation on the system where you intend to install Oracle VM Manager you must backup your databases and uninstall it. Oracle VM Manager requires exclusive use of MySQL due to the specific tuning parameters that it applies to the configuration. Oracle VM Manager uses MySQL Enterprise Edition on a non-standard port. The licensing of the MySQL Enterprise Edition provided with Oracle VM Manager grants exclusive use to Oracle VM. You must not use the MySQL server provided for any other purpose. If MySQL is installed as a result of a previous installation of Oracle VM Manager the installation prompts you to provide the hostname, root password and port number that was used in the previous installation.

Example 4.1 Installation

# ./runInstaller.sh

Oracle VM Manager Release 3.x.x Installer
 
Oracle VM Manager Installer log file:
  /var/log/ovmm/filename.log
 
 
Please select an installation type:
   1: Install
   2: Upgrade
   3: Uninstall
   4: Help

   Select Number (1-4): 1

The installation process starts, and the following is displayed:

Verifying installation prerequisites ...

Starting production with local database installation ...

One password is used for all users created and used during the installation.
Enter a password for all logins used during the installation:
Enter a password for all logins used during the installation (confirm): 

A system-wide password is required during installation. This password is used for all components used by Oracle VM Manager including MySQL, Oracle WebLogic and the Oracle VM Manager application itself. Note that the password should at least adhere to the requirements for an Oracle WebLogic password as set out below:

  • Be between 8 and 16 characters in length.

  • Contain at least 1 lower case and 1 upper case letter.

  • Contain at least 1 numeric value or special character.

Enter the system-wide password and then enter it again when you are prompted to confirm your password.

Please enter your fully qualified domain name, e.g. ovs123.us.oracle.com, (or IP address) 
of your management server for SSL certification generation, more than one IP address are 
detected: 10.172.76.71 192.168.122.1 [10.172.76.71]:

Enter the fully qualified domain name or IP address of the host where you are installing Oracle VM Manager. This is used to generate the self-signed SSL certificate that is used by Oracle VM Manager to encrypt HTTPS communications. The domain name must either match the domain name returned when running the hostname -f command on your system, or must match a valid IP address for the host. The installer validates the IP address or hostname entered here by attempting to ping the entry before proceeding with the installation. If the ping fails, the installer prompts to re-enter a valid domain name or IP address. It is not possible to enter 'localhost' or '127.0.0.1' as a valid hostname.

Verifying configuration ... 

Warnings may occur if not all recommendations are met.

The installer provides a final option to continue or to abort the installation process. Enter 1 to continue. Progress of the installation is output on your screen step by step, as shown below:

Start installing Oracle VM Manager:
   1: Continue
   2: Abort

   Select Number (1-2): 1

Step 1 of 7 : Database Software...
Installing Database Software...
Retrieving MySQL Database 5.6 ...
Unzipping MySQL RPM File ...
Installing MySQL 5.6 RPM package ...
Configuring MySQL Database 5.6 ...
Installing MySQL backup RPM package ...

Step 2 of 7 : Java ...
Installing Java ...

Step 3 of 7 : WebLogic and ADF...
Retrieving Oracle WebLogic Server 12c and ADF ...
Installing Oracle WebLogic Server 12c and ADF ...
Applying patches to Weblogic ...
Applying patch to ADF ...

Step 4 of 7 : Oracle VM  ...
Installing Oracle VM Manager Core ...
Retrieving Oracle VM Manager Application ...
Extracting Oracle VM Manager Application ...

Retrieving Oracle VM Manager Upgrade tool ...
Extracting Oracle VM Manager Upgrade tool ...
Installing Oracle VM Manager Upgrade tool ...

Retrieving Oracle VM Manager CLI tool ...
Extracting Oracle VM Manager CLI tool...
Installing Oracle VM Manager CLI tool ...
Installing Oracle VM Manager WLST Scripts ...

Step 5 of 7 : Domain creation ...
Creating domain ...

Step 6 of 7 : Oracle VM Tools ...

Retrieving Oracle VM Manager Shell & API ...
Extracting Oracle VM Manager Shell & API ...
Installing Oracle VM Manager Shell & API ...

Retrieving Oracle VM Manager Wsh tool ...
Extracting Oracle VM Manager Wsh tool ...
Installing Oracle VM Manager Wsh tool ...

Retrieving Oracle VM Manager Tools ...
Extracting Oracle VM Manager Tools ...
Installing Oracle VM Manager Tools ...

Retrieving ovmcore-console ...
Installing ovmcore-console RPM package ... 
Copying Oracle VM Manager shell to '/usr/bin/ovm_shell.sh' ...
Installing ovm_admin.sh in '/u01/app/oracle/ovm-manager-3/bin' ...
Installing ovm_upgrade.sh in '/u01/app/oracle/ovm-manager-3/bin' ...

Step 7 of 7 : Start OVM Manager ...
Enabling Oracle VM Manager service ... 
Shutting down Oracle VM Manager instance ...
Starting Oracle VM Manager instance ...

Please wait while WebLogic configures the applications...
Oracle VM Manager installed.

When the installation is complete a summary similar to the following is displayed:

Installation Summary
--------------------
Database configuration:
  Database type               : MySQL
  Database host name          : localhost
  Database name               : ovs
  Database listener port      : 49500
  Database user               : ovs

Weblogic Server configuration:
  Administration username     : weblogic

Oracle VM Manager configuration:
  Username                    : admin
  Core management port        : 54321
  UUID                        : 0004fb00000100007c08b684bd203388

Passwords:
There are no default passwords for any users. The passwords to use for Oracle VM Manager, 
Database, and Oracle WebLogic Server have been set by you during this installation. In the 
case of a default install, all passwords are the same.

Oracle VM Manager UI:
  https://hostname:7002/ovm/console
Log in with the user 'admin', and the password you set during the installation.

As of Oracle VM Release 3.4.5, the TLSv1.2 protocol is used for all connections and 
management of 3.2.10/11 servers is not possible by default. TLSv1 protocol must be enabled, 
which is less secure. For instructions, see the Oracle VM 3.4 Installation and Upgrade guide. 

For more information about Oracle Virtualization, please visit:
  http://www.oracle.com/virtualization/

Oracle VM Manager installation complete.

Please remove configuration file /tmp/ovm_configid.

Important

Make sure you delete the temporary configuration file created during the installation:

/tmp/ovm_configid

This file is useful for debugging installation issues, but does contain some sensitive information that may present a security issue if left in place. This file is automatically deleted if you abort an installation.

When you have completed your installation, there are a number of additional steps that you should perform before you start using Oracle VM Manager to manage your deployment. Please see Chapter 7, What Next? to continue configuring your environment.

4.3.3 Installation Logs

If any errors occur during installation, check the Oracle VM Manager installation log file. Usually, this should be found in:

/var/log/ovmm/ovm-manager-3-install-date.log

However, if the installer is unable to create this directory and file for some reason, such as inadequate permissions, the install file is located in:

/tmp/ovm-manager-3-install-date.log

During installation, the installer self-extracts into the /tmp directory, if the installer does not exit properly, you may also find an installation log in this location:

/tmp/ovmm-installer.selfextract_id/ovm-manager-3-install-date.log

4.3.4 Installation Directories

The locations of the Oracle VM Manager components are listed in Table 4.3.

Table 4.3 Oracle VM Manager component installation locations

Component

Location

MySQL

/u01/app/oracle/mysql/data

MySQL Enterprise Backup

/opt/mysql/meb-3.12/

Backups are stored in: /u01/app/oracle/mysql/dbbackup

Java

/u01/app/oracle/java

Oracle WebLogic Server

/u01/app/oracle/Middleware/

Oracle ADF

/u01/app/oracle/Middleware/

Oracle VM Manager application

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

Oracle WebLogic Server domain

/u01/app/oracle/ovm-manager-3/domains/ovm_domain