4.8. Creating Desktop Providers

4.8.1. Creating an Oracle VM VirtualBox Desktop Provider
4.8.2. Creating a Microsoft Hyper-V Desktop Provider
4.8.3. Creating a Microsoft Remote Desktop Provider
4.8.4. Creating a VMware vCenter Desktop Provider
4.8.5. Creating a Sun Ray Kiosk Desktop Provider
4.8.6. Creating a Generic Desktop Provider

Desktop providers encapsulate the details of the underlying virtualization platform. At a minimum, you must configure one desktop provider before you can create desktop pools. There is no limitation to the number of providers the system can manage. At any time, you can configure additional providers.

Desktop providers can also be configured to run a specified number of synchronous desktop cloning and recycling jobs during and outside of specified peak hours. See Section 5.5.10.2, “Setting Peak Times for Desktop Providers” for details.

4.8.1. Creating an Oracle VM VirtualBox Desktop Provider

Due to the differences in the availability of the storage types and the way they are used, the virtualization hosts for an Oracle VM VirtualBox desktop provider must use the same operating system. You cannot mix Oracle Solaris and Oracle Linux virtualization hosts.

Oracle VM VirtualBox desktop providers require storage as well virtualization hosts. See Section 4.6.1, “Introduction to Storage” for details of the supported storage types and the preparation required for use with Oracle VDI.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Desktop Providers.

  2. In the Desktop Providers table, click New.

    The New Desktop Provider wizard is displayed.

  3. On the Select Desktop Provider Type step, select Oracle VM VirtualBox.

  4. On the Specify Hosts step, select Specify New Host.

  5. On the Specify New Host step, enter the host details.

    1. In the Host field, enter the fully-qualified DNS name or IP address of the VirtualBox host.

    2. In the SSL Port field, enter the port number to use for SSL communication with the VirtualBox host.

      This is the port that was specified when VirtualBox was installed. The default SSL port is either port 443 or 18083, depending on whether the root user is used to run VirtualBox on the host.

      If SSL is not used, deselect Use SSL Encryption.

    3. In the SSH Port field, enter the port number used for SSH connections to the VirtualBox host.

    4. In the User Name and Password fields, enter the credentials of the user that runs VirtualBox on the host.

      The credentials must be for the user that was specified when VirtualBox was installed on the host, typically root.

    5. On the Verify Certificate step, check that the SSH and SSL certificate details are correct.

      This is an important security step that ensures you are adding a genuine VirtualBox host to the desktop provider.

      The Specify Hosts step is displayed again.

  6. To add more VirtualBox hosts, select Specify New Host and enter the host details as shown in step 5. Otherwise, select Select Existing Hosts.

  7. On the Specify Storage step, select Specify New Storage.

    The following are the restrictions on how the supported storage types can be used:

    • The iSCSI storage type can only be used with Oracle Linux virtualization hosts.

    • With Oracle Solaris virtualization hosts, you cannot mix Sun ZFS storage with any other storage type.

    • You cannot mix local storage with any other storage type.

    • You can only add one local storage.

    Sun ZFS Storage

    1. From the Storage Type list, select Sun ZFS Storage.

    2. In the Storage field, enter the fully-qualified DNS name or IP address of the storage.

    3. In the SSH Port field, enter the port number used for SSH connections to the storage.

    4. In the User Name and Password fields, enter the credentials of a user with root access to the storage.

    5. On the Verify Certificate step, check that the SSH certificate details are correct.

      This is an important security step that ensures you are adding a genuine storage host to the desktop provider.

    6. On the Select ZFS Pool step, from the ZFS Pool list, click the name of a ZFS pool.

    iSCSI Storage

    1. From the Storage Type list, select iSCSI Storage.

    2. In the Storage field, enter the fully-qualified DNS name or IP address of the storage.

    3. In the Target field, enter the iSCSI Qualified Name (IQN) of the iSCSI volume.

    4. In the LU Number field, enter the logical unit number of the iSCSI volume.

    Network File System Storage

    1. From the Storage Type list, select Network File System.

    2. In the Name field, enter a name for the storage.

    3. In the Path field, enter the mount point of the storage on the virtualization hosts.

    Local Storage

    1. From the Storage Type list, select Local Storage.

    2. In the Path field, enter the path to the storage on the virtualization hosts.

    Once you add the storage, the Specify Hosts step is displayed again.

  8. To add more storage, select Specify New Storage and enter the storage details as shown in step 7. Otherwise, select Select Existing Hosts.

  9. On the Define Desktop Provider step, enter the desktop provider details.

    1. In the Name field, enter the name of the desktop provider.

    2. (Optional) In the Comments field, enter any notes about the desktop provider.

  10. On the Review step, check the configuration of the desktop provider and click Finish.

    The new desktop provider is added to the Desktop Provider table.

    If you add local storage and the desktop provider contains multiple virtualization hosts, Oracle VDI automatically creates a local storage for each virtualization host so that the free space and number of desktops can be monitored.

    Caution

    When you first add a storage for a desktop provider that has Oracle Linux virtualization hosts, a critical alert might be displayed in Oracle VDI Manager and the alert might take some time to clear. This is because Oracle VDI formats the configured storage using Oracle Cluster File System version 2 (OCFS2) and this might take a while, depending on the size of the volume.

