Configuring Dell Wyse ThinOS™ Thin Clients with Dell vWorkspace

Configuring Dell Wyse ThinOS™ Thin Clients with Dell vWorkspace

Configuring Dell Wyse ThinOS™ Thin Clients with Dell vWorkspace


In this blog article I will guide you through the necessary steps in order to successfully integrate Dell Wyse Thin Clients with the ThinOS™ operating system and Dell vWorkspace. If you own any of these Thin Client models from Wyse that use ThinOS™, you can use them with Dell vWorkspace today:

  • C10LE
  • R10L
  • T10
  • V10LE

Updated on March 14th, 2013: We are pleased to announce that Application Publishing in Seamless Window Mode is supported on Dell Wyse Thin Clients with ThinOS™ and Dell vWorkspace 8.0.

This functionality will allow organizations to achieve seamless window application publishing hosted in RDS Hosts managed in a vWorkspace 8.0 Farm without the need of a Windows Embedded operating system.

After completing the easy steps described in this article you will be able to connect and customize the end user experience and environment as seen in the following screenshot.

The customization and configuration files are also provided at the end of this post for your convenience.

About Dell Wyse ThinOS™

ThinOS is a purpose-built cloud client computer operating system with an unpublished API which makes it very secure against attacks, it boots in seconds and it automatically checks for firmware upgrades from a network server. It provides instant-on access so users are ready to logon in seconds. They can be centrally managed using simple .INI configuration files. You can learn more about ThinOS™ here.

Getting Started - Thin Client Configuration

When Dell Wyse ThinOS™ client devices are powered on and the operating system is started they are configured to automatically obtain an IP address from a DHCP Server. In addition, administrators can optionally use DHCP Scope Options to provide the File Server and Connection Broker server information. When a ThinOS™ device starts, it attempts to locate a valid File Server to download the initial environment configuration files named WNOS.INI and RDP.INI and the bitmap files that conform the desktop background and the login window logo. After this, the device will contact the vWorkspace Connection Broker server in order to authenticate the user to the virtual environment and to obtain the list of published Virtual Desktops.

It is important to understand that DHCP Scope configuration is not compulsory in order to setup ThinOS™ devices with your current vWorkspace environment. In this guide we will cover both the "Manual" configuration method for easier deployment and testing, as well as the "DHCP" method recommended for production environments

DHCP Configuration Method

If you wish to configure the ThinOS™ devices using DHCP Scope Options you would need to create options 161 and 188 (both with string values), 161 is the File Server and 188 is the Connection Broker. Dell vWorkspace acts both as a File Server and a Connection Broker, however both options need to be defined and filled in.

Note: replace broker_name with your broker name or IP addresses, if you use a name ensure you have DNS resolution, you can use ';' for multiple addresses.

Manual Configuration Method

If you do not have access to a DHCP Server or if you do not want to make changes to your DHCP Servers, you can opt for the Manual Configuration Method by powering on your Thin Client and manually entering the changes required. If your device is locked and in order to obtain administrative access to the device press the "G" key on your keyboard repeteadly while your device is booting up.

Warning: Pressing the "G" Key while booting will reset the device to the default factory settings as well enabling administrative access.

Before we start we recommend you to upgrade your Thin Client device firmware to the latest production version.

Please contact Dell Wyse Support to obtain the latest firmware for your device. The firmware version used to illustrate this blog article is ThinOS™ version 7.1_207.

Step 1 - Configuring the File Server setting

The Dell vWorkspace Connection Broker natively provides File Server support for your ThinOS Thin Clients, so there is no need to setup an additional FTP or HTTP Server in your environment. Later in this article we will cover the vWorkspace Connection Broker Server configuration and you will see how this configuration ties in together.

  • Click on the desktop area and select the Administration option from the menu, then click on "Central Configuration"
  • Type your connection broker server name or address in the format "http://broker_name:8080/wyse"
  • Leave the "Username" and "Password" with the default values, the vWorkspace Connection Broker Server will accept anonymous requests.
  • When you click OK you may be asked to reboot the device, please do so.

Step 2 - Configuring the Connection Broker Server setting

We will now specify the vWorkspace Connection Broker Servers available in your farm.

  • Click on the desktop area and select the Administration option from the menu, then click on "Remote Connections".
  • Under Select Broker, select "Other"
  • Type your connection broker server name or address in the format "http://broker_name:8080"
  • When you click OK you may be asked to reboot the device, please do so.

You have now completed the required configuration steps on your Dell Wyse ThinOS™ Thin Client, we will continue with the vWorkspace Broker Server settings.

Getting Started - Dell vWorkspace Connection Broker Server Configuration

