Jump to Navigation

Oracle VM Patch Updates

Download the Oracle Cloud Cookbook

 

Copyright © 2014 Mokum Solutions, Inc. All rights reserved.
Distribution of the Oracle Cloud Cookbook or derivative of the work in any form is prohibited unless prior permission is obtained from the copyright holder.
 
 
 Change Log
Revision
Change Description
Updated By
Date
1.0
First Release
Roddy Rodstein
10/05/11
1.1 Oracle VM 3.0.3 Updates Roddy Rodstein 01/20/12
1.2 Oracle VM 3.1.1 Updates Roddy Rodstein 05/09/12
1.3 Oracle VM 3.2.x Updates Roddy Rodstein 12/12/12
 
This chapter of the Oracle Cloud Cookbook reviews how to apply patch updates to Oracle VM Manager and Oracle VM Server. This document applies to Oracle VM 3.x.
 

Table of Contents

Oracle VM Releases
Oracle VM Upgrade Roadmap
How to Backup Oracle VM Manager
How to Backup an Oracle VM Manager Configuration File
How to Backup an Oracle VM Manager Database Repository
MySQL Enterprise Edition Database Repository Backup
How to Backup an Oracle VM Manager Standard or Enterprise Edition Database Repository
How to Backup an Oracle VM Manager Express Database Repository
How to Download the Oracle VM Upgrade Media from the Oracle Linux and Oracle VM Cloud Portal
How to Mount the Oracle VM Manager Media and Run the runUpgrader.sh Script
Oracle VM Server Upgrade, Updates and Patching with a Yum Server
Oracle Yum Server Configurtaion Road Map
Register the Oracle Linux Yum Server with the Oracle Unbreakable Linux Network
Install and configure Apache on the Oracle Linux Yum Server
Oracle Unbreakable Linux Network Yum Server Configuration
Populate and Synchronize the Yum Server with Oracle Unbreakable Linux Network
Oracle VM Manager Yum Server Configuration
Appendix
Patch Update Fails with BUILD FAILED Message
Upgrade Oracle VM Manager Build 3.1.1.305

 

Oracle VM Releases

At Oracle OpenWorld 2007, Oracle announced its entry into the x86 server virtualization market with the first release of Oracle VM. The first release of Oracle VM was actually version 2.1 because of Larry Ellison's aversion to using 1.0 for Oracle product releases to help drive early adoption. As of this writing, there has been a total of 13 Oracle VM Releases.
 
A key component of a successful Oracle VM deployment is acquiring and vetting new releases, patches and updates for production systems. New Oracle VM releases, patches and updates must be researched to identify which release, patches and updates are applicable to your environment. Newly released versions, patches and updates should be vetted before being deployed into production. A best practice is to run the latest stable release of Oracle VM. As of this writing, the latest stable Oracle VM release is 3.1.1 with the Oracle VM Manager 3.1.1-625 patch (patch ID 14227416). 
 
Tip: To support the Oracle VM 3.1.1 release, from the Oracle Unbreakable Linux Network, please subscribe your yum server to the Oracle VM 3.1.1 Server Installation Media copy RPM channel and the Oracle VM 3.1.1 Server Patches RPM channels. Patch jobs using the latest RPM channel will update hosts to their respected latest version update with the latest software patches, updates and fixes. A patch job executed on a Oracle VM 3.1.1 host using the latest RPM channel would update the host from 3.1.1 to 3.2.x with the latest software patches, updates and fixes.
 
The relevant parts of Oracle VM releases are:
  • 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.1 Release
  • Oracle VM 3.0.1 was released on August 23rd 2011. Oracle VM 3.0.1 was the first Oracle VM 3.0 release. 
Oracle VM 3.0.2 Release
  • Oracle VM 3.0.2 was released on September 30th 2011. Oracle VM 3.0.2 includes over 140 fixes without any new features.
Oracle VM 3.0.3 Release
  • 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 Release
  • 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 Release
  • 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 Release
  • Oracle VM 3.2.2 was released on March 18th 2013. Oracle VM 3.2.2 includes numerious bug fixes.
Oracle VM 3.2.6 Release
  • Oracle VM 3.2.6 was released on October 11th 2013. Oracle VM 3.2.6 includes numerious bug fixes.
Oracle VM 3.2.7 Release
  • Oracle VM 3.2.7 was released on December 5th 2013. Oracle VM 3.2.7 includes numerious bug fixes.
Even after a fresh installation of Oracle VM Manager, if a patch update is available, a best practice is to patch Oracle VM Manager before using Oracle VM Manager to avoid previously patched bugs. When updating Oracle VM, Oracle VM Manager must be updated first, followed by the Oracle VM Servers managed by Oracle VM Manager. As of this writing (12-09-2013), there are three Oracle VM Manager patch updates; Oracle VM Manager Release 3.0.3.546, Oracle VM Manager Release 3.1.1.625, and Oracle VM Manager Release 3.2.7.730.
 
Note: Starting with Oracle VM 3.1.1-625, Oracle only maintains the latest patch update. For example, when Oracle VM 3.2.6-726 was released on October 11th 2013, 3.2.4-524, 3.2.3-521, 3.2.3-250, 3.2.1-516 where retired and replaced with 3.2.6-726. 
 
Table 1 lists the Oracle VM Manager Patch Updates.
Oracle VM Release
Available From eDelivery
Latest Oracle VM Patch Update
Available From My Oracle Support
Oracle VM Upgrades
Available From eDelivery
Oracle VM 3.0.1
 
 
Oracle VM 3.0.2
 