Command Line Steps

  1. Create a new Oracle VM VirtualBox desktop provider.

    /opt/SUNWvda/sbin/vda provider-vb-create -p name=name
    
  2. Add at least one VirtualBox host to the desktop provider.

    /opt/SUNWvda/sbin/vda provider-add-host -p host=host,username=user-name provider
    
  3. Add at least one storage host to the desktop provider.

    You must add at least one VirtualBox host to the desktop provider before you can add storage.

    The following are the restrictions on how the supported storage types can be used:

    • The iSCSI storage type can only be used with Oracle Linux virtualization hosts.

    • With Oracle Solaris virtualization hosts, you cannot mix Sun ZFS storage with any other storage type.

    • You cannot mix local storage with any other storage type.

    • You can only add one local storage.

    Sun ZFS storage:

    /opt/SUNWvda/sbin/vda provider-add-storage-zfs -p \
    host=host,username=username,zfspool=zfspool provider
    

    iSCSI storage:

    /opt/SUNWvda/sbin/vda provider-add-storage-iscsi -p \
    host=host,target=target,lu-number=lu-number provider
    

    Network File System storage:

    /opt/SUNWvda/sbin/vda provider-add-storage-networkfs -p \
    host=host,path=path provider
    

    Local storage:

    /opt/SUNWvda/sbin/vda provider-add-storage-local -p \
    path=path provider
    

    If you add local storage and the desktop provider contains multiple virtualization hosts, Oracle VDI automatically creates a local storage for each virtualization host so that the free space and number of desktops can be monitored on each host.

    Caution

    When you first add a storage for a desktop provider that has Oracle Linux virtualization hosts, the status of the provider might be displayed as critical and it might take some time for the critical status to clear. This is because Oracle VDI formats the configured storage using Oracle Cluster File System version 2 (OCFS2) and this might take a while, depending on the size of the volume.

The following example creates an Oracle VM VirtualBox desktop provider with two hosts and one iSCSI storage.

/opt/SUNWvda/sbin/vda provider-vb-create -p name="VB provider"

/opt/SUNWvda/sbin/vda provider-add-host -p \
host=vb1.example.com,username=root "VB provider"

/opt/SUNWvda/sbin/vda provider-add-host -p \
host=vb2.example.com,port=443,username=root "VB provider"

/opt/SUNWvda/sbin/vda provider-add-storage-iscsi -p \
host=192.168.0.1,target=iqn.1986-03.com.sun:02:a5e94e8d-03b8-e50e-9b67,lu-number=12 \
"VB provider"

4.8.2. Creating a Microsoft Hyper-V Desktop Provider

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Desktop Providers from the navigation tree.

  2. In the Desktop Providers table, click New.

    The New Desktop Provider wizard is displayed.

  3. On the Select Desktop Provider Type step, select Microsoft Hyper-V.

  4. On the Specify Hosts step, select Specify New Host.

  5. On the Specify New Host step, enter the host details.

    1. In the Host field, enter the fully-qualified DNS name or IP address of the Hyper-V host.

    2. In the SSL Port field, enter the port number to use for SSL communication with the Hyper-V host.

      This is the port configured on the host for Windows Remote Management (WinRM). The default SSL port is port 443.

    3. In the User Name and Password boxes, enter the credentials of a user with administrative privileges on the Hyper-V host.

    4. On the Verify Certificate step, check that the SSL certificate details are correct.

      This is an important security step that ensures you are adding a genuine Hyper-V host to the desktop provider.

      The Specify Hosts step is displayed again.

  6. To add more Microsoft Hyper-V hosts, select Specify New Host and enter the host details as shown in step 5. Otherwise, select Select Existing Hosts.

  7. On the Specify Storage step, select Specify New Storage.

    1. In the Storage field, enter the fully-qualified DNS name or IP address of the storage.

    2. In the SSH Port field, enter the port number used for SSH connections to the storage.

    3. In the User Name and Password boxes, enter the credentials of a user with root access to the storage.

    4. On the Verify Certificate step, check that the SSH certificate details are correct.

      This is an important security step that ensures you are adding a genuine storage host to the desktop provider.

    5. On the Select ZFS Pool step, from the ZFS Pool list, click the name of a ZFS pool.

    Once you add the storage, the Specify Hosts step is displayed again.

  8. To add more storage , select Specify New Storage and enter the storage details as shown in step 7. Otherwise, select Select Existing Hosts.

  9. On the Define Desktop Provider step, enter the desktop provider details.

    1. In the Name field, enter the name of the desktop provider.

    2. (Optional) In the Comments field, enter any notes about the desktop provider.

  10. On the Review step, check the configuration of the desktop provider and click Finish.

    The new desktop provider is added to the Desktop Provider table.

