Pc Extender Docs

Administrators GuideWyse® PC Extender™

Issue: 042210 PN: 883932-01 Rev. B

Copyright Notices© 2010, 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”)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.

TrademarksThe 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 LegendYou 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 InformationFor 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.

http://www.wyse.com/license

http://www.microsoft.com/exporting

http://www.wyse.com/

Contents

1 Introduction 1Hardware and Software Requirements 1About this Guide 2

Organization of this Guide 2Finding the Information You Need in this Guide 2

Wyse Technical Support 3Related Online Resources Available at Wyse 3Wyse Online Community 3

2 Getting Started 5Installing and Starting Wyse PC Extender 5Product Registration 6Logging In 6Understanding the Desktop Panel 7

Desktop Keyboard Shortcuts 8Using the Computer Menu 9Setting Up Thin Clients and Connections 9Connecting to Network and Session Services 10Connecting to a Printer 10Shutting Down, Restarting, and Suspending 10Restoring Default Settings 11

Restoring Default User Settings with G-key Reset 11Restoring the Original Factory Default Settings 11

Uninstalling Wyse PC Extender 11Enhancing Your Experience with Wyse Software 12

Wyse Device Manager (WDM) 12Wyse TCX Suite 12Wyse Virtual Desktop Accelerator 13

3 Automating Thin Client Configurations and Upgrades 15About Automatic Firmware and Add-on Updates 15How INI files Are Employed 16How to Set Up Automatic Upgrades and Configurations 17

Step 1: Preparing the Root Directory and Folder Structure on the File Server 17Step 2: “Pointing” the Thin Client to the File Server 19

Manually Configuring the File Server Location 19Using DHCP 19

Step 3: Rebooting 21

4 Setting Up the Thin Client Using the Control Center 23Configuring Keyboard Preferences 25Configuring Mouse Preferences 25Setting Up and Managing Printers 26

Installing a Network Printer 26Installing a Local Printer 27Managing Your Printers 27

iv Contents

Configuring Display Settings 28Setting the Language 28Changing Passwords 29Configuring Device Settings 30

Terminal Name 30Hosts 30Ethernet Speed 31Serial Ports Configuration 31

Configuring ICA Global Settings 32Network 32Drive Mapping 33

Adding Drives 33Editing and Deleting Drives 33

Hotkeys 34COM Ports 34

Adding COM Ports 35Deleting COM Ports 35

Display 35Firewall 36Trusted Server Configuration 36

Importing Certificates 37Adding Certificates from a Remote Server 37Adding Certificates from a Local Device 38

Configuring INI and Upgrade Settings 38Obtaining INI and Upgrade Server Details from DHCP 39Manually Configuring the INI Server URL 39Configuring the Image Upgrade Options 39

Configuring Network Connections 40Using Novell Add-on Manager 41Setting Remote Desktop Preferences 42Setting Screensaver Preferences 42Viewing System Information 43TCX Licensing 43Using TCX USB Virtualizer 44Configuring the WDM Agent 45

5 Using and Configuring Connections with the Connection Manager 47Adding Connections Overview 48Adding Mozilla Firefox Browser Connections 49

Network 49Window 49Auto Reconnect 49

Adding ICA Connections 50Network 50Connection 51Window 51Application 51Login 51Auto Reconnect 52Firewall 52

Adding RDP Connections 53Network 53Connection 53Experience 54Window 54Application 54Login 54Auto Reconnect 54

Contents v

Drive Mapping 55Adding Drives 55Editing and Deleting Drives 55

Device Mapping 56Adding Devices 56Deleting Devices 56

Adding SSH Connections 57Network 57Connection 57

Adding VMware View Client Connections 58Network 58Window 58Login 59

Adding VNC Viewer Connections 59Network 59Connection 60Window 60Login 60

Adding XDMCP Connections 60Network 61Window 61Connection 61

6 Accessing Applications with the Application Browser 63Performing Diagnostics 64Configuring Power Management Settings 64Configuring PulseAudio Volume Control Settings 64Adjusting Volume Control Settings 65Taking Screenshots 65

Figures 67

Tables 69

vi Contents

This page intentionally blank.

1 Introduction

Wyse® PC ExtenderTM provides a simple way to “repurpose” an existing PC or laptop into your current thin client environment and VMware Virtual Desktop Infrastructure (VDI). With Wyse PC Extender you can quickly use a PC or laptop running Windows XP Professional as a thin client that can provide all of the advantages of thin computing (high productivity at lower cost, improving security and reliability, ease of management for IT, central management from a data center, and so on).

NoteWyse PC Extender is a great way to quickly experience the advantages of thin computing with your current hardware. Having your thin computing environment up and running before your current hardware reaches “end-of-life” provides minimal downtime when you simply replace your hardware with Wyse thin clients.

Wyse PC Extender uses the Wyse® Enhanced SUSE Linux Enterprise (SLE) operating system. Wyse Enhanced SLE combines the security, flexibility, and market-leading usability of SUSE Linux Enterprise from Novell® with Wyse’s thin computing optimizations in management and user experience. It is ideal for organizations that want to run server-based, Web-based, or local applications (including legacy applications) without the deployment and security concerns of a non-standard Linux distribution.

Wyse Enhanced SLE comes pre-installed with the software needed for most thin computing deployments, including an ICA client, RDP client, Firefox Web browser, and the PowerTerm® Terminal Emulation client. You can extend this base functionality through easy-to-install add-ons qualified and available through Wyse (such as ThinPrint support) or other packages that have been qualified for Novell SUSE Linux Enterprise Thin Client. As with all Wyse platforms, Wyse Enhanced SLE has built in support for Wyse Device Manager (WDM) software, Wyse® TCX Suite™, and Wyse® Virtual Desktop Accelerator.

Hardware and Software RequirementsWhile most models of Enterprise PC’s are compatible with Wyse PC Extender, DellTM OptiplexTM GX series 170, 260, 280 and HP Compaq d530 machines have been tested for use with Wyse PC Extender.

Use the following guidelines for minimum requirements:• PC or laptop with 32-bit Windows XP Professional• 512 MB free hard disk space (NTFS file formatted)• 512 MB RAM• 1 GHz CPU

2 Chapter 1

About this GuideThis guide is intended for administrators, IT, and Customer Service staff that manage thin client environments. It provides the necessary information for using Wyse PC Extender to quickly and easily “repurpose” an existing PC or laptop into a thin client environment and VMware Virtual Desktop Infrastructure (VDI).

Organization of this GuideThis guide is organized as follows:• Chapter 2, "Getting Started," provides information to help you quickly get started using

Wyse PC Extender. It explains how to install Wyse PC Extender and start your thin client operating system. It describes basic thin client functions and provides instructions on setting up the thin client for you and your users.

• Chapter 3, "Automating Thin Client Configurations and Upgrades," contains information on how to configure the network environment so that your thin clients can configure and update themselves automatically. It explains automatic firmware updates, INI text-based configuration, and how you can automate thin client upgrades.

• Chapter 4, "Setting Up the Thin Client Using the Control Center," contains information to help you set up your thin client hardware, look and feel, and system settings using the Control Center.

• Chapter 5, "Using and Configuring Connections with the Connection Manager," provides information and detailed instructions on using and configuring connections to access the enterprise server environment available to the thin client.

• Chapter 6, "Accessing Applications with the Application Browser," provides detailed information about using the Application Browser to access the applications, audio and video, and system features installed on the thin client.

Finding the Information You Need in this GuideYou can use either the Search window or Find toolbar to locate a word, series of words, or partial word in an active PDF document. For detailed information on using these features, refer to the Help in your PDF reader.

Introduction 3

Wyse Technical SupportTo access Wyse technical resources, visit http://www.wyse.com/support. If you still have questions, you can submit your questions using the Wyse Self-Service Center (on the Wyse.com home page, go to Support | Knowledge Base | Home tab) 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. Pacific Time, Monday through Friday.

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

Related Online Resources Available at WyseReference Guide: Wyse ® Enhanced SUSE Linux Enterprise INI Files is intended for administrators of Wyse thin clients running Wyse Enhanced SUSE Linux Enterprise (SLE). It provides the detailed information you need to help you understand and use the Wyse Enhanced SLE INI files. It contains information on the different Wyse Enhanced SLE INI files you can use and the rules for constructing the files. It also provides the parameter details you need (with working examples) to get the most out of your Wyse Enhanced SLE INI files. In addition, this guide also includes an appendix that contains all of the supported connect parameters you can use for supported connections. It is available at: http://www.wyse.com/manuals.

Wyse Enhanced SLE 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.

Wyse Thin Computing Software is available on the Wyse Web site at: http://www.wyse.com/products/software.

