5.2.1 Running the Installer to Perform the Upgrade

The runInstaller.sh script included on the Oracle VM Manager installation ISO includes an option that allows you to perform an upgrade of a previous version of Oracle VM Manager.

# ./runInstaller.sh
Oracle VM Manager Release 3.3.x Installer

Oracle VM Manager Installer log file:
/tmp/ovm-manager-3-install-yyyy-mm-dd-xxxxxx.log

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

   Select Number (1-4): 2

Verifying upgrading prerequisites ...
Starting Upgrade ...

Reading database parameters from config ...

It is also possible to trigger the upgrade process by passing the correct installtype parameter on the command line:

# ./runInstaller.sh --installtype Upgrade

If you do not have both the zip and unzip packages installed on the system that you are upgrading, the installer exits with an error notifying you to install these packages before proceeding with the upgrade.

You are prompted to provide the passwords for each component during the upgrade procedure. You must enter the password you set for that component during the original installation, or the current password if it has been changed since installation.

A log of the upgrade is available in the /tmp/ovm-manager-3-install-date_id.log file.

Tip

When you have completed an upgrade of Oracle VM Manager it is recommended that you ensure that the latest packages required for the VNC and Serial Consoles are also installed. The instructions for installing these packages are provided in Section 6.5, “Installing and Upgrading Packages Required For The VNC and Serial Console”.