Command Line Steps

  1. Create a new Microsoft Hyper-V desktop provider.

    /opt/SUNWvda/sbin/vda provider-hv-create -p name=name
    
  2. Add at least one Microsoft Hyper-V host to the desktop provider.

    /opt/SUNWvda/sbin/vda provider-add-host -p \
    host=host,username=username provider
    
  3. Add at least one storage host to the desktop provider.

    /opt/SUNWvda/sbin/vda provider-add-storage-zfs -p \
    host=host,username=username,zfspool=zfspool provider
    

The following example creates a Microsoft Hyper-V desktop provider with two hosts and one storage.

/opt/SUNWvda/sbin/vda provider-hv-create -p name="HyV provider"

/opt/SUNWvda/sbin/vda provider-add-host -p \
host=my.first.hyv.com,port=443,username=root "HyV provider"

/opt/SUNWvda/sbin/vda provider-add-host -p \
host=my.second.hyv.com,port=443,username=root "HyV provider"

/opt/SUNWvda/sbin/vda provider-add-storage -p \
host=my.zfs.com,username=root,zfspool=vda_zfspool "HyV provider"

4.8.3. Creating a Microsoft Remote Desktop Provider

How you configure a Microsoft Remote Desktop provider depends on whether or not Windows Remote Management (WinRM) is configured on the Remote Desktop Services (RDS) hosts, and whether or not there is an RDS farm. Oracle VDI uses WinRM to obtain session and load information from the RDS hosts. If WinRM is not configured and there is no RDS farm, a desktop provider can only contain a single RDS host because Oracle VDI cannot load balance the sessions between hosts.

Configuration Steps When WINRM Configured

Follow these steps to configure a desktop provider that contains either of the following:

  • Individual RDS hosts with WinRM configured and there is no RDS farm.

  • A farm of RDS hosts and WinRM is configured on each RDS host in the farm.

Oracle VDI Manager Steps (WinRM Configured)

  1. In Oracle VDI Manager, select Desktop Providers from the navigation tree.

  2. In the Desktop Providers table, click New.

    The New Desktop Provider wizard is displayed.

  3. On the Select Desktop Provider Type step, select Microsoft Remote Desktop.

  4. On the Specify Hosts step, select Specify New Host.

  5. On the Specify New Host step, enter the host details.

    1. In the Host field, enter the fully-qualified DNS name or IP address of the RDS host.

    2. In the SSL Port field, enter the port number to use for SSL communication with the RDS host.

      The default SSL port is port 443.

    3. In the User Name and Password boxes, enter the credentials of an Administrator on the RDS host.

    4. On the Verify Certificate step, check that the MD5 fingerprint matches the fingerprint of the SSL certificate for the RDS host.

      This is an important security step that ensures you are adding a genuine RDS host to the desktop provider.

      The Specify Hosts step is displayed again.

  6. To add more RDS hosts, select Specify New Host and repeat step 5. Otherwise, select Select Existing Hosts.

  7. On the Define Desktop Provider step, enter the desktop provider details.

    1. In the Name field, enter the name of the desktop provider.

    2. (Optional) In the Comments field, enter any notes about the desktop provider.

  8. On the Review step, check the configuration of the desktop provider and click Finish.

    The new desktop provider is added to the Desktop Provider table.

  9. Specify the host name or IP address, SSL port, and administrator credentials for each RDS host.

Command Line Steps (WinRM Configured)

  1. Create a Microsoft Remote Desktop desktop provider.

    /opt/SUNWvda/sbin/vda provider-ts-create -p name=name
    
  2. Add at least one RDS host to the desktop provider.

    /opt/SUNWvda/sbin/vda provider-add-host -p host=host,username=username provider
    

    The username property is the user name of an Administrator on the RDS host. You are prompted for the password. If a non-standard port is used for SSL communication with the RDS host, you must specify the port number using the port=port property.

    The following example creates a Microsoft Remote Desktop provider named "RDS Sessions and adds a single RDS host.

    /opt/SUNWvda/sbin/vda provider-ts-create -p name="RDS Sessions"
    
    /opt/SUNWvda/sbin/vda provider-add-host -p \
    host=rds1.example.com,username=Administrator "RDS Sessions"

Configuration Steps When WinRM is Not Configured

Follow these steps to configure a desktop provider that contains either of the following:

  • A single RDS host without WinRM configured and there is no RDS farm.

  • A farm of RDS hosts and WinRM is not configured on each RDS host in the farm.

