Oracle VM Manager Installation

...Oracle VM Manager Simple Uninstallation
Oracle VM Manager Custom Installation

...Oracle VM Manager Custom Uninstallation

...Oracle VM Manager Production Uninstallation

...Oracle VM Manager Demo Uninstallation
Oracle VM Manager Post Installation Checklist
...Enable the Virtual Machine VNC Console
...Download and Install the Oracle VM Manager Utilities
...VMPinfo3 Installation for Diagnostic Capture & Troubleshooting

...Patch Oracle VM Manager
Oracle VM Manager Log Files and Log File Analysis
Restore Oracle VM Manager

Oracle VM Manager Configuration File Backup
Oracle VM Manager Database Repository Backup Options
...Oracle 11g Standard or Enterprise Edition Database Repository Backup
...Oracle 11g Express Database Repository Backup

• Major release numbers: 2.1, 2.2, 3.0, 3.1 and 3.2
• Minor release numbers: 2.1.x, 2.2.x and 3.0.x

• Oracle VM 3.0.3 was released on Janurary 20th 2012. Oracle VM 3.0.3 includes numerious bug fixes along with several new features.

• Oracle VM 3.1.1 was released on May 8th 2012. Oracle VM 3.1.1 includes numerious bug fixes along with several new features.

• Oracle VM 3.2.1 was released on Janurary 18th 2013. Oracle VM 3.2.1 includes numerious bug fixes along with several new features.

• Oracle VM 3.2.2 was released on March 18th 2013. Oracle VM 3.2.2 includes numerious bug fixes.

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.

Table 5 shows the default ports used by Oracle VM Manager.

From the Oracle VM Server 3.x Media Pack for x86 (64 bit) download page, click the desired Oracle VM Manager Revision Download button to download the Oracle VM media pack.

 

 

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.

 

Note: Starting with Oracle Database 11g Release 2 (11.2), Security Enhanced Linux is supported for Oracle Linux 4, Red Hat Enterprise Linux 4, Oracle Linux 5, and Red Hat Enterprise Linux 5.

 

 

Security Enhanced Linux can be temporarily disabled by typing "echo 0 > /selinux/enforce", as root. Security Enhanced Linux can be re-enabled by typing "echo 1 > /selinux/enforce", as root.

 

Security Enhanced Linux can be permanently disabled by changing the "SELINUX=enforcing" entry to "SELINUX=disabled" in the "/etc/selinux/config" file. Security Enhanced Linux can be re-enabled by changing the "SELINUX=disabled" entry to "SELINUX=enforcing" in the "/etc/selinux/config" file. A re-boot is required after changing the "SELINUX=” value to enable to new settings.

 

Step 1	Step 2	Step 3	Step 4
Download the Oracle VM Manager Installation Media	Oracle VM Manager Prerequisites	Install Oracle VM Manager	Oracle VM Manager Post Installation Checklist

Tip: The default firewall used by an Oracle Linux 5U5 and above Oracle VM Manager host is iptables. In order to use Oracle VM Manager, the Core API and the Oracle Management Agent with iptables enabled, it is necessary to open tcp ports 7001, 7002, tcp-54321 or tcps-54322, 15901 and 3872 as well as UDP 123.

To open the necessary ports in iptables, as root edit the /etc/sysconfig/iptables file and ensure that the following iptables rules are present.

 

# vi /etc/sysconfig/iptables
*filter
:INPUT ACCEPT [0:0]
:FORWARD ACCEPT [0:0]
:OUTPUT ACCEPT [0:0]
-A INPUT -m state --state NEW -m tcp -p tcp --dport 7001 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 7002 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 15901 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 54322 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 3872 -j ACCEPT

-A INPUT -m state --state NEW -m tcp -p udp --dport 123 -j ACCEPT
COMMIT
:wq!

Next, restart iptables, by typing the following command:
# /etc/init.d/iptables restart

If you experience connection challenges, a troubleshooting first step is to “temporarily” disable iptables.

To disable iptables, as root, type the following command:
# /etc/init.d/iptables stop && chkconfig iptables off
To re-enable iptables, as root, type the following command:
# chkconfig iptables on && /etc/init.d/iptables start

 

Step 1	Step 2	Step 3	Step 4
Download the Oracle VM Manager Installation Media	Oracle VM Manager Prerequisites	Oracle VM Manager Custom Installation (Oracle VM 3.2 and Above)	Oracle VM Manager Post Installation Checklist

 

