Administrator Guide
Table Of Contents
- Dell Wyse ThinOS Version 9.1 Administrator’s Guide
- Contents
- Introduction
- Upgrading the ThinOS firmware
- Before you upgrade
- Register ThinOS devices to Wyse Management Suite
- Enable Live Update
- Download the ThinOS firmware, BIOS, and application packages
- Add ThinOS 9.x firmware to the repository
- Upgrade ThinOS 8.6 to ThinOS 9.x
- Upgrade ThinOS 9.x to later versions using Wyse Management Suite
- Upgrade ThinOS 9.x to later versions using Admin Policy Tool
- Add ThinOS application packages to the repository
- Upload and push ThinOS 9.x application packages using Groups and Configs on Wyse Management Suite
- Upload and install ThinOS 9.x application packages using Admin Policy Tool
- Firmware installation using Dell Wyse USB Imaging Tool
- Upgrade BIOS
- Edit BIOS settings
- Delete ThinOS application packages
- Downgrading the ThinOS firmware
- Getting started with ThinOS 9.1
- End User License Agreement
- Configure ThinOS using First Boot Wizard
- Configure account privileges for ThinOS
- Connect to a remote server
- Connecting a display
- Connecting a printer
- Configure WMS settings
- Desktop overview
- Modern interactive desktop features
- Classic desktop features
- Configuring thin client settings and connection broker settings
- Configure ThinOS using Admin Policy Tool
- Locking the thin client
- Shut down and restart
- Battery information
- Login dialog box features
- View the system information
- Sleep mode
- Import certificates to ThinOS from Admin Policy Tool or Wyse Management Suite
- ThinOS system variables
- Configuring the global connection settings
- Configuring connectivity
- Configuring connection brokers
- Configuring Citrix
- Configure the Citrix broker setup
- Citrix ADC
- Citrix Cloud services
- Automatically configure using DNS for email discovery
- Citrix HDX Adaptive transport (EDT)
- HDX Adaptive Display V2
- Browser Content Redirection
- HTML5 Video Redirection
- Windows Media Redirection
- QUMU Video Optimization Pack for Citrix
- Citrix Self-Service Password Reset
- Citrix SuperCodec
- Anonymous logon
- Enable UDP audio in a Citrix session
- Keyboard layout synchronization in VDA
- Cursor pattern in ICA session
- Citrix multiple virtual channels
- Configure the Citrix session properties
- Using multiple displays in a Citrix session
- USB Printer Redirection
- Configure the Citrix UPD printer
- Configure the device-specific printer driver
- Export Citrix Workspace App logs
- Configure multifarm
- Configure multilogon
- Configuring VMware
- Configure the VMware broker connection
- VMware Real Time Audio-Video
- Enable Scanner Redirection
- Enable Serial Port Redirection
- Enable Session Collaboration
- Enable Battery State Redirection
- Relative mouse
- Configure Workspace ONE Mode
- Unified Access Gateway
- Configure the VMware integrated printing settings
- Wacom tablet support on ThinOS
- USB Redirection in a VDI session
- Enable Multimedia Redirection in Blast session
- Configuring Windows Virtual Desktop
- Log in to Windows Virtual Desktop using Active Directory Federation Services
- Configuring Microsoft Remote Desktop Services
- Enable Terminal Services Gateway
- Configure the Remote Desktop Services collection
- Add a Remote Desktop Protocol connection
- Log in to RDP session using Remote Desktop Gateway
- Log in to RDP session using Remote Desktop Gateway from Wyse Management Suite or Admin Policy Tool
- Change the display mode for RDP connection using shortcut keys
- Configuring the Amazon WorkSpaces broker connection
- Teradici PCoIP licensing
- Configure the Teradici Cloud Access broker connection
- Configuring PCoIP connections using Teradici Remote Workstation card
- Enable ThinOS to check the server certificate common name
- Bloomberg keyboard support
- Configure the Select Group feature to log in to different brokers
- Configuring Citrix
- Unified Communications optimization with ThinOS
- Citrix Unified Communications support on Wyse 3040 Thin Clients
- Citrix HDX RealTime Optimization Pack for Skype for Business
- VMware Horizon Virtualization Pack for Skype for Business
- Cisco Jabber Softphone for VDI
- Cisco Webex Teams for VDI
- Cisco Webex Meetings for VDI
- Zoom Meetings for VDI
- Microsoft Teams Optimization
- Configuring third-party authentication settings
- Configure the Imprivata OneSign server
- VDI selection on ThinOS
- Configure the VDI settings on OneSign server
- Configure objects on Imprivata Server
- Use smart card as proximity card
- Enroll a proximity card with Imprivata OneSign
- Imprivata Bio-metric Single Sign-On
- Grace period to skip second authentication factor
- Imprivata OneSign ProveID Embedded
- Configure Imprivata fingerprint reader for Citrix ICA and PCoIP sessions
- Configure Imprivata fingerprint reader for VMware Blast session
- Identity Automation
- Configure the Identity Automation
- Install the Identity Automation QwickAccess app package on ThinOS
- Identity Automation support matrix
- Enroll a proximity card with Identity Automation on ThinOS
- Use a proximity card for sign-on with Identity Automation on ThinOS
- Use a proximity card to secure the remote session with Identity Automation on ThinOS
- Use a proximity card to tap-over another user session with Identity Automation on ThinOS
- Configuring the thin client local settings
- Configuring the system preferences
- Configure the display settings
- Configuring the peripherals settings
- Configure the keyboard settings
- Configure the mouse settings
- Configure the touchpad settings
- Configure the audio settings
- Configure the serial settings
- Configure the camera device
- Configure the Bluetooth settings
- Secure Digital cards
- Configure the Jabra Xpress headset settings
- Configure the EPOS headset settings
- Configure the HID Fingerprint reader settings
- Configuring the printer settings
- Reset to factory defaults
- Resetting to factory defaults using G-Key reset
- Recovery mode using R-Key
- Using the system tools
- Using Wyse Management Suite
- Functional areas of Wyse Management Suite console
- Managing groups and configurations
- Edit the ThinOS 9.x policy settings
- Managing devices
- View the BIOS details
- Managing Jobs
- Managing rules
- Managing Events
- Managing users
- Portal administration
- Troubleshooting your thin client
- Capture an HTTP log using ThinOS
- System crashes, freezes or restarts abruptly
- Broker agent login failure
- Citrix desktop and application crashes abruptly
- Unified Communications software call failure
- Request a log file using Wyse Management Suite
- View audit logs using Wyse Management Suite
- System log and trace information
- Upgrade or conversion troubleshooting and logs
- How to debug with new support beyond ThinOS 8?
- How to debug with same support in ThinOS 8?
- Frequently Asked Questions
- ThinOS-related questions
- How do I upgrade from ThinOS 8.6 to 9.1?
- What should I do if the package installation fails?
- Is Wyse Management Suite 3.1 the only way to manage ThinOS 9.1?
- How to verify third-party binary versions on your ThinOS client?
- Is USB Imaging Tool method a possible option for upgrading to ThinOS 9.1?
- Can ThinOS 9.1 be installed on a PCoIP device?
- Does ThinOS 9.1 support zero desktop?
- Does ThinOS 9.1 support ThinOS configurations using INI files?
- iPhone cannot be redirected to the Citrix Desktop session
- Android smartphone is not displayed in the session when redirected or mapped
- Does Citrix Workspace app replace Citrix Receiver on ThinOS?
- What is Workspace mode on ThinOS 9.1?
- Can I enable Flash content to be rendered using a local Flash Player on ThinOS 9.1?
- How do I verify if HDX Enlightened Data Transport Protocol is active?
- How do I check if HTML5 Video Redirection is working?
- How do I check if QUMU Multimedia URL Redirection is working?
- How do I check if Windows Media Redirection is working?
- How to check if Multimedia Redirection is working?
- Is persistent logging supported in ThinOS?
- Is tls.txt file included in network traces on ThinOS?
- Will ThinOS 9.1 device reboot automatically when the system crashes?
- Wyse Management Suite-related questions
- ThinOS-related questions
● If you are using ThinOS 8.6, you must upgrade to ThinOS 8.6_807 and apply the latest BIOS updates before upgrading to
ThinOS 9.1.3112.
● If you are using ThinOS v8.5 or earlier versions, you must first upgrade your device to ThinOS 8.6_807 and apply latest BIOS
updates before installing ThinOS 9.1.
● Your system must be powered on and the sleep mode must be disabled on the system. If the system has entered the sleep
mode, you must send the WOL command using Wyse Management Suite before using any real-time commands. To use the
WOL command, ensure that the Wake-On-LAN (WOL) option is enabled in BIOS.
● All device settings are erased after you upgrade from ThinOS 8.6 to 9.1.3112 except the following settings:
○ Wyse Management Suite group token and server settings
○ Static DNS
○
Certificates
○ IEEE802.1x wired authentication settings—When you upgrade from ThinOS 8.6 to ThinOS 9.1.1131, password set for
security types EAP-PEAP-GTC/EAP-FAST-GTC by using Wyse Management Suite or INI parameters are not preserved.
○ Wireless connections
■ When you upgrade from ThinOS 8.6 to ThinOS 9.1.1131, password set for security types EAP-PEAP-GTC/EAP-FAST-
GTC by using Wyse Management Suite or INI parameters are not preserved.
■ The WEP/Sharekey security type is changed to Open as they are not supported in ThinOS 9.1.
■ When you upgrade from ThinOS 8.6 to ThinOS 9.1.1131, the WPA-Personal security type does not work after upgrade.
However, the WPA2-Personal security type works on ThinOS 9.1.
○ Proxy settings
● If you add multiple application packages along with the operating system image in the same Wyse Management Suite group,
the upgrade may fail due to the low disk space. In this scenario, you must reset to factory default settings for upgrading the
ThinOS client again.
● You cannot boot into ThinOS 9.1 when you perform any of the following operations in BIOS setup:
○ Disable the on-board Network Interface Card (NIC), Trusted Platform Module (TPM), or Platform Trust Technology
(PTT).
○ Clear TPM or PTT.
○ Reset BIOS to factory default settings
● The BIOS version on Wyse 5070 Thin Client must be 1.3.1 or later before you upgrade to ThinOS 9.1. If you upgrade to
ThinOS 9.1 with older BIOS version first and then upgrade to BIOS 1.3.1 or later, the device fails to boot the ThinOS
operating system.
Register ThinOS devices to Wyse Management Suite
NOTE:
DHCP and DNS configurations for Wyse Management Suite work only after you reset the device to factory default
settings.
Register ThinOS devices using Wyse Device Agent
Steps
1. From the desktop menu of the thin client, go to System Setup > Central Configuration.
The Central Configuration window is displayed.
2. Enter the Group Registration Key as configured by your administrator for the wanted group.
3. Select the Enable WMS Advanced Settings check box.
4. In the WMS server field, enter the Wyse Management Server URL.
5. In the Group Registration Key field, enter the group registration key as configured by your Wyse Management Suite
administrator for your group. To verify the setup, click Validate Key. If the key is not validated, verify the group key and
Wyse Management Suite server URL which you have provided. Ensure that ports mentioned are not blocked by the network.
The default ports are 443 and 1883.
NOTE: If the Group Token parameter is not specified, the device is moved to the unmanaged group or quarantine group.
6. Enable or disable CA validation based on your license type. For public cloud, select the Enable CA Validation check box, and
for private cloud, select the Enable CA Validation check box if you have imported certificates from a well-known certificate
authority into your Wyse Management Suite server.
Upgrading the ThinOS firmware
15