Updates to Oracle VDI release 3.3 are supported only on Oracle Solaris platforms. Updates are supported only from the following releases of Oracle VDI:
Release 3.2.2
Release 3.2.1
Release 3.2
To update from any other release of Oracle VDI, contact Oracle Support.
By default, Oracle VDI release 3.3 uses an embedded MySQL Server database instead of the bundled MySQL Cluster database. The following table summarizes the configuration changes that happen when you update to release 3.3.
Supported Configuration | Configuration Changes |
---|---|
Single Oracle VDI Host |
|
High Availability with bundled MySQL Cluster |
|
High Availability with Remote MySQL |
|
To update Oracle VDI, follow the instructions for your specific Oracle VDI configuration:
In addition to updating Oracle VDI, you might also have to update your virtualization platform.
Before you begin:
Ensure that no users are logged in to Oracle VDI on the host. The update stops all Oracle VDI services.
Ensure that you have the user name and password of the privileged administrator of the remote database.
Check that the host meets the requirements for installing Oracle VDI, see Section 3.2, “Oracle VDI System Requirements”.
Check that the host meets the requirements for updating Oracle VDI, see Section 3.8, “Updating Oracle VDI to Release 3.3”.
Download the Oracle VDI software archive to a temporary location on the host.
Log in as root on the host.
Make a backup of the Oracle VDI database.
While the backup job is running, all other jobs are stopped or held in the queue.
From the CLI, run the vda-backup command.
# /opt/SUNWvda/sbin/vda-backup -p <path-to-directory> -o <output-file-name>
Use the vda-backup
-h
to see all the options for
this command.
In Oracle VDI Manager:
Go to Settings → VDI Center.
Select the Database tab.
In the VDI Database Backup section, click Backup.
Unzip the Oracle VDI software archive and change working directory to the extracted directory.
# unzip vda_3.3_solaris_amd64.zip # cd vda_3.3_solaris_amd64
Preserve the Oracle VDI configuration on the host.
# ./vda-preserve
This step preserves the Oracle VDI configuration settings and stops Oracle VDI services on the host.
Install the software.
# ./vda-install
An existing installation is detected and you are prompted to update the installation.
Oracle Virtual Desktop Infrastructure 3.3 Installation Oracle VDI 3.2.2 is already installed on this host. Do you want to update to Oracle VDI 3.3 now? ([y]/n)
To update, press the Return key.
The Software License Agreement is displayed and you are prompted to accept its terms and conditions.
After accepting the license agreement, the update begins and you are prompted for the administrator password for the remote database.
Oracle VDI 3.3 Installation Updating from Oracle VDI 3.2.2 to Oracle VDI 3.3 MySQL VDA Database Update. Enter remote database administrator privileged user name: mydbadmin Enter remote database administrator privileged password:
Type the administrator password and press the Return key.
The Oracle VDI components are updated.
At the end of the update, you are prompted to configure Oracle VDI.
Do you want to configure Oracle VDI 3.3 now? ([y]/n)
To configure the host, press the Return key.
The host is configured using the details from the preserved configuration.
To configure the host later, type n
and
press the Return key. Use the vda-config
command to configure.
Before you begin:
Ensure that no users are logged in to the Oracle VDI Center. The update stops all Oracle VDI services in the Center.
Check that the hosts meet the requirements for installing Oracle VDI, see Section 3.2, “Oracle VDI System Requirements”.
Check that the hosts meet the requirements for updating Oracle VDI, see Section 3.8, “Updating Oracle VDI to Release 3.3”.
Make a backup of the Oracle VDI database.
The backup can be made on any host in the Oracle VDI Center.
While the backup job is running, all other jobs in the Oracle VDI Center are stopped or held in the queue.
From the CLI, run the vda-backup command.
# /opt/SUNWvda/sbin/vda-backup -p <path-to-directory> -o <output-file-name>
Use the vda-backup
-h
to see all the options for
this command.
In Oracle VDI Manager:
Go to Settings → VDI Center.
Select the Database tab.
In the VDI Database Backup section, click Backup.
Preserve the Oracle VDI configuration on all hosts in the Oracle VDI Center.
Start with the primary, then the first secondary, followed by the second secondary, and finally the additional secondaries.
Repeat the following steps on each Oracle VDI host.
Download the Oracle VDI software archive to a temporary location on the host.
Log in as root on the host.
Unzip the Oracle VDI software archive and change working directory to the extracted directory.
# unzip vda_3.3_solaris_amd64.zip # cd vda_3.3_solaris_amd64
Run the preservation script.
# ./vda-preserve
This step preserves the Oracle VDI configuration settings and stops Oracle VDI services on the host.
Install and configure the software on the primary host.
Install the software.
# ./vda-install
An existing installation is detected and you are prompted to update the installation.
Oracle Virtual Desktop Infrastructure 3.3 Installation Oracle VDI 3.2.2 is already installed on this host. Do you want to update to Oracle VDI 3.3 now? ([y]/n)
To update, press the Return key.
The Software License Agreement is displayed and you are prompted to accept its terms and conditions.
After accepting the license agreement, the update begins.
At the end of the update, you are prompted to configure Oracle VDI.
Do you want to configure Oracle VDI 3.3 now? ([y]/n)
To configure the host, press the Return key.
The primary host is configured using the details from the preserved configuration.
To configure the primary host later, type
n
and press the Return key. Use the
vda-config command to configure. If
you do this, you must configure the primary
before you configure
any secondary hosts.
Install and configure the software on all the secondary hosts.
Start with the first secondary, then the second secondary, followed by the additional secondaries.
Only configure one secondary host at a time. Wait for the configuration to complete before adding additional secondary hosts.
Repeat the following steps on each Oracle VDI host.
Install the software.
# ./vda-install
An existing installation is detected and you are prompted to update the installation.
Oracle Virtual Desktop Infrastructure 3.3 Installation Oracle VDI 3.2.2 is already installed on this host. Do you want to update to Oracle VDI 3.3 now? ([y]/n)
To update, press the Return key.
The Software License Agreement is displayed and you are prompted to accept its terms and conditions.
After accepting the license agreement, the update begins.
At the end of the update, you are prompted to configure Oracle VDI.
Do you want to configure Oracle VDI 3.3 now? ([y]/n)
To configure the secondary host, press the Return key.
You are prompted to enter the DNS name of the primary host in the Oracle VDI Center.
Oracle Virtual Desktop Infrastructure 3.3 Configuration Enter the primary Oracle VDI Host [primary.example.com]:
To configure the secondary host later, type
n
and press the Return key. Use the
vda-config command to configure. If
you do this, you must configure the primary
before you configure
any secondary hosts.
To accept the original primary host, press the Return key.
The MD5 fingerprint of the primary's SSL certificate is displayed and you are prompted to enter the password of the root user on the primary host.
Retrieving certificate from primary.example.com... MD5 fingerprint is 7F:59:0C:92:42:FD:13:34:B5:6A:B2:6A:BA:06:C4:E7. Enter the root password for primary.example.com:
Check that the MD5 fingerprint matches the fingerprint of the primary host.
This is an important security step that ensures you are adding the secondary to a genuine Oracle VDI Center. To check the fingerprint:
Log in as root on the primary host.
Use the vda-center agent-status command to display the MD5 fingerprint of the primary host.
# /opt/SUNWvda/sbin/vda-center agent-status Agent is up for 0 day(s), 0:6. MD5 fingerprint is 7F:59:0C:92:42:FD:13:34:B5:6A:B2:6A:BA:06:C4:E7.
On the secondary host, enter root's password and press the Return key.
The host is configured using the supplied settings.
Before you begin:
Ensure that no users are logged in to the Oracle VDI Center. The update stops all Oracle VDI services in the Center.
Ensure that you have the user name and password of the privileged administrator of the remote database.
Check that the hosts meet the requirements for installing Oracle VDI, see Section 3.2, “Oracle VDI System Requirements”.
Check that the hosts meet the requirements for updating Oracle VDI, see Section 3.8, “Updating Oracle VDI to Release 3.3”.
Make a backup of the Oracle VDI database.
While the backup job is running, all other jobs in the Oracle VDI Center are stopped or held in the queue.
From the CLI, run the vda-backup command.
# /opt/SUNWvda/sbin/vda-backup -p <path-to-directory> -o <output-file-name>
Use the vda-backup
-h
to see all the options for
this command.
In Oracle VDI Manager:
Go to Settings → VDI Center.
Select the Database tab.
In the VDI Database Backup section, click Backup.
Preserve the Oracle VDI configuration on all hosts in the Oracle VDI Center.
Start with the primary, then the first secondary, followed by the additional secondaries.
Repeat the following steps on each Oracle VDI host.
Download the Oracle VDI software archive to a temporary location on the host.
Log in as root on the host.
Unzip the Oracle VDI software archive and change working directory to the extracted directory.
# unzip vda_3.3_solaris_amd64.zip # cd vda_3.3_solaris_amd64
Run the preservation script.
# ./vda-preserve
This step preserves the Oracle VDI configuration settings and stops Oracle VDI services on the host.
Install and configure the software on the primary host.
Install the software.
# ./vda-install
An existing installation is detected and you are prompted to update the installation.
Oracle Virtual Desktop Infrastructure 3.3 Installation Oracle VDI 3.2.2 is already installed on this host. Do you want to update to Oracle VDI 3.3 now? ([y]/n)
To update, press the Return key.
The Software License Agreement is displayed and you are prompted to accept its terms and conditions.
After accepting the license agreement, the update begins and you are prompted for the administrator password for the remote database.
Oracle VDI 3.3 Installation Updating from Oracle VDI 3.2.2 to Oracle VDI 3.3 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.
The Oracle VDI components are updated.
At the end of the update, you are prompted to configure Oracle VDI.
Do you want to configure Oracle VDI 3.3 now? ([y]/n)
To configure the host, press the Return key.
The primary host is configured using the details from the preserved configuration.
To configure the primary host later, type
n
and press the Return key. Use the
vda-config command to configure. If
you do this, you must configure the primary
before you configure
any secondary hosts.
Install and configure the software on all the secondary hosts.
Start with the first secondary, followed by the additional secondaries.
Only configure one secondary host at a time. Wait for the configuration to complete before configuring additional secondary hosts.
Repeat the following steps on each Oracle VDI host.
Install the software.
# ./vda-install
An existing installation is detected and you are prompted to update the installation.
Oracle Virtual Desktop Infrastructure 3.3 Installation Oracle VDI 3.2.2 is already installed on this host. Do you want to update to Oracle VDI 3.3 now? ([y]/n)
To update, press the Return key.
The Software License Agreement is displayed and you are prompted to accept its terms and conditions.
After accepting the license agreement, the update begins.
At the end of the update, you are prompted to configure Oracle VDI.
Do you want to configure Oracle VDI 3.3 now? ([y]/n)
To configure the secondary host, press the Return key.
You are prompted to enter the DNS name of the primary host in the Oracle VDI Center.
Oracle Virtual Desktop Infrastructure 3.3 Configuration Enter the primary Oracle VDI Host [primary.example.com]:
To configure the secondary host later, type
n
and press the Return key. Use the
vda-config command to configure. If
you do this, you must configure the primary
before you configure
any secondary hosts.
To accept the original primary host, press the Return key.
The MD5 fingerprint of the primary's SSL certificate is displayed and you are prompted to enter the password of the root user on the primary host.
Retrieving certificate from primary.example.com... MD5 fingerprint is 7F:59:0C:92:42:FD:13:34:B5:6A:B2:6A:BA:06:C4:E7. Enter the root password for primary.example.com:
Check that the MD5 fingerprint matches the fingerprint of the primary host.
This is an important security step that ensures you are adding the secondary to a genuine Oracle VDI Center. To check the fingerprint:
Log in as root on the primary host.
Use the vda-center agent-status command to display the MD5 fingerprint of the primary host.
# /opt/SUNWvda/sbin/vda-center agent-status Agent is up for 0 day(s), 0:6. MD5 fingerprint is 7F:59:0C:92:42:FD:13:34:B5:6A:B2:6A:BA:06:C4:E7.
On the secondary host, enter root's password and press the Return key.
The host is configured using the supplied settings.