During the Oracle VM Manager installation, the installation program asks for the following passwords:
The Oracle VM Manager OVS Database schema password must be selected.
The password must be a minimum of 8 characters in length.
The password cannot be the same as the username.
The password cannot be the same length as the username.
The password cannot be the username spelled backwards.
The password cannot be the same as the server name or the server name with digits from 1 to 100 appended.
The password must include 1 digit and 1 alpha character.
Simple passwords will be rejected.

The Oracle 11g SE and EE Database SYSTEM password must be selected.
The password must be a minimum of 8 characters in length.
The password cannot be the same as the username.
The password cannot be the same length as the username.
The password cannot be the username spelled backwards.
The password cannot be the same as the server name or the server name with digits from 1 to 100 appended.
The password must include one digit and one alpha character.
Simple passwords will be rejected.

The Oracle WebLogic admin account password must be selected.
The password must be between 8 and 16 characters in length
The password must have at least 1 lower case and 1 upper case letter
The password must have at least 1 numeric value or special character
    
The Oracle VM Manager admin account must be selected.
The password must be between 8 and 16 characters in length
The password must have at least 1 lower case and 1 upper case letter
The password must have at least 1 numeric value or special character

Each service has a slightly different password policy. Select your passwords carefully to avoid installation errors and post installation challenges.

Tip: The alphanumeric character set consists of the numbers 0 to 9 and letters A to Z.

 

Oracle VM Manager Custom Uninstallation

 

 

# ./runInstaller.sh
Oracle VM Manager Release 3.1.1 Installer

Oracle VM Manager Installer log file:
 /tmp/install-2012-05-23-091242.log

Please select an installation type:
   1: Demo
   2: Production
   3: Uninstall
   4: Help

   Select Number (1-4): 2

Starting production installation ...


Verifying installation prerequisites ...

Oracle Database Repository
==========================
Use an existing Oracle database
Enter the Oracle Database hostname [localhost]:
Enter the Oracle Database System ID (SID) [XE]: orcl
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

Step 1 of 9 : Database ...
Installing Database ...
Database installation skipped ...

Step 2 of 9 : Java ...
Installing Java ...

Step 3 of 9 : Database Schema ...
Creating database schema 'ovs' ...

Step 4 of 9 : WebLogic ...
Retrieving Oracle WebLogic Server 11g ...
Installing Oracle WebLogic Server 11g ...

Step 5 of 9 : ADF ...
Retrieving Oracle Application Development Framework (ADF) ...
Unzipping Oracle ADF ...
Installing Oracle ADF ...
Installing Oracle ADF Patch...

Step 6 of 9 : Oracle VM  ...
Retrieving Oracle VM Manager Application ...
Extracting Oracle VM Manager Application ...
Installing Oracle VM Manager Core ...

Step 7 of 9 : Domain creation ...
Creating Oracle WebLogic Server domain ...
Starting Oracle WebLogic Server 11g ...
Configuring data source 'OVMDS' ...
Creating Oracle VM Manager user 'admin' ...

Step 8 of 9 : Deploy ...
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' ...

Step 9 of 9 : Oracle VM Manager Shell ...
Retrieving Oracle VM Manager Shell & API ...
Extracting Oracle VM Manager Shell & API ...
Installing Oracle VM Manager Shell & API ...

Retrieving Oracle VM Manager Upgrade tool ...
Extracting Oracle VM Manager Upgrade tool ...
Installing Oracle VM Manager Upgrade tool ...
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' ...
Enabling Oracle VM Manager service ...
Shutting down Oracle VM Manager instance ...
Restarting Oracle VM Manager instance ...
Waiting 15 seconds for the application to initialize ...
Oracle VM Manager is running ...
Oracle VM Manager installed.

Please wait while WebLogic configures the applications... This can take up to 5 minutes.

Installation Summary
--------------------
Database configuration:
  Database host name          : localhost
  Database instance name (SID): orcl
  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                        : 0004fb00000100004aa039092e1841f3


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://<ORACLE VM MANAGER HOST>:7001/ovm/console
  https://<ORACLE VM MANAGER HOST>:7002/ovm/console
Log in with the user 'admin', and the password you set during the installation.

Please note that you need to install tightvnc-java 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.

