2.3. Installing and Configuring Oracle VDI

2.3.1. Installing Oracle VDI
2.3.2. Configuring Oracle VDI on a Primary Host
2.3.3. Configuring Oracle VDI on a Secondary Host
2.3.4. Reconfiguring Oracle VDI on a Host
2.3.5. Reinstalling Oracle VDI
2.3.6. Uninstalling Oracle VDI

2.3.1. Installing Oracle VDI

Before you begin, check that the host meets the requirements for installing Oracle VDI, as described in Section 2.2, “Oracle VDI System Requirements”.

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

  2. Log in as root on the host.

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

    • On Oracle Solaris hosts:

      # unzip vda_3.4.1_solaris_amd64.zip
      # cd vda_3.4.1_solaris_amd64
    • On Oracle Linux hosts:

      # unzip vda_3.4.1_linux.zip
      # cd vda_3.4.1_linux
  4. Install the software.

    # ./vda-install

    The software is installed in /opt/SUNWvda.

    On Oracle Linux hosts, the installation script checks whether the required packages for Oracle VDI are installed. If any required packages are missing and yum is configured correctly, the installation script prompts you to continue and installs the missing packages. If the required packages are not installed, the installation fails.

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

    Do you want to configure Oracle VDI 3.4.1 now? ([y]/n)
    • To configure Oracle VDI later, type n and press the Return key.

    • To configure Oracle VDI now, press the Return key.

    For details of how to configure Oracle VDI, see:

2.3.2. Configuring Oracle VDI on a Primary Host

You can configure Oracle VDI on a host in the following circumstances:

  • As part of the software installation, immediately after installing or updating the Oracle VDI software on a host.

  • As a separate step, after installing or updating the Oracle VDI software on a host.

  • As a separate step, after unconfiguring Oracle VDI on a host.

To use a remote MySQL database instead of the embedded Oracle VDI MySQL Server database, ensure you have all the required information as described in Section 2.2.6, “Requirements for Using a Remote MySQL Database”.

  1. (Optional) Start the configuration script.

    This step is not necessary if you configure the software at the same time as installing the software.

    Run the following command as root:

    # /opt/SUNWvda/sbin/vda-config

    A list of configuration types is displayed.

    1 New Oracle VDI Center
    2 Join Oracle VDI Center
                    
    Select (1/2):
  2. To configure the host as the primary host in an Oracle VDI Center, type 1 and press the Return key.

    If you are configuring an Oracle VDI Center that contains only one host, type 1.

    A list of configuration settings is displayed.

    Review the settings for a new Oracle VDI Center:
       Name: VDI Center
       Administrator Password: ********
       DNS name of this host: primary.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):

    The default is to use the embedded Oracle VDI MySQL Server database. To use a remote MySQL database, you must customize the configuration settings.

    • To accept the defaults and create the Oracle VDI Center, press the Return key.

    • To change the settings before creating the Oracle VDI Center, type c and press the Return key.

      If you change the settings, you can review the changes before they are applied.

    The host is configured using the supplied settings.

    The following are the configuration settings for a primary host:

    • Name: The name of the Oracle VDI Center. The name can contain alphanumeric characters as well as spaces.

    • Administrator Password: The password used to secure the embedded Oracle VDI MySQL Server database and the Sun Ray datastore.

      Normally you do not need to know this password and an automatically-generated password is used. To use the automatically-generated password, press the Return key. Otherwise you can provide a password, which you have to enter twice to confirm. The password must contain at least five characters.

    • DNS name of this host: The fully-qualified DNS name of the host, for example primary.example.com. There must be a valid DNS entry for the host, otherwise the configuration fails.

    • Maximum number of sessions on this host: This is the maximum number of user sessions that can run on each Oracle VDI host in the Oracle VDI Center.

    • User ID range start: Oracle VDI creates a local user for each user session on the Oracle VDI host. This option enables you to specify the starting number of the user ID.

    • Database: Choose whether to use the embedded Oracle VDI MySQL Server database, or connect to a remote MySQL database. For more information about using remote databases, see Section 2.2.6, “Requirements for Using a Remote MySQL Database”.

2.3.3. Configuring Oracle VDI on a Secondary Host

You can configure Oracle VDI on a host in the following circumstances:

  • As part of the software installation, immediately after installing or updating the Oracle VDI software on a host.

  • As a separate step, after installing or updating the Oracle VDI software on a host.

  • As a separate step, after unconfiguring Oracle VDI on a host.

  1. (Optional) Start the configuration script.

    This step is not necessary if you configure the software at the same time as installing the software.

    Run the following command as root:

    # /opt/SUNWvda/sbin/vda-config

    A list of configuration types is displayed.

    1 New Oracle VDI Center
    2 Join Oracle VDI Center
                    
    Select (1/2):
  2. To configure the host as a secondary host in an Oracle VDI Center, type 2 and press the Return key.

    You are prompted to enter the DNS name of the primary host in the Oracle VDI Center.

    Enter the primary Oracle VDI Host:
  3. Enter the fully-qualified DNS name of the primary host in the Oracle VDI Center and press the Return key.

    For example, primary.example.com.

    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:
  4. 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:

    1. Log in as root on the primary host.

    2. 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.
  5. On the secondary host, enter root's password and press the Return key.

    You are prompted to enter the DNS name of the secondary host.

    Enter the DNS name of this host [secondary.example.com]:
  6. To accept the detected DNS name of the secondary, press the Return key. Otherwise, enter the fully-qualified DNS name of the secondary and press the Return key.

    There must be a valid DNS entry for the host, otherwise the configuration fails.

    The host is configured using the supplied settings.

2.3.4. Reconfiguring Oracle VDI on a Host

You might want to reconfigure an Oracle VDI Host to remove it from an Oracle VDI Center or if there is a problem with the host's configuration.

  1. Unconfigure Oracle VDI.

    # /opt/SUNWvda/sbin/vda-config -u
  2. Reconfigure Oracle VDI.

    See Section 2.3.2, “Configuring Oracle VDI on a Primary Host”.

    See Section 2.3.3, “Configuring Oracle VDI on a Secondary Host”.

2.3.5. Reinstalling Oracle VDI

If you want to reinstall Oracle VDI on a host and preserve your configuration, you must first back up the following:

  • Database: You must backup the database before reinstalling. This enables you to restore the current system. For more information about backing up the Oracle VDI database, refer to Section 8.4, “Backing Up and Restoring the Oracle VDI Database”.

  • Customized {*}my.conf{*} files: The database configuration file. The reinstall creates a new /etc/opt/SUNWvda/my.cnf file. Add the customizations from the backup to the new file.

  • Customized {*}pam.conf{*} files: The Sun Ray Server Software access configuration file. The reinstall creates a new /etc/pam.conf file. Add the customizations from the backup to the new file.

To reinstall Oracle VDI, you must first uninstall it, see Section 2.3.6, “Uninstalling Oracle VDI”. After reinstalling the software, restore the data from the backups.

2.3.6. Uninstalling Oracle VDI

  • Unconfigure and uninstall the Oracle VDI.

    # /opt/SUNWvda/sbin/vda-install -u