Oracle VM Manager 3.0.2 - Upgrade only
upgrade Oracle VM Manager 3.0.1
Oracle VM 3.0.3 (Build 546)
Oracle VM Manager 3.0.3 - Upgrade only
Upgrade from Oracle VM Manager 3.0.1 or Oracle VM Manager 3.0.2
Oracle VM 3.1.1 (Build 625)
Oracle VM Manager 3.1.1 - Upgrade only
Upgrade from Oracle VM Manager 3.0.2 or Oracle VM Manager 3.0.3
Oracle VM 3.2.2 (Build 520)
Upgrade from Oracle VM Manager 3.0.3, Oracle VM Manager 3.1.1, and Oracle VM Manager 3.2.x
Oracle VM 3.2.6 (Build 726)
Upgrade from Oracle VM Manager 3.0.3, Oracle VM Manager 3.1.1, and Oracle VM Manager 3.2.x

Oracle VM Upgrade Roadmap

Step 1 Backup Oracle VM Manager
Step 2 Download the Oracle VM Manager Upgrade or Installation Media and/or the patch update
Step 3 Stage and Mount the Oracle VM Manager Upgrade or Installation ISO File and/or patch update on the Oracle VM Manager host and run the upgrade script
Step 4 Update the Oracle VM Servers using a Local YUM repository
 

How to Backup Oracle VM Manager

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

How to Backup an Oracle VM Manager Configuration File

The Oracle VM Manager configuration file “.config ” is located on the Oracle VM Manager host 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 an Oracle VM Manager host.

# cat /u01/app/oracle/ovm-manager-3/.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


The next example shows how to backup the .config file in the root users home directly with a descriptive name “ovm-back-” and the current date.

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

How to Backup an Oracle VM Manager Database Repository

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 next example shows how to do a full Oracle VM Manager 11g 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.

MySQL Enterprise Edition Database Repository Backup

Starting with Oracle VM Manager Release 3.2.1 and above, simple MySQL Oracle VM Manager installations are automatically backed up within the /u01/app/oracle/mysql/dbbackup directory every 24 hours using the MySQL Enterprise Backup utility. By default the Oracle VM Manager MySQL database backups are rotated regularly so that only the 15 most recent backups are retained. It is also possible to perform manual backups using the MySQL Enterprise Backup utility.
 
The default path for the Oracle VM Manager MySQL backups is defined in the /etc/sysconfig/ovmm file on the Oracle VM Manager host. The next example shows the default path settings in the /etc/sysconfig/ovmm file:
DBBACKUP=/u01/app/oracle/mysql/dbbackup
 
Note: The default path can be changed to accommodate disk space requirements.
 
To confirm the existence of the Oracle VM Manager MySQL backups, on the Oracle VM Manager host change to the /u01/app/oracle/mysql/dbbackup directory, and list the contents of the directory. The next example shows how to change to the /u01/app/oracle/mysql/dbbackup directory and list its contents.
# cd /u01/app/oracle/mysql/dbbackup
# ls -lart
 
If your daily backups are failing, it is possible to run a manual backup. As root, access the Oracle VM Manager host, and follow these steps:
# cd /u01/app/oracle/ovm-manager-3/bin
# ./createBackup.sh
Backing up the Oracle VM Manager MySQL Database...
Please enter the Oracle VM manager user name: admin
Please enter the Oracle VM manager user password:
INFO: Succesfully backed up database as AutoFullBackup-20130911_212701
 
If the above command fails, check if both services are running:
# /etc/init.d/ovmm status
Oracle VM Manager is running...
# /etc/init.d/ovmm_mysql status
MySQL running (1977) [ OK ]
 
If ether of the two services are not running, restart the failed service.
 
Manual backups are also retained for 15 backups, before being automatically removed. Using the -n switch with the a user defined backup name excludes the backup from being automatically removed. The next example shows how to create a backup useing the -n switch.
# /u01/app/oracle/ovm-manager-3/bin/createBackup.sh -n MyBackup1

How to Backup an Oracle VM Manager Standard or Enterprise Edition Database Repository

The following example shows how to do a full Oracle VM Manager 3.0 11g Standard or Enterprise Edition Database repository backup using the exp utility.

Log into the Oracle VM Manager Database repository system as the oracle user, or as root and type “su - oracle” to change to the oracle user.

Tip: The exp utility help files are available by typing “exp help=yes”

# su - oracle
$ exp

Export: Release 11.1.0.6.0 - Production on Tue Oct 4 14:03:33 2011

Copyright (c) 1982, 2007, Oracle.  All rights reserved.

Username: <USER NAME>
Password: <PASSWORD>

Connected to: Oracle Database 11g Enterprise Edition Release 11.1.0.6.0 - 64bit Production
With the Partitioning, OLAP, Data Mining and Real Application Testing options
Enter array fetch buffer size: 4096 >

Export file: expdat.dmp >

(1)E(ntire database), (2)U(sers), or (3)T(ables): (2)U > 1

Export grants (yes/no): yes >

Export table data (yes/no): yes >

Compress extents (yes/no): yes >

/

Export terminated successfully with warnings.

The above example creates a back up of the Database repository named expdat.dmp in the working directory.

The next example shows how to backup “only” the Oracle VM Manager 11g Standard or Enterprise Edition Database repository ovs schema. Change the user name and password for your environment.

$ exp USERID=<USER NAME>/<PASSWORD> OWNER=ovs FILE=exp_ovs.dmp

Export: Release 11.1.0.6.0 - Production on Mon Oct 3 16:24:09 2011

Copyright (c) 1982, 2007, Oracle.  All rights reserved.
 
Connected to: Oracle Database 11g Enterprise Edition Release 11.1.0.6.0 - 64bit Production
With the Partitioning, OLAP, Data Mining and Real Application Testing options
Export done in US7ASCII character set and AL16UTF16 NCHAR character set
server uses WE8MSWIN1252 character set (possible charset conversion)

/

Export terminated successfully with warnings.
 

How to Backup an Oracle VM Manager Express Database Repository