Please remove configuration file /tmp/ovm_configK5B1Xk.

#

 

Oracle VM Manager was sucessfully installed.

 

Next, as suggested by the Oracle VM Manager installer, remove the configuration file in the /tmp directory (see your Oracle VM Manager install message for the file name).
# rm -fr /tmp/file-name

Figure 11 shows the Oracle VM Manager Login page.

To login to Oracle VM Manager, use the "admin" user account with the password entered during the installation. Figure 12 shows the Oracle VM Manager administrative console.

 

• Discover the Oracle VM Servers
• Setup the Oracle VM Server's networking
• Setup the Networking for the server pool
• Setup NTP
• Setup a YUM server
• Create Tags (optional)
• Register a file server or a storage array
• Create a storage repository to host virtual machine resources
• Create a server pool

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, 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. Regardless of the Oracle VM Manager uninstall intent, it is necessary to completely uninstall each of the Oracle VM Manager components.

 

The next example shows the steps to perform a Oracle VM Manager Production uninstall (applicable for Oracle VM 3.0.1 up to 3.1.1).

• Download the Oracle VM Manager installation media (not source) from the Oracle Software Delivery Cloud - Oracle Linux and Oracle VM portal.
• Copy the Oracle VM Manager installation media to a directory on the Oracle VM Manager host.
• Log in to the Oracle VM Manager host as root, and unzip the file.
• Mount the ISO file by typing “mount -o loop <FILE NAME>.iso /media”
• Change to the /media directory, i.e. “cd /media.
• Verify that host name in the /etc/hosts file is associated with the server's public IP address.
• Run the installer script as root, by typing “./runInstaller.sh”

Oracle VM Manager Demo Installation

Step 1	Step 2	Step 3	Step 4
Download the Oracle VM Manager Installation Media	Oracle VM Manager Prerequisites	Oracle VM Manager Demo Installation (Oracle VM 3.0.1 up to 3.1.1)	Oracle VM Manager Post Installation Checklist

During an Oracle VM Manager Demo installation, the installation program asks for the following passwords:

• The Oracle XE SYS and SYSTEM account passwords must be selected. The Oracle XE SYS and SYSTEM account passwords cannot contain special characters.
• The Oracle VM Manager OVS Database schema password must be selected. The password cannot contain special characters and must be between 8 and 16 characters in length. Passwords must contain at least 1 lower case and 1 upper case letter. Passwords must contain at least 1 numeric value.
• The Oracle WebLogic admin account password must be selected. The password must be between 8 and 16 characters in length and must have at least 1 lower case and 1 upper case letter. The password must have at least 1 numeric value or special character
• The Oracle VM Manager admin account password must be selected. The password must be between 8 and 16 characters in length and must have at least 1 lower case and 1 upper case letter. The password must have at least 1 numeric value or special character

./runInstaller.sh

Oracle VM Manager Release 3.0.3 Installer

Oracle VM Manager Installer log file:
/tmp/ovmm-installer.selfextract_gx5525/install-2011-09-10-160853.log

Please select an installation type:
1: Demo
2: Production
3: Uninstall
4: Help

   Select Number (1-4): 3

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 in '/u01/app/oracle/ovm-manager-3/'
Oracle VM 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 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 ...

 

#

 

Oracle VM Manager has been successfully uninstalled.

 

Oracle VM Manager utilizes the Remote Access Service (RAS) java applet to proxy virtual machine VNC and serial console connections from an Oracle VM Server's ovm-consoled service to your desktop. To enable the VNC and serial console, download and install the TightVNC RPM package and the Java Telnet Application (JTA2) RPM package on the Oracle VM Manager host. The TightVNC and Java Telnet Application (JTA2) packages can be downloaded and installed in any directory, i.e. /tmp on the Oracle Linux host.

 

Note: I recommend installing the RealVNC client on your workstation to connect to the virtual machine VNC console. The RealVNC client is more full featured than the default TightVNC client. 

 

There is only one VNC packages for both Oracle Linux 5 and 6, and the following two Java Telnet Application (JTA2) RPM packages for Oracle Linux 5 and 6: 

 

The next example shows how to download and install the TightVNC and Java Telnet Application (JTA2) packages on a Oracle Linux 6 Oracle VM Manager host.  

# cd /tmp
# wget http://oss.oracle.com/oraclevm/manager/RPMS/tightvnc-java-1.3.9-3.noarch.rpm

