Cooperar internacionalmente para alcanzar el desarrollo

About the VirtualBox Installation Script

Oracle VM VirtualBox is installed and uninstalled with the vb-install script. VirtualBox is delivered as two packages, an open source package (the Base Pack) and an Oracle proprietary package (the Extension Pack).

The Oracle VDI software archive only includes the Extension Pack. When you run the vb-install script, the script automatically downloads the Base Pack using the wget program. If this fails, for example due to network connectivity problems, the script exits and you must manually download the Base Pack. You can download the Base Pack and the Extension Pack from the VirtualBox download page.

The following table lists the options that can be used with vb-install script to automate the installation on several servers with a script.

Table 4.1. vb-install Script Options

Option Description

-f Forces existing virtual machines to be deleted.

-n user Specifies the user name of the VirtualBox user. The default is root.

-o port Specifies the SSL port to use to connect to VirtualBox. The default is port 443 if the user is root, otherwise port 18083.

-p Requires input from standard input (stdin) to enter the password in a secure way.

-u Uninstalls the currently installed release of VirtualBox.

Steps

1. Download the Oracle VDI software archive. 2. Become superuser (root) on the host.

3. Unzip the Oracle VDI software archive and change working directory to the extracted directory. • On Oracle Linux hosts:

Updating Oracle VM VirtualBox

# 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. Unzip the VirtualBox archive and change working directory to the extracted directory. # unzip vbox_4.2.zip

# cd vbox_4.2

5. Install VirtualBox. # ./vb-install

The installation script downloads the VirtualBox Base Pack, and then installs both the Base Pack and the Extension Pack. You complete the installation by providing a user name, a password, and a port number to use for SSL connections.

If the Base Pack download fails, you must manually download it from the VirtualBox download page. Make sure you download the release that is bundled and supported with this release of Oracle VDI. Copy the Base Pack to the same folder as the vb-install script, and then run the script again.

4.1.4. Updating Oracle VM VirtualBox

You update Oracle VM VirtualBox by installing the new release bundled with an Oracle VDI release. When you update, the existing version of VirtualBox must first be uninstalled. When you install the new release, the installation script prompts you to uninstall existing release. Alternatively, you can uninstall the existing release manually with the vb-install -u command.

When you uninstall VirtualBox, you are prompted to shut down any virtual machines that are running. You must shut down all running virtual machines before uninstalling. You are also prompted to unregister and delete the virtual machines. If you choose to unregister and delete, you cannot register the virtual machines again after the update.

After you update VirtualBox, remember to update the guest additions in all templates and desktops. You might need to upgrade the operating system on your hosts in order to meet the VirtualBox installation requirements for this release. If you need to upgrade the operating system, consider the following:

• 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. This might have an impact if you are using local storage or network file system storage.

• If you use iSCSI or ZFS storage, all VirtualBox hosts on Oracle Linux platforms must run the same kernel and kernel version. This is a requirement of the Oracle Cluster File System version 2 (OCFS2) file system used for these storage types. If you use these storage types, you must upgrade all the hosts for a desktop provider in parallel.

• Do not change the host name or IP address of a VirtualBox host as part of the operating system upgrade.

Updating Oracle VM VirtualBox

If you need to change these details, remove the host from the desktop provider and then perform a fresh installation of VirtualBox.

The following is the recommended procedure for updating an Oracle VM VirtualBox Desktop Provider:

Updating an Oracle VM VirtualBox Desktop Provider

1. Ensure that all desktops hosted by the desktop provider are shut down. 2. Back up the storage.

This is a precautionary step to ensure you can recover in the event of failure.

The action required depends on the storage type and the operating system of the VirtualBox hosts, as shown in the following table.

Storage Type Platform Action

Local Storage Oracle Solaris and Linux

Back up the directory used for local storage to a separate host.

Network File System

Oracle Solaris and Linux

If the file system is a share on another host, unmount it. If the file system is shared by the host, back it up to a separate host.

iSCSI Linux Ensure you have a backup of the iSCSI LUN. Sun ZFS Linux Ensure you have a backup of the ZFS pool.

Sun ZFS Oracle Solaris If the storage is a local ZFS pool on the host, back it up to a separate host.

For all other ZFS storage, no action is needed. 3. In Oracle VDI, enable maintenance mode for the VirtualBox hosts.

See Section 8.9.1, “Oracle VM VirtualBox and Microsoft Hyper-V Host Maintenance” for details. 4. Upgrade the operating system, or install the new operating system, on the VirtualBox hosts.

When you upgrade the operating system, do not change the host name or IP address of the hosts. Ensure that the hosts meet the operating system requirements for installing Oracle VDI:

• Section 4.1.2.2, “System Requirements for VirtualBox Hosts on Oracle Linux Platforms” • Section 4.1.2.3, “System Requirements for VirtualBox Hosts on Oracle Solaris 11 Platforms” • Section 4.1.2.4, “System Requirements for VirtualBox Hosts on Oracle Solaris 10 Platforms” 5. Rebuild the VirtualBox kernel module on the VirtualBox hosts.

If you performed a fresh installation of Oracle Linux 6 or Oracle Solaris 11, you do not need to do this because you perform a fresh installation of VirtualBox in the next step.

Run the following command as root: # /etc/init.d/vboxdrv setup

Configuring the VRDP Port Range

See Section 4.1.3, “Installing Oracle VM VirtualBox” for details. 7. Restore the storage.

The action required depends on the storage type and the operating system of the VirtualBox hosts, as shown in the following table.

Storage Type Platform Action

Local Storage Oracle Solaris and Linux

If the directory used for local storage was destroyed by the operating system upgrade, recreate it and restore the content from the backup.

If the directory was not destroyed, verify that the contents of the directory have not changed. If they have changed, restore from the backup.

Network File System

Oracle Solaris and Linux

If the file system is a share on another host, mount it again. If the file system is shared by the host and it was destroyed by the operating system upgrade, recreate the share and restore the content from the backup.

Ensure the mount point is in the same location as before the upgrade.

iSCSI Linux No action is needed.

Sun ZFS Linux No action is needed.

Sun ZFS Oracle Solaris If the storage is a local ZFS pool on the host and it was destroyed by the operating system upgrade, recreate it and restore the content from the backup.

If the storage is a local ZFS pool on the host and it was not destroyed by the operating system upgrade, verify that the contents of the directory have not changed. If they have changed, restore from the backup.

For all other ZFS storage, no further action. 8. Reconfigure the VirtualBox hosts for a desktop provider.

This is needed to ensure that the credentials of the VirtualBox user, or that the SSL or SSH certificates, are up-to-date. See Section 8.8.1, “Reconfiguring an Oracle VM VirtualBox Host” for details.

9. In Oracle VDI, enable the VirtualBox hosts to bring them out of maintenance mode. 10. Reload the iSCSI or Sun ZFS storage configuration for the desktop provider.

Required only for Oracle Linux desktop providers that use iSCSI or Sun ZFS storage. See

Section 8.8.2, “Reloading iSCSI or Sun ZFS Storage Configuration on Oracle VM VirtualBox Hosts” for details.