2.4. Updating Oracle VDI to Release 3.5

2.4.1. Oracle VDI Update Requirements
2.4.2. Updating an Oracle VDI Center

2.4.1. Oracle VDI Update Requirements

Updates to Oracle VDI release 3.5 are supported only from the following releases of Oracle VDI:

  • 3.4.1

  • 3.4

To update from any other release of Oracle VDI, contact Oracle Support.

When you update, you might also need to upgrade the operating system on your hosts to meet the installation requirements for this release of Oracle VDI. The update instructions indicate the point at which you should perform the operating system upgrade. Ensure that you have adequate backups of your hosts so that you can recover in the event of a failure. When you upgrade a host, do not change the host's DNS name or IP address as part of the upgrade. If you need to change these details, you must perform a fresh installation of Oracle VDI after removing the existing version.

If your Oracle VDI hosts are also used as Oracle VM VirtualBox virtualization hosts, you must also take the VirtualBox requirements into account, see Section 4.1.2, “System Requirements for Oracle VM VirtualBox” and Section 4.1.4, “Updating Oracle VM VirtualBox” for details.

Sun Ray Operating Software

When you update Oracle VDI, you should also check whether updates to the Sun Ray Operating Software (Client Firmware) are available. See Section 2.2.12, “Sun Ray Operating Software” for details of how to obtain and install the firmware.

Oracle Virtual Desktop Client

When you update Oracle VDI, you should also check for the latest release of Oracle Virtual Desktop Client, see Section 2.2.13, “Oracle Virtual Desktop Client”.

Updating Virtualization Platforms

In addition to updating Oracle VDI, you might also have to update your virtualization platform. See the following for details of what is supported in this release:

2.4.2. Updating an Oracle VDI Center

Before you begin:

  1. Make a backup of the Oracle VDI database.

    See Section 8.7.1, “Backing Up the Oracle VDI Database” for details.

  2. Copy the database backup to a separate host.

    You do not need to perform this step if you created the database backup on an NFS share on a different host.

    You might need this file if a failure occurs during or after the update.

    It is best to copy the database backup to a host that is not a member of the Oracle VDI Center.

  3. Back up the Oracle VDI configuration and stop Oracle VDI services on all hosts in the Oracle VDI Center.

    Caution

    Once you begin this step, do not use Oracle VDI Manager or the vda command until the update process has been finished on all hosts in the Oracle VDI Center.

    Start with the primary host, followed by the secondary hosts, in the Oracle VDI Center.

    Repeat the following steps on each Oracle VDI host.

    1. Download the Oracle VDI software archive to a temporary location on the host.

    2. Become superuser (root) on the host.

      See Section 2.2.6, “User Requirements” for details.

    3. Unzip the Oracle VDI software archive and change working directory to the extracted directory.

      • On Oracle Linux hosts:

        # unzip vda_3.5_linux.zip
        # cd vda_3.5_linux
      • On Oracle Solaris 11 hosts:

        # unzip vda_3.5_solaris_11plus_amd64.zip
        # cd vda_3.5_solaris_11plus_amd64
      • On Oracle Solaris 10 hosts:

        # unzip vda_3.5_solaris_10_amd64.zip
        # cd vda_3.5_solaris_10_amd64
    4. Run the vda-preserve command.

      # ./vda-preserve

      This command creates a zip file, /var/opt/SUNWvda/preserve/vda-preserve.zip.

    5. Copy the vda-preserve.zip file to a separate host.

      The zip file containing the preserved Oracle VDI configuration is unique to each host. Make sure you can identify each host's zip file.

      You might need this file if a failure occurs during or after the update.

      It is best to copy the zip file to a host that is not a member of the Oracle VDI Center.

  4. (Optional) Upgrade the operating system on the hosts in the Oracle VDI Center.

    You might need to upgrade the operating system on your hosts in order to meet the installation requirements for this release of Oracle VDI.

    You cannot upgrade the operating system from Oracle Linux 5 to Oracle Linux 6, or from Oracle Solaris 10 to Oracle Solaris 11. You must perform a fresh installation of Oracle Linux 6 or Oracle Solaris 11.

    Ensure that the hosts meet the operating system requirements for installing Oracle VDI:

    Before you upgrade, ensure that you have backups of all your hosts in case you need to revert to the previous version of Oracle VDI.

    When you upgrade the operating system, do not change the host name or IP address of the host.

    After you upgrade the operating system, you might need to download the Oracle VDI software archive to a temporary location on the host and extract it.

  5. Install and configure the software on all hosts in the Oracle VDI Center.

    Install and configure the software on the primary host first.

    When the configuration of the primary host is complete, install and configure the software on all the secondary hosts. Only configure one secondary host at a time. Wait for the configuration to complete before you configure another secondary host.

    Warning

    If you are prompted to reboot the host to complete the installation, ensure you do this.

    Repeat the following steps on each Oracle VDI host.

    1. Ensure that the zip file containing the host's preserved Oracle VDI configuration is available on the host.

      By default, the zip file is /var/opt/SUNWvda/preserve/vda-preserve.zip. If the zip file is missing, restore it from the copy you made. You cannot update Oracle VDI without this file.

      The zip file containing the preserved Oracle VDI configuration is unique to each host. You cannot use the zip file from one host to update a different host.

    2. Become superuser (root) on the host.

      See Section 2.2.6, “User Requirements” for details.

    3. Change working directory to the directory extracted from the Oracle VDI software archive.

    4. Install the software.

      If the zip file containing the preserved Oracle VDI configuration is in the default location, use the following command:

      # ./vda-install

      If the zip file containing the preserved Oracle VDI configuration is not in the default location, or if the zip file has been renamed, use the following command:

      # ./vda-install -p path-to-zip-file
      

      An existing installation is detected and you are prompted to update the installation.

      Oracle Virtual Desktop Infrastructure 3.5 Installation
              
      Found preserved data from 3.4.1.
      Do you want to update to Oracle VDI 3.5 now? ([y]/n)
    5. To update, press the Return key.

      If you are using a remote MySQL database, you are prompted for the administrator password for the remote database.

      Oracle VDI 3.5 Installation
      Updating from Oracle VDI 3.4.1 to Oracle VDI 3.5
      
      MySQL VDA Database Update.
      Enter remote database administrator privileged user name: mydbadmin
      Enter remote database administrator privileged password:

      Enter the administrator password and press the Return key.

      At the end of the update, you are prompted to configure Oracle VDI.

      Do you want to configure Oracle VDI 3.5 now? ([y]/n)
    6. To configure the host, press the Return key.

      To configure the host later, type n and press the Return key. Use the vda-config command to configure the host. If you do this, you must configure the primary host before you configure any secondary hosts.

      If you configure the host now, the host is configured using the details from the preserved configuration.

      On secondary hosts, the MD5 fingerprint of the primary host's SSL certificate is displayed and you are prompted to enter the credentials for becoming the root user on the primary host. To check the MD5 fingerprint, run the vda-center agent-status command as root on the primary host. Enter the credentials as follows:

      • On Oracle Linux and Oracle Solaris hosts where root is not configured as a role, enter root's password and press the Return key.

      • On Oracle Solaris hosts where root is configured as a role, enter the credentials for assuming the root role and press the Return key.

  6. Clear your browser's cache.

    It is best to clear your browser's cache before logging in to Oracle VDI Manager. This prevents any display problems after the update.