The next example shows how to backup an Oracle VM Manager 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
exp ovs/<PASSWORD> grants=y compress=y file=/tmp/ovsbackup.dmp
 

How to Download the Oracle VM Upgrade Media from the Oracle Linux and Oracle VM Cloud Portal

In order to upgrade Oracle VM Manager, the installation or upgrade media must be downloaded and made available to the Oracle VM Manager host. Oracle VM Server can also be upgraded using the installation media or with a local YUM repository. The Oracle VM Manager installation and upgrade media can be burned to DVD and applied using a CD-ROM, or the ISO file can be copied to Oracle VM Manager host and mounted locally to start the upgrade program.
 
Tip: This chapter of the Oracle Cloud Cookbook covers how to upgrade Oracle VM Server using a local YUM repository. 
 
The Oracle VM installation and upgrade media is available at the Oracle Linux and Oracle VM Cloud Portal. Access to the Oracle Linux and Oracle VM Cloud Portal requires an Oracle.com user account and password to authenticate into the Oracle Linux and Oracle VM Cloud Portal. If you do not already have an Oracle.com user account, visit the Oracle Linux and Oracle VM Cloud Portal, click the Sign In / Register link or button to create an Oracle.com account.
 
Figure 1 shows the Oracle Linux and Oracle VM Cloud Portal.
Oracle Software Delivery Cloud Oracle VM
 
From the Sign In page, enter your Oracle.com user name and password, then click the Sign In button.
 
Figure 2 shows the Oracle Linux and Oracle VM Cloud Portal Sign In page.
Oracle.com SSO Sign In
 
Once authenticated, accept the registration/export regulations to access to the Oracle VM and Oracle Linux Media.
 
Figure 3 shows the registration/export regulations form.
Oracle Software Delivery Cloud Terms & Restrictions
 
 
After completing the registration/export regulation form, you will be redirected to the Media Pack Search page. From the Media Pack Search page, select Oracle VM from the Select a Product Pack dropdown menu. Next, select x86 64-bit from the Platform dropdown menu, then click the Go button to be taken to the Oracle VM Media Pack download page.
 
Tip: If you do not see Oracle VM from the Select a Product Pack dropdown menu, you are not in the Oracle Linux and Oracle VM section of the Cloud Portal. Click the Cloud Portal link in the page header, then click the Oracle Linux/VM drop down menu to be redirected to the Oracle Linux and Oracle VM section of the Cloud Portal.
 
Figure 4 shows the Media Pack Search page.
Download Oracle VM
 
From the Oracle VM Media Pack page, click the desired Oracle VM Media Pack radio button, then the Continue button, or click the desired Oracle VM Media Pack hyperlink to go to the download page.
 
From the Oracle VM Media Pack download page, click the desired Oracle VM Manager and Server Download button to download the Oracle VM Media Pack. As of this writingthe latest installation media for Oracle VM Manager is Oracle VM Manager 3.1.1, and the latest upgrade media is Oracle VM Manager 3.1.1 - Upgrade only. Oracle VM Manager can be upgraded using the installation media and/or with the upgrade only media. The upgrade only media is a much smaller and faster to download. The latest installation media for Oracle VM Servers is Oracle VM Server 3.1.1 for x86_64 (64 bit).
 
The Oracle VM media is delivered as a zip file. The zip file name corresponds to the Part Number listed on the download page. The Oracle VM Manager and/or Server zip file contains an ISO file.
 
Once the zip file(s) is downloaded, use your favorite zip utility to unzip the Oracle VM Manager media. Next, burn the ISO file to DVD to be able to install and or upgrade Oracle VM with a CD-ROM drive, or copy the ISO file to the Oracle VM Manager host, mount the ISO file and then perform the upgrade.
 

How to Mount the Oracle VM Manager Media and Run the runUpgrader.sh Script

In order to run the Oracle VM Manager runUpgrader.sh script, the upgrade or installation media (ISO file) must be made available to the Oracle VM Manager host. The Oracle VM Manager upgrade or installation media can be burned to DVD and applied using a CD-ROM, or the ISO file can be copied to Oracle VM Manager host and mounted locally to start the upgrade program. 
 
Note: The workflow to apply a patch update or an upgrade is virtually identical. Some of the upgrade and update code may ask you to stop Oracle VM Manager to proceed, i.e. "service ovmm stop".
 
List 2 walks through the steps to download, mount and start an Oracle VM Manager patch update or an upgrade.
  1. Download the desired Oracle VM Manager media from the Oracle Linux and Oracle VM Cloud Portal or My Oracle Support.
  2. Use your favorite zip utility to unzip the Oracle VM Manager zip file.
  3. Copy the ISO file to a directory on the Oracle VM Manager host, i.e. to the /media directory.
  4. Note: The directory where the ISO file will be mounted must be writable by the oracle user account.
  5. Log in to the Oracle VM Manager host as root.
  6. Mount the ISO file by typing “mount -o loop OracleVM-Manager-<VERSION>.iso /media”
  7. Change to the directory where the ISO file is mounted, i.e. “cd /media.
  8. Run the installer script as root, by typing “./runUpgrader.sh”, as shown in the following example.
The following two examples shows how to install patch ID 14227416 (3.1.1.365), then patch ID 16410417 (3.2.3.521). Patch ID 14227416 can be applied to Oracle VM Manager 3.0.3 and 3.1.1.. Patch ID 16410417 can be applied to Oracle VM Manager 3.0.3, 3.1.1, 3.2.1, and 3.2.2..
 
The next example shows how to apply Patch ID 14227416 to Oracle VM Manager 3.0.3 and 3.1.1..
 
# ./runUpgrader.sh
Stating OVM Manager upgrade on Thu Jul 12 05:23:21 PDT 2012

Oracle VM Manager 3.1.1.365 upgrade utility
Upgrade logfile : /tmp/upgrade-2012-07-12-23.log

