| Oracle® VM Installation and Upgrade Guide Release 3.0 for x86 Part Number E18548-02 |
|
|
PDF · Mobi · ePub |
| Oracle® VM Installation and Upgrade Guide Release 3.0 for x86 Part Number E18548-02 |
|
|
PDF · Mobi · ePub |
This document is intended for users who want to install Oracle VM Manager. This document provides an overview of the Oracle VM Manager installation process, and includes the following sections:
Oracle VM uses an Oracle database as a repository. Oracle VM production deployments require Oracle Database Standard Edition (Oracle SE) or Enterprise Edition (Oracle EE). If you are testing Oracle VM and do not require a supported product, you can use Oracle Database Express Edition (Oracle XE). Oracle XE is not a supported product, and Oracle Support Services cannot supply patches for it. If you require full support from Oracle, you should use Oracle SE or EE as the Oracle VM database repository.
Oracle VM Manager can be installed in a simple installation using Oracle XE, or as a standard installation using Oracle SE or EE. The simple installation installs Oracle XE on the local host and configures it to use as the repository. The standard option collects information on the pre-installed Oracle Database and uses it as the repository. In both install types, Java, the Oracle VM Manager application, and Oracle WebLogic Server are installed on the local host.
An uninstaller is included with the installation script. The uninstaller gives you options to remove Oracle XE, Java, the Oracle VM Manager application, and the Oracle WebLogic Server.
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:
The Oracle VM Manager application provided as a Oracle WebLogic Server domain and container.
Oracle WebLogic Server Release 11g, including Application Development Framework (ADF) Release 11g. For more information about Oracle WebLogic, see the Oracle WebLogic 11g documentation.
Use of Oracle WebLogic Server with Oracle VM Manager is restricted to the servlet functionality without clustering for the Oracle VM Management Server.
In a new installation, Oracle Database 11g Express Edition (Oracle XE) for Linux 64-bit may be installed. If Oracle XE is already installed, the installer asks whether it should use the existing database, install a new one, or use another database in the local area network (LAN). For more information about Oracle XE, see the Oracle Database Express Edition Documentation for 11g Release 2 (11.2).
You should only use the Oracle XE database as the Oracle VM Manager repository in non-production environments. Oracle XE is not a supported product and Oracle Support Services cannot provide bug fixes or patches for this product. If you are deploying Oracle VM Manager in a production environment, you should use Oracle Database Standard or Enterprise Edition, which you must install separately to Oracle VM. Oracle VM Manager includes a restricted-use license of the Oracle Database (Standard Edition or Enterprise Edition) for use as the Oracle VM Manager Management Repository only. The supported version of Oracle Database are:
Oracle Database Release 10.2.0.4 or greater
Oracle Database Release 11.1.0.7 or greater
Oracle Database Release 11.2.0.1 or greater
The following minimum system requirements must be met on the computer on which you want to install Oracle VM Manager:
Before you install Oracle VM Manager, make sure that your computer meets the minimum hardware requirements listed in Table 3-1:
Before you install Oracle VM Manager, make sure that your computer meets the following minimum software and configuration requirements:
Oracle VM Manager is supported on the following operating systems:
Oracle Linux 5 Update 5 64-bit or later
Oracle Linux 6 64-bit or later
You can download Oracle Linux from:
https://edelivery.oracle.com/linux
Note:
For more information about Oracle Linux, see:http://www.oracle.com/technetwork/topics/linux/whatsnew/index.html
The host computer on which you install Oracle VM Manager must have the host name correctly configured (pingable). 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 a text editor to check the host name in the /etc/hosts file. For example, to use VI enter
# vi /etc/hosts
For example, if the computer's host name is hostname1.example.com, and the IP address is 10.1.1.1, the corresponding item in the /etc/hosts file should be:
10.1.1.1 hostname1.example.com hostname1
The Oracle VM Manager user interface is supported in the following Web browsers:
Microsoft Internet Explorer 9.0 and above
Mozilla Firefox 3.5 and above
Apple Safari 5.0 and above
Google Chrome 1.0 and above
This section contains the prerequisite operating system packages that may be required prior to installing Oracle VM Manager and contains:
If you select during the Oracle VM Manager installation to use Oracle Database 11g Express Edition (Oracle XE) as the management data repository, you must install the libaio package. You must install libaio release 0.3.104 or above.
If your computer is configured with Oracle Unbreakable Linux Network (ULN) you can run either of the following commands to update or install libaio, whichever is appropriate for your system:
# yum install libaio
or
# up2date libaio
You can also find the libaio package on the Oracle Linux DVD or ISO file. To install libaio, go to the directory where the libaio.rpm is located, and enter the command:
# rpm -ivh libaio-version.rpm
To upgrade libaio, you can use the command:
# rpm -Uvh libaio-version.rpm
If you have a minimal installation of Oracle Linux, you may not have unzip installed, which is a required package for the Oracle VM Manager installer. To install unzip, enter:
# yum install unzip
A default Oracle Linux install has the firewall enabled (iptables on). In order to use Oracle VM Manager on a system with iptables enabled you can either open all the ports used by Oracle VM Manager, or open all ports by disabling iptables.
To disable iptables and open all ports, enter the following commands as the root user:
# service iptables stop # chkconfig iptables off
Alternatively, open the required ports by using the iptables command as the root user:
# iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 1521 -j ACCEPT # iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 8080 -j ACCEPT # iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 7001 -j ACCEPT # iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 7002 -j ACCEPT # iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 15901 -j ACCEPT # iptables -A INPUT -m state --state NEW -m udp -p udp --dport 123 -j ACCEPT
To remotely connect to the Oracle VM Manager core API, also enter the following command:
# iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 54321 -j ACCEPT
When all the ports have been opened, save the iptables configuration:
# service iptables save
This does not require iptables to be restarted as the commands open the ports while iptables is running and the save ensures they are opened on reboot/restart in future.
To configure the firewall to open the required ports automatically, use the environment configuration script provided with the Oracle VM Manager installer. See Section 3.3.2.9, "Environment Configuration Script" for information on using this script.
During the Oracle VM Manager installation, you may be required to set the following ports and passwords:
The Oracle XE HTTP port. The default port number is 8080.
The Oracle XE listening port. The default port number is 1521.
The password for the Oracle XE SYS and SYSTEM accounts. You cannot use special characters for this password. Use only alpha numeric characters.
The password for the Oracle VM Manager OVS database schema.
The password for the Oracle WebLogic admin account.
The password you use for the Oracle WebLogic admin account must conform to the following rules:
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.
You must have an oracle user that is a member of a group named dba. If an 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
To configure the oracle user automatically, use the environment configuration script provided with the Oracle VM Manager installer. See Section 3.3.2.9, "Environment Configuration Script" for information on using this script.
Oracle VM Manager and supporting products are installed into the /u01/app/oracle directory. Before you begin the Oracle VM Manager installation, make sure a /u01 directory exists, and it has at least 2.4 GB of space available.
To create the /u01 directory automatically, use the environment configuration script provided with the Oracle VM Manager installer. See Section 3.3.2.9, "Environment Configuration Script" for information on using this script.
The createOracle.sh is a script that automatically:
Creates the operating system dba group
Creates the oracle user and adds it to the dba group
Creates the /u01 directory
Sets the required parameters in the /etc/security/limits.conf file
Opens the required ports in the /etc/sysconfig/iptables file
To run the createOracle.sh script, you must first mount the Oracle VM Manager installer ISO file or CD. See Section 3.4.1, "Mounting the Oracle VM Manager Installer Media" for information on mounting the installation media. Then enter the following command as the root user:
# ./createOracle.sh
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 can being the install, download the Oracle VM Manager software from:
http://edelivery.oracle.com/oraclevm
This section describes the Oracle VM Manager installation process. It includes the following sections:
Note:
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 virtual machine running on an Oracle VM Server.Before you can run the Oracle VM Manager installer, you must mount the installation media. You can either burn the installation media to a CD and mount the CD, or mount the ISO file directly from the hard drive. Which ever way you choose to mount the installation media, you should perform this as the root user on the computer on which you want to install Oracle VM Manager.
To install Oracle VM Manager from a CD, burn the Oracle VM Manager ISO file to a CD. Insert and mount the Oracle VM Manager CD using the following commands:
# mkdir mount-point # mount /dev/cdrom mount-point
Where mount-point refers to the directory on which you mount the ISO file.
To install Oracle VM Manager from a hard drive, locate the folder that contains the ISO file. Mount the ISO file to an existing directory using the following commands:
# mkdir mount-point # mount -o loop OracleVM-Manager-version.iso mount-point
Where mount-point refers to the directory on which you mount the ISO file. For example:
# mkdir /OVMCD
# mount -o loop OracleVM-Manager-3.0.x.iso /OVMCD
You can find all the mounted files under the directory /OVMCD.
Note:
The location of the mounted Oracle VM Manager ISO file should be accessible by the oracle user.To install Oracle VM Manager, enter the mount point you created in Section 3.4.1, "Mounting the Oracle VM Manager Installer Media", for example, /OVMCD and start the installation with the runInstaller script:
# cd /OVMCD # ./runInstaller.sh
A set of installer options are displayed:
Please select an installation type: 1: Simple 2: Standard 3: Uninstall 4: Help
At the command prompt, enter 1 (a simple install) or 2 (a standard install) to install Oracle VM Manager. If you already have Oracle VM Manager installed and want to uninstall it, select 3 (uninstall).
See Section 3.4.2.1, "Simple Install" for information on installing Oracle VM Manager and Oracle XE database, using the same password for all components. This should only be used in non-production environments. Oracle XE is not a supported product and Oracle Support Services cannot provide bug fixes or patches for this product.
See Section 3.4.2.2, "Standard Install" for information on installing Oracle VM Manager as a standard installation. This is the preferred installation type, with options for selecting Oracle SE or EE database as the location for the Oracle VM Manager repository, as well as setting individual passwords for each component.
See Section 3.10, "Uninstalling Oracle VM Manager" for information on uninstalling Oracle VM Manager, and its components such as Oracle XE (if applicable), Oracle WebLogic Server, ADF and Java.
You can also perform a silent install using the installer script optional parameters. See "Oracle VM Manager Installer Script Options" at the end of this chapter for the full syntax to the installation script and how to perform a silent install.
The following sections walk through the following simple and standard install options:
The simple installation installs Oracle Database XE, Oracle WebLogic Server, Oracle Application Development Framework (ADF), Java, and Oracle VM Manager on the local system. Use this installation option for testing and non-production environments; do not use this installation option in production environments. Oracle XE is not a supported product and Oracle Support Services cannot provide bug fixes or patches for this product. The following example install shows a simple installation, and sample configuration options.
Example 3-1 Simple installation
# ./runInstaller.sh Oracle VM Manager Release 3.0.x Installer Oracle VM Manager Installer log file: /tmp/ovmm-installer.selfextract_id/install-date.log Please select an installation type: 1: Simple 2: Standard 3: Uninstall 4: Help Select Number (1-4): 1
The installation process starts, and the following is displayed:
Starting simple installation ... Verifying installation prerequisites ...
Enter a password to use for all users created during the simple installation. Password requirements are outlined in Section 3.3.2.6, "Installation Ports and Passwords".
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): Verifying configuration ...
You have the option to continue or abort the installation. Enter 1 to continue.
Start installing the configured components: 1: Continue 2: Abort Select Number (1-2): 1 Retrieving Oracle Database 11g XE ... Installing Oracle Database 11g XE ... Configuring Oracle Database 11g XE ... Installing Java ... Creating database schema 'ovs' ... Retrieving Oracle WebLogic Server 11g ... Installing Oracle WebLogic Server 11g ... Retrieving Oracle Application Development Framework (ADF) ... Unzipping Oracle ADF ... Installing Oracle ADF ... Retrieving Oracle VM Manager Application ... Extracting Oracle VM Manager Application ... Installing Oracle VM Manager Core ... Creating Oracle WebLogic Server domain ... Starting Oracle WebLogic Server 11g ... Configuring data source 'OVMDS' ... Creating Oracle VM Manager user 'admin' ... Deploying Oracle VM Manager Core container ... Deploying Oracle VM Manager UI Console ... Deploying Oracle VM Manager Help ... Enabling HTTPS ... Granting ovm-admin role to user 'admin' ... Retrieving Oracle VM Manager Shell & API ... Extracting Oracle VM Manager Shell & API ... Installing Oracle VM Manager Shell & API ... Copying Oracle VM Manager shell to '/usr/bin/ovm_shell.sh' ... Enabling Oracle VM Manager service ...
When the installation is complete a message similar to the following is displayed:
Oracle VM Manager installed. Installation Summary -------------------- Database configuration: Database host name : localhost Database instance name (SID): XE Database listener port : 1521 Application Express port : 8080 Oracle VM Manager schema : ovs Weblogic Server configuration: Administration username : weblogic Oracle VM Manager configuration: Username : admin Core management port : 54321 UUID : 0004fb00000100007c8d58c83316de89 Passwords: There are no default passwords for any users. The passwords to use for Oracle VM Manager, Oracle Database 11g XE, and Oracle WebLogic Server have been set by you during this installation. In the case of a simple install, all passwords are the same. Oracle VM Manager UI: http://example.com:7001/ovm/console https://example.com:7002/ovm/console Log in with the user 'admin', and the password you set during the installation. Please note that you need to install tight-vnc on this computer to access a virtual machine's console. For more information about Oracle Virtualization, please visit: http://www.oracle.com/virtualization/ Oracle VM Manager installation complete.
The standard installation lets you choose whether to install Oracle Database XE on the local system, or connect to an existing local or remote Oracle database. You set the users and passwords to use for the Oracle Database, Oracle VM Manager database, Oracle WebLogic Server, and Oracle VM Manager during the standard installation. This is the preferred installation method. Use this installation option and select an existing local or remote Oracle SE or EE database in production environments; do not use an Oracle XE database in a production environment. The following example describes how to connect to an existing local Oracle XE database.
Example 3-2 Standard installation with local Oracle XE database
# ./runInstaller.sh Oracle VM Manager Release 3.0.x Installer Oracle VM Manager Installer log file: /tmp/ovmm-installer.selfextract_id/install-date.log Please select an installation type: 1: Simple 2: Standard 3: Uninstall 4: Help Select Number (1-4): 2
The installation process starts, and the following is displayed:
Starting standard installation ... Verifying installation prerequisites ...
The following options are displayed. Enter 2 to connect to an existing database on the local system
Oracle Database Repository ========================== Would you like to install Oracle Database 11g Express Edition (XE) or connect to an existing Oracle database? 1: Install Oracle Database 11g XE 2: Use an existing Oracle database Select Number (1-2): 2
When prompted, enter the following information as outlined in section Section 3.3.2.6, "Installation Ports and Passwords":
Enter the Oracle Database hostname [localhost]: example.com Enter the Oracle Database System ID (SID) [XE]: Enter the Oracle Database SYSTEM password: Enter the Oracle Database listener port [1521]: Enter the Oracle VM Manager database schema [ovs]: Enter the Oracle VM Manager database schema password: Enter the Oracle VM Manager database schema password (confirm): Oracle Weblogic Server 11g ========================== Enter the Oracle WebLogic Server 11g user [weblogic]: Enter the Oracle WebLogic Server 11g user password: Enter the Oracle WebLogic Server 11g user password (confirm): Oracle VM Manager application ============================= Enter the username for the Oracle VM Manager administration user [admin]: Enter the admin user password: Enter the admin user password (confirm): Verifying configuration ...
You have the option to continue or abort the installation. Enter 1 to continue.
Start installing the configured components: 1: Continue 2: Abort Select Number (1-2): 1 Installing Java ... Creating database schema 'ovs' ... Retrieving Oracle WebLogic Server 11g ... Installing Oracle WebLogic Server 11g ... Retrieving Oracle Application Development Framework (ADF) ... Unzipping Oracle ADF ... Installing Oracle ADF ... Retrieving Oracle VM Manager Application ... Extracting Oracle VM Manager Application ... Installing Oracle VM Manager Core ... Creating Oracle WebLogic Server domain ... Starting Oracle WebLogic Server 11g ... Configuring data source 'OVMDS' ... Creating Oracle VM Manager user 'admin' ... Deploying Oracle VM Manager Core container ... Deploying Oracle VM Manager UI Console ... Deploying Oracle VM Manager Help ... Enabling HTTPS ... Granting ovm-admin role to user 'admin' ... Retrieving Oracle VM Manager Shell & API ... Extracting Oracle VM Manager Shell & API ... Installing Oracle VM Manager Shell & API ... Copying Oracle VM Manager shell to '/usr/bin/ovm_shell.sh' ... Enabling Oracle VM Manager service ... Installation Summary -------------------- Database configuration: Database host name : example.com Database instance name (SID): XE Database listener port : 1521 Application Express port : None Oracle VM Manager schema : ovs Weblogic Server configuration: Administration username : weblogic Oracle VM Manager configuration: Username : admin Core management port : 54321 UUID : 0004fb0000010000655d18309c21368c Passwords: There are no default passwords for any users. The passwords to use for Oracle VM Manager, Oracle Database 11g XE, and Oracle WebLogic Server have been set by you during this installation. In the case of a simple install, all passwords are the same. Oracle VM Manager UI: http://example.com:7001/ovm/console https://example.com:7002/ovm/console Log in with the user 'admin', and the password you set during the installation. Please note that you need to install tight-vnc on this computer to access a virtual machine's console. For more information about Oracle Virtualization, please visit: http://www.oracle.com/virtualization/ Oracle VM Manager installation complete.
The standard installation lets you choose whether to install Oracle Database XE on the local system, or connect to an existing local or remote Oracle database. You set the users and passwords to use for the Oracle Database, Oracle VM Manager database, Oracle WebLogic Server, and Oracle VM Manager during the standard installation. This is the preferred installation method. Use this installation option and select an existing local or remote Oracle SE or EE database in production environments. The following example describes how to install Oracle VM Manager using a remote Oracle database.
Example 3-3 Standard Installation with remote Oracle database
# ./runInstaller.sh Oracle VM Manager Release 3.0.x Installer Oracle VM Manager Installer log file: /tmp/ovmm-installer.selfextract_id/install-date.log Please select an installation type: 1: Simple 2: Standard 3: Uninstall 4: Help Select Number (1-4): 2
The installation process starts, and the following is displayed:
Starting standard installation ... Verifying installation prerequisites ...
The following menu appears. Enter 2 to install using a remote Oracle database.
Oracle Database Repository ========================== Would you like to install Oracle Database 11g Express Edition (XE) or connect to an existing Oracle database? 1: Install Oracle Database 11g XE 2: Use an existing Oracle database Select Number (1-2): 2
When prompted, enter the following information as outlined in Section 3.3.2.6, "Installation Ports and Passwords":
Enter the Oracle Database hostname [localhost]: example.com
Enter the Oracle Database System ID (SID) [XE]: mySID
Enter the Oracle Database SYSTEM password:
Enter the Oracle Database listener port [1521]:
Enter the Oracle VM Manager database schema [ovs]:
Enter the Oracle VM Manager database schema password:
Enter the Oracle VM Manager database schema password (confirm):
Oracle Weblogic Server 11g
==========================
Enter the Oracle WebLogic Server 11g user [weblogic]:
Enter the Oracle WebLogic Server 11g user password:
Enter the Oracle WebLogic Server 11g user password (confirm):
Oracle VM Manager application
=============================
Enter the username for the Oracle VM Manager administration user [admin]:
Enter the admin user password:
Enter the admin user password (confirm):
Verifying configuration ...
Start installing the configured components:
1: Continue
2: Abort
Select Number (1-2): 1
Installing Java ...
Creating database schema 'ovs' ...
Retrieving Oracle WebLogic Server 11g ...
Installing Oracle WebLogic Server 11g ...
Retrieving Oracle Application Development Framework (ADF) ...
Unzipping Oracle ADF ...
Installing Oracle ADF ...
Retrieving Oracle VM Manager Application ...
Extracting Oracle VM Manager Application ...
Installing Oracle VM Manager Core ...
Creating Oracle WebLogic Server domain ...
Starting Oracle WebLogic Server 11g ...
Configuring data source 'OVMDS' ...
Creating Oracle VM Manager user 'admin' ...
Deploying Oracle VM Manager Core container ...
Deploying Oracle VM Manager UI Console ...
Deploying Oracle VM Manager Help ...
Enabling HTTPS ...
Granting ovm-admin role to user 'admin' ...
Retrieving Oracle VM Manager Shell & API ...
Extracting Oracle VM Manager Shell & API ...
Installing Oracle VM Manager Shell & API ...
Copying Oracle VM Manager shell to '/usr/bin/ovm_shell.sh' ...
Enabling Oracle VM Manager service ...
Oracle VM Manager installed.
Installation Summary
--------------------
Database configuration:
Database host name : example.com
Database instance name (SID): mySID
Database listener port : 1521
Application Express port : 8080
Oracle VM Manager schema : ovs
Weblogic Server configuration:
Administration username : weblogic
Oracle VM Manager configuration:
Username : admin
Core management port : 54321
UUID : 0004fb0000010000bc57bd993848e78b
Passwords:
There are no default passwords for any users. The passwords to use for Oracle VM
Manager, Oracle Database 11g XE, 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:
http://example.com:7001/ovm/console
https://example.com:7002/ovm/console
Log in with the user 'admin', and the password you set during the installation.
Please note that you need to install tight-vnc on this computer to access a
virtual machine's console.
For more information about Oracle Virtualization, please visit:
http://www.oracle.com/virtualization/
Oracle VM Manager installation complete.
The Oracle VM Manager installer can be installed silently, without any intervention. An installation configuration script can be used to provide the installation options, and a set of command line options are available for the installation parameters. See "Oracle VM Manager Installer Script Options" at the end of this chapter for information on the command line options.
The following example performs a standard, silent install.
Example 3-4 Silent install using configuration file
The command to run the silent standard installation using a configuration is:
./runInstaller.sh --config=/path/config.yml --installtype=standard --assumeyes
The configuration file used in this installation example (config.yml) installs a local Oracle XE database. Replace the password entry with your own password.
db:
install : Yes
host : localhost
sys_password : password
port : 1521
sid : XE
mgmt_port : 8080
user : ovs
password : password
webLogic:
install : Yes
user : weblogic
password : password
java:
install : Yes
ADF:
install : Yes
OVMCore:
install : Yes
user : admin
password : password
OVMConsole:
install : Yes
OVMShell:
install : Yes
onFailure:
cleanup : No
OVMUpgrade:
install : Yes
Oracle VM Manager uses a secure tunnel to protect the virtual machine console (remote connection utility) data across the network. Oracle VM Manager does not communicate directly with the VNC client, but rather connects via an SSH-encrypted tunnel on port 69xx (where xx is based on the guest to which it is connecting).
Any firewall between the client and Oracle VM Manager needs port 15901 to be open. Any firewall between the Oracle VM Manager and the Oracle VM Servers needs ports 6900 to 6xxx open; one port for each virtual machine on an Oracle VM Server. For example, if you have 100 virtual machines on an Oracle VM Server, you should open ports 6900-6999 (100 ports) on your firewall.
To connect to a virtual machine's console in Oracle VM Manager, you should have a VNC viewer installed somewhere in your environment, either:
On the Oracle VM Manager host computer
On the client computer
On both the Oracle VM Manager host computer and the client computer
The virtual machine console feature uses the client instance of a VNC viewer, if one exists, to connect to a virtual machine's console. If a VNC viewer is not found on the client computer, a request is sent to the Oracle VM Manager host computer to display the VNC viewer.
You can install either TightVNC or RealVNC on the Oracle VM Manager host computer. You can get the latest TightVNC package from:
http://oss.oracle.com/oraclevm/manager/RPMS/
Install TightVNC with the command:
# rpm -ivh tightvnc-java-version.noarch.rpm
You should install TightVNC or RealVNC on the client computer you use to connect to Oracle VM Manager. Oracle recommends you install RealVNC on the client computer as it renders more quickly, and has less mouse control issues than TightVNC.
If you are using a Linux-based operating system on your client computer, you can also install TightVNC as above on your client computer and it is automatically discovered when you connect to a virtual machine using the console feature in Oracle VM Manager.
If any errors occur during installation, check the Oracle VM Manager installation log file:
/tmp/ovmm-installer.selfextract_id/install-date.log
When the installation is complete, the installation log is copied to:
/tmp/install-date.log
The locations of the Oracle VM Manager components are listed in Table 3-2.
Table 3-2 Oracle VM Manager component installation locations
| Component | Location |
|---|---|
|
Java |
/u01/app/oracle/java |
|
Oracle WebLogic Server 11g |
/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/machine1/base_adf_domain |
To open the Login page of Oracle VM Manager, enter the following address in a Web browser:
http[s]://hostname:port/ovm/console
Where, hostname refers to the host name or IP address of the Oracle VM Manager host, and port refers to the port number on which Oracle VM Manager is listening.
To connect to Oracle VM Manager using Secure Sockets Layer (SSL) on a host named example.com, use:
https://example.com:7002/ovm/console
To connect to Oracle VM Manager on a host named example.com, use:
http://example.com:7001/ovm/console
Enter your Oracle VM Manager administration username in the Username field. This is the administration username you create during the Oracle VM Manager install. Enter the password for the Oracle VM Manager administration username in the Password field.
To manage the local instance of Oracle VM Manager (installed on localhost), leave the Management Server URI field as the default, tcp://localhost. If you want to manage a remote instance of Oracle VM Manager, enter the hostname or IP address for that machine, for example:
tcp://example.com
Now you are logged in, you can create storage repositories, server pools, add Oracle VM Servers, and create virtual machines, import resources, and so on.
The user interface displays context sensitive information, relevant to the selection in the navigator and content panes.
When Oracle VM Manager is installed, it is set to automatically start when the operating system starts. If you want to disable this, enter:
# chkconfig --del ovmm
Note:
If you chose to start Oracle XE manually during the installation, start Oracle XE before you start Oracle VM Manager.To manually start or stop Oracle VM Manager, as the root user, use the syntax:
/sbin/service ovmm [start|stop|status]
For example, to start Oracle VM Manager:
# /sbin/service ovmm start
# /sbin/service ovmm stop
To check the status of Oracle VM Manager:
# /sbin/service ovmm status
The status option returns either a 0 or a 1. A 0 denotes the Oracle VM Manager application is running, and a 1 denotes the application is stopped.
You can also use the Services dialog to start and stop Oracle VM Manager. 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 ovmm to check the status, and start or stop it.
The Oracle VM Manager admin user is used to log in to the Oracle VM Manager user interface. To change the password for the Oracle VM Manager admin user account, log in to the Oracle VM Manager host computer as the root user and perform the following:
# cd /u01/app/oracle/ovm-manager-3/bin #./ovm_admin --modifyuser admin password new_password
Where password is the current password for the admin user and new_password is the new password you want to use. The Oracle VM Manager administration tool starts.
Oracle VM Manager Release 3.0.x Admin tool
Please enter the password for weblogic :
Enter the Oracle WebLogic password. You set this during the installation of Oracle VM Manager. The utility connects to Oracle WebLogic and changes the Oracle VM Manager admin password.
Initializing WebLogic Scripting Tool (WLST) ... Welcome to WebLogic Server Administration Scripting Shell Type help() for help on available commands Connecting to WebLogic server ... Connecting to t3://localhost:7001 with userid weblogic ... Successfully connected to Admin Server 'AdminServer' that belongs to domain 'base_adf_domain'. Warning: An insecure protocol was used to connect to the server. To ensure on-the-wire security, the SSL port or Admin port should be used instead. Connected ... Modifying user 'admin' ... Modified user 'admin' successfully ... Disconnected from weblogic server: AdminServer Exiting... Exiting WebLogic Scripting Tool.
To back up Oracle VM Manager, you should back up the Oracle VM Manager configuration file, and the Oracle VM Manager database schema. By default, this schema is named OVS, and this is used in the back up example. Replace the schema name with your own.
The Oracle VM Manager configuration file is stored in the location:
/u01/app/oracle/ovm-manager-3/.config
This configuration file contains database connection information, ports and the UUID used by Oracle VM Manager. An example of this configuration file follows:
Example 3-5 Oracle VM Manager configuration file
DBHOST=<hostname of database server> SID=<oracle SID> LSNR=<listener port number defaults 1521> APEX=<application express port number defaults 8080> OVSSCHEMA=<database schema name for oracle vm manager defaults ovs> WLSADMIN=<weblogic server admin defaults weblogic> OVSADMIN=<oracle vm manager administrator name defaults admin> COREPORT=<oracle vm manager core port defaults 54321> UUID=<oracle vm manager uuid>
To back up Oracle VM Manager:
Back up/copy the Oracle VM Manager configuration file located at
/u01/app/oracle/ovm-manager-3/.config
As the root user, shut down Oracle VM Manager:
# /sbin/service ovmm stop
Back up the Oracle VM Manager database OVS schema. Run the Oracle Database EXP utility to export the OVS schema. The following example shows how to run this utility on the local install of Oracle XE. If you are using an Oracle Standard or Enterprise Edition on the local host, or on a remote computer, you should consult your Oracle Database documentation for the appropriate method for your environment.
Log into the operating system as the oracle user. You can su - oracle as the root user if you do not have the password for the oracle user.
Run the following commands:
export ORACLE_HOME=/u01/app/oracle/product/11.2.0/xe export PATH=$ORACLE_HOME/bin:$PATH export ORACLE_SID=XE exp ovsschema/password grants=y compress=y file=/location/ovsbackup.dmp
The ovschema user in the exp command should be replaced with the name of your OVS schema; the default schema name in an Oracle XE install is ovs. Store the Oracle VM Manager database schema backup along with the Oracle VM Manager configuration file.
To restore Oracle VM Manager, and the Oracle VM Manager database schema from a backup, you must have performed the steps to back up Oracle VM Manager in Section 3.8, "Backing Up Oracle VM Manager".
To restore Oracle VM Manager from a backup:
Restore the Oracle VM Manager OVS database schema. Log into the Oracle Database to perform the following steps to restore the OVS schema from backup. Log into the Oracle Database as the sys or system user to create the Oracle VM Manager administration user:
$ sqlplus system/password SQL> create user ovs identified by password; SQL> grant connect, resource to ovs; SQL> exit;
Import the OVS schema from the backup file:
# export ORACLE_HOME=/u01/app/oracle/product/11.2.0/xe # export PATH=$ORACLE_HOME/bin:$PATH # export ORACLE_SID=XE # imp ovsschema/password file=/location/ovsbackup.dmp full=y
The ovschema user in the imp command should be replaced with the name of your OVS schema; the default schema name in an Oracle XE install is ovs.
If you need to reinstall Oracle VM Manager, use the Oracle VM Manager installation media to perform an install of the software on your server. See Section 3.4, "Installing Oracle VM Manager" for information on how to perform the installation.
You should perform the install using the runInstaller.sh --uuid uuid option and provide the UUID from the previous manager installation. The uuid can be located in the Oracle VM Manager configuration file. For example,
# ./runInstaller.sh --uuid 0004FB000000100002CB7F2DFFA8D8
When the Oracle VM Manager installer prompts for installation information other than passwords, reuse the same usernames for the Oracle Database schema, Oracle WebLogic Server and Oracle VM Manager administration user, as set out in the back up of the Oracle VM Manager configuration file. You must set new passwords as the passwords are not backed up and cannot be restored.
If you do not need to reinstall Oracle VM Manager, restart Oracle VM Manager:
# /sbin/service ovmm stop # /sbin/service ovmm start
Before uninstalling Oracle VM Manager, you may want to back up Oracle VM Manager and the Oracle VM Manager database schema. For information on how to back up Oracle VM Manager, see Section 3.8, "Backing Up Oracle VM Manager".
You perform the uninstall using the Oracle VM Manager installation script. You must start the installer from the installation media; you cannot perform an uninstall without the installation media as there is no installer located on the Oracle VM Manager host computer. See Section 3.4.2, "Running the Oracle VM Manager Installer" for information on starting the installer. Follow the prompts to uninstall Oracle VM Manager. See "Oracle VM Manager Installer Script Options" at the end of this chapter for the full syntax to the installation script.
An example follows which shows an uninstall of a default Oracle VM Manager installation using a local Oracle XE database.
Example 3-6 Uninstall Oracle VM Manager
# ./runInstaller.sh Oracle VM Manager Release 3.0.x Installer Oracle VM Manager Installer log file: /tmp/ovmm-installer.selfextract_id/install-date.log Please select an installation type: 1: Simple 2: Standard 3: Uninstall 4: Help Select Number (1-4): 3
The uninstallation process starts, and the following is displayed:
Uninstall Oracle VM Manager Product component : Oracle 11g XE in '/u01/app/oracle/product' Oracle 11g XE is installed ... Uninstall options 1: Uninstall Oracle 11g XE 2: Skip uninstall of Oracle 11g XE Select Number (1-2): 1 Removing Oracle 11g XE installation ... Product component : Java in '/u01/app/oracle/java/' Java is installed ... Uninstall options 1: Uninstall Java 2: Skip uninstall of Java Select Number (1-2): 1 Removing Java installation ... Product component : Oracle VM Manager 3.0 in '/u01/app/oracle/ovm-manager-3/' Oracle VM 3.0 Manager is installed ... Uninstall options 1: Uninstall Oracle VM 3.0 Manager 2: Skip uninstall of Oracle VM 3.0 Manager Select Number (1-2): 1 Removing Oracle VM 3.0 Manager installation ... Product component : Oracle WebLogic Server in '/u01/app/oracle/Middleware/' Oracle WebLogic Server is installed Uninstall options 1: Uninstall Oracle WebLogic Server 2: Skip uninstall of Oracle WebLogic Server Select Number (1-2): 1 Removing Oracle WebLogic Server installation ... Uninstall completed ...
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:
Oracle MetaLink:
Oracle Technology Network virtualization forum:
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.
The known installation issues are:
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.4, "Prerequisite Packages".
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.
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. See Section 3.3.2.2, "Network" to configure the host name.
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:
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.
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
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
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:
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.
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.
The syntax for the Oracle VM Manager installer script is:
runInstaller.sh [-h | --help] [-e | --extract_only] [{-d | --dir=}directory] [{-c | --config=}configfile.yml] [{-u | --uuid=}uuid] [{-i | --installtype=}{simple | standard | uninstall}] [-y | --assumeyes]
Displays the installer help.
Extracts the installer and exits.
Looks for all Oracle VM Manager installer scripts in the directory.
Specifies an install configuration file. This file is used to set install options in a silent install.
# ./runInstaller.sh --config=/path/myconfig.yml --installtype=standard --assumeyes
The install configuration file should be in the format shown in Example 3-7. You should uses spaces and not tabs when formatting this configuration file.
Example 3-7 Oracle VM Manager install configuration file
db:
install : No
host : example.com
sys_password : mypassword
port : 1521
sid : mySID
mgmt_port : 8080
user : ovs
password : mypassword
webLogic:
install : Yes
user : weblogic
password : mypassword
java:
install : Yes
ADF:
install : Yes
OVMCore:
install : Yes
user : myuser
password : mypassword
OVMConsole:
install : Yes
OVMShell:
install : Yes
onFailure:
cleanup : No
OVMUpgrade:
install : Yes
Sets the UUID for Oracle VM Manager. Use this option when recovering an Oracle VM Manager instance to use the existing UUID. The Oracle VM Manager configuration file contains the UUID and is stored in the location:
/u01/app/oracle/ovm-manager-3/.config
# ./runInstaller.sh --uuid=0004FB000000100002CB7F2DFFA8D8
Sets the install type to use without being prompted during the install. Use this option during a silent install.
# ./runInstaller.sh --config=/path/myconfig.yml --installtype=standard --assumeyes
Sets each prompt during the install to respond as yes. If combined with the --installtype=simple option, performs a silent install with the default settings, using a local Oracle XE database.
# ./runInstaller.sh --assumeyes --installtype=simple
|
 Copyright © 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|