Administrators Guide: Wyse® TCX Suite - Wyse Technology

Administrators Guide 

Wyse ® TCX Suite 

Issue: 012309 

PN: 883902-01 Rev. H

Copyright Notices 

© 2009, Wyse Technology Inc. All rights reserved. 

This manual and the software and firmware described in it are copyrighted. You may not reproduce, transmit, 

transcribe, store in a retrieval system, or translate into any language or computer language, in any form or by any 

means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise, any part of this publication 

without express written permission. 

End User License Agreement (“License”) 

Trademarks 

A copy of the Wyse Technology End User License Agreement is included in the software and provided for your 

reference only. The License at http://www.wyse.com/license as of the purchase date is the controlling licensing 

agreement. By copying, using, or installing the software or the product, you agree to be bound by those terms. 

The Wyse logo and Wyse are trademarks of Wyse Technology Inc. Other product names mentioned herein are for 

identification purposes only and may be trademarks and/or registered trademarks of their respective companies. 

Specifications subject to change without notice. 

Restricted Rights Legend 

You acknowledge that the Software is of U.S. origin. You agree to comply with all applicable international and 

national laws that apply to the Software, including the U.S. Export Administration Regulations, as well as end-user, 

end-use and country destination restrictions issued by U.S. and other governments. For additional information on 

exporting the Software, see http://www.microsoft.com/exporting. 

Ordering Information 

For availability, pricing, and ordering information in the United States and Canada, call 1-800-GET-WYSE 

(1-800-438-9973) or visit us at http://www.wyse.com. In all other countries, contact your sales representative.

Contents 

1 Introduction 1 

Wyse Technical Support 1 

Links to Related Documentation and Services 1 

Wyse TCX Product Support Matrix 2 

Prerequisites for Installing All TCX Server Products 3 

2 Wyse ® TCX Multi-display 1.2 5 

Installing the Wyse TCX Multi-display Server Software 5 

Installation 5 

Uninstallation 6 

Silent Installation 6 

Silent Uninstallation 6 

Installing the Wyse TCX Multi-display Client Software 6 

Installing on Wyse Thin OS Client-based Clients 7 

Installing on Windows XPe-based Clients 7 

Installing on Windows CE-based Clients 7 

Installing on Wyse Enhanced SLE-based Clients 7 

Using Wyse TCX Multi-display Software with Wyse Thin Clients 7 

Understanding the Features of Wyse TCX Multi-display Software 8 

Monitor Display Layout 8 

Window Maximization and Full Screen Display 9 

Window Repositioning 9 

GINA Logon Dialog Box Display 10 

Exclusion Lists 11 

Windows Security Dialog Support 11 

Using Commands in the .ini Files 11 

3 Wyse ® TCX Multimedia 3.0 13 

Installing Wyse TCX Multimedia Server Software 14 





Port Configuration 15 

Wyse TCX Multimedia Server Performance for WAN 15 

Wyse TCX Multimedia Server Logging 16 

Support for URL Redirection on Wyse Thin OS-based Clients 16 

Custom URL Redirection Support 16 

Custom Transport Registration 17 

Wyse-specific Registry Entries for URL Redirection 17 

An Example Using QVMC 18

iv Contents 

Installing the Wyse TCX Multimedia Client Software 19 

Installing on Wyse Thin OS-based Clients 19 


Installing on Windows CE 5.0-based Clients 20 


4 Wyse ® TCX USB Virtualizer 2.0 23 

Hardware Peripherals Supported 23 

Installing Wyse TCX USB Virtualizer Server Software 23 

Installing on Windows XP Professional 24 

Installing on Windows Vista 24 




Configuring the Wyse TCX USB Virtualizer Software on the Server 25 

Logging 26 

Installing Wyse TCX USB Virtualizer Client Software 26 


Configuring for the Wyse Thin OS-based Clients 27 

Configuring the .ini File to Support Isochronous Devices (Headsets and 

Webcams) 27 


Logging 28 

Configuring for the Windows XPe-based Clients 29 

Installing on Windows CE 5.0-based Clients 30 


Configuring for the Wyse Enhanced SLE-based Clients 30 

5 Wyse ® TCX Rich Sound 1.0 31 

Validated Hardware Peripherals 31 

Analog Headsets 31 

USB Headsets 31 

Installing Wyse TCX Rich Sound Server Software 31 





Port Configuration 33 

Logging 33 

Sound Recorder Quality 33 

Installing the Wyse TCX Rich Sound Client Software 33 



Installing on Windows CE-based Clients 34 


Tables 35

1 Introduction 

Wyse Technical Support 

Wyse Thin Computing Extensions (TCX) offer software solutions that enable multiple 

monitor awareness, rich multimedia playback, high quality bi-directional audio capabilities, 

and seamless USB device access for Wyse thin clients. The Wyse TCX Server software is 

typically installed in a virtual desktop or on a terminal server or XenApp server. The client 

software is typically available as an add on module to Wyse thin clients’ OS platforms or 

embedded in the Wyse Thin OS. 

Wyse Thin Computing Extensions are available only in English. 

• TCX Multi-display 1.2 software provides several productivity-enhancing advantages for 

Wyse thin clients using multiple monitors. 

• TCX Multimedia 3.0 software supports enhanced playback of MPEG, WAV, WMV, and 

other multimedia file formats. 

• TCX USB Virtualizer 2.0 software provides a PC-like experience by supporting the 

USB peripheral devices connected to Wyse thin clients in two modes: 

· As locally attached devices. 

· Redirected to a virtual desktop. 

• TCX Rich Sound 1.0 enables support for applications that require high quality 

bi-directional audio capabilities. 

To access Wyse technical resources, visit http://www.wyse.com/support. If you have 

further questions, you can submit your questions using the Wyse Self-Service Center 

(from the Wyse website, navigate to Support, then Overview, and click “Wyse Self-Service 

and Knowledge Base Center”) or call Customer Support at 1-800-800-WYSE (toll free in 

U.S. and Canada). Hours of operation are from 6:00 A.M. to 5:00 P.M. PST, Monday 

through Friday. 

To access international support, visit http://www.wyse.com/global. 

Links to Related Documentation and Services 

Wyse thin client hardware and operating systems platform features can be found in the 

datasheet for your specific thin client model. Datasheets are available on the Wyse Web 

site at: http://www.wyse.com/products. 

Administrator, User, and ReadMe documentation for your thin client model are available 

on the Wyse Web site at: http://www.wyse.com/manuals. 

More information on Wyse Thin Computing Software is available on the Wyse Web site at: 

http://www.wyse.com/products/software. 

For more information on Wyse Thin Computing Extensions (including FAQs), refer to the 

Wyse Knowledge base at: http://www.wyse.com/support/kbase.asp.

2 Chapter 1 

Wyse TCX Product Support Matrix 

Tables 1 and 2 show the server and client platforms that support the Wyse TCX 

Extensions. 

Table 1 Wyse TCX Extensions Supported Server Platforms 

Product Server Platforms 

Windows XP Professional 

SP2 and later 

XenDesktop 

2.0 

VMware 

VDI 1 

Windows Vista (Ultimate, 

Business, Enterprise) 

SP1 and later 

XenDesktop 

2.0 

VMware 

VDI 1 

Windows 

Server 2003 

Terminal 

Services 

Windows 

Server 2008 

Terminal 

Services 

TCX Multi-display 

1.22 � � � � � � � 

TCX Multimedia 

3.03 � � � � � 

TCX USB Virtualizer 

2.0 

TCX Rich Sound 

1.0 

� � � � 