It is highly recommended to do a full database repository backup prior to upgrading Oracle VM Manager ...

Press any key to continue ...

Oracle VM Manager is running ...
Verifying installation status ...
Read Oracle VM Manager config file ...
Skipping database upgrade for the same product version (3.1.1 to 3.1.1)
Found Oracle VM Manager install files ...
Found Oracle VM Manager upgrader ...
Found Oracle WebLogic Server ...
Found Java ...
Using the following information :
  Database Host          : localhost
  Database SID           : orcl
  Database LSNR          : 1521
  Oracle VM Schema       : ovs
  Oracle VM Manager UUID : 0004fb00000100004aa039092e1841f3
  Current Build ID       : 3.1.1.305
  Upgrade from version   : 3.1.1
  Upgrade to version     : 3.1.1
Using /tmp/workdir.8tJUbAKhqE for backup and export location.
Using /tmp/patchdir.XZoV9DSQR for patching.
Undeploying previous version of Oracle VM Manager application ...
Undeploying Oracle VM Manager help ...
Undeploying Oracle VM Manager console ...
Undeploying Oracle VM Manager core ...
Waiting for Oracle VM Manager core to fully undeploy...
Waiting...
Finished undeploying previous version ...
Upgrading Oracle VM Manager ...
Backing up old files to /tmp/ovm-manager-3-backup-2012-07-12-052505...
Removing old files ...
Unpacking Oracle VM Manager 3.1.1.365
Refresh system-jazn-data.xml file ...
Redeploying Oracle VM Manager core container ...
Redeploying Oracle VM Manager console ...
Redeploying Oracle VM Manager help ...
Unpacking Oracle VM Manager OVM CLI Tool
Completed upgrade to 3.1.1.365 ...
Writing updated config in /u01/app/oracle/ovm-manager-3/.config
Restart WebLogic ...
Stopping Oracle VM Manager                                 [  OK  ]
Starting Oracle VM Managernohup: ignoring input and redirecting stderr to stdout
                                                           [  OK  ]

OVM Manager upgrade finished on Thu Jul 12 05:27:04 PDT 2012
#
Oracle VM Manager has just been successfully updated.

The new Oracle VM Manager version number can be validated by viewing the release number listed on the BUILDID line in the .config file. The next example shows the .config file before the upgrade.

# cat /u01/app/oracle/ovm-manager-3/.config
DBHOST=localhost
SID=orcl
LSNR=1521
APEX=None
OVSSCHEMA=ovs
WLSADMIN=weblogic
OVSADMIN=admin
COREPORT=54321
UUID=0004fb00000100004aa039092e1841f3
BUILDID=3.1.1.365
FROMVERSION=3.1.1
TOVERSION=3.1.1
 
The next examples shows how to install patch ID 16410417Patch ID 16410417 can be applied to Oracle VM Manager 3.0.3, 3.1.1, 3.2.1, and 3.2.2.
 

# ./runUpgrader.sh
Upgrade logfile : /tmp/ovm-manager-3-upgrade-2013-12-10-07.log
2013-12-10 10:07:23
2013-12-10 10:07:23 Starting Oracle VM Manager upgrade...
2013-12-10 10:07:23
2013-12-10 10:07:23 Oracle VM Manager 3.2.7.730 upgrade utility
2013-12-10 10:07:23
2013-12-10 10:07:23
2013-12-10 10:07:23 It is highly recommended to do a full database repository backup prior to upgrading Oracle VM Manager ...
2013-12-10 10:07:23
2013-12-10 10:07:23 Press [Enter] key to continue ...

2013-12-10 10:07:24
2013-12-10 10:07:24 Oracle VM Manager is running ...
2013-12-10 10:07:44 Verifying installation status ...
2013-12-10 10:07:44 Read Oracle VM Manager config file ...
2013-12-10 10:07:44 Skipping database upgrade for the same product version (3.2.6 to 3.2.7)
2013-12-10 10:07:44 Found Oracle VM Manager install files ...
2013-12-10 10:07:44 Found Oracle VM Manager upgrader ...
2013-12-10 10:07:44 Found Oracle WebLogic Server ...
2013-12-10 10:07:44 Found Java ...
2013-12-10 10:07:44 Using the following information :
2013-12-10 10:07:44 Database type : MySQL
2013-12-10 10:07:44 Database Host : localhost
2013-12-10 10:07:44 Database SID : ovs
2013-12-10 10:07:44 Database LSNR : 49500
2013-12-10 10:07:44 Oracle VM Schema : ovs
2013-12-10 10:07:44 Oracle VM Manager UUID : 0004fb0000010000e2a0f9412d480499
2013-12-10 10:07:44 Current Build ID : 3.2.6.726
2013-12-10 10:07:44 Upgrade from version : 3.2.6
2013-12-10 10:07:44 Upgrade to version : 3.2.7
2013-12-10 10:07:44 Using /tmp/workdir.nRuKMvbGK2 for backup and export location.
2013-12-10 10:07:44 Using /tmp/patchdir.GD4L0XWKs for patching.
2013-12-10 10:07:44 Undeploying previous version of Oracle VM Manager application ...
2013-12-10 10:07:45 Undeploying Oracle VM Manager help ...
2013-12-10 10:09:08 Undeploying Oracle VM Manager console ...
2013-12-10 10:09:33 Undeploying Oracle VM Manager core ...
2013-12-10 10:10:34 Waiting for Oracle VM Manager core to fully undeploy...
Waiting...