Wyse Online CommunityWyse maintains an online community where users of our products can seek and exchange information on user forums. Visit the Wyse Online Community Forums at: http://community.wyse.com/forums.

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

http://www.wyse.com/support

http://www.wyse.com/products

https://support.wyse.com/OA_HTML/ibuhpage.jsp

http://www.wyse.com/manuals

http://www.wyse.com/manuals

http://www.wyse.com/global

http://community.wyse.com/forums/

http://community.wyse.com/forums/

4 Chapter 1


2 Getting Started

This chapter provides information to help you quickly get started using Wyse PC Extender. It explains how to install Wyse PC Extender and start your thin client operating system. It describes basic thin client functions and provides instructions on setting up the thin client for you and your users.

Installing and Starting Wyse PC ExtenderUse the following guidelines:

NoteWyse PC Extender installation is safe to install and uninstall as there is no re-partitioning of your current system.

1. Obtain and place the Wyse PC Extender Setup.exe file into the directory you want (for example C:\WysePC Extender).

2. Double-click the Setup.exe file to open and use the Wyse PC Extender InstallShield Wizard.

Figure 1 Wyse PC Extender InstallShield Wizard

3. After the installation is complete, be sure to remove any disks from their drives before restating your computer.

4. After your computer restarts, you will be prompted to select either the Wyse Enhanced SUSE Linux option or the installed Windows operating system option.

5. To start the Wyse Enhanced SUSE Linux operating system, use the arrow keys to select the option and press the Enter key (the Wyse Enhanced SUSE Linux option will automatically start if no selection is made).

6 Chapter 2

NoteWhat a user will see, initially, when they turn on or reboot a “Wyse PC Extender” thin client, depends on the method of access to the enterprise intranet and how the network administrator has set up the user account. If a PC or laptop does not successfully boot to the Wyse Enhanced SUSE Linux operating system, you can re-start your machine and select the originally installed Windows operating system boot option to return to your original system. Note that each time you select the originally installed Windows operating system boot option, a prompt to uninstall Wyse PC Extender appears to help support uninstallation.

Product RegistrationUse the following guidelines:

1. After product purchase, you will receive an e-mail containing your software License Key.

2. Go to http://commerce.wyse.com, click the registration and software download link for your product, and then use the Customer Log In page.

3. After login, click the registration link for your product to open and complete the software License Key page.

Logging InAfter your thin client starts, you can log in to your desktop using the default user name admin, and the default password admin. It is highly recommended that you change the default password by using the Change Password icon in the Control Center (see "Changing Passwords").

NoteWhat a user will see when they turn on or reboot a thin client after administrator configuration, depends on the method of access to the enterprise intranet and how the network administrator has set up the user account.

http://commerce.wyse.com

Getting Started 7

Understanding the Desktop PanelThe desktop panel, located along the bottom of the desktop, provides various applications and tools for use.

Figure 2 Desktop

Notable icons on the desktop panel include:• Computer button - Allows you to open and use the Computer menu. This menu

allows you to access the Connection Manager, Control Center, and Application Browser. You can also shut down your thin client from the Computer menu.

• Power icon - Move the pointer over this icon to see a pop-up message that shows you whether your thin client is running on AC power or battery power. The message also shows you (by percentage) your battery charge.

• Network Manager icon - Allows you to manage your network connections (see "Connecting to Network and Session Services").

• System Information icon - Allows you to open and use the System Information dialog box. Use this dialog box to view system information about the thin client (see "Viewing System Information").

• Display Settings icon - Allows you to set the monitor display settings (see "Configuring Display Settings").

• Volume icon - Allows you to control the audio volume (see "Configuring PulseAudio Volume Control Settings").

• Calendar - Lists the day of the week, date, and time. You can click the calendar to open a calendar window and reset the date.

8 Chapter 2

Desktop Keyboard ShortcutsDepending on the type of application window you are using (full screen, standard, or seamless), you can use shortcut keys (see Table 1) to manage windows.

NoteThe shortcut keys Alt+DownArrow (allows you to switch windows using a dialog box) and Alt+Ctrl+DownArrow (minimizes or maximizes all windows) are useful for navigating multiple remote sessions without having to log out.

Table 1 Window-related Shortcut Keys

Window Action Press

Maximize window Alt+F10

Minimize window Alt+F9

Restore maximized window to previous size

Alt+F5

Move focus to next window Alt+Esc

Move focus to previous window Alt+Shift+Esc

Switch windows using a dialog box.

Alt+DownArrow

Switch panel focus Alt+Ctrl+Shift+DownArrow

Show the window menu Alt+Space (you can also right-click the window title bar or border, or click the window icon)

Minimize/maximize all windows Alt+Ctrl+DownArrow

Move window with arrow keys Alt+F7 and press an arrow key

Resize window Alt+F8 and press an arrow key

Show desktop panel Alt+F1

Close the window Alt+F4

Getting Started 9

Using the Computer MenuClick the Computer button on the left side of the desktop panel to open the Computer menu. This menu provides provide quick access to frequently used programs and common system areas.

Figure 3 Computer menu

Use the following guidelines:• Connection Manager - Opens the Connection Manager. Use the Connection

Manager to view, use, and locally configure connections on the thin client as described in "Using and Configuring Connections with the Connection Manager."

• Firefox - Allows you to open and use the Firefox Web Browser.• More Applications - Opens the Application Browser. Use the Application Browser to

use and manage applications on the thin client. For more information, see "Accessing Applications with the Application Browser."

• Control Center - Opens the Control Center. Use the Control Center to configure the hardware, look and feel, and system settings of your thin client as described in "Setting Up the Thin Client Using the Control Center."

• Lock Screen - Allows you to lock your desktop screen (desktop displays blank after you click the icon). To restore your screen, move the mouse, enter your credentials, and then click Unlock.

• Logout - Allows you to open and use the Log Out dialog box (click Log Out to end your session but continue to run the thin client).

• Shutdown - Allows you to open and use the Shutdown dialog box (where you can shut down your thin client, restart your thin client, or put your thin client in Standby mode).

Setting Up Thin Clients and ConnectionsWhile Wyse Enhanced SLE INI Files can be used to set up the thin clients in your environment and configure the connections available to users (as described in "Automating Thin Client Configurations and Upgrades" and Reference Guide: Wyse ®

Enhanced SUSE Linux Enterprise INI Files), you can use the:• Control Center to locally set up your thin client hardware, look and feel, and system

