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”).
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:
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.NoteThe script does not set a password for the
oracleuser as a security measure. Because the user does not have a password, it is not possible to log in as theoracleuser. If you want to allow login access, you must set the password manually.Creates the
/u01directory, if it does not already exist, and sets permissions on required installation folders.NoteThe
/u01directory 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.conffile on a Linux system.Opens the required ports in the
/etc/sysconfig/iptablesfile on a Linux system.
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:
Mount the Oracle VM Manager installation media. See Section 1.3, “Installation From Bootable Physical Media” or Section 1.4, “Loopback ISO Mounts”.
Change directory to the mount point, for example:
# cd /mnt/cdrom
As the root user, run
createOracle.sh# ./createOracle.sh
The createOracle.sh script does not
automatically enable the iptables service.
You should manually confirm that the
iptables service is enabled.
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 nofilesandsoft nofilesminimum of at least 8192, as well as some other security limits set. To set these, edit the/etc/security/limits.conffile 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
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:
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.
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.
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.xInstaller 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.
Make sure you delete the temporary configuration file created during the installation:
/tmp/ovm_config
id
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.
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
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 |
|
MySQL Enterprise Backup |
Backups are stored in:
|
Java |
|
Oracle WebLogic Server |
|
Oracle ADF |
|
Oracle VM Manager application |
|
Oracle WebLogic Server domain |
|