2013-12-10 10:11:05 Finished undeploying previous version ...
2013-12-10 10:11:05 Upgrading Oracle VM Manager ...
2013-12-10 10:11:05 Backing up old files to /tmp/ovm-manager-3-backup-2013-12-10-101105...
2013-12-10 10:11:05 Removing old files ...
2013-12-10 10:11:05 Unpacking Oracle VM Manager 3.2.7.730
2013-12-10 10:11:06 Refresh system-jazn-data.xml file ...
2013-12-10 10:11:06 Redeploying Oracle VM Manager core container ...
2013-12-10 10:12:10 Redeploying Oracle VM Manager console ...
2013-12-10 10:13:02 Redeploying Oracle VM Manager help ...
2013-12-10 10:13:34 Unpacking Oracle VM Manager CLI Tool
2013-12-10 10:13:34 Disabling HTTP and enabling HTTPS
2013-12-10 10:14:01 Completed upgrade to 3.2.7.730 ...
2013-12-10 10:14:01 Writing updated config in /u01/app/oracle/ovm-manager-3/.config
2013-12-10 10:14:01 Restart WebLogic ...
Stopping Oracle VM Manager                                 [  OK  ]
Starting Oracle VM Manager                                 [  OK  ]
2013-12-10 10:14:51
2013-12-10 10:14:51 Oracle VM Manager upgrade finished

Next, as root type the following commands to allow https connection with Microsoft Internet Explorer  7, 8, or 9. 

 
# cd /u01/app/oracle/ovm-manager-3/weblogic
# sh configureIdentityTrust.sh
# service ovmm stop
# service ovmm start
 

Oracle VM Server Upgrade, Updates and Patching with a Yum Server

When upgrading Oracle VM, Oracle VM Manager must be upgraded first, followed by the Oracle VM Servers managed by Oracle VM Manager. Oracle VM Servers are updated and patched using a local yum repository. A local yum repository can be configured on any Internet accessible Oracle Linux or Red Hat Enterprise Linux web server that has been registered with the Unbreakable Linux Network. A valid customer service identifier (CSI) for Oracle Linux and/or Oracle VM is required to configure a yum server at the Unbreakable Linux Network.
 

Oracle Yum Server Configurtaion Road Map

List 3 shows the steps to configure, update and patch an Oracle VM Server.
1- Register an Oracle Linux or Red Hat Enterprise Linux host with the Unbreakable Linux Network.
2- Install and configure Apache on the Linux host.
3- Login to the Unbreakable Linux Network, edit the properties of the Linux host, select the yum server check box, and select and save the desired RPM channels, i.e. Oracle VM 3 latest.
4- Use Oracle' 167283.sh script to populate the RPM channels from the Unbreakable Linux Network.
5- Login to Oracle VM Manager and enter the URL of the Oracle VM 3 latest RPM repository in the Server Update Management (YUM) dialog box.
6- Update and/or patch the Oracle VM Servers using Oracle VM Manager.
 

Register the Oracle Linux Yum Server with the Oracle Unbreakable Linux Network

Before an Oracle Linux or Red Hat Enterprise Linux host can connect to the Oracle Unbreakable Linux Network, Oracle’s GPG key must be imported using the rpm command. To import the Oracle’s GPG key, as root type “rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY”, as shown in the next example.
 
# rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY
 
Once the GPG key has been imported, the Linux host can be registered at the Oracle Unbreakable Linux Network from the command line or using an X Windows application. Linux 4 and 5 systems use the up2date command as root to access the registration screen by typing “up2date --register” for X Windows or "up2date --nox --register" for text mode. Linux 6 systems use the "uln_register" command as root to access the registration screen. The registration process requires you to enter your Unbreakable Linux Network associated Oracle Single Sign-on user name and password and a valid Oracle Linux Support Identifier number (CSI).
 
If a proxy server is in the mix, for Oracle Linux 4 and 5 systems, as root type “up2date --configure” to list and edit the up2date program defaults. There are five proxy configurations that can be edited to allow access from your Linux host to the internet. The next example shows the up2date proxy configuration items with their default settings and item numbers.
  • 3. enableProxy        No
  • 4. enableProxyAuth    No
  • 11. httpProxy
  • 21. proxyPassword
  • 22. proxyUser
To edit an up2date program item, type the item number, i.e. enter 3 or 4, etc.... then type C to clear the default value or type q to quit without saving. Next, type the new value and press Enter to save the new value and to exit. If you need to enter multiple values, separate them with semicolons (;).
 
Oracle Linux 6 systems use the “--proxy” option to specify an http proxy, i.e. “# uln_register –proxy=<HOST NAME>:<PORT NUMBER> “. If your proxy server requires authentication, use the “--proxyUser” and “--proxyPassword” to add a username and password, i.e “# uln_register –proxy=<HOST NAME>:<PORT NUMBER> --proxyUser=<USER NAME> --proxyPassword=<PASSWORD>”
 
List 4 shows the six steps to register a Linux host with the Oracle Unbreakable Linux Network:
1.      Review the Unbreakable Linux Privacy Statement
2.      Register a User Account
3.      Register a System Profile—Hardware
4.      Register a System Profile—Packages
5.      Send Profile Information to the Unbreakable Linux Network
6.      Finished Registration
 
The following examples walk through the six steps to register a Linux host with the Oracle Unbreakable Linux Network.
 
Step 1. Review the Unbreakable Linux Privacy Statement
From the Review the Unbreakable Linux Privacy Statement screen use the Alt key to select the Next tab, once the Next tab is selected press the Enter key to proceed.  
 
Figure 5 shows the Review the Unbreakable Linux Privacy Statement screen.
Unbreakable Linux Privacy Statement
 
Step 2. Register a User Account
On the Register a User Account screen, enter your  your Unbreakable Linux Network associated Oracle Single Sign-on User namePassword, Password confirmation and a valid Oracle VM CSI number. Use the Alt key to select the Next tab, and then press the Enter key to proceed.
 
Figure 6 shows the Register a User Account screen.
Oracle Unbreakable Linux Network Register a User Account
 