settings (as described in "Setting Up the Thin Client Using the Control Center").• Connection Manager to locally configure connections for use (as described in "Using

and Configuring Connections with the Connection Manager").

10 Chapter 2

Connecting to Network and Session ServicesThe Network Manager icon, located on the right side of the desktop panel, displays information about your network connection. Move the pointer over the Network Manager icon to view a pop-up message displaying the name of the network to which your thin client is connected. If a red X appears on this icon, your thin client is not connected to the network. Connect your thin client to the wired network by attaching the network cable to your thin client (the Connection Established message appears).

Connecting to a PrinterTo connect a parallel printer to your thin client through a USB port, you will need a USB-to-printer adapter cable (not included). Before use, you may need to install the driver for the printer by following the printer driver installation instructions. For information on connecting to printers, refer to "Setting Up and Managing Printers."

Shutting Down, Restarting, and SuspendingAfter using your thin client, you can shut down, restart, or place your thin client into Standby mode. Click the Computer button to open the Computer menu, and then click the Shutdown button to open the Shutdown dialog box. Use this dialog box to do one of the following:• Shutdown - Shuts down and turns off your thin client.• Restart - Shuts down and restarts your thin client.• Suspend - Places the thin client in Standby mode to preserve power. To exit Standby

mode, click the mouse.

NoteSuspend may not work properly on some PC models.

Getting Started 11

Restoring Default SettingsDepending on the default settings you want to restore on the thin client, you can use either the G key reset (to restore default users settings), or the Thin Client Settings dialog box (to restore all factory default settings).

Restoring Default User Settings with G-key ResetWith a G-key reset restoration (PS/2 keyboard is required), user customizations are deleted. However, add-on applications that you installed are retained, and applications that you removed are not restored.

To use this type of restoration, when you see the splash screen during system boot (the screen reads, “SUSE Linux Enterprise Desktop” and displays a progress bar), hold down the G key to restore the default user settings.

Restoring the Original Factory Default SettingsUsing the Thin Client Settings dialog box you can restore all factory default settings.

Use the following guidelines:

1. Click the Computer button on the desktop panel and select Control Center to open the Control Center.

2. Click INI and Upgrade Settings to open the INI and Upgrade Network Settings dialog box.

3. If necessary, clear the Get INI and upgrade server details via DHCP check box.

4. Click Image upgrade settings to open the Thin Client Settings dialog box.

5. Select the Restore factory defaults when upgrading check box.

6. Select the Force base system update check box.

7. Click OK.

Uninstalling Wyse PC ExtenderThe Wyse PC Extender InstallShield Wizard allows you to easily uninstall Wyse PC Extender (the installation wizard recognizes that you already have a current installation). Uninstalling Wyse PC Extender removes all Wyse PC Extender features currently existing by previous installations.

NoteTo help support uninstallation, a prompt to uninstall Wyse PC Extender appears each time you select the originally installed Windows operating system boot option. You can also use the Windows Add/Remove Programs feature to uninstall Wyse PC Extender.


1. Obtain and place the Wyse PC Extender Setup.exe file into the directory you want (for example C:\WysePC Extender).

2. Double-click the Setup.exe file to open the Wyse PC Extender Setup Maintenance Wizard.

12 Chapter 2

3. Select the Remove option, and then click Next to open a remove confirmation message.

Figure 4 Remove confirmation message

4. Click Yes to begin uninstalling.

5. After the removal is complete, click Finish.

NoteAfter the computer restarts, the installed Windows operating system will start.

Enhancing Your Experience with Wyse SoftwareWyse provides several software products that are specifically designed to enhance your thin client experience. Wyse Thin Computing Software is available on the Wyse Web site at: http://www.wyse.com/products/software.

Wyse Device Manager (WDM)Wyse Device ManagerTM (WDM) servers provide network management services to the thin client (complete user-desktop control—with features such as remote shadow, reboot, shutdown, boot, rename, automatic device check-in support, Wake-On-LAN, change device properties, and so on). With WDM you can manage all of your network devices from one simple-to-use console.

Wyse TCX SuiteWyse TCX SuiteTM is a single software solution that helps thin client environments provide the benefits of thin computing without compromises on the end-user experience. Each software component in the suite delivers a specific enhancement designed to work seamlessly within a variety of prevalent backend infrastructure solutions such as Microsoft® Terminal Services, Citrix® XenApp, Citrix® XenDesktop, and VMware® View or Virtual Desktop Infrastructure.

Wyse TCX Suite includes:• Wyse® TCX Flash Acceleration™ - enables Wyse thin client users to experience

improved Flash video content performance in a remote computing environment.• Wyse® TCX Multi-display™ - makes virtual desktops and applications multi-monitor

aware (provides productivity-enhancing advantages for Wyse thin clients using multiple monitors).

• Wyse® TCX Multimedia™ - supports enhanced playback of MPEG, WAV, WMV, and other multimedia file formats (the software includes both the server and client components that work intelligently to redirect multimedia processing tasks dynamically between the client and server for a richer user experience).

• Wyse® TCX Rich Sound™ - enables the zero-compromise deployment of virtual desktops and applications with the capability of receiving and transmitting high quality

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

Getting Started 13

audio (provides bi-directional audio capabilities for virtual desktops and applications, and supports sound recording and playback applications).

• Wyse® TCX USB Virtualizer™ - makes client attached USB devices visible to virtual desktops and applications (removes any compromises on limited local device drivers for a broad range of USB-based printers, scanners, storage devices, Palm, BlackBerry, Pocket PC handhelds, webcams and headsets).

Wyse Virtual Desktop AcceleratorWyse® Virtual Desktop Accelerator (VDA) is a software product that, when used with Wyse thin clients and supported PCs, provides an “accelerated” user experience on remote desktop sessions with high round-trip delay between the server and client. By accelerating the remote desktop protocols by a factor of up to 3 times on certain networks, a Wyse VDA session with a server located thousands of miles from your client “feels” similar to a non-accelerated session with a server located just a few hundred miles from your client.

Built for use on high-bandwidth high-latency networks that are prone to packet loss situations, primary use cases for Wyse VDA include:• Datacenter Consolidation• Desktop Cloud Computing• Remote Off-Shore Desktop Computing

14 Chapter 2


3 Automating Thin Client Configurations and UpgradesThis chapter contains information on how to configure the network environment so that your thin clients can configure and update themselves automatically. It explains INI text-based configuration and how you can automate thin client updates. For detailed information on constructing and using Wyse Enhanced SLE INI files, refer to Reference Guide: Wyse ® Enhanced SUSE Linux Enterprise INI Files.

NoteWyse® Enhanced SUSE Linux Enterprise (SLE) does not require device management software. Your thin client is configured to obtain its IP address, as well as the location of firmware and configuration instructions, from a DHCP server. You can use "Wyse Device Manager (WDM)" for a more hands-on management of client upgrades and configuration. For information about configuring thin clients to communicate with a WDM server, see "Configuring the WDM Agent" and related INI parameters in Reference Guide: Wyse ® Enhanced SUSE Linux Enterprise INI Files.

About Automatic Firmware and Add-on UpdatesAt each boot up, Wyse Enhanced SLE checks to see whether any updates are available on a predefined file server, and if updates are available, the updates are installed automatically. Firmware and any additional software (add-ons) that are on the unit are replaced by their up-to-date versions on the server.

NoteOnly pre-existing add-ons are automatically pulled from the server. If you want to place new add-ons on the client, use the Novell Add-on Manager available in the Control Center (see "Using Novell Add-on Manager") or the NewAddons INI parameter (see Reference Guide: Wyse ® Enhanced SUSE Linux Enterprise INI Files).

16 Chapter 3

How INI files Are EmployedINI files determine how the thin client is configured and upgraded. The thin client accesses INI (.ini) files from the server during the initialization process. The network administrator creates and maintains these INI files. Typically, INI files are accessed through FTP or HTTP (other supported protocols include FTPS, TFTP, and HTTPS); if no protocol is specified, the default is anonymous FTP.

INI files are employed as follows: • wlx.ini - This is the global INI file. One wlx.ini file is available to all users. It

contains global parameters for all thin clients accessing the server. If the operating system cannot find wlx.ini, it defaults to wnos.ini.

• {username}.ini - This file is unique to each user. The {username}.ini file contains the connection profile for each user. Parameters in the user profile generally supersede the identically named global parameters.

• $MAC.ini - This file can be used for device-specific configuration. If the thin client locates this INI file (it is stored in the same directory as wlx.ini), wlx.ini is not accessed, unless you use the include=wlx.ini parameter.

When a thin client is initialized, it accesses the global wlx.ini file. When a user logs in, the thin client accesses the user’s unique {username}.ini file.

NoteDescriptions of INI file commands and parameters can be found in Reference Guide: Wyse ® Enhanced SUSE Linux Enterprise INI Files.

NoteIf both PNLite and a user profile are being used, the username must be defined in the Windows domain to be used, and the password must be the same for the domain and the profile.

Automating Thin Client Configurations and Upgrades 17

How to Set Up Automatic Upgrades and ConfigurationsFor the thin client to successfully access INI files and upgrade itself from the server, you must set up the file server with the correct folder structure and “point” the thin client to the file server where the INI files and other upgrade files are located. Finally, you must reboot. These tasks are described in the following pages.

Step 1: Preparing the Root Directory and Folder Structure on the File ServerFigure 5 demonstrates how to set up the folder structure on your file server and where to place INI files and other necessary files inside the structure. This list describes the folder structure, starting with the root directory./wyse_pce/ The root directory. It stores the wlx directory and the addons

directory. It also stores these files, which are used for imaging and updating devices: Latest-image.raw and Latest-image.raw.info.

/wyse_pce/wlx The main INI configuration folder. It stores the bitmap, certs, and ini directory.It also stores these files: wlx.ini or $MAC.ini.

/wyse_pce/wlx/bitmap

Stores custom icons and other images.

/wyse_pce/wlx/certs

Stores certificates to import to the thin client using the INI commands Certs and ImportCerts.

/wyse_pce/wlx/ini

Stores the {username}.ini file.

/wyse_pce/addons Stores add-ons. It also stores the directory file and the *.rpm packages available to be installed on the thin client. The directory file should list all available add-ons. The directory file is required in the addons folder to guarantee that add-ons are properly located.

NOTE: If you want to do an update with the Preserve changes option enabled, make sure that your addons directory includes a copy of your current add-ons. The system may require two reboots to fully update the firmware and add-ons while preserving local changes.

18 Chapter 3

Figure 5 File server folder structure

CautionThe location of the addons folder is part of the root path directory (Wyse_pce).


Step 2: “Pointing” the Thin Client to the File ServerAfter you set up the folder structure and populate it with the correct files, the next step is to point the thin client to the server location. The thin client can obtain the location of the server in two different ways, using DHCP or manually configuring the file server location. Using DHCP is strongly recommended.

Manually Configuring the File Server LocationTo manually configure the file server location (not recommended), open the INI and Upgrade Settings dialog box, and enter the address in the INI Server URL text box. For more information, see "Configuring INI and Upgrade Settings."

NoteYou can click Image Upgrade Settings to configure INI and upgrade network settings as described in "Configuring the Image Upgrade Options."

Figure 6 INI and Upgrade Network Settings dialog box

Using DHCPWith the DHCP method of configuring the file server location (recommended), information about the server and root directory is obtained from DHCP option tags 161, 162, 184, and 185 (refer to Table 2 for complete descriptions of these option tags): • 161 - The server URL (full URL including the root path).• 162 - Root path to the file server (ftp/http/https) (for backward compatibility).

· If no root path is defined, /wyse_pce is assumed.· If a root path is defined, the additional path will be appended to the URL supplied by

tag 161.• 184 - (Optional) File server user name (to server specified in Option 161).• 185 - (Optional) File server password (to server specified in Option 161).

NoteCheck-in for firmware updates are done early in the boot process. For that reason, changes in DHCP information may not be propagated to a unit until a full boot is completed. However, you can avoid this by forcing a renewing of the DHCP lease, which makes sure that the unit has the latest file-server location before the next firmware check. Open the System Information dialog box (click the System Information icon on the desktop panel), click the Network tab, click the Release button, and then click the Renew button.

20 Chapter 3

Table 2 describes all the DHCP option tags.

Table 2 DHCP Option Tags

Option Description Notes

1 Client identifier Always sent

2 Time Offset Optional.

3 Router Optional but recommended. It is not required unless the appliance must interact with servers on a different subnet.

6 Domain Name Server(DNS)

Optional but recommended.

12 Host Name/Terminal Name

Optional string. The host name or terminal name to be set.

15 Domain Name Optional but recommended. See Option 6.

28 Broadcast Address Optional.

44 WINS servers IP Address

Optional.

51 Lease Time Optional but recommended.

52 Option Overload Optional.

53 DHCP Message Type Recommended.

54 DHCP Server IP Address

Recommended.

55 Parameter Request List

Sent by appliance.

57 Maximum DHCP Message Size

Optional (always sent by appliance).

58 T1 (renew) Time Optional but recommended.

59 T2 (rebind) Time Optional but recommended.

61 Client identifier Always sent.

161 Server address or URL

Optional string. If this is an IP address or resolvable hostname, the protocol is assumed to be FTP; however, it may be the leading portion of a URL that specifies another protocol. If using the URL form, it should not include a trailing slash (for example, http://server.example.com or ftp://192.168.0.1).


Step 3: RebootingAfter you reboot, the thin client will look in the defined root path for the latest available image and upgrade if necessary. Additionally, it will check the directory file in the addons folder to see if any updates for installed add-ons are defined.

NoteAdd-ons that exist in the addons folder but are not listed in the directory file, will be ignored during upgrade check-in.

162 Root path to the file server (ftp/http/https)

Optional string. The relative directory starting from the root directory must be given. For example, on a Windows FTP server, the full directory may be C:\Inetpub\ftproot\wyse_pce, where wyse_pce is the directory that contains the firmware. In this example, the correct string value for this DHCP option is /wyse_pce. On a Linux server, an FTP user-based directory might be /home/test/wyse_pce. In this example, if the FTP user is test, then the FTP root path is /wyse_pce and not the full path (/home/test/wyse_pce).This value should use URL path notation (start with a forward slash, /, and use a forward slash as folder separators).

181 PN Server Optional string. IP address or FQDN of the PNLite server.

182 Admin List Optional string. DHCP equivalent of the DomainList ini file parameter.

184 File Server Username Optional string. Username to use when authenticating to the server specified in Option 161.

185 File Server Password Optional string. Password to use when authenticating to the server specified in Option 161.

186 Wyse WDM Servers Optional binary IP addresses. IP address or FQDN of the WDM server. Does not require option 187 to be specified.

Table 2 DHCP Option Tags, Continued

Option Description Notes

22 Chapter 3


4 Setting Up the Thin Client Using the Control CenterThis chapter contains information to help you set up your thin client hardware, look and feel, and system settings using the Control Center.

NoteConfigurations made in the Control Center only apply to the thin client you are using. If you want to configure more than one thin client at a time or configure thin clients remotely, Wyse recommends configuring thin client settings using INI files as described in "Automating Thin Client Configurations and Upgrades."

CautionSome thin client information, applications, and system configurations are saved and remain persistent after reboot for high-privilege users only.

Clicking Control Center in the Computer menu (see "Using the Computer Menu") or in the Connection Manager (see "Using and Configuring Connections with the Connection Manager") opens the Control Center. You can use the Control Center to set up your thin client settings and preferences.

Figure 7 Control Center

24 Chapter 4

This chapter includes information on:• "Configuring Keyboard Preferences"• "Configuring Mouse Preferences"• "Setting Up and Managing Printers"• "Configuring Display Settings"• "Setting the Language"• "Changing Passwords"• "Configuring Device Settings"• "Configuring ICA Global Settings"• "Importing Certificates"• "Configuring INI and Upgrade Settings"• "Configuring Network Connections"• "Using Novell Add-on Manager"• "Setting Remote Desktop Preferences"• "Setting Screensaver Preferences"• "Viewing System Information"• "TCX Licensing"• "Using TCX USB Virtualizer"• "Configuring the WDM Agent"

Setting Up the Thin Client Using the Control Center 25

Configuring Keyboard PreferencesClicking the Keyboard icon in the Control Center opens the Keyboard Preferences dialog box. Use this dialog box to select general (repeat key and cursor blinking), layout (keyboard models and layout options), accessibility (sticky key, slow key, bounce, key audio feedback), mouse keys (keypad control of pointer), and typing break (reminder) preferences.

Figure 8 Keyboard Preferences

Configuring Mouse PreferencesClicking the Mouse icon in the Control Center opens the Mouse Preferences dialog box. Use this dialog box to select general (mouse orientation, locate pointer, pointer speed, drag-and-drop, double-click time out) and accessibility (simulated secondary click and Dwell click) preferences.

Figure 9 Mouse Preferences

26 Chapter 4

Setting Up and Managing PrintersClicking the Printers icon in the Control Center opens the Printer Configuration dialog box. Use this dialog box to:• View the list of currently configured printers.• Add and configure a network or local printer.• Select the default printer (select a printer in the list and select Edit | Make Default).• Change printer settings (select a printer in the list and select Edit | Properties).

Figure 10 Printers

NoteAfter you add a printer, you can manage its print jobs from the Printer dialog box (select a printer, and then select Edit from the menu).

Installing a Network PrinterUse the following guidelines:

1. Click the New icon in the Printer Configuration dialog box to open and use the New Printer dialog box.

Figure 11 New Printer

2. Select the printer option you want from the Devices list and click Forward.

3. Select the Network Printer option.


4. On the Network Printer menu, select a type of connection. For example: · CUPS Printer (IPP) - A printer attached to a different Linux system on the same

network running CUPS or a printer configured on another operating system to use IPP.

· Windows Printer (SMB) - A printer attached to a different system that is sharing a printer over an SMB network (for example, a printer attached to a Microsoft Windows machine).

· UNIX Printer (LPD) - A printer attached to a different UNIX system that can be accessed over a TCP/IP network (for example, a printer attached to another Linux system on your network).

· HP JetDirect - A printer connected directly to the network instead of to a computer.

5. Enter information for accessing the printer in the text boxes that appear.

6. Click the Forward button.

7. Select a printer driver and click Apply. You can install the printer from a disk or download it from the manufacturer.

8. In the Properties dialog box, select settings for the printer and click Close.

Installing a Local PrinterConnect the printer cable to your thin client and use the following guidelines:

1. Click the New icon in the Printers dialog box to open the Add a Printer - Printer Connection dialog box.

2. Select the Local Printer option. The thin client attempts to detect the printer you connected.

3. Select an option to identify your printer to the thin client:· Printer was detected - Click the Use a detected printer option and then select the

name of the printer in the printer list.· Printer was not detected - Click the Use another printer by specifying a port

option and then select a printer port.

4. Click Forward.

5. If necessary, select the Manufacturer and Model of your printer.

6. Select the printer driver for your printer (you can install the driver from a disk or download and install it from the manufacturer).

7. Specify the options you want for the printer.

8. Click Apply.

Managing Your PrintersUse the following guidelines to manage the printers available to you:• Selecting a Default printer - Select the printer you want to be the default and then

select Edit | Make Default.• Editing printer settings - Select a printer and then select Edit | Properties to open

and use the Properties dialog box.• Deleting a printer - Select the printer and click Delete.

28 Chapter 4

Configuring Display SettingsClicking the Screen Resolution icon in the Control Center opens the Display Settings dialog box. Use this dialog box to set the monitor display settings (Primary Display Output, Resolution, Refresh Rate, and Rotation). For most monitors, resolution is obtained automatically from the monitor. Note that screen rotation is not currently supported.

Figure 12 Display Settings

Setting the LanguageClicking the Language icon in the Control Center opens the Select a Language dialog box. Use this dialog box to select the language of the User Interface (UI) from the list of supported languages (select the language you want and click OK). Note that currently only English is supported.

NoteAdditional language packs can be downloaded as they become available from Wyse at: www.wyse.com/download.

http://www.wyse.com/serviceandsupport/support/downloads.asp


Changing PasswordsClicking the Change Password icon in the Control Center opens the Change Password dialog box. Use this dialog box to change the Admin password (for login) and root password.

Figure 13 Change Password

To change a password, select the check box you want (Change Password for ‘Admin’ or Change Password for ‘root’), enter a New Password for the option (and enter again in the Confirm Password box), and then click OK.

NoteLinux users who have a root password have high privileges. By default, the Allow ssh root login option is disabled for security purposes. You can enable ssh root login by selecting the Allow ssh root login check box.

30 Chapter 4

Configuring Device SettingsClicking the Device Settings icon in the Control Center opens the Device Settings dialog box. Use this dialog box to set the parameters of your device.

NoteThe Serial Ports Configuration tab will not appear for mobile thin clients.

Terminal NameUse the Terminal Name tab to obtain the device name:• Contact DHCP server - Obtains the name from the DHCP server.• DNS reverse lookup - Obtains the name from a DNS reverse lookup.• Derive from MAC address - Generates the name from the device MAC address.• Use the following name - Allows you to manually enter a name.

Figure 14 Device Settings - Terminal Name tab

HostsUse the Hosts tab to add mappings of IP addresses to hostnames that are not available through DNS (the names of mapped addresses appear on the Hosts tab): • Adding an IP address - Click Add to open the /etc hosts entry dialog box, enter an

IP Address, Hostname (and optionally, Aliases), and then click OK.• Editing a Host– Select a host from the list, click Edit, and configure the host.• Deleting a Host– Select a host from the list and click Delete.


Figure 15 Device Settings - Hosts tab

Ethernet Speed Use the Ethernet Speed tab to configure the Ethernet speed (select an option and click OK).

Serial Ports Configuration Use the Serial Ports Configuration tab (not available for mobile thin clients) to select:• Speed• Parity• Size• Flow control• Stop bits (the size of the stop bit with respect to the size of all the other signaling bits

in a character)

Figure 16 Device Settings - Serial Ports Configuration tab

32 Chapter 4

Configuring ICA Global SettingsClicking the ICA icon in the Control Center opens the ICA Global Settings dialog box. Use this dialog box to configure the common settings you want for all ICA connections. After configuring the settings you want, be sure click OK.

NetworkUse the Network tab to configure the servers and reconnection settings.

Figure 17 ICA Global Settings - Network tab

Use the following guidelines:• PN Agent Server - Enter the PN Agent Server you want to use (this can be a list of

servers with each server separated by a semi-colon).• Metaframe Server - Enter the Metaframe Server you want to use (this can be a list of

servers with each server separated by a semi-colon).• Browsing Protocol - Select the browsing protocol to use from the list.• PN Logon Domains - Enter the PN logon domains.• Seamless - Select to display the connection in a seamless window.• Program Neighborhood - Select to show the published applications in the Start menu

(available for use with published applications only).• Application Reconnection - Select the Automatic reconnection at logon check box

to enable reconnection, and then select the connect option you want.


Drive MappingUse the Drive Mapping tab to map drives on the server to devices on the thin client, and to view and manage (add, edit, and delete) the list of current drives (including drive information) mapped on the thin client.

Figure 18 ICA Global Settings - Drive Mapping tab

Adding DrivesUse the following guidelines:

1. Click Add to open the ICA Drive Map dialog box.

2. Select a drive letter (A to Z) from the Drive Letter list.

3. To enable or disable reading and writing for the drive, select or clear the Enable Read and Enable Write check boxes.

4. Select a drive type (USB Floppy, USB CDROM, USB Disk or Memory Stick, or Local or Mounted Disk) from the Drive Type list.

5. (Optional) Enter the directory on the USB device to access in the Base Directory text box.

6. Click OK to add the drive to the list of available drives.

Editing and Deleting DrivesTo edit or delete a drive, select a drive from the list of available drives and do one of the following:• Edit - Click Edit and configure the drive as described in "Adding Drives."• Delete - Click Delete to remove the drive.

34 Chapter 4

Hotkeys Use the Hotkeys tab to map hotkeys on the thin client, and to view and manage (add, edit, and delete) the list of current hotkeys mapped on the thin client. To set the hotkeys, select a Hotkey option using the Hotkey lists for each function you want.

Figure 19 ICA Global Settings - Hotkeys tab

COM Ports Use the COM Ports tab to map COM ports on the server to devices on the thin client, and to view and manage (add and delete) the list of current COM ports (including device information) mapped on the thin client.

Figure 20 ICA Global Settings - COM Ports tab


Adding COM PortsUse the following guidelines:

1. Click Add to open the Add COM Port Mapping dialog box.

2. Select a COM Port (1 to 4) from the COM Port list.

3. Select a device from the Device list.

4. Click OK to add the COM port and device to the list of available COM Ports.

Deleting COM PortsTo delete a COM Port, select a COM Port from the list of available COM Ports and click Delete.

Display Use the Display tab to set the Scroll Adjustment (select an adjustment option) and PrintScreen (select or clear the check box) on the thin client.

Figure 21 ICA Global Settings - Display tab

Use the following guidelines:• Scroll Adjustment - If you encounter over-scrolling when using certain published

applications, increase the adjustment by 100 until the display improves (maximum scroll adjustment is 1000).

• PrintScreen - Select to use the Print Screen key to capture an image of the desktop to the Clipboard (used for ICA XCapture support). If the check box is selected, a message appears warning about the influence of this setting on other applications).

36 Chapter 4

Firewall Use the Firewall tab to set the firewall configurations on the thin client.

Use the following guidelines:• Automatically detect proxy - Detects proxy servers automatically.• Use Alternate Address for Firewalls - Enables connections behind a firewall • Proxy Type - Select a Proxy Type from the list and if necessary (Secure (HTTPS) or

SOCKS, enter the Proxy Address and Port).

Figure 22 ICA Global Settings - Firewall tab

Trusted Server Configuration Use the Trusted Server Configuration tab to set and enforce the trusted server configurations. To enforce a trusted server configuration, select the Enabled option, select the Enforce trusted server configuration dialog box, enter the Address of the trusted server, and then click OK (you can also use the Enabled or Disabled options to quickly enable or disable the enforcement configuration).

Figure 23 ICA Global Settings - Trusted Server Configuration tab


Importing CertificatesClicking the Import Certificates icon in the Control Center opens the Import Certificates dialog box. Use this dialog box to import and manage (add and delete) ICA Digital Certificates as described in "Adding Certificates from a Remote Server" and "Adding Certificates from a Local Device."

Figure 24 Import Certificates

Adding Certificates from a Remote ServerUse the following guidelines (certificate files you add from a remote server must end with the extension .crt, and be DER-encoded or Base64-encoded):

1. In the Import Certificates dialog box, click Add to open the Add Certificate dialog box.

2. Select the Remote Server option, and then click Next to open the Certificate Import Server Settings dialog box.

Figure 25 Certificate Import Server Settings

3. Select the Remote Certificate Source server option that contains the certificate you want. If you select the Use the following Server option, enter the Import Server URL (supported protocols are ftp, http, and https) and the User name, and Password required for that server.

4. Select the certificate file from the Certificate file list (if the Import Server URL, User name, and Password are entered correctly, this list automatically displays the names of available certificates on the server).

5. After the configuring the Remote Certificate Source server option you selected, click Add.

38 Chapter 4

Adding Certificates from a Local DeviceUse the following guidelines:

1. In the Import Certificates dialog box, click Add to open the Add Certificate dialog box.

2. Select the Local Server option, and then click Next to open the Open File dialog box.

Figure 26 Open File

3. Use the folders and command buttons to find and select the certificate you want to use.

Configuring INI and Upgrade SettingsClicking the INI and Upgrade Settings icon in the Control Center opens the INI and Upgrade Network Settings dialog box. Use this dialog box to configure INI file downloads and image upgrades from the server. You can configure the downloads by using DHCP options or by manually entering the server address.

CautionWyse recommends obtaining INI files from DHCP options rather than from a static IP address. For information about how INI files and images are downloaded from the server, see "How to Set Up Automatic Upgrades and Configurations."

Figure 27 INI and Upgrade Network Settings dialog box


Obtaining INI and Upgrade Server Details from DHCPTo obtain INI file downloads and image upgrades from the DHCP server, select either the Use INI files from server only or If available, use INI files from server only; otherwise use local INI files option, select the Get INI and Upgrade server details via DHCP check box, and then click OK.

Manually Configuring the INI Server URLIf you want your thin client to obtain INI file information from a static address rather than a DHCP server, use the following guidelines:

1. Select either the Use INI files from server only or If available, use INI files from server only; otherwise use local INI files option.

2. Clear the GET INI and Upgrade server details via DHCP check box.

3. Manually enter a server address in the INI server URL text box.

4. If the server requires authentication, click the Server requires authentication check box, and then enter a username and password.

5. Click OK.

You can click Image Upgrade Settings to configure INI and upgrade network settings as described in "Configuring the Image Upgrade Options."

Configuring the Image Upgrade OptionsUsing the INI and Upgrade Network Settings dialog box, you can configure how the image on the thin client is upgraded if you manually configured the INI server URL as described in "Manually Configuring the INI Server URL."

In the INI and Upgrade Network Settings dialog box, click the Image Upgrade Settings to open the Thin Client Settings dialog box.

Figure 28 Thin Client Settings dialog box


1. From the Update Mode list, select an update mode:• No Update - Image updates are disabled.• Base System & Add-ons - The base image and add-ons are updated at each

reboot.• Base System Only - Only the base image is updated at each reboot.• Add-ons Only - Only add-ons are updated at each reboot.

40 Chapter 4

2. Enter the Update Server URL and if the server from which the thin client upgrades requires authentication, select the Server required authentication check box, and enter the Username and Password.

3. The Restore factory defaults when updating option removes all local-machine customizations when software is updated from the file server. This setting is enabled by default and is recommended. However, if you want to keep locally defined connections or custom changes to installed applications, you can disable this option.

NoteIn order to upgrade with the Restore factory defaults when updating option disabled, you must have a properly set up addons folder with a directory file that defines which software versions you want on the thin client. Moreover, it may take two full reboots to restore the latest software as well as your customizations.

4. If you want to install the image and add-ons available on the file server regardless of whether or not they are the same as the currently installed image and add-ons on the thin client, select the Force base system update option.

NoteThe Restore factory defaults when updating option and the Force base system update option are useful when you want to fully restore the unit to factory defaults. These options remove any customizations and install only the base image supplied by Wyse.

5. Click OK to return to the INI and Upgrade Network Settings dialog box.

Configuring Network Connections Clicking the Network Connections icon in the Control Center opens the Network Connections dialog box. Use this dialog box to configure the settings you want for supported network connections. Use the Wired, Wireless, Mobile Broadband, VPN, and DSL tabs to view and manage (add, edit, and delete) the list of network connections configured on the thin client. By default, your thin client obtains information from the DHCP server about network connections (highly recommended), but you can manually enter connection information to connect to other networks (experienced users only).

Figure 29 Network Connections dialog box


Using Novell Add-on ManagerClicking the Novell Add-on Manager icon in the Control Center opens the Novell Add-on Manager dialog box. Use this dialog box to view and manage (add and remove) the list of add-on packages available. Add-ons that are selected in the list have been installed on your thin client.

Figure 30 Novell Add-on Manager dialog box

To install add-ons, your thin client must be connected to the correct update server and folder on that server. If you receive a Failed to download available add-on list error message, click Server Settings in the Novell Add-on Manager dialog box to open and use the Thin Client Settings dialog box as described in "Configuring the Image Upgrade Options" (IMPORTANT: In the Update Server URL text box, be sure to enter the root path on the server followed by the path to the Addons folder).

NoteThe Novell Add-On Manager populates the list with add-ons listed in the directory plain text file located in the addons folder. For more information, see "Step 1: Preparing the Root Directory and Folder Structure on the File Server."

Use the following guidelines to install and uninstall add-ons:• Installing add-ons - Select the check box of the add-on and click Execute.• Uninstalling add-ons - Clear the check box of the add-on and click Execute.

42 Chapter 4

Setting Remote Desktop PreferencesClicking the Remote Desktop icon in the Control Center opens the Remote Desktop Preferences dialog box. Use this dialog box to select general (sharing and security) and advanced (network, security, and notification) preferences.

Figure 31 Remote Desktop Preferences dialog box

Setting Screensaver PreferencesClicking the Screensaver icon in the Control Center opens the Screensaver Preferences dialog box. Use this dialog box to select screen saver theme settings and power management settings (click Power Management to open and use the Power Management Preferences dialog box).

NotePress the Power button to wake the computer from standby or sleep mode.

Figure 32 Screensaver Preferences dialog box


Viewing System InformationClicking the System Information icon in the Control Center opens the System Information dialog box. Use this dialog box to view Identity, Network, System Log, and Copyright information of the thin client:• Identity tab - Shows identity information.• Network tab - Shows you network information about the thin client.• System Log tab - Shows the System Log information, including various messages

generated during the operation of the thin client.• Copyright tab - Shows copyright information for the software.

TCX LicensingClicking the TCX Licensing icon in the Control Center opens the TCX Licensing dialog box. Use this dialog box to manage (add and delete) older versions of TCX License Keys and view the product copyright information. To add a License Key, click Add to open and use the Add License dialog box.

NoteYou will find your TCX License Key in the e-mail sent to you from Wyse after purchasing your software (this is the same key you used to register your software). Do not use the TCX Licensing dialog box to manage newer versions of TCX License Keys for Wyse TCX SuiteTM, as these newer license keys are managed on the server side only. For information on TCX Suite software, refer to "Wyse TCX Suite."

Figure 33 TCX Licensing

44 Chapter 4

Using TCX USB VirtualizerClicking the TCX USB Virtualizer icon in the Control Center opens the TCX USB Virtualizer Configuration Utility dialog box. Use this dialog box to view and manage (add, edit, and delete) the list of current device classes (including configuration information) and view the list USB devices enabled or denied for use on the thin client. You can deny a device class, but still permit a USB device in that class to be used, by adding it to the Devices list of the Configuration tab.

Figure 34 TCX USB Virtualizer dialog box

Use the following guidelines:• Enabling USB devices: Select the Enabled check box (default).• Adding or denying USB device classes - On the Configuration tab, select or clear a

device class check box to add or deny its use. For example, select Audio Devices to permit USB audio devices to be used.

• Adding or denying a USB device - After you add a USB device, its name appears on the Configuration tab. Select or clear a USB device check box to add or deny its use.

• Adding a USB device - On the Configuration tab, click Add to open the Add dialog box, enter a Device Name, select a class for the device from the Class list, enter the Sub Class, Protocol, Vendor ID, and Product ID, and then click Add. After you reboot your thin client, the name of the new device appears on the Configuration tab.

NoteYou can obtain a device Class, Sub Class, Protocol, Vendor ID, and Product ID information by plugging the device into the USB port of your thin client. The information appears in the USB Devices tab.

For information on the TCX USB Virtualizer component of TCX Suite software, refer to "Wyse TCX Suite."


Configuring the WDM AgentClicking the Wyse WDM icon in the Control Center opens the WDM Agent Configuration dialog box. Use this dialog box to configure the Wyse Device Manager server location.

NoteIt is recommended that after configuring, you reboot the thin client.

Figure 35 WDM Agent Configuration dialog box


1. Enter the WDM Server IP address.

2. Enter the Client to Sever Port (default, is 80).

3. Enter the Secure Port (HTTPS port default is 443).

4. Click OK.

46 Chapter 4


5 Using and Configuring Connections with the Connection ManagerThis chapter provides information and detailed instructions on using and configuring connections to access the enterprise server environment available to the thin client.

NoteConfigurations made in the Connection Manager only apply to the thin client you are using. If you want to configure more than one thin client at a time or configure thin clients remotely, Wyse recommends configuring thin client settings using INI files as described in "Automating Thin Client Configurations and Upgrades."

Clicking the Connection Manager icon in the Computer menu (see "Using the Computer Menu") or in the Application Browser (see "Accessing Applications with the Application Browser") opens the Connection Manager. You can use the Connection Manager to view, use, and configure connections on the thin client.

Figure 36 Connection Manager

Use the Connection Manager to:• Add connections (see "Adding Connections Overview")• Edit connections (select a connection, click Edit, and then follow the guidelines for

configuring the connection in "Adding Connections Overview")• Delete connections (select a connection and click Delete)• Connect to connections (select a connection and click Connect)• Access the Control Center (click Control Center)• Log off, shut down, suspend, or restart the thin client (click Logout)

NoteThe Connection Manager features a user can access depends on the privilege level (set by the administrator). For example, a low privilege level allows a user to view and use the connections available, but does not allow the user to configure and edit connections.

48 Chapter 5

Adding Connections OverviewUse the following guidelines:

1. In the Connection Manager, click Add to open the Add Connection dialog box.

Figure 37 Add Connection dialog box

2. Select the type of connection you want from the list and click Next.

3. Configure the connection using the appropriate procedures from the following list:• "Adding Mozilla Firefox Browser Connections"• "Adding ICA Connections"• "Adding RDP Connections"• "Adding SSH Connections"• "Adding VMware View Client Connections"• "Adding VNC Viewer Connections"• "Adding XDMCP Connections"

Using and Configuring Connections with the Connection Manager 49

Adding Mozilla Firefox Browser ConnectionsUse the following guidelines:


2. Select Browser from the list and click Next to open the Mozilla Firefox Browser Configuration dialog box.

Figure 38 Mozilla Firefox Browser Configuration dialog box

3. Use this dialog box to configure the settings you want.

NoteAfter configuring the settings you want, click OK. The connection appears in the Connection Manager and is ready to use.

Network Use the Network tab to configure the description and URL (optional if you want the browser to open to a particular Web page each time you connect). If you want the browser to launch automatically after system startup, select the Auto Connect check box.

Window Use the Window tab to configure how the browser window is displayed. If you want the browser to appear without any menus or toolbars, select Kiosk Mode. Select the Window Size you want from the list.

Auto Reconnect Use the Auto Reconnect tab to enable automatic reconnect after a disconnection (select the Enable Auto Reconnect check box, and then select the amount of time to delay the reconnection attempt after a disconnection occurs).

50 Chapter 5

Adding ICA Connections

NoteWhen using multiple ICA connections, you can use the ICA Connection Center to manage the open ICA connections. For more information on using multiple ICA connections, refer to the Wyse Knowledge Base on the Wyse Web site.



2. Select ICA from the list and click Next to open the Citrix ICA Client Settings dialog box.

Figure 39 Citrix ICA Client Settings dialog box



Network Use the Network tab to configure the network settings:• Server or Published Application - Select an option for making the connection.• Description - Enter a description for the connection.• Network Protocol - Select a network protocol.• Browser Server - Enter the Browser Server name (this can be a list of server names

with each name separated by a semi-colon).

NoteYou do not need to enter a browser server name if you do not want to connect to either a published application or a server by name. Generating an ICA connection to a server using a server name in the Server text box for the connection does not require a Browser Server address, as long as the DNS information is properly entered.


• Server or Application Name - Select a server from the Server list or a published application from the Application Name list. If needed, click Refresh to refresh the list of servers or published applications.

NoteYou can enter the IP address of the target server as long as there is no need to resolve a name.

ConnectionUse the Connection tab to configure the connection settings:• Enable compression - Enables compression.• Low bandwidth - Enables low-bandwidth optimization.• Enable sound - Enables sound.• Ping before connect - Pings the connection to see if it is reachable before the

connection is attempted.• Enable Middle Button Paste - Enables middle button paste for the mouse.• Encryption - Select an encryption type (default is Basic).

Window Use the Window tab to select the Window Colors and the Window Size you want from the lists.

Application Use the Application tab to enter the command line and Working Directory of the application (if you selected the Published Application option on the Network tab):• Command Line - Enter the command line for the program on the server.• Working Directory - Enter the working directory for the program.

Login Use the Login tab to configure credentials used to automatically log in to the server:• User Name - Enter a user name for the connection.• Password - Enter the password.• Domain - Enter the domain name.• Serial Number - Enter the serial number for Metaframe environments that require the

thin client license serial number.• Connect automatically after login - Enables an automatic connection after

successful login to the thin client.

NoteThe User Name, Password, Domain, and Serial Number fields are optional. If the User Name, Password, and Domain fields are blank, interactive login is required (users must enter the information at login time).

52 Chapter 5


Firewall Use the Firewall tab to configure an alternate address for firewalls:• Automatically detect proxy - Select to automatically detect the proxy type.• Use Alternate Address for Firewalls - Select Yes to use an alternate address for

firewalls.• Proxy Type - Select a proxy type.• Proxy Address and Port - If you select Secure (HTTPS) or SOCKS as the Proxy

Type, you must enter the Proxy Address and Port.

NotePublished applications do not support Firewall functions.


Adding RDP ConnectionsUse the following guidelines:


2. Select RDP from the list and click Next to open the Remote Desktop (RDP) Configuration dialog box.

Figure 40 Remote Desktop (RDP) Configuration dialog box



Network Use the Network tab to configure the network settings:• Description - Enter a description for the connection.• Server - Enter a server name or IP address.• Ping Before Connect - Pings the connection to see if it is reachable before the

connection is attempted.• Notify When Disconnected - Notifies you when the connection is broken.

Connection Use the Connection tab to configure the connection settings:• NT4 compatible - Enables RDP protocol version 4.• Low bandwidth - Enables low-bandwidth optimization.• Sound - Select audio source for the connection (Local or Remote).• Encryption Level - Select an encryption level (Normal or None).

NoteFor servers with data encryption settings, you must select Normal for the encryption level.

54 Chapter 5

Experience Use the Connection tab to configure the experience settings for a user desktop:• Menu and window animation - Enables menu and window animation.• Show contents of window while dragging - Shows the window content when the

user drags the window on screen.• Desktop Background - Displays the desktop background.• Speed Level - Select a speed level to describe the network connection.

NoteConsider your network restrictions when you select options on the Experience tab. For example, be sure to configure the settings appropriately for your bandwidth level and so on.


Application Use the Application tab to enter the command line and Working Directory of the application that will run at the beginning of a session:• Command Line - Enter the command line for the program on the server.• Working Directory - Enter the working directory for the program.

Login Use the Login tab to configure credentials used to automatically log in to the connection:• User Name - Enter a user name for the connection.• Password - Enter the password.• Domain - Enter the domain name.• Use smart card - Enables the use of a smart card when connecting.• Connect automatically after login - Enables an automatic connection after


NoteThe Username, Password, and Domain fields are optional. If you leave any of these fields blank, interactive login is required (users must enter the information at login time).



Drive Mapping Use the Drive Mapping tab to map share names on the server to USB mass storage devices attached to the thin client, and to view and manage (add, edit, and delete) the list of current server share names (including drive information) mapped on the thin client.

Figure 41 Remote Desktop (RDP) Configuration - Drive Mapping tab

Adding DrivesUse the following guidelines:

1. Click Add to open the RDP Drive Map dialog box.

Figure 42 RDP Drive Map dialog box

2. Select a drive letter (A to Z) from the Drive Letter list.

3. Select a drive type (USB Floppy, USB CDROM, USB Disk or Memory Stick, or Local or Mounted Disk) from the Drive Type list.

4. (Optional) Enter the directory on the USB device to access in the Base Directory text box.

5. Click OK to add the drive to the list of available drives.

Editing and Deleting DrivesTo edit or delete a drive, select a drive from the list of available drives and do one of the following:• Edit - Click Edit and configure the drive as described in "Adding Drives."• Delete - Click Delete to remove the drive.

56 Chapter 5

Device Mapping Use the Drive Mapping tab to map devices to ports on the thin client, and to view and manage (add and delete) the list of current devices (including device information) mapped on the thin client.

Figure 43 RDP Connection - Device Mapping tab

Adding DevicesUse the following guidelines:

1. Click Add to open the Add Port Mapping dialog box.

2. Select a port from the Port list.

3. Select the directory of the device to access from the Device list.

4. Click OK to add the device to the list of available devices.

Deleting DevicesTo delete a device, select a device from the list of available devices and click Delete.


Adding SSH ConnectionsUse the following guidelines:


2. Select SSH from the list and click Next to open the SSH Configuration dialog box.

Figure 44 SSH Configuration dialog box



Network Use the Network tab to configure the network settings:• Description - Enter a description for the connection.• Host - Enter a host name or IP address.• Remote Username - Enter a username.• Remote Command - Enter the command to execute on the server.

Connection Use the Connection tab to configure the connection settings:• Auto Connect - Starts the connection automatically after system startup.• Ping Before Connect - Pings the connection to see if it is reachable before the

connection is attempted.• Auto Reconnect - Reconnects automatically after a disconnection occurs.• Delay before retrying - Select the amount of time to delay the reconnection attempt

after a disconnection occurs.

58 Chapter 5

Adding VMware View Client ConnectionsUse the following guidelines:


2. Select VMware_ViewClient from the list and click Next to open the VMware View Client Settings dialog box.

Figure 45 VMware View Client Settings dialog box


NoteAfter configuring the settings you want, click OK. The connection appears in the Connection Manager and is ready to use. No special client-side configuration is needed to enable PCOIP connections. This is configured on the View broker, and once a user logs in from the client and obtains a list of desktops, they will be presented with an option to choose PCOIP or RDP (based on server settings).

Network Use the Network tab to configure the network settings:• Description - Enter a description for the connection.• Host - Enter a host name or IP address.• Port - Enter the port of the host.• Use Secure Connection (SSL) - Select to use an SSL connection.• Ping Before Connect - Pings the connection to see if it is reachable before the

connection is attempted.• Enable interactive mode - Enables interactive mode.

Window Use the Window tab to select a Display size and whether to use full screen on all monitors.


Login Use the Login tab to configure credentials used to automatically log in to the connection:• User Name - Enter a user name for the connection.• Password - Enter the password.• Domain Name - Enter the domain name.• Desktop - Enter the desktop name.• Connect automatically after login - Enables an automatic connection after


Adding VNC Viewer ConnectionsUse the following guidelines:


2. Select VNC_Viewer from the list and click Next to open the VNC Viewer Settings dialog box.

Figure 46 VNC Viewer Settings dialog box



Network Use the Network tab to configure the network settings:• Description - Enter a description for the connection.• Host - Enter a host name or IP address.• Connect to - Select a connection type:

· Display number - Enter the display to connect to on the server.· Port number - Enter the port to connect to on the server.

• Ping Before Connect - Pings the connection to see if it is reachable before the connection is attempted.

60 Chapter 5

Connection Use the Connection tab to configure the connection settings:• Compression Level - Select a compression level for encoding.• Shared - Enables or disables a shared connection.• View Only - Blocks mouse and keyboard events for a view-only connection.

Window Use the Window tab to configure window settings:• JPEG Quality - Specifies the image quality for encoding.• Full Screen - Opens the connection in a full-screen window.• Color Depth - Controls how many colors to display with each on-screen pixel.

Login Use the Login tab to configure credentials used to automatically log in to the VNC server:• Password - Enter the password to connect to the VNC server.• Connect automatically after login - Enables an automatic connection after


Adding XDMCP ConnectionsUse the following guidelines:


2. Select XDMCP from the list and click Next to open the XDMCP Client Settings dialog box.

Figure 47 XDMCP Client Settings dialog box




Network Use the Network tab to configure the network settings:• Description - Enter a description for the connection.• Host - Enter a host name or IP address of an XDMCP server.• Connect Style - Select a connection mode: Query, Chooser, or Broadcast.• Connect Program - Select the program through which the connection is made: Xnest

or Xserver.


Connection Use the Connection tab to configure the connection settings:• Auto Connect - Starts the connection automatically after system startup.• Ping Before Connect - Pings the connection to see if it is reachable before the

connection is attempted.• Auto Reconnect - Reconnects automatically after a disconnection occurs.• Delay before retrying - Select the amount of time to delay the reconnection attempt

after a disconnection occurs.

62 Chapter 5


6 Accessing Applications with the Application BrowserThis chapter provides detailed information about using the Application Browser to access the applications, audio and video, and system features installed on the thin client.

NoteFor a list of supported addons you can install, contact Wyse. For information on adding and managing addons, refer to "Automating Thin Client Configurations and Upgrades" and "Using Novell Add-on Manager."

Clicking More Applications in the Computer menu (see "Using the Computer Menu") opens the Application Browser. You can use the Application Browser to access the applications, audio and video, and system features installed on the thin client.

Figure 48 Application Browser

This chapter includes information on:• "Performing Diagnostics"• "Configuring Power Management Settings"• "Configuring PulseAudio Volume Control Settings"• "Adjusting Volume Control Settings"• "Taking Screenshots"

NoteClicking the Connection Manager icon in the Application Browser opens the Connection Manager. You can use the Connection Manager to view, use, and configure connections on the thin client as described in "Using and Configuring Connections with the Connection Manager."

64 Chapter 6

Performing DiagnosticsClicking the Diagnostics icon in the Application Browser opens the Diagnostics dialog box. Use this dialog box to select and use a diagnostic tool:• Ping - Enter or select a destination from the Destination list and click Ping.• Trace Route - Enter or select a destination from the Destination list and click Trace

Route (diagnostic information appears on the Trace Route tab).• Temporary Settings - View the temporary settings of the thin client.• Permanent Settings - View the permanent settings of the thin client.• wlx.ini/wnos.ini - View the wlx.ini or wnos.ini file as copied to the thin client.• user.ini - View the user.ini file as copied to the thin client.

Configuring Power Management SettingsClicking the Power Management icon in the Application Browser opens the Power Management Preferences dialog box. Use this dialog box to select On AC Power (actions and display), On Battery Power (actions and display), General (actions, notifications, and extras), and Scheduling (automatic wake-up) power preferences.

NotePress the Power button to wake the computer from standby or sleep mode.

Configuring PulseAudio Volume Control SettingsClicking the PulseAudio Volume Control icon in the Application Browser opens the Volume Control dialog box. Use this dialog box to select Playback (system sounds), Recording (application recording sounds), Output Devices (left and right sounds), and Input Devices (left and right sounds) volume preferences.

Figure 49 PulseAudio Volume Control dialog box

You can use the Show list on each tab to select which items you want shown.

Accessing Applications with the Application Browser 65

Adjusting Volume Control SettingsClicking the Volume Control icon in the Application Browser opens the Volume Control dialog box. Use this dialog box to select volume levels for various devices.

Figure 50 Volume Control dialog box

You can click Preferences to open the Volume Control Preferences dialog box and select more tracks to be shown the Volume Control dialog box.

NoteFor these settings to take effect, sound must be supported and enabled on the server used for ICA connections, RDP connections, or MPlayer. Sound requires significant bandwidth that may not be available on some WAN and dial-up connections.

Taking ScreenshotsClicking the Take Screenshot icon in the Application Browser opens the Take Screenshot dialog box. Use this dialog box to select screenshot preferences and effects (for example, entire desktop with pointer or current window with a border). After setting your preferences, click Take Screenshot to take the screenshot and open the Save Screenshot dialog box allowing you to name and save the file.

Figure 51 Take Screenshot dialog box

66 Chapter 6


Figures1 Wyse PC Extender InstallShield Wizard 52 Desktop 73 Computer menu 94 Remove confirmation message 125 File server folder structure 186 INI and Upgrade Network Settings dialog box 197 Control Center 238 Keyboard Preferences 259 Mouse Preferences 2510 Printers 2611 New Printer 2612 Display Settings 2813 Change Password 2914 Device Settings - Terminal Name tab 3015 Device Settings - Hosts tab 3116 Device Settings - Serial Ports Configuration tab 3117 ICA Global Settings - Network tab 3218 ICA Global Settings - Drive Mapping tab 3319 ICA Global Settings - Hotkeys tab 3420 ICA Global Settings - COM Ports tab 3421 ICA Global Settings - Display tab 3522 ICA Global Settings - Firewall tab 3623 ICA Global Settings - Trusted Server Configuration tab 3624 Import Certificates 3725 Certificate Import Server Settings 3726 Open File 3827 INI and Upgrade Network Settings dialog box 3828 Thin Client Settings dialog box 3929 Network Connections dialog box 4030 Novell Add-on Manager dialog box 4131 Remote Desktop Preferences dialog box 4232 Screensaver Preferences dialog box 4233 TCX Licensing 4334 TCX USB Virtualizer dialog box 4435 WDM Agent Configuration dialog box 4536 Connection Manager 4737 Add Connection dialog box 4838 Mozilla Firefox Browser Configuration dialog box 4939 Citrix ICA Client Settings dialog box 5040 Remote Desktop (RDP) Configuration dialog box 5341 Remote Desktop (RDP) Configuration - Drive Mapping tab 5542 RDP Drive Map dialog box 5543 RDP Connection - Device Mapping tab 5644 SSH Configuration dialog box 5745 VMware View Client Settings dialog box 5846 VNC Viewer Settings dialog box 5947 XDMCP Client Settings dialog box 6048 Application Browser 6349 PulseAudio Volume Control dialog box 6450 Volume Control dialog box 6551 Take Screenshot dialog box 65

Tables1 Window-related Shortcut Keys 82 DHCP Option Tags 20

Administrators Guide Wyse® PC ExtenderTM Issue: 042210

Written and published by: Wyse Technology Inc., April 2010

Created using FrameMaker® and Acrobat®

Pc Extender Docs

Documents

Transcript of Pc Extender Docs