Oracle VDI Manager Steps (WinRM Not Configured)

  1. In Oracle VDI Manager, select Desktop Providers from the navigation tree.

  2. In the Desktop Providers table, click New.

    The New Desktop Provider wizard is displayed.

  3. On the Select Desktop Provider Type step, select Microsoft Remote Desktop.

  4. On the Specify Hosts step, select Specify Remote Desktop Server Farm.

  5. On the Specify Remote Desktop Server Farm step, enter the fully-qualified DNS name or IP address of the RDS farm in the Farm Name field.

  6. On the Define Desktop Provider step, enter the desktop provider details.

    1. In the Name field, enter the name of the desktop provider.

    2. (Optional) In the Comments field, enter any notes about the desktop provider.

  7. On the Review step, check the configuration of the desktop provider and click Finish.

    The new desktop provider is added to the Desktop Provider table.

Command Line Steps (WinRM Not Configured)

  1. Create a Microsoft Remote Desktop desktop provider.

    /opt/SUNWvda/sbin/vda provider-ts-create -p name=name
    
  2. Specify the RDS farm.

    /opt/SUNWvda/sbin/vda provider-add-host -p host=host,farm=true provider
    
  3. The following example creates a desktop provider named "RDS farm" for the farm rdsfarm.example.com.

    /opt/SUNWvda/sbin/vda provider-ts-create -p name="RDS farm"
    
    /opt/SUNWvda/sbin/vda provider-add-host -p host=rdsfarm.example.com,farm=true "RDS farm"

4.8.4. Creating a VMware vCenter Desktop Provider

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, go to Desktop Providers.

  2. In the Desktop Providers table, and click New to activate the New Desktop Provider wizard.

    The wizard enables you to add multiple hosts and multiple storages in a loop.

    Once you click Finish, the new desktop provider appears appear in the Oracle VDI Manager.

    The New Desktop Provider wizard requires different information depending on the virtualization platform in use. For example, most desktop providers require a host IP address and administrator credentials. Oracle VDI or Microsoft Hyper-V desktop providers require a host and a storage.

    You can view the VMware vCenter resource details, including data centers, VMware clusters, and datastores.

Command Line Steps

  • Create a new VMware vCenter desktop provider.

    /opt/SUNWvda/sbin/vda provider-vc-create -p name=name,host=host,username=username
    

    The following example creates a VMware vCenter desktop provider.

    /opt/SUNWvda/sbin/vda provider-vc-create -p \
    name="VC provider",host=my.vc.com,username=Administrator

4.8.5. Creating a Sun Ray Kiosk Desktop Provider

Before you begin, see Section 4.4, “Sun Ray Kiosk Desktop Providers” for information about using kiosk session types with Oracle VDI.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Desktop Providers from the navigation tree.

  2. In the Desktop Providers table, click New.

    The New Desktop Provider wizard is displayed.

  3. On the Select Desktop Provider Type step, select Sun Ray Kiosk.

  4. On the Select Kiosk Session Type step, select a Sun Ray kiosk session type in the Session Type list.

  5. On the Define Desktop Provider step, enter the desktop provider details.

    1. In the Name field, enter the name of the desktop provider.

    2. (Optional) In the Comments field, enter any notes about the desktop provider.

  6. On the Review step, check the configuration of the desktop provider and click Finish.

    The new desktop provider is added to the Desktop Provider table.

Command Line Steps

  1. (Optional) List the available kiosk session types.

    # /opt/SUNWkio/bin/kioskdesc list -s
  2. Create a Sun Ray Kiosk desktop provider.

    /opt/SUNWvda/sbin/vda provider-kiosk-create -p name="name",session=session
    

    The following example creates a Sun Ray Kiosk desktop provider named "VMWare View Provider" that uses the VMWare View Manager Session kiosk session.

    /opt/SUNWvda/sbin/vda provider-kiosk-create -p name="VMWare View Provider",session=vdm

4.8.6. Creating a Generic Desktop Provider

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Desktop Providers from the navigation tree.

  2. In the Desktop Providers table, click New.

    The New Desktop Provider wizard is displayed.

  3. On the Select Desktop Provider Type step, select Generic.

  4. On the Define Desktop Provider step, enter the desktop provider details.

    1. In the Name field, enter the name of the desktop provider.

    2. (Optional) In the Comments field, enter any notes about the desktop provider.

  5. On the Review step, check the configuration of the desktop provider and click Finish.

    The new desktop provider is added to the Desktop Provider table.

Command Line Steps

  • Create a generic desktop provider.

    /opt/SUNWvda/sbin/vda provider-pc-create -p name=name
    

    The following example creates a generic desktop provider named "windows-pcs".

    /opt/SUNWvda/sbin/vda provider-pc-create -p name=windows-pcs