Step 3. Register a System Profile—Hardware
On the Register a System Profile—Hardware screen, accept the defaults and use the Alt key to select the Next tab. Once the Next tab is selected, press the Enter key to proceed.
 
Note: The information gathered from the system profile step is saved in your user profile at the Oracle Unbreakable Linux Network. 
 
Figure 7 shows the Register a System Profile—Hardware screen.
Oracle Unbreakable Linux Network Register a System Profile
 
Step 4. Register a System Profile— Packages
On the Register a System Profile—Packages screen, accept the defaults and use the Alt key to select the Next tab. Once the Next tab is selected, press the Enter key to proceed.
 
Figure 8 shows the Register a System Profile—Packages screen.
Oracle Unbreakable Linux Network Register a System Profile
 
Step 5. Send Profile Information to the Unbreakable Linux Network
From the Send Profile Information to the Unbreakable Linux Network screen, accept the defaults and use the Alt key to select the Next tab. Once the Next tab is selected, press the Enter key to proceed.
 
Figure 9 shows the Send Profile Information to the Unbreakable Linux Network screen.
Oracle Unbreakable Linux Network Send Profile Information
 
Step 6 Finished Registration
On the Finished Registration screen, accept the defaults and use the Alt key to select the Next tab. Once the Next tab is selected, press the Enter key to proceed.
 
Figure 10 shows the Finished Registration screen.
Oracle Unbreakable Linux Network Registration Finnshed
 
The Oracle Linux host has been successfully registered.
 

Install and configure Apache on the Oracle Linux Yum Server

Installing Apache from an Unbreakable Linux Network registered Oracle Linux host is accomplished by typing “up2date -i httpd” and /or "yum install httpd" while logged in as root. Once Apache is installed, configure Apache to automatically start by typing “chkconfig httpd on”. Next, start Apache by typing “service httpd start”. The next example shows how to install, configure and start Apache.
 
Using up2date, as root type:
# up2date -i httpd
# chkconfig httpd on && service httpd start
 
Using yum, as root type:
# yum install httpd
# chkconfig httpd on && service httpd start
 
Once the “up2date -i httpd”, “chkconfig httpd on” and “service httpd start” commands have completed, test Apache by pointing a web browser to the fully qualified domain name (FQDN) or the IP address of the Apache server. You will see the default Apache test page as shown in Figure 11.
 
Oracle Linux Apache Web Server
 
Tip: If you don’t see the default Apache test page, check if iptables is blocking http traffic on the Apache host. Consider disabling iptables to test Apache by typing “sudo /sbin/service iptables stop”.
 
Next, create a the yum repository base directory in /var/www/html by typing "mkdir -p /var/www/html/yum".

Table 2 shows the approximate disk space requirements for each Oracle VM RPM channel:

Channel
Binaries
ovm*_latest
147M
ovm*_base
400M
ovm*_patch
100M
 

Oracle Unbreakable Linux Network Yum Server Configuration

Once your yum server has been registered, and apache has been installed and configured, access the Oracle Unbreakable Linux Network dashboard and click the Systems tab. From the Systems tab click on the yum server to access its System Details page.
 
Figure 12 shows the Systems tab and the YUM server.
Oracle Unbrekable Linux Network Systems
 
From the YUM servers Systems Details page click the Edit button, as shown in Figure 13.
Oracle Linux YUM Server Configuration Oracle Unbreakable Linux Network
From the Edit Systems Properties page, select the Yum Server check box, enter a valid CSI number, then click the Apply Changes button, as shown in Figure 14.
Oracle Unbreakable Linux Network YUM Server
Next, click the Manage Subscriptions button, as shown in in Figure 15.
Oracle Unbreakable Linux Network System Details
 
From the System summary page select the Oracle VM 3 latest channel. Next, click the Save Subscriptions button to save the changes, as shown in Figure 16.
Oracle Unbreakable Linux Network System Summary
 
The yum server has been successfully configured using the the Oracle Unbreakable Linux Network dashboard.  The next step is to populated and synchronize the local yum repository with the Oracle Unbreakable Linux Network using the 167283.sh script.
 

Populate and Synchronize the Yum Server with Oracle Unbreakable Linux Network

Local yum repositories are populated and synchronized to the Unbreakable Linux Network using a script (167283.sh) and a cron job, or with Oracle Enterprise Manager. To populate the yum repository using the 167283.sh script, as root type “cd”, then “wget http://www.oracle.com/ocom/groups/public/@otn/documents/webcontent/167283.sh to download the 167283.sh script. Next, type “chmod 755 167283.sh” to make the script executable. Then type “nohup sh 167283.sh &” to run the script. Once the 167283.sh script completes, the yum RPM repository will be populated and ready to update or patch Oracle VM Servers.
 
To automatically synchronize your local yum RPM repository to the Unbreakable Linux Network, use a cron job with the 167283.sh script. As root or any other user with access to the 167283.sh script, type "chrontab -e" to edit your crontab file, or create a new crontab file if one does not already exist. The next example shows how to create a crontab file as root that will run the 167283.sh script at midnight every weekday.
 
# crontab -e
0 0 * * 1-5 /root/167283.sh
:wq!

To view the current cronjob on a Oracle Linux host, type "crontab -l". To edit the cronjob type "crontab -e".

Crontab Syntax:
1 2 3 4 5 /path/to/command arg1 arg2
1: Minute (0-59)
   2: Hours (0-23)
       3: Day (0-31)
          4: Month (0-12 [12 == December])
              5: Day of the week(0-7 [7 or 0 == sunday])
                 /path/to/command - Command name or script to schedule
 

Oracle VM Manager Yum Server Configuration

To patch Oracle VM Servers using Oracle VM Manager, a YUM server should be added to Oracle VM Manager' Server Update Management (YUM) menu.
 