In order to allow Dell vWorkspace to service Dell Wyse ThinOS devices the following steps will need to be performed at all your vWorkspace Connection Broker Servers.

Step 1 - Enabling Compatibility Mode

Dell vWorkspace version 6.x introduced enhanced security to allow connections from only version 6.x connectors. In some cases it is required to turn off this option, for example if you wanted to connect to the Farm using a Dell Wyse ThinOS Thin Client. Enabling Compatibility mode will still encrypt sensitive data like user passwords. To enable compatibility mode you are required to add the following registry key on each server running the "Quest Connection Broker" service:

For 64-bit Operating Systems

HKLM\Software\Wow6432Node\Provision Networks\Common\Load And License Manager

CompatibilityMode = 1 REG_DWORD

For 32-bit Operating Systems

HKLM\Software\Provision Networks\Common\Load And License Manager

CompatibilityMode = 1 REG_DWORD

Note: After completing the registry changes you must restart the "Quest Connection Broker" service on all of the vWorkspace Connection Broker Servers.

Step 2 - Creating the required Files and Directories

As I described in previous sections of this article, the Dell vWorkspace support for ThinOS™ is not limited to VDI Broker Authentication, in fact it also acts as a File Server, so Thin Clients can both authenticate users and download INI configuration files and bitmaps used for desktop backgrounds and login window logos.

  • Download the following ZIP File containing the pre-configured Directories, INI Files and Bitmaps <<Click here to download>>
  • Open up Windows Explorer on each of your vWorkspace Connection Broker Servers and navigate to the base installation folder, normally "C:\Program Files (x86)\Quest Software\vWorkspace"
  • Extract the contents of WNOS.ZIP file inside the "C:\Program Files (x86)\Quest Software\vWorkspace\WYSE"
  • The extracted files and directories path is displayed below:

  • Now open the file named wnos.ini with a text editor like Notepad. replace the values, BROKER_NAME, with your vWorkspace Connection Broker Server name or address.
  • Replace the Language value with your keyboard specifications, the list of available languages can be found here.
  • Replace the DomainList value with your Active Directory Windows Domain.

You can further customize the wnos.ini file or save the changes, however the provided wnos.ini file contains the minimum settings required to get you started.

Next, open the rdp.ini to configure the AutoConnect value.

  • If you wish that users are automatically connected to a Virtual Desktop after authentication to the Connection Broker set this value to "1".
  • If you wish to have the users click on the Icon representing the Virtual Desktop in order to connect leave the default value of "0"

Step 3 - Customizing the ThinOS™ Desktop Background Image and Login Window

If you wish to replace the provided Desktop Background and Login Window logo, simply navigate to the "bitmap" directory under WNOS folder and replace the files accordingly with the following file specifications:

  • Desktop Background: File Name Dellback.jpg 1024 x 768 pixels
  • Login Window Logo: File Name DellForm.jpg 352 x 80 pixels

Verifying the Configuration

We have completed all the required configuration steps required to use Dell Wyse ThinOS™ Thin Clients with Dell vWorkspace. We will proceed to test our configuration by restarting our Thin Client device. When the boot process completes, you should see the customized desktop background and the login window as seen below:

Once ther user is authenticated by the Connection Broker you should see the list of published Virtual Desktops:

If you click on the Connect Manager Window, you will see the list of published Virtual Desktops too:

Finally, you can choose your preferred Visual Experience, under System Administration, Remote Connections, Visual Experience.

Dell Wyse introduced a modern Zero Launchpad that provides an overlay interface which allows end users, among other options, to easily switch between Virtual Desktop sessions.

I hope you found this article useful and if you have any doubts or questions you can use the Discussions section of the vWorkspace Community to raise them.

To learn more about Dell vWorkspace:

  • Visit the official vWorkspace webpage.
  • Download vWorkspace 7.6 and try it for yourself.
  • Read the vWorkspace ‘What’s New Guide
  • Contact your Dell | Quest Software Sales Representative.

To learn more about Dell Wyse:

  • Visit the official Dell Wyse webpage.
  • Contact your Dell Wyse Sales Representative.

Note: You can additionally download a PDF formatted version of this blog post at the end of the article.

Jose Romero

Principal Solutions Architect

Dell | Quest Software

Attachment: Configuring Dell Wyse ThinOS™ Thin Clients with Dell vWorkspace.rar
  • Hi Jose

    Please, can you correct the:

    "DHCP Scope Option 161 File Server: http://broker_name:/8080/wyse (it is important that you type the directory /wyse as stated)"

    There is an " / " after " ; " that I think is a mistake.

    Thank you for this information. All seems work great after change that setting.

  • Thank you, the post has been updated.