# wget http://public-yum.oracle.com/repo/OracleLinux/OL6/addons/x86_64/jta-2.6-1.noarch.rpm
# rpm -ivh tightvnc-java*
warning: tightvnc-java-1.3.9-3.noarch.rpm: Header V3 DSA/SHA1 Signature, key ID 1e5e0159: NOKEY
Preparing...                ########################################### [100%]
   1:tightvnc-java          ########################################### [100%]

• ovm_managercontrol
• ovm_poolcontrol
• ovm_repocontrol
• ovm_servercontrol
• ovm_vmcontrol
• ovm_vmdisks
• ovm_vmmessage

Oracle VM Manager Log Files and Log File Analysis

Restore Oracle VM Manager

Discover the Oracle VM Servers and Configure the Storage

Oracle VM Manager Backups

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.

DBHOST=<THE HOSTNAME OF THE DATABASE SERVER>
SID=<ORACLE DATABASE SID>
LSNR=<THE LISTENER PORT FOR THE DATABASE>
APEX=<THE APPLICATION EXPRESS PORT>
OVSSCHEMA=<THE DEFAULT ORACLE VM MANAGER DATABASE SCHEMA NAME>
WLSADMIN=<THE DEFAULT WEBLOGIC SERVER ADMIN NAME>
OVSADMIN=<THE DEFAULT ORACLE VM MANAGER ADMIN NAME>
COREPORT=<THE DEFAULT ORACLE VM MANAGER CORE PORT>
UUID=<THE ORACLE VM MANAGER UUID>

The next example shows a .config file from a production Oracle VM Manager host.

# cat /u01/app/oracle/ovm-manager-3/.config
# cat .config
DBHOST=localhost
SID=orcl
LSNR=1521
APEX=None
OVSSCHEMA=ovs
WLSADMIN=weblogic
OVSADMIN=admin
COREPORT=54321
UUID=0004fb00000100009edfaa0f93184f44
BUILDID=3.1.1.305
FROMVERSION=3.0.3
TOVERSION=3.1.1

Before backing up the .config file, Oracle VM Manager must be shut down. To shut down Oracle VM Manager, access the Oracle VM Manager host as the root user, and type “service ovmm stop”, as shown in the next example.

# service ovmm stop
Stopping Oracle VM Manager                                 [  OK  ]

Once Oracle VM Manager is stopped, backup the /u01/app/oracle/ovm-manager-3/.config. The next example shows how to backup the .config file in the root users home directly with a descriptive name “ovm-back-” and the date.

# zip -9r /~ovm-back-`hostname -s`-`date +%F`.zip /u01/app/oracle/ovm-manager-3/.config

Once the .config file is backed up, start Oracle VM Manager by typing “service ovmm start” as shown in the following example.

# service ovmm start
Starting Oracle VM Manager                                 [  OK  ]

Oracle VM Manager Database Repository Backup

Once the Oracle VM Manager configuration file is backed up, and Oracle VM Manager is running, the Oracle VM Manager repository should be backed up. Oracle recommends a full database repository backup. If you're brave, “only” backup the ovs schema.

The following example shows how to do a full Oracle Express, Standard or Enterprise Edition Database repository backup using the exp utility.

Note: The exp utility is one of many applications that can be used to do a full Oracle VM Manager Database repository backup.

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.

The exp utility usage is a field unto itself, a detailed review is beyond the scope of this book. The goal of this section is to explain how to do a full Oracle VM Manager 11g Standard or Enterprise Edition Database repository backup using the exp utility.

 
Oracle 11g Standard or Enterprise Edition Database Repository Backup

How to Backup an Oracle 11g Express Database Repository

The next example shows how to backup an Oracle 11g Express Database repository using the exp utility.  

Log into the Oracle VM Manager host as the oracle user, or as root and type “su - oracle” to change to the oracle user. As the oracle user type the following commands to backup the  Oracle VM Manager 11g XE Database repository.

Note: Replace <PASSWORD> with the ovs database schema password that was selected during the Oracle VM Manager installation. In the below example a file named “ovsbackup.dmp” is created in the /tmp directory. Any name or directory can be used with the “file=” argument.

export ORACLE_HOME=/u01/app/oracle/product/11.2.0/xe
export PATH=$ORACLE_HOME/bin:$PATH
export ORACLE_SID=XE