To upgrade Oracle VM Manager:

  1. Log in to the Oracle VM Manager host computer as the root user.

  2. Oracle VM Manager must be running to perform the upgrade. If Oracle VM Manager is not running, start it. On Linux:

    # service ovmm start

    If Oracle VM Manager is not running when you run the installation script, an error is returned by the script and the installer exits.

  3. Mount the Oracle VM Manager ISO file or burn a DVD-ROM disc and mount that. See either Section 1.3, “Installation From DVD-ROM or CD-ROM” or Section 1.4, “Loopback ISO Mounts” for more information.

  4. Start the Oracle VM Manager installation script, for example:

    # cd /OVMCD
    # ./runInstaller.sh

    The installer starts and presents you with a variety of options:

    Oracle VM Manager Release 3.3.x Installer
    
    Oracle VM Manager Installer log file:
    /tmp/ovm-manager-3-install-yyyy-mm-dd-xxxxxx.log
    
    Please select an installation type:
       1: Install
       2: Upgrade
       3: Uninstall
       4: Help
    
       Select Number (1-4): 2
    
    Verifying upgrading prerequisites ...
    Starting Upgrade ...
    
    Reading database parameters from config ...

    Enter the menu number for the Upgrade option and press Enter to continue with the upgrade. You are prompted for the password that must be used to access the current Oracle VM Manager database:

    Typically the current Oracle VM Manager database password will be the same as the 
    Oracle VM Manager application password.
    
    Although you need to enter a *new* password for Oracle WebLogic Server 12c, it 
    may be the same password that you used for the previous Oracle VM Manager installation.
    
    Database Repository
    ==========================
    Please enter current Oracle VM Manager database password for user ovs:  

    Enter the password that should be used to access the database. If you set a system-wide password during the original installation and have not changed the database password at any stage, this password should be used here. This password continues to be used for the database after the upgrade is complete. If you enter this password incorrectly and the installer is unable to access the database, the installer exits with an error message.

    The installer prompts you for the current Oracle VM Manager password. This is the same password that you use to log into the Oracle VM Manager Web Interface, using the admin username.

    Oracle VM Manager application
    =============================
    Please enter current Oracle VM Manager application password for user admin:

    Enter the password. If you set a system-wide password during the original installation and have not changed the admin user password at any stage, this password should be used here. This password continues to function after the upgrade. If you intend to change it, you must do so after the upgrade is complete.

    The installer prompts you to set the new Oracle WebLogic Server password. The installer does not need to know the original password for this operation. You can choose to either reuse the original password, or set a new password here. Keep in mind that if you set a new password, you should make note of the new password and ensure that anybody who may need to know this password is informed via your own site processes. Since this step essentially sets a new password, the installer also prompts you to confirm your password entry to ensure that you have not mistyped it.

    Oracle WebLogic Server 12c
    ==========================
    Please enter a "new" Oracle WebLogic Server 12c user password for user weblogic: 
    Please enter a "new" Oracle WebLogic Server 12c user password for user weblogic (confirm):

    You are prompted for the system's FQDN (fully qualified domain name) or IP address to use during the generation of the SSL certificate that should be used for HTTPS connections to Oracle VM Manager:

    Please enter your fully qualified domain name, e.g. ovs123.us.oracle.com, 
    (or IP address) of your management server for SSL certification 
    generation 192.168.0.254 [192.168.0.254]: manager.example.com

    It is important that you specify the hostname, fully qualified domain name or the IP address that is to be used when accessing the Oracle VM Manager Web Interface, so that the SSL certificate hostname matches the hostname portion of the URL entered into the web browser.

    The installer displays the current release number and the release number to which Oracle VM Manager is to be upgraded, and presents a final option to exit from the upgrade process:

    Verifying configuration ...
    
    Upgrading from version 3.x.y.z to version 3.3.v.w
    
    Start installing the configured components:
       1: Continue
       2: Abort
    
       Select Number (1-2): 1

    Select the Continue option to continue with the upgrade process.

    Verifying upgrading prerequisites ...
    Starting Upgrade ...
    
    Reading database parameters from config ...
    
    Verifying configuration ...
    
    Upgrading from version 3.x.y.z to version 3.3.v.w
    
    Running full database backup ...
    Successfully backed up database as 3.x.y_preUpgradeBackup-yyyymmdd_xxxxxx

    The upgrade process automatically ensures that the database for the current installation is fully backed up prior to starting the upgrade. This ensures that you are able to roll back to the version that you currently have installed if something fails during the upgrade process. This backup file is located in /u01/app/oracle/mysql/dbbackup/.

    Before the actual upgrade takes place, a pre-upgrade script runs to remove any existing job history. This process can take quite some time, depending on the number of jobs in the job history. The pre-upgrade process provides output that indicates the number of jobs that must be deleted at different stages of its progress so that you can monitor its status:

    Running ovm_preUpgrade script, please be patient this may take a long time ...
    Sun May 18 13:53:02 2014: Deleting 4163 Jobs before upgrade.
    Sun May 18 13:54:02 2014: 200 Jobs have been deleted. 3963 Jobs remaining.
    Sun May 18 13:55:00 2014: 400 Jobs have been deleted. 3763 Jobs remaining.
    Sun May 18 13:55:58 2014: 600 Jobs have been deleted. 3563 Jobs remaining.
    Sun May 18 13:56:56 2014: 800 Jobs have been deleted. 3363 Jobs remaining.
    ...
    Sun May 18 14:11:39 2014: 3800 Jobs have been deleted. 363 Jobs remaining.
    Sun May 18 14:12:43 2014: 4000 Jobs have been deleted. 163 Jobs remaining.
    Sun May 18 14:12:55 2014: Jobs have been deleted.
    

    The rest of the upgrade process is automated and continues as follows:

    Stopping service on Linux: ovmm
    Exporting core database, please be patient this may take a long time  ... 
    NOTE: To monitor progress, open another terminal session and run: 
    tail -f /var/log/ovmm/ovm-manager-3-install-YYYY-MM-DD-HHmmss.log 
    
    Product component : Java in '/u01/app/oracle/java'
    Java is installed ...
    
    Removing Java installation ...
    
    Installing Java ...
    
    DB component : MySQL RPM package
    MySQL RPM package installed by OVMM was found...
    Removing MySQL RPM package installation ...
    
    Installing Database Software...
    Retrieving MySQL Database 5.6 ...
    Unzipping MySQL RPM File ...
    Installing MySQL 5.6 RPM package ...
    Configuring MySQL Database 5.6 ...
    Installing MySQL backup RPM package ...
    
    Product component : Oracle VM Manager in '/u01/app/oracle/ovm-manager-3/'
    Oracle VM Manager is installed ...
    Removing Oracle VM Manager installation ...
    
    Product component : Oracle WebLogic Server in '/u01/app/oracle/Middleware/'
    Oracle WebLogic Server is installed
    
    Removing Oracle WebLogic Server installation ...
    Service ovmm is deleted.
    
    Retrieving Oracle WebLogic Server 12c and ADF ...
    Installing Oracle WebLogic Server 12c and ADF ...
    Applying patches to Weblogic ...
    
    Installing Oracle VM Manager Core ...
    Retrieving Oracle VM Manager Application ...
    Extracting Oracle VM Manager Application ...
    
    Retrieving Oracle VM Manager Upgrade tool ...
    Extracting Oracle VM Manager Upgrade tool ...
    Installing Oracle VM Manager Upgrade tool ...
    
    Creating Oracle WebLogic Server domain ...
    Starting Oracle WebLogic Server 12c ...
    Creating Oracle VM Manager user 'admin' ...
    Upgrading core database, please be patient this may take a long time ...
    NOTE: To monitor progress, open another terminal session and run: 
    tail -f /var/log/ovmm/ovm-manager-3-install-YYYY-MM-DD-HHmmss.log 
    
    Retrieving Oracle VM Manager CLI tool ...
    Extracting Oracle VM Manager CLI tool...
    Installing Oracle VM Manager CLI tool ...
    
    Configuring Https Identity and Trust...
    Deploying Oracle VM Manager Core container ...
    Configuring Client Cert Login...
    Deploying Oracle VM Manager UI Console ...
    Deploying Oracle VM Manager Help ...
    Disabling HTTP access...
    
    Retrieving Oracle VM Manager Shell & API ...
    Extracting Oracle VM Manager Shell & API ...
    Installing Oracle VM Manager Shell & API ...
    
    Retrieving Oracle VM Manager Wsh tool ...
    Extracting Oracle VM Manager Wsh tool ...
    Installing Oracle VM Manager Wsh tool ...
    
    Retrieving Oracle VM Manager Tools ...
    Extracting Oracle VM Manager Tools ...
    Installing Oracle VM Manager Tools ...
    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 ...
    Starting Oracle VM Manager instance ...
    Waiting for the application to initialize ...
    Oracle VM Manager is running ...
    
    Please wait while WebLogic configures the applications...
    
    Installation Summary
    --------------------
    Database configuration:
      Database type               : MySQL
      Database host name          : localhost
      Database name               : ovs
      Database listener port      : 49501
      Database user               : ovs
    
    Oracle WebLogic Server configuration:
      Administration username     : weblogic
    
    Oracle VM Manager configuration:
      Username                    : admin
      Core management port        : 54321
      UUID                        : 0004fb000001000089b5dd06719d804c
    
    
    Passwords:
    There are no default passwords for any users. The passwords to use for Oracle VM Manager, 
    Database, and Oracle WebLogic Server have been set by you during this installation. In the 
    case of a default install, all passwords are the same.
    
    Oracle VM Manager UI:
      https://manager.example.com:7002/ovm/console
    Log in with the user 'admin', and the password you set during the installation.
    
    Note that you must install the latest ovmcore-console package for your Oracle Linux 
    distribution to gain VNC and serial console access to your Virtual Machines (VMs).
    Please refer to the documentation for more information about this package.
    
    For more information about Oracle Virtualization, please visit:
      http://www.oracle.com/virtualization/
    
    Oracle VM Manager upgrade complete.
    
    Please remove configuration file /tmp/ovm_configp3Jrjk.