� � � � 

Citrix 

XenApp 

4.5 and 

later 

1. For VDM 2.1, use the Non-tunneled mode only. 

2. TCX Multi-display 1.2 also supports Windows 2000 (Advanced) Server with SP4, Microsoft XP Pro x64 with SP2, Windows Vista 

Ultimate x64 with SP1, and Windows Vista Business x64 with SP1. 

3. TCX Multimedia 3.0 also supports Microsoft XP Pro x64 with SP2, Windows Vista Ultimate x64 with SP1, Windows Vista Business x64 

with SP1, Windows Vista Enterprise x64 with SP1, Windows 2003 Standard x64 with SP2, and Windows 2003 Enterprise x64 with SP2. 

Table 2 Wyse TCX Extensions Supported Client Platforms 

Product Client Platforms 

TCX Multi-display 

1.2 

TCX Multimedia 

3.0 

TCX USB Virtualizer 

2.0 

TCX Rich Sound 

1.0 

Wyse Thin OS Windows XPe Windows CE 5.0 Linux 

� 

S, V 

� 

V 

� 

S, V 

� 

V 

� 

V, R, G 

� 

V, X, G 

� 

V, X, R, G 

� 

S, V 

No XenApp or 

XenDesktop support. 

S, V 

� 

R, X 

No XenApp or 

XenDesktop support 

� 

X 

No isochronous 

devices (headsets, 

webcams) 

R, X

Introduction 3 

Prerequisites for Installing All TCX Server Products 

Complete the following requirements for server installation: 

• Terminal Services or XenApp installations 

· A server must have Windows Terminal Services installed and enabled. 

· Administrator access is required. 

• Windows Vista or Windows XP Professional installations 

· Windows Remote Desktop Connections must be enabled before proceeding with a 

Windows XP Professional SP2 or Windows Vista SP1 installation. 

· Administrator access is required.

4 Chapter 1 

This page intentionally blank.

2 Wyse ® TCX Multi-display 1.2 

Wyse TCX Multi-display is the software that enables enhanced multi-monitor awareness. 

It provides users with several productivity-enhancing features when using Wyse thin 

clients with multiple monitors. 

TCX Multi-display features include: 

• Multi-monitor awareness capability (awareness of primary and non-primary monitors) 

• Window maximization on appropriate monitor 

• Dialog box and message box position control 

• Windows “position memory” (“remembers” on which monitor an application window 

was last closed) 

• Advance monitor layout and application layout 

• Application exclusion list 

• Windows security dialog box positioning 

• GINA log on dialog box positioning 

Installing the Wyse TCX Multi-display Server Software 

Installation 

You can download the Wyse TCX Multi-display server software from the Wyse website, 

www.wyse.com. Click Support | Downloads, expand the list next to “Please Choose Your 

Product (Active),” choose Wyse TCX, and click the Search button. Click the file name next 

to Wyse TCX Multi-display to download the software. 

For supported server platforms, see Table 1 in Chapter 1. 

To install the Wyse TCX Multi-display server software, follow these guidelines: 

1. Uninstall any existing Wyse TCX Multi-display server software. 

2. Double-click Wyse TCX Multi-display.exe to open the installation wizard. 

The installation wizard guides you through the install process. 

3. You must read and accept the terms and conditions in the license agreement before 

proceeding to install the software. 

• By default, the required files are installed in this directory: 

C:\Program Files\Wyse\TCX Multi-display. 

• You can choose a different destination folder for the files by selecting a Custom 

install type. 

4. When the installation is complete, to enable the software, select the Launch Wyse 

TCX Multi-Display option before clicking Finish.

6 Chapter 2 

Uninstallation 

Silent Installation 

To uninstall the Wyse TCX Multi-display server software, use the Windows Add or 

Remove Programs feature. Follow these steps: 

1. Click Start | Settings | Control Panel and double click Add or Remove Programs. 

2. From the list of currently installed programs, select Wyse TCX Multi-display and click 

Remove. 

You can install the Wyse TCX Multi-display server software using the silent installation 

mode. During the installation process, you are not prompted for any inputs. The silent 

installation mode performs a “complete” or “typical” install of the product. 

Follow these steps: 

1. Uninstall any existing Wyse TCX Multi-display server software. 

2. Click Start | Run and type cmd to display the operating system command prompt. 

3. Navigate to the directory where the Wyse TCX Multi-display.exe file is located. 

4. At the command prompt, type start /B "Wyse TCX Multi-display.exe" /s /v"/qn 

ALLUSERS=1". 

Silent Uninstallation 

Note 

Use of the parameter ALLUSERS=1 enables anyone who uses the 

computer to access the Wyse TCX Multi-display software. 

Use of the /qn syntax hides all the dialog box prompts during installation or 

uninstallation. To display only the basic dialog box prompts with a Cancel 

button, use the syntax /qb. 

To silently uninstall the Wyse TCX Multi-display software, follow these steps: 

1. Ensure Wyse TCX Multi-display is not running. 


3. Navigate to the directory where the file is located. 

4. At the command prompt, type start /B "Wyse TCX Multi-display.exe" /x /s /v/qn (or 

qb). 

Installing the Wyse TCX Multi-display Client Software 

To see which thin client hardware and OS platforms support WyseTCX Multi-display 

software, see Table 2 in Chapter 1.

Wyse ® TCX Multi-display 1.2 7 

Installing on Wyse Thin OS Client-based Clients 

The Wyse TCX Multi-display client software is embedded in the firmware for clients 

running Wyse Thin OS. 

Installing on Windows XPe-based Clients 

You can download the Wyse TCX Multi-display client software for XPe clients from the 

Wyse website, www.wyse.com. Click Support | Downloads, expand the list marked 

“Please Choose Your Product (Active),” select your hardware model (for example, V90) 

and click the Search button. On the resulting page, scroll down to the Firmware Addons 

section to find the latest client software. 

Download and extract the MDS Client.msi from the zip file. 


1. Log in as administrator. 

2. Disable the write filter. The thin client reboots. 

3. After reboot, log in as administrator. 

4. Double click MDS Client.msi and install the TCX Multi-display client. 

5. Enable the write filter after installation is complete. 

Installing on Windows CE-based Clients 

No additional install is required to support Wyse TCX Multi-display software on CE 5.0 

clients. 

Note 

Requires ICA 10 Build 98.6 RDP add-on build 61.11. 

Installing on Wyse Enhanced SLE-based Clients 

No additional install is required to support Wyse TCX Multi-display software on Wyse 

Enhanced SLE clients. 

Using Wyse TCX Multi-display Software with Wyse Thin Clients 

When the software is in execution: 

• A TCX Multi-display icon 

tray) in a session. 