Tip: Oracle VM Servers that are patched and rebooted by Oracle VM Manager restart in Maintenance Mode. Oracle VM Servers in Maintenance Mode cannot run virtual machine or be edited. For example, if you patch a host before adding it to a server pool, and it reboots in Maintenance Mode, the host cannot be edited or added to the pool until Maintenance Mode is disabled.
 
To add a Yum repository to Oracle VM Manager, select the Tools and Resources tab, and then click the Server Update Management (YUM) link to add the base URL and GPG key details. 
 
Figure 17 shows the Server Update Management (YUM) page.
Oracle VM Manager Server Update Management YUM
 
Enter the following information in the Server Update Management (YUM) page to add a YUM repository:
  • YUM Base URL: Enter the URL from the Oracle VM latest channel, i.e.:
    • http://<YUM SERVER IP OR FQDN>/yum/OracleVM/OVM3/latest/x86_64/
  • Enable GPG Key: GPG keys are used to validate the identity of a Yum server and its RPM packages (RPMs).  Select the Enable GPG Key checkbox to be able to enter the YUM GPG Key.
    • Note: If you elect"not" to configure the GPG key, it is necessary to type "rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-oracle" as root on each Oracle VM Server that uses the configured yum reporitory.
  • YUM GPG Key: An Oracle-signed GPG key for ULN is pre-installed on Oracle Linux hosts at /etc/pki/rpm-gpg/RPM-GPG-KEY-oracle. To to use the pre-installed Oracle GPG key, enter “file:///etc/pki/rpm-gpg/RPM-GPG-KEY-oracle” in the YUM GPG Key text box.
  • Note: The GPG key field is only enabled when you select Enable GPG Key.
    • It is also possible to copy the GPG key from the web server OS to the Yum repository, i.e. as root type “cp /etc/pki/rpm-gpg/RPM-GPG-KEY-oracle /var/www/html/yum/ && chown apache:apache /var/www/html/yum/RPM-GPG-KEY-oracle”, next enter the URL "http://<YUM SERVER IP OR FQDN>/yum/ RPM-GPG-KEY-oracle" in the YUM GPG Key text box.
    • To validate the path/location of the RPM-GPG-KEY-oracle file, as root, type "find / -name RPM-GPG-KEY-oracle -print" to print the path. If necessary substitute the bold text with the correct path: rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-oracle.
    • To confirm if the RPM-GPG-KEY-oracle key has already been installed, as root type "rpm -q gpg-pubkey-1e5e0159-464d0428"
    • The Oracle GPG key is also available from "https://oss.oracle.com/el5/RPM-GPG-KEY-oracle"
  • Click Apply to save the setting.
 
Once the YUM repository is added, Oracle VM Manager will automatically query all the managed Oracle VM Servers and update the Update Required status to Yes or No. 
 
Figure 18 shows the Update Required status.
Oracle VM Manager Update Required
 
Select the Update Server option from Oracle VM Manager to upgrade one or more hosts. Upgrading a server automatically puts the server into maintenance mode and if possible Live Migrates any running VMs to an available node.
 
Firgure 19 shows the Update Server menu.
Oracle VM Manager Update Server Menu
 
Once the Yum repository has been configured, each Oracle VM Server will have a new files named ovm.repo in the /etc/yum.repos.d directory.
 
The next example shows the contents of the ovm.repo file.
# cat /etc/yum.repos.d /ovm.repo
[ovm_repo]
gpgkey = http://<YUM SERVER IP OR FQDN>/yum/RPM-GPG-KEY-oracle
gpgcheck = 1
baseurl = http://<YUM SERVER IP OR FQDN>/yum/OracleVM/OVM3/latest/x86_64/
 
TIP. Oracle VM Servers that are patched and rebooted by Oracle VM Manager restart in Maintenance Mode. Oracle VM Servers in Maintenance Mode cannot run virtual machine or be edited.
 

Appendix

Patch Update Fails with BUILD FAILED Message

If an upgrade fails with "Failed undeploying application" and/or "BUILD FAILED" messages below, the solution is to access the WebLogic Server Administration Console at https://<ORACLE VM MANAGER 3.0 HOST>:7001/console/login/LoginForm.jsp. Login to the the WebLogic Server Administration Console with the user name and password you seleted during the Oracle VM Manager installation. Once authenticated, locate the "Change Center" section, then click the "Release Configuration" button. Once the "Release Configuration" button has been pressed, the Oracle VM Manager upgrade will run without errors.
 
The following meesage is displayed on the Oracle VM Manager host's console during the upgrade:
Undeploying Oracle VM Manager core ...
Waiting for Oracle VM Manager core to fully undeploy...
Waiting.................................
Failed undeploying application ... Exiting upgrade process.
 
The following message is displayed on the Oracle VM Manager host in the /tmp/upgrade log file.
BUILD FAILED
weblogic.management.ManagementException: [Deployer:149163]The domain edit lock is owned by another session in non-exclusive mode - this deployment operation requires exclusive access to the edit lock and hence cannot proceed. If you are using " Automatically Aquire Lock and Activate Changes" in the console, then the lock will expire shortly so retry this operation.


Upgrade Oracle VM Manager Build 3.1.1.305

# ./runUpgrader.sh
Stating OVM Manager upgrade on Wed May  9 09:38:49 PDT 2012
Oracle VM Manager 3.1.1.305 upgrade utility
Upgrade logfile : /tmp/upgrade-2012-05-09-38.log
It is highly recommended to do a full database repository backup prior to upgrading Oracle VM Manager ...
Press any key to continue ...
Oracle VM Manager is running ...
Verifying installation status ...
Read Oracle VM Manager config file ...
Found Oracle VM Manager install files ...
Found Oracle VM Manager upgrader ...
Found Oracle WebLogic Server ...
Found Java ...
Using the following information :
  Database Host          : localhost
  Database SID           : orcl
  Database LSNR          : 1521
  Oracle VM Schema       : ovs
  Oracle VM Manager UUID : 0004fb00000100009edfaa0f93184f44
  Current Build ID       : 3.0.3.126
  Upgrade from version   : 3.0.3
  Upgrade to version     : 3.1.1
