Chapter 3. Installing the Software

In this chapter, you install and configure Oracle VDI, install Oracle VM VirtualBox (VirtualBox), and then test the installation.

Installing Oracle VDI

Log in as root, or assume the root role (Oracle Solaris), on the host. Change working directory to the directory containing the Oracle VDI software archive. Unzip the Oracle VDI software archive and install the software with the vda-install command, as follows:

  • On Oracle Solaris 10 hosts:

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

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

    # unzip vda_3.5_linux.zip
    # cd vda_3.5_linux

At the end of the installation, you are prompted to configure Oracle VDI. Press the Return key to start the configuration. A list of configuration types is displayed.

1 New Oracle VDI Center
2 Join Oracle VDI Center
                
Select (1/2):

Type 1 (for a new Oracle VDI Center) and press the Return key. A list of configuration settings is displayed.

Review the settings for a new Oracle VDI Center:
   Name: VDI Center
   Administrator Password: ********
   VDI Administrator (super-user): root
   DNS name of this host: vdi.example.com
   Maximum number of sessions on this host: 100
   User ID range start: 150000
   Database: Embedded Oracle VDI

Do you want to create the Oracle VDI Center now? 
Enter 'c' to customize the settings. ([y]/c):

Generally, it is fine to accept the default settings. The main things to check are:

  • VDI Administrator (super-user)

    This is the user name of the initial Oracle VDI administrator. You can add further Oracle VDI administrators later. Make a note of the user name, you need it later.

  • DNS name of this host

    This should be a fully qualified DNS name.

To accept the defaults and create the Oracle VDI Center, press the Return key. Otherwise type c and press the Return key to change the configuration settings. After a few minutes, the installation is complete.

Installing VirtualBox

Next, you need to install VirtualBox. Everything you need is contained in the extracted Oracle VDI software archive.

Unzip the VirtualBox software archive, change working directory to the extracted directory, and install the software with the vb-install script, as follows:

# unzip vbox_4.2.zip
# cd vbox_4.2
# ./vb-install

VirtualBox consists of two components, a Base Pack and an Extension Pack. The VirtualBox software archive contains only the Extension Pack. However, the vb-install script downloads the VirtualBox Base Pack, and then installs both the Base Pack and the Extension Pack. If the Base Pack download fails, you must manually download it from http://download.virtualbox.org/virtualbox. Make sure you download the release that is bundled and supported with the release of Oracle VDI. Copy the Base Pack to the same directory as the vb-install script, and then run the script again.

The vb-install script prompts you for a user name, a password, and a port number to use for SSL connections.

The user name and password is for the user that runs VirtualBox on the host. On Oracle Linux platforms and Oracle Solaris platforms where root is a user, the root user is used by default. It is best to use the root user on these platforms. On Oracle Solaris platforms where root is a role, you must provide the credentials for a different user.

If the VirtualBox user is root, the SSL port is port 443 by default. Otherwise, port 18083 is used by default. If another process is using the default port, the vb-install script suggests another available port. If you plan to install Oracle Secure Global Desktop software on this host as well and port 443 is selected, choose a different port.

Make a note of the user name and port, you need these later.

After a few minutes, the installation is complete.

Logging in to the Oracle VDI Web Administration Tool

Next, log in to the Oracle VDI web administration tool, Oracle VDI Manager. Using a browser, go to https://<host-name>:1801. The browser displays a security warning and prompts you to accept the security certificate. Accept the security certificate. A login page is displayed, as shown in Figure 3.1.

Figure 3.1. Oracle VDI Manager Login Page

The image shows the login page for Oracle VDI Manager.

Log in with the credentials of the initial Oracle VDI Administrator you specified when you installed the software. You are logged in to Oracle VDI Manager and the Users page is displayed, as shown in Figure 3.2.

Figure 3.2. Users Page

The image shows Oracle VDI Manager after you have logged in and shows the "No Company" message.

A "No Company" message is displayed because you have not yet configured a user directory. Chapter 4, Connecting the User Directory, shows you how to do this.