appears on the right side of the Windows taskbar (system 

Right-clicking the TCX Multi-display icon in the taskbar provides the following menu 

options: 

• Enable - If this option is grayed out, the software is already activated and running. 

• Disable 

• Options - Allows you to configure Wyse TCX Multi-display features

8 Chapter 2 

• About 

• Exit 

Note 

Each monitor must be set to the same screen resolution for the Wyse TCX 

Multi-display software to function with multiple monitors. 

Understanding the Features of Wyse TCX Multi-display Software 

The following sections discuss the features and advantages of using the Wyse TCX 

Multi-display software: 

• "Monitor Display Layout" 

• "Window Maximization and Full Screen Display" 

• "Window Repositioning" 

• "GINA Logon Dialog Box Display" 

• "Exclusion Lists" 

• "Windows Security Dialog Support" 

Monitor Display Layout 

Wyse TCX Multi-display software leverages the local multiple-monitor configuration 

settings of the thin client. To change the monitor layout, right-click the Multi-display icon in 

the system tray, select Options and then select the General tab. 

Note 

For information on local multiple-monitor configuration settings for your thin 

client, refer to the Administrator, User, and ReadMe documentation for your 

thin client model (available on the Wyse Web site at: 

http://www.wyse.com/manuals.) 

For example, a Wyse ® V50L thin client would act as follows: 

• The monitor display layout will be a dual display when the Enable Dual Monitor check 

box is selected (in the Dual Monitor Configuration dialog box - opened by 

double-clicking the DMonitor icon in the Control Panel), and when the Windows Size 

setting Full Screen is selected and the Expand to both screens check box is 

selected in the Window tab of the RDP Configuration dialog box. 

For example: 

• With 1024X768 selected for each single monitor, horizontal dual monitors will 

display the whole desktop in 2048X768. 

• The display orientation (horizontal/vertical) follows the Monitor Orientation setting 

selected in the Dual Monitor Configuration dialog box. Options include: 

Screen 1: Left + Screen 2: Right 

Screen 1: Right + Screen 2: Left 

Screen 1: Top + Screen 2: Bottom 

Screen 1: Bottom + Screen 2: Top 

• By default, the analog input monitor will be Screen 1, the primary display.


• The monitor display layout is a single display when the Windows Size setting Full 

Screen is not selected and the Expand to both screens check box is cleared in the 

Window tab of the RDP Configuration dialog. 

For example: 

• One monitor (Left screen or Top screen) will display the whole desktop. 

• Any other monitor will not display the connection. 

• By default, the analog input monitor will be Screen 1, the primary display. 

• The monitor display layout is a single display when the Enable Dual Monitor check 

box is cleared (in the Dual Monitor Configuration dialog box). 

For example: 

• Regardless of the number of connected monitors, a single monitor displays the 

whole desktop. 

Window Maximization and Full Screen Display 

With Wyse TCX Multi-display software: 

• When you maximize an application window or configure for a full screen, the window 

will be maximized or shown as a full screen on the monitor in which it is located. If the 

window was spanning multiple displays, it will be maximized on the monitor that initially 

displayed the largest area of the window. 

Note 

Microsoft RDP 5.5 supports a maximum total resolution of 1600 x 1200 pixels 

for Windows CE and XPe clients: for example, either a single monitor set at 

1600 x 1200 resolution or dual monitors each set to a maximum of 800 x 600 

(with the desktop extended over both monitors). RDP 5.5 supports display 

resolution ratios of 4:3 only (for example, 1024 x 768, 800 x 600, etc.). 

Microsoft RDP 6.0 adds support for spanning multiple monitors horizontally 

to form a single large desktop; it also supports resolutions up to 4096 x 2048 

pixels (one monitor at 4096 x 2048, or two monitors at 2048 x 2048) and 

additional display resolution ratios, including 16:9 and 16:10. 

Window Repositioning 

With Wyse TCX Multi-display software: 

• Dialog boxes or popups that do not have a “parent” window are displayed in the middle 

of the farthest left or top monitor. Without Wyse TCX Multi-display software, most 

pop-up windows are centered around the border between the two monitors. 

• If the dialog or popup has a “parent” window, it is displayed in the middle of the monitor 

where the parent window is located. 

• An application window opens at the location where it was last closed. 

• When an application window is opened in the maximized view, it is displayed on one 

monitor. 

• Use the key combinations to change the display location of an application (see 

Table 3.) To enable or disable the key combinations, right click the Multi-display icon in 

the system tray, select Options, then select the General tab.

10 Chapter 2 

Table 3 Moving an Application Among Displays 

Keystroke Combination Application Location 

Alt key+Left Arrow The active application moves left to the next display. 

Alt key+Right Arrow The active application moves right to the next display. 

Alt key+Up Arrow The active application moves up to the next display. 

Alt key+Down Arrow The active application moves down to the next display. 

Alt + Shift + Left Arrow All windows move left to the next display. 

Alt + Shift + Right Arrow All windows move right to the next display. 

Alt + Shift + Up Arrow All windows move up to the next display. 

Alt + Shift + Down Arrow All windows move down to the next display. 

Alt + Shift + Number key 

(1-9) 

GINA Logon Dialog Box Display 

The Graphical Identification and Authentication (GINA) dialog box displays the user log on 

interface in Microsoft Windows. With Wyse TCX Multi-display software: 

• The GINA dialog box is shown on the display where the mouse cursor is located. 

• The GINA windows are special windows, and the screen layout must be configured in 

the system INI file (wysehk.ini) located at C:\Program Files\Wyse\Wyse TCX 

Multi-display using the command “Gina= {yes, no}[hori=nX vert=nY]”. 

Note 

The GINA windows positioning feature is not supported on Windows Vista or 

any 64-bit operating system platforms. 

To enable GINA dialog box positioning, you must run Wyse TCX 

Multi-display as a Windows service. 

To run Wyse TCX Multi-display as a Windows service: 

1. Right-click the TCX Multi-display taskbar icon. 

All windows move to the corresponding display. The 

sequence depends on the monitor layout of the Wyse 

thin client. 

Alt + Shift + '0' 

All windows are spread among the displays. 

Alt + Shift + 'Z' 

All windows scale in size to fit the display without 

crossing. 

Alt + 'Z' 

Foreground window scales in size to fit the display 

without crossing. 

2. Select Options | Advanced and check the Run service option. 

3. Click the Install Service button to install Wyse Multi-display as a Windows service. 

(This action requires administrative access.)


Exclusion Lists 

You can exclude applications from being positioned by Wyse TCX Multi-display. To do this, 

right-click the TCX Multi-display icon in the system tray, and navigate to Options | 

Exclusive Application. Select the listed application(s) you wish to exclude, and click 

Add. 

To browse for the application(s) you wish to exclude, click the Add by Browser button. 

Windows Security Dialog Support 

Wyse TCX Multi-display software supports appropriate positioning of the Windows 

security dialog box that appears after the system has been in screen saver mode and the 

“on resume, password protect” feature is enabled. 

Note 

Third party screen saver applications are not supported. 

Using Commands in the .ini Files 

Table 4 shows the commands supported in the wysehk.ini and user.ini files. The 

user.ini file is located in the following directory: 

C:\Documents and Settings\User_Name\Application Data\Wyse\Wyse TCX 

Multi-display 

The wysehk.ini file is located in the following directory: 

C:\Program Files\Wyse\Wyse TCX Multi-display 

Except as noted, all commands shown are supported in both types of .ini files, and the 

user.ini settings take priority over the wysehk.ini settings. 

Write all commands in a single line. Use a number sign (#) at the start of the line to change 

a command to a comment line. 

Table 4 .ini File Commands 

Command/Parameter Description 

AutoStartup={yes, no} Launch Multi-display automatically upon 

session logon. 

DisplayTrayIcon={yes, no} Display the Multi-display icon in the system 

tray icon area. The default value is yes. 

Enable={yes, no} Enable or disable Multi-display. 

Gina={yes, no}[hori=nX vert=nY] For administrators only. 

This command is not supported in the user.ini 

file. The nX represents the horizontal monitor 

number (1-8). The nY represents the vertical 

monitor number (1-8). 

ExitOnSingleHead={yes, no} Set to yes to exit Multi-display when the 

session is configured for a single monitor.

12 Chapter 2 

Table 4 .ini File Commands, Continued 

Command/Parameter Description 

HideTrayIconOnSingleHead={yes, 

no} 

Set to yes to hide the Multi-display icon when 

the session is configured for a single monitor. 

Hori=nX Vert=nY nX represents the horizontal monitor number 

(1-8) 

nY represents the vertical monitor number 

(1-8) 

The priority of monitor layout is user.ini, device 

settings, wysehk.ini (system default). 

HotKeyStyle={HOTKEY_ALT_ARRO 

W, HOTKEY_SHIFT_ALT_ARROW, 

HOTKEY_SHIFT_ALT_NUM} 

RecallApp=”” 

““ 

SplashWin={yes, no} MonitorX=nX 

MonitorY=nY 

LeftTopToMonitor_X=Pixel_X 

LeftTopToMonitor_Y=Pixel_Y 

UnHookProgram=”” 

““ 

HOTKEY_ALT_ARROW 0x00000001 // Alt + 

arrow key 

HOTKEY_SHIFT_ALT_ARROW 0x00000002 / 

/ Alt + SHIFT + arrow key 

HOTKEY_SHIFT_ALT_NUM 0x00000004 // 

Alt + SHIFT + number key (1-9) 

The specified application windows will open in 

the configured monitor. 

PROCESS_NAME is the name of the 

application. 

APP_FILEPATH is the application file name, 

including the full path. 

All windows will open in the configured 

monitor. 

nX represents the horizontal monitor number 

(1-8) 

nY represents the vertical monitor number 

(1-8) 

Disables Multi-display for the specified 

application. 

PROCESS_NAME is the name of the 

application. 

APP_FILEPATH is the application file name, 

including the full path.

3 Wyse ® TCX Multimedia 3.0 

Wyse TCX Multimedia software enables deployment of multimedia applications and 

delivery of multimedia content in a server-centric computing environment. It provides 

users with several media viewing and experience enhancing features when using Wyse 

thin clients. 

Notable features include: 

• Multi-format awareness capability (unicast: MPEG-1, MPEG-2, MPEG-4 Part 2, 

WMV-7, WMV-8, WMV-9, WMA, WAV, MP3, AC3, and Multicast: UDP/RTP MPEG-1) 

• DirectShow based media player support (for example, Windows Media Player 11) 

• Decoder redirection: Wyse thin clients with supported multimedia codecs installed 

support this feature. All media content is transferred to the client for rendering. This 

feature optimizes the audio-video synchronization experience for the user and 

improves server scalability. 

• Rendering redirection: When decoder redirection is not possible, the media content is 

encoded in a series of efficiently compressed JPEG images and transferred to the 

client. This results in significant improvement compared to rendering content using the 

underlying protocol, such as RDP. 

• Playlist playback, network-shared clip playback, URL playback, and web page 

embedded playback are also supported. 

Note 

Network bandwidth required will generally be the same as the bitrate of the 

multimedia file being played. 

Note 

MP3 and WMA files are not supported on Windows Vista with any of the thin 

client platforms. 

AVI support (audio: MP3, WMA, AC3; video: MPEG-1, MPEG-2, MPEG-4, 

part 2) is provided via the availability of corresponding decoders on the 

connecting thin client. If client side decoders are not available, the 

functionality will seamlessly fallback to compression of raw video as JPEG 

images on the server and transmission to client with synchronized audio. 

This fallback functionality is not supported on Windows Vista because MP3 

and WMA files are not supported on Vista. 

MPEG-2 support on Windows XPe thin clients requires a client side decoder 

installed. 

TCX Multimedia for XenApp is supported for Wyse thin clients by clearing the 

Enable Sound check box on an ICA connection. In order to disable TCX 

Multimedia for XenApp and use the native RAVE (Speed Screen) technology, 

check the Enable Sound check box on an ICA connection. 

Rendering redirection is disabled on XPe.

14 Chapter 3 

Installing Wyse TCX Multimedia Server Software 

Installation 



You can download the Wyse TCX Multimedia server software from the Wyse website, 

www.wyse.com. Click Support | Downloads, expand the list next to “Please Choose Your 


to Wyse TCX Multimedia to download the software. 


To install the Wyse TCX Multimedia software on a server, follow these steps: 

1. Double-click the filename WyseMMRServer.msi to open the installation wizard. 


2. You must read and accept the terms and conditions in the license agreement before 

proceeding to install the software. 

• By default the required files are installed in this directory: 

C:\Program Files\Wyse\TCX Multimedia. 

• You can choose a different destination folder for the files by selecting a Custom 

install type. 

To uninstall the Wyse TCX Multimedia server software, use the Windows Add or Remove 

Programs feature. Follow these steps: 


2. Select Wyse TCX Multimedia and click Remove. 

You can install the Wyse TCX Multimedia server software using the silent installation 

mode. During the installation process, you are not prompted for any inputs. The silent 

installation mode performs a “complete” or “typical” install of the product. 



2. Navigate to the directory where the MSI file Wyse MMRServer.msi is located. 

3. At the command prompt, type: 

msiexec /i "WyseMMRServer.msi" ALLUSERS="1" /qn (or /qb) 

Note 


computer to access the Wyse TCX Multimedia software. 



button, use the syntax /qb.

Wyse ® TCX Multimedia 3.0 15 


Port Configuration 

To silently uninstall the Wyse TCX Multimedia server software, follow these steps: 


2. Navigate to the directory where the MSI file WyseMMRServer.msi is located. 


msiexec /x "WyseMMRServer.msi" /qn (or /qb). 

A registry location is created that is used by the Wyse TCX Multimedia server component; 

this entry lists the port number. The registry entry is in the following format: 

[HKEY_LOCAL_MACHINE\Software\Wyse\Multimedia Support\Port] 

portnumber = DWORD value. 

Note 

If the Wyse TCX Multimedia server component finds this registry entry with 

the portnumber defined, the server will attempt to establish a socket 

connection with the thin client on a maximum range of 32 ports (starting with 

the defined portnumber). If the server component does not find the registry 

entry or if the server fails to make a connection with the defined port number, 

then the connection is established on default port numbers 9427 to 9427+31 

(both inclusive). 

Wyse TCX Multimedia Server Performance for WAN 

To improve the performance of Wyse TCX Multimedia on WAN, modify the SO_SNDBUFF 

(SendBuffer) on the server using the registry shown below. 

[HKLM\Software\WYSE\MMR] 

“SendBuff”=dword:0xXXXX 

Note 

For Wyse Thin OS-based clients, set the following parameters in the wnos.ini 

file: 

MMRTcpScale={0-6} 

Explanation: This changes the TCP window scale option from the default 

value of 0 to a value of 0~6. For more details, refer to: 

http://en.wikipedia.org/wiki/TCP_window_scale_option

16 Chapter 3 

Wyse TCX Multimedia Server Logging 

For easier troubleshooting, Wyse TCX Multimedia server can create a log file. 

First, install DebugView. This software is available at: 

http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx 

Create the following registry entries on the server where you want to enable logging: 

[HKEY_LOCAL_MACHINE\SOFTWARE\WYSE\Multimedia Support\debug] 

“level”=dword:00000002 

“type”=dword:00000000 

There are two levels of debugging available: standard (level 1) and debug (level 2). Debug 

mode performs more extended logging than standard mode. 

To enable logging, follow these steps: 

1. Start DebugView. 

2. Start the media playback. 

Wyse TCX Multimedia starts writing log information to DebugView. When the logging is 

finished, the logs that appear in DebugView can be saved to a file. 

To disable logging, set the registry key value for level to 0. 

Support for URL Redirection on Wyse Thin OS-based Clients 

URL redirection sends an original URL with multimedia content directly to the thin client for 

processing, reducing load on the server and providing increased scalability. There are two 

types of URL redirection: 

• URL Redirection is a standard supported via HTTP/HTTPS/FTP for *.mpg files out of 

the box. This type of redirection does not require any special modifications. The server 

and thin client negotiate by default whether to take advantage of URL redirection for 

these files. 

• Custom URL Redirection provides redirection for a Custom Type URL (for example, 

qvmc://...). This type of redirection requires special changes to the Windows registry on 

the server. The following sections provide specific instructions on how to set up custom 

URL redirection. 

Note 

URL Redirection is not supported on XPe and CE or Wyse Enhanced SLE. 

Custom URL Redirection Support 

The server must be a Windows-based machine. When Windows Media Player attempts to 

play a URL, the player parses the initial part of the URL and determines the correct source 

filter to load. Windows Media Player does not play all udp:// or rtp:// based links. The 

default udp or rtp filter cannot process links from other hardware or software based 

streaming servers such as VLC, Minerva, or Darwin.


To support the playback of standard udp or rtp based streams on Windows Media Player, 

various third party vendors have developed their own source filters with different URL 

primitives. For example, QVMC-based URLs begin with qvmc://; Elecard-based URLs 

begin elecard_rtsp://. These URLs are designed to play streams from standard streaming 

servers. When the URL is played, either the QVMC or Elecard source filter is loaded, as 

needed. 

Wyse Thin OS thin client devices support standard rtp and udp protocols for streaming 

media. However, URL playback is only possible if the Wyse URL Redirection SRC filter 

can be registered for such protocols. To enable URL redirection you first need to create 

specific registry entries, as explained in the following sections. This allows the Wyse 

Multimedia server to convert a custom-based URL (such as qvmc:// or elecard_rtsp://) to 

an rtp URL and send it to the thin client for processing. 

Custom Transport Registration 

Any custom transport type can be registered with DirectShow. Therefore, whenever a 

custom URL is found, DirectShow searches for the right source filter based on registry 

entry and loads it. 

A custom registry entry should follow this format: 

HKEY_CLASSES_ROOT 

 

Source Filter = 

Extensions 

= 

= 

For more information on registering a custom file type, refer to Microsoft documentation at: 

http://msdn2.microsoft.com/en-us/library/ms787558.aspx. 

Wyse-specific Registry Entries for URL Redirection 

The following is the tree of Wyse-specific registry entries you need to create for URL 

redirection of custom URL types: 

HKEY_LOCAL_MACHINE/Software/Wyse/Multimedia Support/Transports 

 

Real Transport = 

Real Transport X1 = < url primitive > 

Real Transport X2 = < url primitive > 

. 

. 

. 

Alternate Source Filter = 

Extensions 

= 

= 

There can be several Real Transport X entries. Each X entry represents a client type. 

Each client type is assigned a number. The X is replaced by the appropriate client number 

for that client: for example, the Wyse V10L thin client model uses client number 3. 

Real Transport stores the replacement for the original URL primitive. The user can also 

have a Real Transport entry. This is the default entry. If the Wyse URL SRC filter does not 

find a specific entry for Real Transport, then it selects the default entry.

18 Chapter 3 

is always a string value stored in format: 

“{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}” 

is the file extension and is stored in the format .mpg, .wmv, and so on. 

Whenever a custom transport type is registered to use the Wyse URL SRC filter, the filter 

(based on these registry entries) sends a URL to the thin client or carries out a decoder 

redirection by loading the appropriate src filter on the server side. 

If a user enters a URL such as qvmc://..., and the above mentioned registry entries exist, 

and the Wyse URL SRC filter is registered for a qvmc transport type, then the Wyse URL 

SRC filter can make the following decisions for URL playback (in the priority listed): 

1. The Wyse URL SRC filter always attempts to carry out URL redirection first. If the filter 

finds a matching Real Transport X entry with matching thin client type, then the URL is 

modified and sent to the thin client. If no Real Transport X entry is found, then the 

default Real Transport entry is selected. If the Real Transport default entry does not 

exist, then the filter will send the URL as typed by the user to the thin client. 

2. If the thin client fails using the URL type as described in 1, then the Wyse URL SRC 

filter attempts to carry out decoder redirection by loading the appropriate src filter on 

the server side. Priority is given to loading an extension-based src filter (.extension). 

3. If the Wyse URL SRC filter is unable to find an entry based on .extension as described 

in item 2 in this list, then the filter attempts to load the source filter based on the 

alternate source filter type entry. 

4. If the Wyse URL SRC filter is unable to find an alternate source filter type entry as 

described in 3, then a standard DirectShow URL filter is loaded for decoder redirection. 

An Example Using QVMC 

For QVMC URL redirection, first create the following registry entry: 

[HKEY_CLASSES_ROOT\Qvmc] 

"Source Filter"="{ca5d5362-6720-4666-8405-3928915f9571}" 

The above CLSID is that of the Wyse URL SRC filter. This will ensure that whenever 

qvmc://...is typed, the Wyse URL SRC filter is loaded. 

Next, create the following entries: 

[HKEY_LOCAL_MACHINE\Software\Wyse\Multimedia Support\Transports\Qvmc] 

"Alternate Source Filter"="{AB3499B0-949F-11D4-BAB8-0000863E0FD8}" 

"real transport"="udp" 

"real transport 3"="qvmc" 

[HKEY_LOCAL_MACHINE\Software\Wyse\Multimedia 

Support\Transports\Qvmc\Extensions] 

As a result of these entries, when a Wyse V10L thin client user enters qvmc://: as the URL, real transport is used and qvmc is replaced by udp (because 

there are no real transport entries specific to this thin client type). The URL sent to the thin 

client will be udp:// :. 

For the Wyse V10L thin client, real transport 3 is selected. The entry is the same as the 

original URL primitive.


If the thin client is unable to play the URL and returns ‘false’ to the server, the server 

attempts a decoder redirection by selecting the CLSID from an Alternate Source Filter 

entry in the registry. The CLSID mentioned above is the CLSID of the qvmc src filter. 

If the user enters a URL such as qvmc://10.150.5.15:2000/Olympic.mpg and URL 

redirection fails, the Wyse URL SRC filter attempts a decoder redirection based on an 

Alternate Source Filter entry, since there are no entries under the .../extensions key. 

Installing the Wyse TCX Multimedia Client Software 

To see which thin client hardware and operating systems platforms support Wyse TCX 

Multimedia software, see Table 2 in Chapter 1. 

Installing on Wyse Thin OS-based Clients 

The Wyse TCX Multimedia software is embedded in the firmware for clients running Wyse 

Thin OS. 

Although the Wyse TCX Multimedia client software is already built in the Wyse Thin OS 

thin client, you need a valid license key to activate the software. 

To activate the license key: 

1. Edit the wnos.ini file on your FTP server, adding the entry TCXLicense= at the 

top of the file, where is your license key, for example: 

TCXLicense=XXXXX-XXXXX-XXXXX-XXXXX-XXXXX 

Note 

If you have a non-production key, a valid time server must be set up to 

validate the key. Add the following entry at the beginning of any line in the 

wnos.ini file: TimeServer={IPaddress}, where {IPaddress} is the time 

server’s IP address. 

2. Reboot the thin client. 

3. To validate an activated key, play a multimedia file, then check the key information in 

the thin client Event Log. A valid key displays: Valid TCX Multimedia Key (Expiration 

Date: ). 


You can download the Wyse TCX Multimedia client software for XPe clients from the 





There are two MSI packages. The first MSI package (Wyse TCX 

Multimedia_x.xx.x.x.msi) installs the Wyse TCX Multimedia application. The other MSI 

package (Wyse TCX Multimedia License_x.x.x.x.msi) installs the TCX Multimedia 

license. Both MSI packages and an evaluation license key are bundled in an executable 

package (Wyse TCX Multimedia MSIs_x.xx.x.x.exe).

20 Chapter 3 


1. Log in as administrator. 


3. After reboot, log in again as administrator. 

4. Double click the executable file Wyse TCX Multimedia MSIs_x.xx.x.x.exe to extract 

the TCX multimedia MSI application, the license MSI, and the TCX_Multimedia.txt 

file, as well as an evaluation license key. 

Note 

The license key is an alphanumeric string, similar to the example shown 

here: “license”=”XXXXX-XXXXX-XXXXX-XXXXX-XXXXX” 

5. Install the Wyse TCX Multimedia application MSI. 

6. Install the evaluation Wyse TCX Multimedia License MSI. 

• During the installation, browse for the TCX_Multimedia.txt file included with the 

package. 

7. After installation is complete, enable the write filter. 

Note 

On XPe-based Wyse thin clients, if you are using the VMware VDM Client to 

use Wyse TCX Multimedia functionality in a VDI environment, then you need 

to obtain the “QDVD Client Patch.msi” patch and install it on the Wyse thin 

clients. 

To activate Wyse TCX Multimedia software after your evaluation license expires, you need 

to purchase a valid license key and update the Wyse TCX Multimedia.txt file with the new 

key. To re-activate, follow steps 1, 6, and 7 in the “Installing on Windows XPe-based 

Clients” section. 

Note 

Requires display driver v6.14.10.342 for V90 and v6.14.10.360 for V90L. 

Installing on Windows CE 5.0-based Clients 

You can download the Wyse TCX Multi-display client software for CE clients from the 





There are two executable packages: TCAMultimediaLicenseCE2.0.exe and 

Addon_TCX_Multimedia_B0017.exe bundled as a zip file. Open the zip file and extract 

the contents of Addon_TCX_Multimedia_B0017.exe. You can use the 

TCX_Multimediaaddon.bin file and params.ini file and “Instructions for Installing an 

Addon Using FTP Pull” in the Windows CE 5.0 reference guide to install the TCX 

Multimedia client on a CE 5.0 client. The reference guide is available at www.wyse.com. 

Click Support | Knowledgebase. Click the Knowledgebase tab, and click the Reference 

Guides link. Scroll down to the Solutions section and locate the Reference Guide - 

Windows CE 5.0.


To install the license, extract the contents of TCXMultimediaLicenseCE2.0.exe. Use the 

bootstrap212.exe and tcx_multimedia.txt file and instructions for “Installing an Addon 

Using FTP Pull” in the Windows CE 5.0 reference guide to install the TCX Multimedia 

client license on a CE 5.0 client. The reference guide is available at www.wyse.com. Click 

Support | Knowledgebase. Click the Knowledgebase tab, and click the Reference 

Guides link. Scroll down to the Solutions section and locate the Reference Guide - 

Windows CE 5.0. 


No additional install is required to support Wyse TCX Multimedia software on Wyse 

Enhanced SLE clients. 

Please refer to the “TCX Licensing” section in the reference guide for Wyse Enhanced 

SLE for information on activating the license for the Wyse TCX Multimedia client. 

The reference guide is available at www.wyse.com. Click Support | Knowledgebase. 

Click the Knowledgebase tab, and click the Reference Guides link. Scroll down to the 

Solutions section and locate the Reference Guide - Wyse Enhanced SLE.

22 Chapter 3 

This page intentionally blank.

4 Wyse ® TCX USB Virtualizer 2.0 

Wyse TCX USB Virtualizer software provides thin client users a PC-like experience for 

locally attached USB devices. With Wyse TCX USB Virtualizer, when the user connects to 

Windows XP Pro or Vista in a remote session, the locally attached USB devices on the 

thin client will be redirected to the remote session and will be available as a local device in 

the session. 

Hardware Peripherals Supported 

Wyse TCX USB Virtualizer performs port-level redirection, so the USB device attached to 

a thin client is recognized by the remote operating system as a local USB device. This 

enables more functionality than basic device-level redirection. 

Wyse has verified support for the types of USB devices shown in Table 5. 

Table 5 USB Devices Verified by Wyse for TCX USB Virtualizer 

Device Type Make/Model 

Printer HP Laserjet 1320, HP Deskjet 1280 

Scanner Docket Port 465 

PDA/Blackberry 8820 Smartphone (Edge, WiFi), 8700G, 7100-T Mobile 

Floppy Disk Drive Sony Floppy Drive, Enter Floppy Drive 

USB Flash Drive Crucial, SanDisk, Transcend 

CD ROM IBM USB CD-ROM drive, Adonics CD-ROM drive 

Webcams Microsoft LifeCam VX-1000, Microsoft LifeCam VX-3000, 

Logitech Quickcam Pro (Experimental only.) 

Headsets Microsoft LifeChat LX-3000, Logitech M/NA-00008, 

M/N-00008, 00009 

Biometric Digital Persona 4000B reader 

USB Zip Drive 10 MB USB bus-powered zip 250 

Installing Wyse TCX USB Virtualizer Server Software 

You can download the Wyse TCX Multi-display server software from the Wyse website, 

www.wyse.com. Click Support | Downloads, expand the list next to “Please Choose Your

24 Chapter 4 


to Wyse TCX Multi-display to download the software. 


Installing on Windows XP Professional 

To install Wyse TCX USB Virtualizer server software on Windows XP Professional: 

1. Double click the Wyse_TCX_USB_x.x.xx.msi file to start the installation wizard. 

2. You must accept the terms in the license agreement to proceed with the install. 

Installing on Windows Vista 



To install Wyse TCX USB Virtualizer server software on Windows Vista: 

1. Double click the Wyse_TCX_USB_x.x.xx.exe file to start the installation wizard. 

2. You must accept the terms in the license agreement to proceed with the install. 

To uninstall the Wyse TCX USB Virtualizer server software, use the Windows Add or 

Remove Programs feature. Follow these steps: 


2. Select Wyse TCX USB Virtualizer program and click Remove. 

3. A reboot is required after the uninstall. 

You can install software using the silent installation mode. During the installation process, 

you are not prompted for any inputs. The silent installation mode performs a “complete” or 

“typical” install of the product. 

To silently install the Wyse TCX USB Virtualizer software on Windows XP Professional, 

follow these steps: 

1. Navigate to the directory where the MSI file Wyse_TCX_USB_x.x.xx.msi is located. 


msiexec /i "Wyse_TCX_USB_x.x.xx.msi" ALLUSERS="1" /qn (or /qb) 

Note 


computer to access the Wyse TCX USB Virtualizer software. 




Wyse ® TCX USB Virtualizer 2.0 25 


To silently uninstall the Wyse TCX USB Virtualizer server software from Windows XP 

Professional, follow these steps: 

1. Navigate to the directory where the MSI file Wyse_TCX_USB_x.x.xx.msi is located. 


msiexec /x "Wyse_TCX_USB_x.x.xx.msi" /qn (or /qb). 

Configuring the Wyse TCX USB Virtualizer Software on the Server 

You can configure the port on which the USB redirection service is hosted and decide 

which classes or devices to allow. 

Double click the taskbar icon to open the Wyse TCX USB Virtualization configuration 

utility. 

1. To configure the port that will host the USB virtualizer service, edit the value in the Port 

Number box, and click the Update button. 

2. To allow redirection for a device, or class of devices, check the box in front of the 

device or class name. Allowing redirection for a class means all devices of that type, 

for example, printers and scanners, will be redirected. 

3. To remove a device or class of devices, click to highlight the device or class name and 

click the Remove button. 

4. To allow redirection for a specific device, first add the device to the list. To do this, click 

the Add button. 

5. In the Add window, click the USB Device radio button and enter the device 

information, and click the Allow this USB device check box. 

6. To add a device, click the USB Device radio button, enter the device information, and 

click the Allow this USB Device check box. 

7. To add a class of devices, click the USB Class radio button, enter the class 

information, and click the Allow this USB Class check box.

26 Chapter 4 

Logging 

To enable logging on the server, create the following registry keys with values shown. 

[HKEY_LOCAL_MACHINE\SOFTWARE\Wyse\USBTCX\Debug] 

"AGENT"=dword:0000ffff // For the service 

"CONFIG"=dword:0000ffff // UI 

"TRAYICON"=dword:0000ffff // sys tray application 

Reboot the server. All error conditions and information logs will be added to the event 

viewer and DebugView. DebugView can be found at: 


To disable logging: 

Delete these registry entries and restart the server. 

Installing Wyse TCX USB Virtualizer Client Software 

To see which thin client platforms support Wyse TCX USB Virtualizer software, see 

Table 2 in Chapter 1. 


The Wyse TCX USB Virtualizer software is embedded in the firmware for clients running 

Wyse Thin OS. 

Although the software is already built into the Wyse Thin OS, you need a valid license key 

to activate the software. 

To activate the license key, follow these steps: 

1. Activate the license key (provided at the time of purchase): 

· On the FTP server, edit the wnos.ini file, adding the entry TCXLicense= at 

the top of the file, where is your license key, for example: 


· To activate additional licenses, list the license keys in a single line, using a comma 

to separate the key strings. You can install a maximum of ten licenses on one thin 

client. 

· Save the changes to the wnos.ini file. 

Note 

If you have a non-production key, a valid time server must be set up to 

validate the key. Add the following entry at the beginning of any line in the 

wnos.ini file: TimeServer={IPaddress}, where {IPaddress} is the time 

server’s IP address. 

2. Reboot the thin client.


Configuring for the Wyse Thin OS-based Clients 

To enable USB virtualization for individual sessions, select the USB check box and click 

OK in the Connection Settings window for an RDP session. 

Configuring the .ini File to Support Isochronous Devices (Headsets and 

Webcams) 

To optimize performance of isochronous devices, like USB headsets and webcams, add 

the following lines to the wnos.ini file on the FTP server: 

; required for webcam to work when it requires minimum 16-bit color depth 

desktopcolordepth=16 rgb565=yes 

; required for headsets to work, 

; to not bring sound to the local client and let TCX USB Virtualizer redirect it 

Connect= host= DisableSound=2 

; when TCX USB virtualizer is used along with TCX Rich Sound, 

; Logitech headsets are not redirected by default 

; To force a redirection of Logitech headsets via TCX USB Virtualizer 

Device=vusb ForceRedirect=0x0a81,0x0205,0x03,0x01,0x01 

; required for headsets to work 

; when using TCX USB Virtualizer with XenDesktop 

; to not bring sound to the local client and let TCX USB Virtualizer redirect it 

Pnliteserver=http:// DisableSound=Yes 


You can download the Wyse TCX USB Virtualizer client software for XPe clients from the 


“Please Select a Model,” select your hardware model (for example, V90) and click the 

Search button. On the resulting page, scroll down to the Firmware Addons section to find 

the latest client software. 

There are two MSI packages. The first MSI package (Wyse_TCX_USB_x.x.xx.msi) 

installs the Wyse TCX USB Virtualizer application. The other MSI package (Wyse TCX 

USB License_x.x.x.x.msi) installs the Wyse TCX USB Virtualizer license. Both installers 

and an evaluation license key, tcx_usb_license.txt, are bundled in an executable package 

(Wyse_TCX_USB_x.x.xx.exe). 


1. Log in as administrator.

28 Chapter 4 

Logging 


3. After reboot, log in again as administrator. 

4. Double click the executable file Wyse_TCX_USB_x.x.xx.exe to extract the Wyse 

TCX USB Virtualizer MSI application, the license MSI, and the tcx_usb_license.txt 

file. 

Note 

The license key is an alphanumeric string, similar to the example shown 

here: “license”=”XXXXX-XXXXX-XXXXX-XXXXX-XXXXX” 

5. Install the Wyse TCX USB Virtualizer application MSI. 

6. Install the evaluation Wyse TCX USB Virtualizer License MSI. 

• During the installation, browse for the tcx_usb_license.txt file included with the 

package. 

7. After installation is complete, enable the write filter. 

To activate the software after your evaluation license expires, you need to purchase a 

valid license key and update the tcx_usb_license.txt file with the new key. To re-activate, 

follow steps 1, 6, and 7 in the “Installing on Windows XPe-based Clients” section. 

To enable logging on the XPe client, create the following registry keys with values shown. 

You need to disable the write filter before creating these keys. You can enable the write 

filter after creating the registry keys. 

[HKEY_LOCAL_MACHINE\SOFTWARE\Wyse\USBTCX\Debug] 

"PROXY"=dword:0000ffff // For the service 

"CONFIG"=dword:0000ffff // UI 

"VCCLIENT"=dword:0000ffff // Virtual channel dll 

"TRAYICON"=dword:0000ffff // sys tray application 

Reboot the server. All error conditions and information logs will be added to the event 

viewer and DebugView. DebugView can be found at: 


To disable logging: 

Delete these registry entries and restart the thin client. 

Configuring for the Windows XPe-based Clients 

After Wyse TCX USB Virtualizer software is installed, you can configure the way your USB 

peripherals are connected. A USB device can be: 

• Configured to “always work in a remote session.” 

· When an RDP session is connected, the device is redirected to the server and is 

available a s a local device in the remote session.


· When there is no RDP session, the device is ready for redirection, and unavailable 

locally. 

• Configured to “always work as a local device.” 

· When an RDP session is connected, the device is not redirected to the server and 

is not available as a local device in the remote session. 

• Unconfigured, so that: 

· When the user starts an RDP session, the device is redirected to the server and is 

available as a local device in the remote session. When a device is not configured 

to work either locally or remotely, it is redirected to the server by default, unless it is 

a Human Interface Device (HID), such as a keyboard or mouse. 

· When there is no RDP session, the device is available as a local device. 

After the software installation is complete, a Wyse USB Virtualizer icon appears in your 

taskbar. 

Double-click or right-click the icon to open the configuration utility. 

When you open the configuration utility, a list of attached devices appears. 

To configure device redirection, follow these steps: 

1. In the list of devices, right-click a device name to display the current configuration. A 

device may be preconfigured or unconfigured. You can change the current 

configuration setting by deselecting the configured state and selecting a new 

appropriate state. 

2. When a device is configured to “Always work on the remote server,” the device name 

appears grayed out and italicized when no RDP session is connected. The device is 

ready for redirection, and no longer available locally. 

Note 

All Human Interface Devices are designed to work locally, and by default, the 

Wyse TCX software preconfigures these devices in the Work as local device 

state. If you change the default configuration to make a Human Interface 

Device (for instance, a keyboard) work remotely, the device will be 

unavailable to the local machine. 

3. To add or remove devices from the list, click the Configure button at the bottom of the 

Configuration Utility window. 

4. To remove a device from the list, click the device entry to highlight the device, and then 

click Remove. 

5. To add a device to the list, click Add. You can add a device by using the vendor and 

product ID information, or by class, subclass and protocol information.

30 Chapter 4 

Figure 1 Add USB Device Window 

6. Enter the required information, check or uncheck the box to configure the device for 

local availability, then click Add. 

Installing on Windows CE 5.0-based Clients 

Wyse TCX USB Virtualizer client software is not supported on Windows CE 5.0. 


No additional install is required to support Wyse TCX USB Virtualizer client software on 

Wyse Enhanced SLE. 

Please refer to the “TCX Licensing” section in the reference guide for Wyse Enhanced 

SLE for information on activating the license for the Wyse TCX USB Virtualizer client. 

The reference guide is available at www.wyse.com. Click Support | Knowledgebase. 

Click the Knowledgebase tab, and click the Reference Guides link. Scroll down to the 

Solutions section and locate the Reference Guide - Wyse Enhanced SLE. 

Configuring for the Wyse Enhanced SLE-based Clients 

For information on configuring the Wyse TCX USB Virtualizer client software on Wyse 

Enhanced SLE devices, refer to the “Wyse TCX Virtualizer” section of the Wyse Enhanced 

SLE Administrator’s Guide at the location described in the “Installing on Wyse Enhanced 

SLE-based Clients” section.

5 Wyse ® TCX Rich Sound 1.0 

Wyse TCX Rich Sound software enables delivery of audio communication applications in 

a server-centric computing environment. Wyse TCX Rich Sound virtualization software 

enables the Cisco IP Communicator soft phone application in virtual desktop 

environments. Using any analog headsets and approved USB headsets attached to Wyse 

thin clients, customers can now deploy the Cisco IP Communicator application inside 

virtual desktops and eliminate the need for separate hardware phone units. Wyse TCX 

Rich Sound virtualization software provides high quality bi-directional audio and is 

qualified for use in LAN deployments. 

Wyse TCX Rich Sound also supports: 

• Using any analog headsets and approved USB headsets attached to Wyse thin clients, 

Wyse TCX Rich Sound supports Microsoft RDP for use in VDI environments, Citrix 

PortICA in XenDesktop environments and Citrix ICA in XenApp environments. 

• Recording and playback using Windows Sound Recorder. 

• Audio playback using Windows Media Player and VLC Player. 

• Smooth audio playback of You Tube content. 

• Instant messaging tools like Google Talk and Skype (v 2.5.0.154) (experimentally). 

Validated Hardware Peripherals 

The following peripherals work with Wyse TCX Rich Sound. 

Analog Headsets 

• GE Analog headset 

• Phillips SHM 3100 

USB Headsets 

• Logitech ClearChat Comfort 

• Logitech- 981-000015 

Installing Wyse TCX Rich Sound Server Software 

You can download the Wyse TCX Rich Sound server software from the Wyse website, 

www.wyse.com. Click Support | Downloads, expand the list marked “Please choose your 

product (Active),” choose Wyse TCX, and click the Search button. Click the file name next 

to Wyse TCX Rich Sound to download the software. 

For supported server platforms, see Table 1 in Chapter 1.

32 Chapter 5 

Installation 



To install the Wyse TCX Rich Sound software on a server, follow these steps: 

1. Double-click the filename Wyse TCX Rich Sound Server.msi to open the installation 

wizard. 


2. You must read and accept the terms in the license agreement before proceeding to 

install the software. 

• By default the required files are installed in this directory: 

C:\Program Files\Wyse\TCX Rich Sound. 

Note 

An executable, WATrafficContrller.exe, is added to the Windows firewall 

exception list by the installer. 

Wyse recommends that you uninstall Wyse TCX Rich Sound Server from a console 

session only, and not from within a remote session. 

To uninstall the software, use the Windows Add or Remove Programs feature. Follow 

these steps: 

1. Select Wyse TCX Rich Sound program and click Remove. 

2. A reboot may be required. 

In this mode, you are not prompted for any inputs. The silent installation mode performs a 

“typical” or “complete” installation of Wyse TCX Rich Sound server software. 

To silently install the software, follow these steps: 


2. Navigate to the directory where the MSI file Wyse TCX Rich Sound Server.msi is 

located. 


msiexec /i "Wyse TCX Rich Sound.msi" ALLUSERS="1" /qn (or /qb) 

Note 


computer to access the Wyse TCX Multimedia software. 




Wyse ® TCX Rich Sound 1.0 33 


Port Configuration 

Logging 

To silently uninstall the Wyse TCX Rich Sound server software, follow these steps: 


2. Navigate to the directory where the MSI file Wyse TCX Rich Sound Server.msi is 

located. 


msiexec /x "Wyse TCX Rich Sound.msi" /qn (or /qb). 

The port configuration information for Wyse TCX Rich Sound is stored at this registry 

location: 

Key: [HKLM\Software\Wyse\TCX Rich Sound] 

Port: REG_DWORD 

Wyse TCX Rich Sound client and server software communicate using UDP. The default 

port value is 6901. Rich Sound uses approximately 100 ports, starting from the value set 

in the Port field. 

For easier troubleshooting, enable logging by modifying the following registry entries. 

Key : [HKLM\Software\Wyse\TCX Rich Sound] 

DoFileLog : REG_DWORD 

To enable logging to file, set the DoFileLog value to 1. 

The logged files are in the directory referred to by the LogfileDir. 

To enable logging to debug view, set the DoFileLog value to 4. 

LogLevel : REG_DWORD 

Sound Recorder Quality 

Set the Log Level value to 3 to enable logging. 

Wyse TCX Rich Sound best supports sound recorder audio format of PCM 16.000 kHz, 

16 Bit, Mono or higher. 

Installing the Wyse TCX Rich Sound Client Software 

To see which thin client platforms support Wyse TCX Rich Sound software, see Table 2 in 

Chapter 1.

34 Chapter 5 


The Wyse TCX Rich Sound software is embedded in the firmware for clients running 

Wyse Thin OS. 

Although the software is already built into the Wyse Thin OS, you need a valid license key 

to activate the software. 

To activate and test the license key: 

1. Edit the wnos.ini file, adding the entry TCXLicense= at the top of the file, where 

is your license key, for example.: 


Note 

If you have a non-production key, a valid time server must be set up on the 

thin client to validate the key. To add a time server, add the following entry at 

the beginning of any line in the wnos.ini file: TimeServer={IPaddress}, 

where {IPaddress} is the time server’s IP address. 

2. Reboot the thin client. 

3. Play a media or audio file, then check the key information in the thin client Event Log. A 

valid key displays: Valid TCX Rich Sound Key (Expiration Date: ). 


Wyse TCX Rich Sound software is not currently supported on Windows XPe clients. 

Installing on Windows CE-based Clients 

Wyse TCX Rich Sound software is not currently supported on Windows CE clients. 


Wyse TCX Rich Sound software is not currently supported on Wyse Enhanced SLE 

clients.

Tables 

1 Wyse TCX Extensions Supported Server Platforms 2 

2 Wyse TCX Extensions Supported Client Platforms 2 

3 Moving an Application Among Displays 10 

4 .ini File Commands 11 

5 USB Devices Verified by Wyse for TCX USB Virtualizer 23 

35

Administrators Guide 

Wyse ® TCX Suite 

Issue: 012309 

Written and published by: 

Wyse Technology Inc., January 2009 

Created using FrameMaker ® and Acrobat ®

Administrators Guide: Wyse® TCX Suite - Wyse Technology

Create successful ePaper yourself

Delete template?

Save as template?