Using /tmp/workdir.mScEt29478 for backup and export location.
Using /tmp/patchdir.xuEM29479 for patching.
Enter password for user ovs :
Undeploying previous version of Oracle VM Manager application ...
Undeploying Oracle VM Manager help ...
Undeploying Oracle VM Manager console ...
Undeploying Oracle VM Manager core ...
Waiting for Oracle VM Manager core to fully undeploy...
Waiting...
Finished undeploying previous version ...
Exporting Oracle VM Manager repository ...
Please wait as this can take a long time ...
Oracle VM Manager repository export completed ...
Creating backup file ...
Oracle VM Manager repository backup in /tmp/ovm-manager-3-backup-2012-05-09.zip
Upgrading Oracle VM Manager ...
Backing up old files to /tmp/ovm-manager-3-backup-2012-05-09-094359...
Removing old files ...
Unpacking Oracle VM Manager 3.1.1.305
`transform_003001001000_010.xsl' -> `/tmp/patchdir.xuEM29479/transform_003001001000_010.xsl'
`transform_003001001000_020.xsl' -> `/tmp/patchdir.xuEM29479/transform_003001001000_020.xsl'
`deletedClasses.xml' -> `/tmp/patchdir.xuEM29479/deletedClasses.xml'
Filtering full repository export to the selective export subset at /tmp/workdir_sel.rDZob29899 ...
cp: omitting directory `/tmp/workdir.mScEt29478/jrnl'
cp: omitting directory `/tmp/workdir.mScEt29478/objs'
  adding: objs/81/818.cl.xml (deflated 73%)
  adding: objs/64/6470.cl.xml (deflated 82%)
  adding: objs/23/2369.cl.xml (deflated 74%)
  adding: objs/50/506.cl.xml (deflated 73%)
  adding: objs/9.cl.xml (deflated 93%)
  adding: objs/88/883.cl.xml (deflated 81%)
  adding: objs/44/445.cl.xml (deflated 87%)
  adding: objs/62/628.cl.xml (deflated 72%)
  adding: objs/74/748.cl.xml (deflated 87%)
  adding: objs/52/5279.cl.xml (deflated 83%)
  adding: objs/16/161.cl.xml (deflated 67%)
  adding: objs/89/899.cl.xml (deflated 72%)
  adding: objs/89/892.cl.xml (deflated 81%)
  adding: objs/36/3695.cl.xml (deflated 73%)
  adding: objs/36/3610.cl.xml (deflated 73%)
  adding: objs/61/615.cl.xml (deflated 81%)
  adding: objs/60/607.cl.xml (deflated 81%)
  adding: objs/13/1354.cl.xml (deflated 77%)
  adding: objs/13/1326.cl.xml (deflated 77%)
  adding: objs/13/1381.cl.xml (deflated 76%)
  adding: objs/49/4988.cl.xml (deflated 83%)
  adding: objs/45/459.cl.xml (deflated 69%)
  adding: objs/29/2920.cl.xml (deflated 71%)
  adding: objs/19/193.cl.xml (deflated 70%)
  adding: objs/14/1408.cl.xml (deflated 76%)
  adding: objs/14/1435.cl.xml (deflated 77%)
  adding: objs/32/3224.cl.xml (deflated 77%)
  adding: objs/12/1241.cl.xml (deflated 76%)
  adding: objs/12/1297.cl.xml (deflated 77%)
  adding: objs/76/764.cl.xml (deflated 68%)
  adding: objs/27/2766.cl.xml (deflated 71%)
Selective export is at /tmp/workdir_sel.rDZob29899
 31 objects selected (out of 4725) to be upgraded
Transform XSL files used:
-rw-r--r-- 1 root root 56678 May  9 09:44 /tmp/patchdir.xuEM29479/transform_003001001000_010.xsl
-rw-r--r-- 1 root root 10079 May  9 09:44 /tmp/patchdir.xuEM29479/transform_003001001000_020.xsl
Changed classes encountered in selective export set:
    com.oracle.ovm.mgr.api.manager.BusinessManagerDbImpl
    com.oracle.ovm.mgr.api.manager.ModelManagerDbImpl
    com.oracle.ovm.mgr.api.manager.RasManagerDbImpl
    com.oracle.ovm.mgr.api.physical.network.BondPortDbImpl
    com.oracle.ovm.mgr.api.physical.network.EthernetPortDbImpl
    com.oracle.ovm.mgr.api.physical.network.InternalPortDbImpl
    com.oracle.ovm.mgr.api.physical.ServerDbImpl
    com.oracle.ovm.mgr.api.virtual.VirtualMachineDbImpl
    com.oracle.ovm.mgr.api.virtual.VirtualMachineTemplateDbImpl
    com.oracle.ovm.mgr.api.virtual.XenHypervisorDbImpl
Upgrading Oracle VM Manager repository ...
Please wait as this can take a long time ...
Oracle VM Manager repository upgrade completed ...
Validating Oracle VM Manager repository ...
Oracle VM Manager repository validation completed ...
Refresh system-jazn-data.xml file ...
Redeploying Oracle VM Manager core container ...
Redeploying Oracle VM Manager console ...
Redeploying Oracle VM Manager help ...
Install ADF Patch ...
Completed upgrade to 3.1.1.305 ...
Writing updated config in /u01/app/oracle/ovm-manager-3/.config
Restart WebLogic ...
Stopping Oracle VM Manager                                 [  OK  ]
Starting Oracle VM ManagerTime out...
OVM Manager upgrade finished on Wed May  9 10:18:27 PDT 2012
#