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
agreement. By copying, using, or installing the software or the product, you agree to be bound by those terms.
Trademarks
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.
Patents
This product and/or associated software are protected by copyright, international treaties, and various patents,
including the following U.S. patents: 6,836,885 and 5,918,039.
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
as of the purchase date is the controlling licensing
.
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
FCC Statement
This equipment has been tested and found to comply with the limits for either Class A or Class B digital devices,
pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful
interference in a residential installation. This equipment generates, uses, and can radiate radio frequency energy
and, if not installed and used in accordance with the instructions, may cause harmful interference to radio
communications. However, there is no guarantee that interference will not occur in a particular installation. If this
equipment does cause harmful interference to radio or television reception, which can be determined by turning
the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following
measures:
•Reorient or relocate the receiving antenna.
•Increase the separation between the equipment and the receiver.
•Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
•Consult the dealer or an experienced radio/TV technician for help.
Shielded interconnect cables and shielded AC power cable must be employed with this equipment to insure
compliance with the pertinent RF emission limits governing this device. Changes or modifications not expressly
approved by the system’s manufacturer could void the user’s authority to operate the equipment.
Caution
Modifications made to the product, unless expressly approved by Wyse Technology, could void
the user’s authority to operate the equipment.
. In all other countries, contact your sales representative.
Page 3
Regulatory Compliance for Thin Clients
Basic EMC and Safety Requirements
Wyse thin clients are compliant with the regulatory requirements in the regions listed below.
U.S.A. - FCC Part 15 (class B), cUL 60950
Canada - IC ICES-003, CAN/CSA-C22 No. 60950
Europe - EN 55022 (class B), EN 55024
Canadian DOC Notices
Class A - This digital apparatus does not exceed the Class A limits for radio noise emissions from digital apparatus
set out in the Radio Interference Regulations of the Canadian Department of Communications.
Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites applicables aux
appareils numériques de la classe A prescrites dans le Réglement sur le brouillage radioélectrique édicté par le
Ministère des Communications du Canada.
Class B - This digital apparatus does not exceed the Class B limits for radio noise emissions from digital apparatus
set out in the Radio Interference Regulations of the Canadian Department of Communications.
Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites applicables aux
appareils numériques de la classe B prescrites dans le Réglement sur le brouillage radioélectrique édicté par le
Ministère des Communications du Canada.
Device Power Supply
Use only the external power supply that comes with your thin client. For power and voltage ratings, see the serial
number label or regulatory label on your device. For power adapter replacement, contact your Wyse Service
Representative. For proper replacement compare the labels on both mobile thin client and power adapter to
ensure that their voltages match.
Warning
Use of any other power adapter may damage your mobile thin client or the power adapter. The
damage caused by an improper power adapter is not covered by warranty.
Battery Information
Models Cx0, Rx0L, and VX0 contain an internal button cell battery replaceable by Wyse or one of our Authorized
Service Centers. For service, visit http://www.wyse.com/serviceandsupport/service/service.asp
.
Warning
There is a risk of explosion if the battery is replaced by an incorrect type. Always dispose of used
batteries according to the instructions accompanying the battery.
Perchlorate Materials - Special Handling May Be Required under California Code of Regulations,
title 22. (Only required within the U.S.A.)
Page 4
This page intentionally blank.
Page 5
Content s
1Introduction 1
About this Guide 1
Finding the Information You Need in this Guide 1
Wyse Technical Support 1
Related Documentation and Services 1
Wyse Online Community 2
2Getting Started 3
Connecting to a Remote Server 3
Manual Connection Procedures 4
Using Your Desktop 5
Locking the Thin Client 6
Signing Off and Shutting Down 6
3Notable Wyse ThinOS Features 9
Login Dialog Box Features 9
Accessing System Information 10
Manually Configuring Global Connection Settings 10
Additional Wyse Zero Desktop Features 12
Wyse Zero Interactive Desktop Guidelines 12
Wyse Zero Toolbar 13
List of Connections 14
Additional Classic Desktop Features 15
Classic Interactive Desktop Guidelines 15
Shortcut Menu 16
Desktop Menu 16
Connect Manager 17
4Configuring Connectivity Options 19
Network Setup 20
Remote Connections 25
Central Configuration 27
Advanced Details on Configuring ICA and RDP Connections 28
Configuring ICA Connections 28
Configuring RDP Connections 32
5Configuring Local Settings Options 35
System Preferences 36
Display 38
Peripherals 40
Printers 43
Configuring LPD Services 46
Setting Up Windows NT4 Servers 46
Setting Up Windows 2003/2008 Servers 47
Page 6
viContents
6Performing Diagnostics 49
System Tools 50
Network Tools 50
Using Ping 50
Using Trace Route 51
ACentral Configuration: Automating Updates and Configurations 53
Understanding How to Configure Your Network Services 53
DHCP and FTP Servers Available 54
FTP Server Available (DHCP Server Unavailable) 55
DHCP and Virtual Desktop Servers Available 56
Virtual Desktop Server Available (DHCP Server Unavailable) 57
FTP and Virtual Desktop Servers Unavailable (Stand-alone User or PNAgent/
Configuring for Transport Layer Security (TLS) Connections Ove r a LAN 68
Configuring Session Services 70
About Wyse TCX Software 71
About Wyse Virtual Desktop Accelerator Software 71
Configuring ICA Session Services 72
Configuring RDP Session Services 73
PNAgent/PNLite Installation Guidelines 72
BRemote System Administration 75
Using Wyse Device Manager Software For Remote Administration 75
Updating Software 75
Managing Icons and Logos 77
Understanding and Using System Lockdown Operations 77
Configuring Virtual Access Suite Support 78
Installing the VAS Hotfix 78
Enabling HTTP and HTTPS Support on the Connection Brokers (VAS Support) 79
Installing Connection Broker Web Server Certificates (VAS Support) 79
Configuring the Connection Broker HTTP and HTTPS Ports (VAS Support) 79
Configuring {username}.ini Files and RDP Connection Parameters (VAS
Support) 79
Updating the Wyse ThinOS Firmware (VAS Support) 80
CLocal System Administration 81
Resetting to Factory Defaults Using G-Key Reset 81
Resetting to Factory Defaults Using Shutdown Reset 81
Resetting Display Settings Using V-Key Reset 82
Accessing Thin Client BIOS Settings 82
Enabling a Disabled Network Setup Dialog Box 82
Configuring ThinPrint 83
Tables 85
Page 7
1Introduction
Wyse® thin clients running Wyse ThinOS™ are highly optimized thin clients that provide
ultra-fast access to applications, files, and network resources available on machines
hosted by Citrix, Microsoft, VMware, or other leading infrastructures. Wyse Th in OS us es
the new Wyse Zero engine to provide a secure, near-zero management core that requires
no local antivirus software or firewall to protect against viruses or malware.
Session and networks services available on enterprise networks may be accessed on
enterprise networks, a direct intranet connection, or from a remote location using a secu re
gateway from Citrix or VMware.
About this Guide
This guide is intended for administrators of Wyse thin clients running Wyse ThinOS. It
provides information and detailed system configurations to help you design and manage a
Wyse ThinOS environment.
Finding the Information You Need in this Guide
You can use either the Search window or Find toolbar to locate a word, serie s of words, o r
partial word in an active PDF document. For detailed information on using these features,
refer to the Help in your PDF reader.
Wyse Technical Support
To 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
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 Documentation and Services
Wyse thin client features can be found in the Fact Sheet for your specific thin client model.
Fact Sheets are available on the Wyse Web site. Go to http://www.wyse.com/products
click the Wyse Thin Clients link, click the link for your thin client, and then click the Fact
Sheet link.
Sample User INI files are intended for administrators of Wyse thin clients running Wyse
ThinOS. These files are available from the Wyse Web site (go to
http://www.wyse.com/manuals
then click the sample ini link to open and use the file download dialo g bo x to save the
compressed file to a folder you want). These sample files are annotated to allow you to
(on the
.
,
, search for sample.ini, click the reference guide link, and
Page 8
2Chapter 1
use them as a “starter set” (that you can modify for your users needs) to quickly get your
file server up and running. For information on using the sample files, refer to the
clients running Wyse ThinOS. It provides the detailed information you need to help you
understand and use the Wyse ThinOS INI files. It contains information on the different
Wyse ThinOS 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
ThinOS INI files. In addition, this guide also includes an appendix that contains all of the
supported connect options you can use for ICA and RDP connections. It is available at:
http://www.wyse.com/manuals
Getting Started Guide: Wyse ThinOS
system. It provides a setup and configuration overview of the entire Wyse ThinOS system
to help you get your Wyse ThinOS environment up and running quickly and easily. It is
available at: http://www.wyse.com/manuals
Wyse Thin Computing Software is available on the Wyse Web site at:
INI Files is intended for administrators of Wyse thin
.
TM
is intended for administrato rs of the Wyse ThinOS
.
.
TM
has been discontinued and incorporated into this
Wyse Online Community
Wyse maintains an online community where users of our products can see k and exchange
information on user forums. Visit the Wyse Online Community forums at:
http://community.wyse.com/forum
.
Page 9
2Getting St arted
While it can be used in environments without central configuration for basic connectivity
needs, Wyse ThinOS is designed to be centrally managed and configured using INI files.
In general, it is recommended that you use central configuration to enable you to
automatically push updates and any desired default configuration to all thin clients in your
Wyse ThinOS environment.
This chapter includes:
•"Connecting to a Remote Server"
•"Using Your Desktop"
•"Locking the Thin Client"
•"Signing Off and Shutting Down"
Connecting to a Remote Server
Central Configuration - If you are set up for automatic detection (using INI files - see
Reference Guide: Wyse ThinOS
connect to the configured remote services during the boot-up process. Simply press the
power button to turn on your thin client to see the Login dialog box. Enter your User name, Password, and Domain, and then click Login. After authentication is successful,
your available connections are presented for use. Although the thin client will default to the
Classic Desktop for INI backward compatibility, you can configure the thin client to display
the Wyse Zero Desktop by using the SysMode=VDI parameter in the INI files or by
selecting the desktop option in a dialog box (see "Using Your Desktop").
Manual Connection - If you are not yet set up for central configuration, you will see the
Wyse Zero Toolbar, where you can configure the initial server connection you want using
the Remote Connections dialog box before you can log in. See "Manual Connection
Procedures."
TM
INI Files), your thin client will automatically detect and
You only need to complete this manual configuration once (or after reboot to factory
defaults). After the thin client “knows” the location of your server, it automatically connects
to the server for login when you start the thin client in the future. After you confirm your
environment is ready for deployment, you can create INI files for central configuration.
Page 10
4Chapter 2
Manual Connection Procedures
1. Click the System Settings icon on the Wyse Zero
Toolbar to open the System Settings menu, and then
click Remote Connections to open the Remote
Connections dialog box.
2. Use the Broker Setup tab of the Remote Connections
dialog box to configure one of the following connections:
•ICA or RDP connection (select None, select ICA or
RDP, click Configure Connection, and then follow
the wizard).
•A specific broker server connection (select OtCitrix Xen, or VMware View, and then enter the IP
Address for the server in the Broker Server box).
Note: For more details, see "Remote Connections."
3. Click
OK, and then restart the thin client (click the
Shutdown icon on the Wyse Zero Toolbar to open and use the Shutdown dialog box to restart the thin client).
her,
(If Y
ou Configured an ICA or RDP Connection) After thin client restart, click the Home icon on the Wyse Zero
Toolbar to open the list of available connections, click the
ICA or RDP connection you created, and then log in.
ou Configured a Specific Broker Server Connection)
(If Y
After thin client restart, the Login dialog box appears for
your server.
Enter the User name, Password, and Domain and click
Login.
After authentication is successful, your Wyse Zero Toolbar is presented with your assigned connections
defined by the broker server.
Page 11
Getting Started5
Using Your Desktop
What you see after logging on to the server depends on the administrator configuration s.
Users with a Classic Desktop - will see the classic Wyse
ThinOS desktop with full taskbar, desktop, and Connect Manager familiar to Wyse ThinOS users. This option is
recommended for terminal server environments with
published applications and for backward compatibility with
Wyse ThinOS 6.x versions.
For more information on using the Classic Desktop, see
"Additional Classic Desktop Features."
Users with a Wyse Zero Desktop - will see the Wyse Zero
Desktop with the Wyse Zero Toolbar showing the assigned
list of connections from which to select. This option is
recommended for VDI and any full-screen only connections.
For more information on using the Wyse Zero Desktop, see
"Additional Wyse Zero Desktop Features."
In any desktop case, you can select the desktop option you want (Classic Desktop or
Wyse Zero Desktop) and create the connections you need using the Remote
Connections dialog box (see "Remote Connections").
To open the Remote Connections dialog box, do one of the following:
•Classic Desktop - Click User Name (User Name is the user who is logged-on and is
located at the bottom-left side of the taskbar), and then select System Setup > Remote Connections.
•Wyse Zero Desktop - Click the System Settings icon on the Wyse Zero Toolbar, and
then select Remote Connections.
Page 12
6Chapter 2
Locking the Thin Client
To help ensure that no one else can access your private information without permission,
Wyse ThinOS allows you to lock your thin client so that credentials are required to unlock
and use the thin client after you do one of the following:
•Unplug a signed-on smart card - If an administrator has set SCRemovalBehavior=1
for the Signing parameter in the INI files and you unplug the smart card that you used
to sign on to the thin client, then the thin client will lock. To unlock the think client for
use, you must use the same smart card and your correct PIN. Note that removing a
signed-on smart card can also cause the thin client to log-off, if an administrator has
set the INI files to do so (in this case you must sign-on as usual to use the thin client).
•Use LockTerminal from the Shortcut Menu and Shutdown dialog box - On the Classic Desktop, click on the desktop and select Lock Terminal, or use the Shutdown
dialog box (see
use the Shutdown dialog box (see "Signing Of f and Shutting Down"). To open the thin
client for use, you must use your correct password.
•Use the screen saver - If an administrator has set LockTerminal=2 for the
ScreenSaver parameter in the INI files and you use the screen saver, then the thin
client will lock. To open the thin client for use, you must use your correct password.
"Additional Classic Desktop Features"). On the Wyse Zero Desktop,
Signing Off and Shutting Down
Use the Shutdown dialog box (Classic Desktop - click Shutdown in the Connect
Manager or Desktop Menu; Wyse Zero Desktop - click the Shutdown icon on the Wyse
Zero Toolbar) to select the available option you want.
Tip
You can also configure automatic behavior after all desktop sessions are
closed by using the Remote Connections dialog box (see "Remote
Connections") or the AutoSignoff parameter in a wnos.ini file (see "Central
Configuration: Automating Updates and Configurations").
Page 13
Getting Started7
Use the following guidelines (depending on user privilege, some options may not be
available for use):
Table 1 Shutdown dialog box options
Option What It Does
Sign-off from accountAllows you to sign off from the current open account (the
Login dialog box appears and is ready for another user).
Lock TerminalLocks the thin client from use until you log in again.
Shutdown the systemTurns off the thin client.
Restart the systemLogs off the user account (the Login dialog box appears
after the thin client restarts).
Reset the system
setting to factory
default
Appears for high-privileged users/administrators only. This
option allows you to reset the thin client to factory defaults
(see "Resetting to Factory Defaults Using Shutdown
Reset").
Page 14
8Chapter 2
This page intentionally blank.
Page 15
3Not able Wy se ThinOS Features
This chapter includes:
•"Login Dialog Box Features"
•"Accessing System Information"
•"Manually Configuring Global Connection Settings"
•"Additional Wyse Zero Desktop Features"
•"Additional Classic Desktop Features"
Login Dialog Box Features
While the Login dialog box allows you to log in to the server, it also allows you to obtain
system information, configure thin client settings, and shut down the thin client.
Use the following guidelines
•Sys Info - Click the Sys Info button to open the System Information dialog box and
view the thin client system information such as System Version, IP Address,
information on devices connected to your thin client, event logs, and so on (see
"Accessing System Information").
•Admin Mode - Click the Admin Mode button to configure various settings locally on
the thin client (not broker desktop configurations). For example, you can choose to
manually configure the Citrix Xen Broker Server URL (or override the URL that is
centrally defined by file servers) by using the Remote Connections dialog box as
described in
Tip
By default there is no password needed for Admin Mode button use. You
can password protect the Admin Mode button (to require login credentials)
by using the AdminMode parameter in a wnos.ini file (see Reference Guide:
Wyse ThinOS
•Shutdown - Click the Shutdown button to open and use the Shutdown dialog box to
sign-off, shut down, restart, reset the system setting to factory default s, a nd so on (see
"Signing Off and Shutting Down").
"Remote Connections."
TM
INI Files).
Page 16
10Chapter 3
Accessing System Information
Use the System Information dialog box to view the following system information (Classic
Desktop - click System Information in the Desktop Menu; Wyse Zero Desktop -click the
System Information icon on the Wyse Zero Toolbar):
•General Tab - Displays general information such as System Version, Serial Number,
Boot From, Memory Size (Total and Free), Terminal Name, IP Address, Net Mask,
Gateway, and DHCP Lease.
•Devices Tab - Displays information about devices such as the CPU Speed, ROM Size,
Monitor, Parallel Ports, Ethernet Speed, Memory Speed, NAND Size, Resolution,
Serial Ports, and the thin client MAC Address.
•Copyright/Patents Tab - Displays the software copyright and patent notices.
•Event Log Tab - Displays the thin client start-up steps (normally beginning from
System Version to Checking Firmware) or error Messages that are helpful for
debugging problems.
•Status Tab - Displays status information about TCP performance-related parameters,
CPU Busy , System Up T ime , Wireless performance-related parameters, Fre e Memory,
and DHCP lease time remaining.
Manually Configuring Global Connection Settings
If you do not use INI files to provide central configuration (global connection settings) to
users, you can click Global Connection Settings (in the Connect Manager for the
Classic Desktop; in the List of Connections for the Wyse Zero Desktop) to open and use
the Global Connection Settings dialog box to configure settings that affect all of the
connections in your list of connections.
Tip
For information on configuring the thin client using INI files (recommended),
refer to Reference Guide: Wyse ThinOS
configuring the thin client locally using dialog boxes, refer to
Connectivity Options" and "Configuring Local Settings Options."
TM
INI Files. For information on
"Configuring
Page 17
Notable Wyse ThinOS Features11
Use the Session tab to select the check boxes you want for the options that are available
to all sessions (the Smart Cards check box specifies the default setting for connecting to a
smart card reader at startup).
Tip
ICA sessions always have automatic connection to attached smart card
readers.
When using the Disks check box for automatic connection to connected
USB sticks, use the following guidelines:
- Support is for VF AT File System only, be sure that the USB stick yo u use is
formatted to FAT16 or FAT32.
- More than one disk can be used at the same time, however, the maximum
number of USB sticks (including different subareas) is 12.
- It recommended that you use Windows XP, Windows Server 2003, or
Windows Server 2008 for the server.
- Be sure to save all data and sign off from the se ssion mapping the USB
stick before removing the USB stick.
Use the ICA tab to select the check boxes you want for the options that are available to all
ICA sessions. Note the following:
Map to - When a drive is entered, maps a disk under the drive.
Map all disks under (z:) - When selected, maps all disks under the Z drive.
Use the RDP tab to enable or disable Network Level Authentication (NLA). The NLA
authentication method verifies users before they ar e allowed to connect with a full Remo te
Desktop connection.
Page 18
12Chapter 3
Additional Wyse Zero Desktop Features
This section includes information on:
•"Wyse Zero Interactive Desktop Guidelines"
•"Wyse Zero Toolbar"
•"List of Connections"
Wyse Zero Interactive Desktop Guidelines
The Wyse Zero Desktop has a Wyse default background with the Wyse Zero Toolbar at
the left of the screen.
Use the following guidelines:
•If configured to display (by an administrator), the current date and time are shown on
the Wyse Zero Toolbar.
Tip
The thin client is capable of synchronizing its clock to time provided by a
Simple Network Time Protocol (SNTP) server.
•Press CTRL+ALT+UPARROW to display the Wyse Zero Toolbar.
•Press CTRL+AL T+DOWNARROW to open a selection box for toggling between the
desktop and currently-active connect i on s.
•Lock the thin client at any time by pressing CTRL+ALT+LEFTARROW or
CTRL+ALT+RIGHTARROW.
•Keyboard shortcuts are supporte d. Use the LEFT ALT+UDERLINED LETTER on the
keyboard for keyboard shortcuts (the RIGHT ALT+UDERLINED LETTER combination
is not currently supported).
•Use the Peripherals dialog box to switch the left and right buttons (see "Peripherals.").
•In addition to the standard two-button mouse, the thin client supports a Microsoft
Wheel Mouse (used for scrolling). Other similar types of a wheel mouse may or may
not work.
•Press PRINT SCREEN to capture a full desktop or ALT+PRINT SCREEN to capture
the active window.
•You can copy and paste between application sessions and between sessions and the
desktop, however, this function depends on session server configurations.
Page 19
Notable Wyse ThinOS Features13
Wyse Zero Toolbar
The Wyse Zero Toolbar usually appears at the left edge of the Wyse Zero Desktop.
However, dep ending on administrator configurations, the toolbar can be removed or
hidden (shown only when a user moves the mouse pointer over the left edge of the
desktop screen).
Table 2 Toolbar icons
Icon What It Does
HomeOpens the list of available connections (see "List of
System Information Displays thin client system information (see "Accessing
System Settings Opens the System Settings menu to configure thin client
Connections").
System Information").
system settings and perform diagnostics (see "Configuring
Connectivity Options," "Configu ring L ocal Settin gs Op tions ,"
and "Central Configuration: Automating Updates and
Configurations").
Shutdown TerminalClick the Shutdown Terminal icon to use the Shutdown
options available on the thin client (see "Signing Off and
Shutting Down"). Note that the Shutdown Terminal icon
does not display on the toolbar when using the Admin Mode
button to configure system settings.
Tip
Administrators can configure the toolbar settings using either a dialog box
(see
"Remote Connections") or the SysMode parameter in the wnos.ini file
(see Reference Guide: Wyse ThinOSTM INI Files).
Page 20
14Chapter 3
List of Connections
On the Wyse Zero Toolbar, you can click the Home icon to open your list of assigned
connections (in some cases the list may contain only default connections).
Use the following guidelines (depending on user privilege level, some options may not be
available for use):
Table 3 Connection Options
Option What It Does
Name of the
connection
Restart icon Restarts the connection (useful when a connection is not
Quick Disconnect
icon
Edit icon Opens the Connection Settings dialog box (see "Advanced
Configuring Global
Connection Settings
Opens the connection you want to use (all open connections
display a blue icon to the left of the connection name in the
list).
functioning properly or you need to reboot the connection).
Closes the connection (the Close icon is grayed out for
connections that are not open).
Details on Configuring ICA and RDP Connections") to
change the connection options (depending on user privilege
level, editing options may not be available for use).
If you do not use INI files to provide global connection
settings, you can click Global Connection Settings to open
and use the Global Connection Settings dialog box to
configure settings that affect all of the connection in the list
(see "Manually Configuring Global Connection Settings").
Page 21
Notable Wyse ThinOS Features15
Additional Classic Desktop Features
This section includes information on:
•"Classic Interactive Desktop Guidelines"
•"Shortcut Menu"
•"Connect Manager"
Classic Interactive Desktop Guidelines
The Classic Desktop has a Wyse default background with a horizontal taskbar at the
bottom of the screen. The number of icons that can be displayed o n the deskto p de pends
on the desktop resolution and administrator configuration.
Use the following guidelines:
•Icons representing available server connections and published applications are
displayed on the background. Hovering the mouse pointer over an icon pops-up
information about the connection. Right-clicking (or left-clicking if the mouse buttons
are reversed) on an icon opens a Connection Settings dialog box which displays
additional information about the connection.
•A server connection/published application can be opened by double- clicking a desktop
icon or a user can navigate to the desktop icon they want by using tab key and
pressing Enter to initiate the connection.
•The Desktop Menu may be opened by clicking the mouse button on the desktop
background or by clicking on the User Name on the taskbar.
•If configured to display (by an administrator), the volume control is displayed in the
right corner of the taskbar and the current time and date are shown when the cu rsor is
placed on the time.
Tip
The thin client is capable of synchronizing its clock to time provided by a
Simple Network Time Protocol (SNTP) server.
•Press CTRL+ALT+UPARROW to toggle between window display modes.
•Press CTRL+AL T+DOWNARROW to open a selection box for toggling between the
desktop, Connect Manager, and currently-active connections.
•Lock the thin client at any time by pressing CTRL+ALT+LEFTARROW or
CTRL+ALT+RIGHTARROW.
•Keyboard shortcuts are supporte d. Use the LEFT ALT+UDERLINED LETTER on the
keyboard for keyboard shortcuts (the RIGHT ALT+UDERLINED LETTER combination
is not currently supported).
•Use the System Preference dialog box to switch the left and right buttons (see
"System Preferences").
•In addition to the standard two-button mouse, the thin client supports a Microsoft
Wheel Mouse (used for scrolling). Other similar types of a wheel mouse may or may
not work.
•You can copy and paste between application sessions and between sessions and the
desktop, however, this function depends on session server configurations.
Page 22
16Chapter 3
Shortcut Menu
Right-clicking on the desktop provides a Shortcut Menu with the following options:
•Administrator Mode - Allows administrators to configure various settings locally on
thin client.
•Hide all windows - Brings the full desktop to the foreground.
•Copy to clipboard - Copies an image of the full screen, current window, or event log
to the clipboard. The clipboard contents can then be pasted to an ICA or an RDP
session.
•Purge clipboard - Discards the contents of the clipboard in order to free up memory.
•Group Sessions - Enables you to open more than three ICA or three RDP or three
ICA seamless sessions. The sessions will be displayed as a group on the taskbar.
•Lock Terminal - Puts the thin client in a locked state if the user has signed on to the
system with a password. The thin client can only be unlocked using the same
password.
Desktop Menu
Clicking the User Name (User Name is the user who is logged-on and is located at the
bottom-left side of the taskbar), or clicking on the desktop, opens the Desktop Menu with
the following options (for High-privileged and Low-privileged users only):
•System Setup - Provides access to the following local system setup dialog boxes:
•Network Setup - Allows selection of DHCP or manual entry of network settings, as
well as entry of locations of servers essential to thin client operation. This menu
selection is disabled for Low-privileged users. See
•Remote Connections - Allows you to configure thin client network connections
including ICA, RDP, Citrix Xen, VMware View, and other broker server connections.
See
"Remote Connections."
•Central Configuration - Allows you to configure thin client central connection
settings such as file server and optional Wyse Device Manager server settings. See
"Central Configuration."
•WAN Setup - Allows you to configure thin client WAN.
•System Preference - Allows user selection of thin client parameters that are a
matter of personal preference. See
•Display - Allows you to configure the monitor resolution and refresh rate. See
"Display."
•Peripherals - Allows you to select the peripherals settings such as keyboard,
mouse, volume, and touch screen settings. See
•Printer - Allows configuration of network printers and local printers that are
connected to the thin client. See
•System Information - Provides thin client system information. See "Accessing System
Information."
•Applications - Contains a submenu of all locally configured applications and is
populated with published applications when a user is signed on using either PNLite or
PNAgent.
"System Preferences."
"Printers."
"Network Setup."
"Peripherals."
Page 23
Notable Wyse ThinOS Features17
•Network Test - Opens a submenu from which the Ping and T ra ce Route tools can be
used to check the integrity of the network connection. See
Trace Route."
•View INI Settings - Opens a submenu from which the wnos.ini and user.ini windows
can be opened to view the contents of the files. See
•Shutdown - Opens the Sign-off/Shutdown/Shutdown/Restart the System dialog
box. See
Connect Manager
Clicking Connect Manager on the taskbar opens the Connect Manager. The Connect
Manager has a list of connection entries and a set of command buttons available for use
with the connections.
Tip
Non-privileged users cannot view the Connect Manager.
"Using Ping" and "Using
"System Tools."
"Signing Off and Shutting Down."
The command buttons available depend on the privileges of the user and administrator
configuration; the following default examples are typical:
•High-privileged user - Includes Connect, New, Settings, and Sign-off.
•Low-privileged user - Includes Connect, Settings, and Sign-off.
•Stand-alo n e user - Includes Connect, New, Settings, and Delete.
Tip
If set by an administrator (enablelocal=yes in the user.ini/wnos.ini file),
High-privileged and Low-privileged users will have the Delete command
button available instead of the Sign-off command button).
The use associated with these command buttons also depends on user privilege. For
example, Settings allows a High-privileged user to view and edit connection definitions,
while it allows a Low-privileged user to only view connection definitions.
Tip
Guest user privileges are determined by an admi n istr at or.
Page 24
18Chapter 3
The Connect Manager command buttons include:
•Connect - To make a connection, select a connection from the list and click Connect.
•New - Clicking New opens the Connection Settings dialog box either directly or
through the Connection Protocol menu selection for creating a new connection
definition (for more information on the Connection Settings dialog box, refer to
"Advanced Details on Configuring ICA and RDP Connections"). The new
locally-defined connections are added to the connection list. Be aware of the follo wing
information:
•High-privileged user - Typically, all locally-defined connection definitions are
temporary and are lost when the user logs off and when th e thin client restarts or is
shut down. However, if config ured by an administrator (enablelocal=yes),
locally-defined connection definitions can be saved in these cases.
•Stand-alo n e user - Locally-defined connections are retained when the thin client
restarts or is shut down (there is no individual log-on). Network configuration
settings must be made locally.
•Properties - Clicking Properties opens the Connection Settings dialog box for the
selected connection (for more information on the Connection Settings dialog box,
refer to
the following information:
•High-privileged user - Can view and edit the definitions for the currently-selected
connection. Edits are not permanently retained when the user signs-off.
•Low-privileged user - Cannot create or edit connections, but can view connection
definitions.
•Stand-alo n e user - Can permanently modify the persistent connections (except
when PNAgent/PNLite services are used).
•Sign-off - To sign-off from the thin client, click Sign-off.
•Delete - To delete a connection, select a connection from the list and click Delete.
•Reset VM - To reset a virtual connection, select a virtual connection from the list and
click Reset VM.
•Global Connection Settings - If you do not use INI files to provide global connection
settings, you can click Global Connection Settings to open and use the Global Connection Settings dialog box to configure settin gs that affect all of the connections
in the list (see
"Advanced Details on Configuring ICA and RDP Connections"). Be aware of
"Manually Configuring Global Connection Settings").
Page 25
4Configuring Connectivity Options
You can configure the following Connectivity options using thin client dialog boxes
(depending on user privilege level, some options may not be available for use):
•"Network Setup"
•"Remote Connections"
•"Central Configuration"
Tip
While it is not recommended to use thin client dialog boxes for configuring
Connectivity options, they are available in case you want to temporarily
override central default configurations or you do not have the option to set up
central configuration (smaller environments). In general, it is recommended
that you use central configuration to enable you to automatically push
updates and any desired default configuration to all thin clients in your Wyse
ThinOS environment (see "Central Configuration: Automating Updates and
Configurations").
To access Connectivity options:
•Wyse Zero Desktop - click the System Settings icon on the Wyse Zero Toolbar
(administrators can also click the Admin Mode button on the Login dialog box).
•Classic Desktop - click User Name (User Name is the user who is logged-on and is
located at the bottom-left side of the t askbar), and select System Setup.
Page 26
20Chapter 4
Network Setup
The Network Setup dialog box allows you to configure thin client network settings .
Tip
If required by the operating environment, the network administrator may
disable access to this dialog box. Specifically, it cannot be accessed by
Low-privileged and Non-privileged users (and not until after log-on if using
PPPoE access).
Use the following guidelines for the General tab:
•Ethernet Speed - Normally the default (Auto-Detect) should be selected, but another
selection can be made if automatic negotiation is not supported by your network
equipment. Selections include Auto-Detect, 10 Mb Half-Duplex, 10 Mb Full-Duplex,
100 Mb Half-Duplex, 100 Mb Full-Duplex.
Tip
The 10 Mb Full-Duplex option can be selected locally at the device,
however, this mode may need to be negotiated through Auto-Detect.
•No local LAN, invoke PPPoE only - Select this option if the thin client will access a
network through a PPPoE connection.
•Dynamically allocated over DHCP/BOOTP - Selecting this option enables the thin
client to automatically receive information from the DHCP server. The network
administrator must configure the DHCP server (using DHCP options) to provide
information. Any value provided by the DHCP server will replace any value entered
locally on the Options tab, however, locally entered values will be used if the DHCP
server fails to provide replacement values.
•Statically specified IP Address - Select this option to manual enter the IP Address,
Subnet Mask, and Default Gateway:
IP Address - Must be a valid network address in the server environment. The network
administrator must provide this information.
Subnet Mask - Enter the value of the subnet mask. A subnet mask is used to gain
access to machines on other subnets. The subnet mask is used to differentiate the
location of other IP addresses with two choices: same subnet or other subnet. If the
location is other subnet, messages sent to that address must be sent through the
Default Gateway, whether specified through local configuration or through DHCP. The
network administrator must provide this value.
Page 27
Configuring Connectivity Options21
Default Gateway - Use of gateways is optional. Gateways are used to interconnect
multiple networks (routing or delivering IP packets between them). The default
gateway is used for accessing the Internet or an intranet with multiple subnets. If no
gateway is specified, the thin client can only address other systems on the same
subnet. Enter the address of the router that connects the thin client to the Internet. The
address must exist on the same subnet as the thin client as defined by the IP address
and the subnet mask. If DHCP is used, the address can be supplied through DHCP.
•DHCP Vendor ID - Shows the DHCP Vendor ID when the Dynamically allocated over DHCP/BOOTP option is selected.
•DHCP UserClass ID - Shows the DHCP UserClass ID when the Dynamically allocated over DHCP/BOOTP option is selected.
Use the following guidelines for the Name Servers tab:
•DNS Domain and DNS Servers - Use of DNS is optional. DNS allows you to specify
remote systems by their host names rather than IP addresses. If a specific IP address
(instead of a name) is entered for a connection, it rather than DNS will be used to make
the connection. Enter the DNS Domain and the network address of an available DNS
Server. The function of the DNS Domain entry is to provide a default suffix to be used
in name resolution. The values for these two boxes may be supplied by a DHCP
server. If the DHCP server supplies these values, they will replace any locally
configured values. If the DHCP server does not supply these values, the locally
configured values will be used.
Tip
You may enter two DNS Server addresses, separated by a sem ico lo n,
comma, or space. The first address is for the primary DNS server and the
second is for a backup DNS server.
•WINS Servers - Use of WINS is optional. Enter the network address of an available
WINS name server. WINS allows you to specify remote systems by their host names
rather than IP addresses. If a specific IP address (instead of a name) is entered for a
connection, it rather than WINS will be used to make the connection. These entries can
be supplied through DHCP if DHCP is used. DNS and WINS provide essentially the
same function, name resolution. If both DNS and WINS are available, the thin client will
attempt to resolve the name using DNS first and then WINS.
Tip
You may enter two WINS Server addresses (primary and secondary),
separated by a semicolon, comma, or space.
Page 28
22Chapter 4
Use the following guidelines for the Options tab:
•DHCP Option IDs - Enter the supported DHCP options (each value can only be used
once and must be between 128 and 254). For information on DHCP options, refer to
"Configuring DHCP (DHCP Options)."
•Show WAN configuration on System Settings - Allows you to show the WAN
configuration on the System Settings submenu.
•Tcp Timeout - Enter the number of 30 seconds for the timeout value of a TCP
connection. The value must be between 1 and 255 which means the connection
timeout value is from 1x30 seconds to 255x30 seconds.
Use the following guidelines for the Security tab:
•Access Type - (For Wireless Option Only) Select the access type option (either None, WPA_Personal, WPA2_Personal, WPA_Enterprise, or WPA2_Enterprise) to be
used for this wireless communication link.
WPA_Personal and WPA2_Personal - Wi-Fi Protected Access (WPA)_Pre-Shared
Key (PSK) encryption can be enabled by selecting one of these options (WPA was
designed to improve upon the security features of WEP; WPA2 provides government
grade security).
WPA_Enterprise and WPA2_Enterprise - Wi-Fi Protected Access (WPA)_Enterprise
encryption can be enabled by selecting one of these options (WPA2-Enterprise verifies
network users through a server. WPA2 is backward compatible with WPA).
•Enable IEEEE 802.1x authentication - Select this check box to enable this
authentication and activate the EAP Type list of options.
Page 29
Configuring Connectivity Options23
•EAP T ype - If you have enabled the Enable IEEEE 802.1x authentication check box,
select the EAP Type option you want (TLS, LEAP, or PEAP).
TLS - If you select the TLS option, click Properties to open and configure the
Authentication Properties dialog box (you can use Browse to find and select the
Client Certificate file and Private Key file you want). Note that the CA certificate must
be installed on the thin client.
LEAP - If you select the LEAP option, click Properties to open and configure the
Authentication Properties dialog box (be sure to use the correct Username and
Password for authentication). Note that the maximum length for the username or the
password is 64 characters.
PEAP - If you select the PEAP option, click Properties to open and configure the
Authentication Properties dialog box (be sure to select either EAP_GTC or
EAP_MSCHAPv2, and then use the correct Username, Password, and Domain, if
necessary, for authentication). To configure EAP-GTC, enter the username only, and
the password or PIN will be asked when authenticating. T o configure EAP-MSCHAPv2,
enter the username, password, and doma in (domain\username in the username box is
supported, but you must leave the domain box blank). Note that the CA certificate must
be installed on the thin client (the server certificate is forced to be validated).
•Certificate Management - Opens the Certificates Browser where you can select the
Import From option you want to import a certificate (either USB Storage or File
Server).
USB Storage - If you select the USB Storage option, click Import to open and us e the
Import dialog box to find and select the certificate you want to use. The maximum
importing path is limited to 128 characters and the maximum certificate name is limited
to 64 characters.
File Server - If you select the File Server option, click Import to open and use the
Import dialog box to enter the detailed p ath to the certificate you want to use in the File
Servers box (if necessary, be sure to use the correct Username and Password). Note
that you must enter the absolute path of the certificate. For example: 10.151.121.100/
wnos/cacerts/mycertificate.cer. The maximum importing path is limited to 128
characters and the maximum certificate name is limited to 64 characters.
Use the following guidelines for the Wireless tab:
Tip
While Service Set Identification (SSID) and encryption configurations must
be entered in the Wireless tab on the thin client, be sure that the
corresponding entries are also be made on th e en te rp ris e access point.
•SSID - Enter the Service Set Identification (name o f the wireless netwo rk) set up by the
network administrator for this wireless communication link (maximum is 32 characters).
Page 30
24Chapter 4
•Security Type and Encryption - Select the encryption option (either None,
WPA-Personal, WPA2-Personal, WPA-Enterprise, or WPA2-Enterprise) to be used
for this wireless communication link (If a WPA option is selected, TKIP and CCMP
encryption is supported; if a WPA2 option is selected, CCMP encryption is supported).
None - Select None if encryption is not required.
WPA-Personal and WPA2-Personal - Wi-Fi Protected Access (WPA and WPA2)
Personal encryption is designed to improve upon the security features of WEP but is
still designed for home and small office networks that do not require the complexity of
an authentication server (WPA2 provides more security than WPA).
WPA-Enterprise and WPA2-Enterprise - Wi-Fi Protected Access (WPA and WPA2)
Enterprise encryption is designed to improve upon the security features of WEP but
also verifies network users through an authentication server (WPA2 provides more
security than WPA; WPA2 is backward compatible with WPA).
•WEP Key or WPA Key - If either box is active (depending on Encryption option), enter
the key according to your Encryption selection. The selected key is used to encrypt/
decrypt each frame transmitted from or received by the wireless adapter. The access
point must recognize frames encrypted by the same key. Keys can be 5 or 13
characters for the 64 or 128 bit encryption key, or specified as 10 or 26 hex-decimal
digits.
•Enable IEEEE 802.1x authentication - Select this check box to enable this
authentication and activate the EAP Type list of options.
•EAP T ype - If you have enabled the Enable IEEEE 802.1x authentication check box,
select the EAP Type option you want (TLS, LEAP, or PEAP).
TLS - If you select the TLS option, click Properties to open and configure the
Authentication Properties dialog box (you can use Browse to find and select the
Client Certificate file and Private Key file you want). Note that the CA certificate must
be installed on the thin client.
LEAP - If you select the LEAP option, click Properties to open and configure the
Authentication Properties dialog box (be sure to use the correct Username and
Password for authentication). Note that the maximum length for the username or the
password is 64 characters.
PEAP - If you select the PEAP option, click Properties to open and configure the
Authentication Properties dialog box (be sure to select either EAP_GTC or
EAP_MSCHAPv2, and then use the correct Username, Password, and Domain, if
necessary, for authentication). To configure EAP-GTC, enter the username only, and
the password or PIN will be asked when authenticating. T o configure EAP-MSCHAPv2,
enter the username, password, and doma in (domain\username in the username box is
supported, but you must leave the domain box blank). Note that the CA certificate must
be installed on the thin client (the server certificate is forced to be validated).
Page 31
Configuring Connectivity Options25
Remote Connections
The Remote Connections dialog box allows you to configure thin client remote
connections (including ICA, RDP, Citrix XenDesktop, VMware View, and other broker
server connections), visual options, and general connection settings.
Tip
In the Classic Desktop option, the Remote Connections dialog box allows
you to create default ICA and RDP connections for use. If you want to create
several ICA and RDP connections (more than the default connections), use
the Connect Manager (see "Connect Manager").
Use the following guidelines for the Broker Setup tab:
Tip
Locations can be supplied through a wnos.ini file if it is used. If DHCP is
used, locations can be supplied through DHCP. After creating an entry, be
sure to reboot the thin client to have the changes take effect.
•ICA Connection - Select None, select ICA, click Configure Connection, and then
follow the wizard (see
•RDP Connection - Select None, select RDP, click Configure Connection, and then
follow the wizard (see
•Direct Connection - Select Other, enter the IP Address for the broker server in the
Broker Server box, and then click OK.
•Citrix Xen Connection - Select Citrix Xen, enter the IP Address for the server in the
Broker Server box, select your options, and then click OK.
Use the following guidelines for the Citrix Xen Broker Server:
Enter the IP Address or host name for the server in the Broker Server box.
Use the Enable automatic reconnection at logon and Enable automatic reconnection from button menu check boxes and options to further configure the
connection for automatic reconnection.
•VMware View Connection - Select VMware View, enter the IP Address for the server
in the Broker Server box, and then click OK.
"Configuring ICA Connections").
"Configuring RDP Connections").
Tip
The broker supports both http and https, and depends on the broker server
support. If http or https is not specified on the broker se rver, then http is used
by default. If https is specified, the client side must install a corresponding
Page 32
26Chapter 4
root certificate locally. For detailed instructions on installing a corresponding
root certificate locally , refer to Wyse Knowledge Base Solution #15508 (go to
the Wyse Knowledge Base at
http://www.wyse.com/kb and search for 15508).
Use the following guidelines for the Visual Experience tab:
•Classic Desktop - Displays the full taskbar, desktop, and Connect Manager familiar to
Wyse ThinOS users. This option is recommended for terminal server environmen ts
and for backward compatibility with Wyse ThinOS 6.x versions.
•Zero Launchpad - Displays the new launchpad style GUI designed for VDI use.
Functionality is accessed through an always available interface. This option is
recommended for VDI and any full-screen only connections.
•Toolbar, hotkey, and connection icon options are also available for configuration.
Use the General Options tab options to select the action after you exit all open desktops
(by default, the thin client automatically returns to the Login dialog box and is ready for
another user), set the default sign-on username and domain, and to clear locally saved
connections.
Page 33
Configuring Connectivity Options27
Central Configuration
The Central Configuration dialog box allows you to configure thin client central
connection settings such as file server and optional Wyse Device Manager server
settings.
Use the following guidelines:
•File Servers/Path, Username, and Password - IP address or host name of the file
server that provides the system software and update images. The address can be
supplied through DHCP if DHCP is used. Use the following guidelines:
File Servers/Path - Allows 128 characters maximum. The data specifies part of the
path to be used when the server is accessed. Multiple file servers/paths may be
named, as long as all data fits in the length limitation.
Username - To log in to the file server. Use 15 characters maximum.
Password - To log in to the file server. Use 15 characters maximum.
•WDM Servers - List of IP addresses or host names if Wyse Device Manager is used.
Locations can be supplied through user profiles if user profiles are used. If DHCP is
used, locations can be supplied through DHCP.
Page 34
28Chapter 4
Advanced Details on Configuring ICA and RDP Connections
Use the following information when configuring ICA and RDP connections (this
information assumes that the thin client does not have a locked down privilege level):
•High-privileged user - The additional functionality provided by the Connection Settings dialog box allows testing of connection definitions before they are ente red (by
a network administrator) into the user profile file s.
•Low-privileged user - The settings for the selected connection can be viewed but
cannot be edited, and new connections cannot be defined. Connection definitions are
controlled by a network administrator and are accessed by the thin client from the use r
profiles located on a remote server.
•Stand-alo n e user - The Connect Manager is available to Stand-alone users because
connection definitions cannot be accessed from remote user profiles. If user profiles
are available on an FTP server but are not accessed because DHCP is not available or
is not configured to provide the file server IP address, the file server IP location can be
entered manually using the Network Setup dialog box.
Configuring ICA Connections
Use the following guidelines:
If you select the Server option, the Host Names box is displayed.
If you select the Published Application option, the Application Name box replaces the Host Names box.
Page 35
Configuring Connectivity Options29
Use the following guidelines on the Connection tab:
•Server or Published Application - Select the type of connection to which the settings
apply.
•Connection Description - Enter the descriptive name that is to appear in the
connection list (38 characters maximum) .
•Browser Servers IP - Enter a delimited (comma or semicolon) list of IP addresses or
DNS-registered names of ICA servers that contains the master browsers list, or that
could refer to another server that contains the list. The master browsers list is
generated automatically by a browsing progra m on one of the ICA servers (selected by
negotiation between servers). It is used to provide the information displayed in the
Server Name or IP box. No entry is needed if the list is on an ICA server in the same
network segment as the thin client. No entry is necessary if the connection is to a
server, or if the server name or IP contains the IP address of the server.
•Host Name or Application Name (title depends on the Server or Published Application option selected) - You can enter a delimited (semicolon or comma
separated) list of server hostnames or IP addresses, or you can select from the list of
ICA servers or published applications (depending on Server or Published
Application option selected) obtained from the ICA master browser (you can also use
Browse next to the box to make the selection you want). If you enter a delimited list of
servers, the thin client attempts to connect to the next server on the list if the previous
server attempt failed. If you use the list and the selected connection fails, the thin client
attempts to connect to the next one on the list.
Tip
The Host Name may be resolved using one of three mechanisms: ICA
master browser, DNS, or WINS. Master browser is the only mechanism that
can resolve a published application (unless manual entry is made in DNS for
the application). DNS uses the default domain name in the network control
panel to attempt to construct an FQDN but will also try to resolve the name
without using the default.
•Encryption Level - Allows you to sele ct the se curity le vel of communications betwe en
the thin client and the ICA server. Basic (the default option) is the lowest level of
security. Basic allows faster communication between the device and the ICA server
because it requires less processing than do the higher levels of encryption.
Caution
The encryption selection applies to the security of communications between
the thin client and the ICA server only. It is independent of the security
settings of individual applications on the ICA server . For exampl e, most W eb
financial transactions require the thin client to use 128-bit encryption.
However, transaction information could be exposed to a lower level of
security if the thin client encryption is not also set to 128 bits.
•Use HTTP for browsing - When selected, the thin client, by default, uses http when
browsing.
•Alternate address via firewall - When selected, the thin client will use an alternate IP
address returned from the ICA master browser to get through firewalls. Used for the
Windows log-on when the connection is activated.
•Wyse VDA - When selected, the thin client will use Wyse® Virtual Desktop Accelerator
software to provide an “accelerated” user experience on remote deskto p sessions with
high round-trip delay between the server and client.
Page 36
30Chapter 4
•Display Resolution - Select the display resolution for this connection (if you select the
Published Application option, the Connection Display will allow you to select the
Seamless Display Resolution option):
Default
640 x 480
800 x 600
1024 x 768
1152 x 864
1280 x 720
1280 x 768
1280 x 1024
1360 x 768
1366 x 768
1368 x 768
1440 x 900
1400 x 1050
1600 x 900
1600 x 1200
1680 x 1050
1920 x 1080
1920 x 1200
Colors - Select the color depth of the ICA session. If High Colors (16bits) or True
Colors is selected and the ICA server does not support this color depth, the thin client
renegotiates the color depth to the lower value (for example, 256 Colors [8 bits]).
•Window mode and Full screen mode - Select the initial view of the application in a
windowed screen or full screen. You can toggle between viewing modes by using
CTRL+ALT+UPARROW.
•Auto-connect on start-up - When selected, automatically connects the session on
start-up.
•Re-connect after disconnect - When selected, causes th e thin client to automatically
reconnect to a session after a non-operator-initiated disconnect. If selected, the wait
interval is that set in the Delay before re-connecting box (enter the number of
seconds 1 to 3600) or the user profile for yes (20 seconds) or seconds. The default is
20 seconds if there is no INI file description of this connection, or is a Stand-a lone user,
or simply omitted.
Page 37
Configuring Connectivity Options31
Use the following guidelines on the Logon tab:
•Logging on area - Enter Login Username, Password, Domain name, and Logon Mode
(if the Login Username, Password, and Domain name boxes are not populated, you
can enter the information manually in the ICA server login screen when the co nnection
is made):
•Login Username - 31 characters maximum.
•Password - 19 characters maximum.
•Domain Name - 31 characters maximum.
•Logon Mode - Select User-specified credentials, Smart Card, or Local User.
•Start Command area - (Server Connection Option Only - This area is disabled
(grayed) for a Published Application option.)
•Application (127 characters maximum) and Working Directory (63 characters
maximum) - Enter an initialization string and arguments, including an associated
working directory, that you want to start automatically on the server when the
connection is made.
Use the following guidelines on the Options tab:
•Auto-connect to local devices - Select any options (Printers, Serials, USB, Smart Cards, Sound, and Disks) to have the thin client automatically connect to the devices
(an ICA session will not automatically connect to a device through a serial port).
•Turn compression off - When selected, turns compression off (intended for
high-speed connections).
•Optimize for low speed link - When selected, allows optimization for low-speed
connections, such as reducing audio quality and /or decr easing pr otocol-specific cache
size. Intended for a connection spanning a WAN link or using dialu p.
•Map all disks under (z:) - When selected, maps all disks under the Z drive.
•Enable session reliability - When enabled, session reliability allows a user to
momentarily lose connection to the server without having to re-authenticate upon
regaining a connection. Instead of a user’s connection timing out after X seconds, the
session is kept alive on the server and is made available to the client upon regaining
connectivity. Session reliability is most relevant for wireless devices.
•Allow font smoothing - When selected, enables font smoothing (smooth type).
•Mouse queue timer - Specifies the default queue timer of a mouse event in an ICA or
RDP session (in 1/100 of a second). It can be used to adjust the bandwidth of a
network.
Page 38
32Chapter 4
Configuring RDP Connections
In a Virtual Desktop environment, an RDP connection will be assigned by the Virtual
Desktop Broker; you do not need to create an RDP connection manually. The Virtual
Desktop Broker virtual machine can be reset from the thin client by opening the
Connection Settings dialog box of the virtual machine, and then clicking th e reset button
(appears in the top-right of the dialog box).
Use the following guidelines:
Use the following guidelines on the Connection tab:
•Connection Description - Enter the descriptive name that is to appear in the
connection list (38 characters maximum) .
•Host Names - Use the list to select the valid DNS server name or the IP address of the
server to which the thin client connection is to be made (you can also use Browse next
to the box to make the selection you want). For example, a list of WTS servers on the
local network from which you can select.
Tip
The server name may be resolved using one of two mechanisms: DNS, and
WINS. DNS uses the default domain name in the network control panel to
attempt to construct an FQDN but will also try to resolve the name without
using the default.
•Wyse VDA - When selected, the thin client will use Wyse® Virtual Desktop Accelerator
software to provide an “accelerated” user experience on remote deskto p sessions with
high round-trip delay between the server and client.
•Console mode - Select to set the RDP connection with Windows Console mode.
•Display Resolution - Select the display resolution for this connection:
Default
640 x 480
800 x 600
1024 x 768
1152 x 864
1280 x 720
1280 x 768
1280 x 1024
1360 x 768
1368 x 768
1440 x 900
1600 x 900
Page 39
Configuring Connectivity Options33
1600 x 1200
1680 x 1050
1920 x 1080
1920 x 1200
Colors - Select the color depth of the RDP session. If High Colors (16 bits) or True
Colors (32 bits) is selected and the RDP server does not support this color depth, the
thin client renegotiates the color depth to the lower value (for example, 256 Colors (8
bits). The highest is 32 bits, if hardware supports it.
Tip
For some thin clients versions, only the 256 Colors (8 bits) selection is
available for RDP connections. Also, for older versions of the server sof tware
(for example, RDP 4.0) the server only supports 8 bit color. This is not
detectable in advance but results in use of 8-bit color when the conn ection is
established.
•Window mode and Full screen mode - Select the initial view of the application in a
windowed screen or full screen. You can toggle between viewing modes by using
CTRL+ALT+UPARROW.
•Auto-connect on start-up - When selected, automatically connects the session on
start-up.
•Re-connect after disconnect - When selected, causes th e thin client to automatically
reconnect to a session after a non-operator-initiated disconnect. If selected, the wait
interval is that set in the Delay before re-connecting box (enter the number of
seconds 1 to 3600) or the user profile for yes (20 seconds) or seconds. The default is
20 seconds if there is no INI file description of this connection, or is a Stand-a lone user,
or is simply omitted.
Tip
Y ou can re set the options on the Con nection tab of the Connection Settings
(RDP) dialog box. To do so, click the Reset VM command button. This
command button is located in the upper-right of the dialog box. It appears
only with a VDM broker connection.
Page 40
34Chapter 4
Use the following guidelines on the Logon tab:
•Logging on area - Enter login username, p assword, and domain nam e. If these boxes
are not populated, you can enter the information manually in the RDP server login
screen when the connection is made. Use the following guidelines:
•Login Username - 31 characters maximum.
•Password - 19 characters maximum.
•Domain Name - 31 characters maximum.
•Application (127 characters maximum) and Working Directory (63 characters
maximum) - Enter an initialization string and arguments, including an associated
working directory, that you want to start automatically on the server when the
connection is made.
Use the following guidelines on the Options tab:
•Wallpaper - When selected, disables the desktop wallpaper.
•Menu / Window animation - When selected, disables the menu or window animation.
•Theme - When selected, disables the desktop themes.
•Show content when dragging - By default, when you “grab” a Window by the title bar
and move it around, the contents of the window will move with it. Select this to disable
this content view so that only the outline of the window moves when dragging it, until
you drop the window. This option can be beneficial, as it uses less processing power.
•Font smoothing - Converts vector text to bitmap for better display.
•Auto-connect to local devices - Select any options (Printers, Serials, USB, Smart Cards, Sound, and Disks) to have the thin client automatically connect to the devices
(USB - Redirects locally attached USB devices on the thin client to a Microsoft
Windows terminal server. When the user connects to the terminal server, locally
attached USB devices on the thin client are accessible).
•RDP Audio Playback and RDP Audio Recording - Select the audio options you
want.
•Turn compression off - When selected, turns compression off (intended for
high-speed connections).
•Optimize for low speed link - When selected, allows optimization for low-speed
connections, such as reducing audio quality and /or decr easing pr otocol-specific cache
size. Intended for a connection spanning a WAN link or using dialu p.
•Mouse queue timer - Specifies the default queue timer of a mouse event in an ICA or
RDP session (in 1/100 of a second). It can be used to adjust the bandwidth of a
network.
Page 41
5Configuring Local Settings Options
You can configure the following Local Settings options using thin client dialog boxes
(depending on user privilege level, some options may not be available for use):
•"System Preferences"
•"Display"
•"Peripherals"
•“Printers”
Tip
While it is not recommended to use thin client dialog boxes for configuring
Local Settings options, they are available in case you want to temporarily
override central default configurations or you do not have the option to set up
central configuration (smaller environments). In general, it is recommended
that you use central configuration to enable you to automatically push
updates and any desired default configuration to all thin clients in your Wyse
ThinOS environment (see "Central Configuration: Automating Updates and
Configurations").
To access Local Settings options:
•Wyse Zero Desktop - click the System Settings icon on the Wyse Zero Toolbar
(administrators can also click the Admin Mode button on the Login dialog box).
•Classic Desktop - click User Name (User Name is the user who is logged-on and is
located at the bottom-left side of the t askbar), and select System Setup.
Page 42
36Chapter 5
System Preferences
The System Preference dialog box allows you to select personal preferences such as
screen saver, time/date, and custom information settings.
Use the following guidelines for the General tab:
•Screen Saver - Allows you to select the type of screen saver you want. The default is
to Turn Off Screen. Other selections available include Flying Bubbles and Moving Image (which are screen savers with the monitor remaining on).
•Timer - Select a time after which the screen saver is to be activated (either 1 minute, 5 minutes, 10 minutes or default is 20 minutes). When the thin client is left idle for the
specified idle time, the screen saver is initiated.
•Terminal Name - Allows entry of a name for the thin client. The default is a
14-character string composed of the let ters WT followed by the thin client Ethernet
MAC address. Some DHCP servers use this value to identify the IP address lease in
the DHCP Manager display.
Use the following guidelines for the Time/Date tab:
•Time Zone - Allows you to select a time zone where the thin client operates (default is
Unspecified).
•Enable Daylight Saving - Allows you to enable the daylight saving settings. When
selected, the six boxes must be properly configured to define the daylight saving
starting (month/week/day) and ending (month/week/day) periods. Use the following
guidelines:
Month - Specifies the month in the year from January through December.
Week - Select 1 through 4 for the week in the month. Week Last denotes the last week
in the month.
Day - Specifies the day of the week from Monday through Sunday.
Page 43
Configuring Local Settings Options37
•Time Format - Allows you to select a 12 or 24 hour time format (default is 24-hour format).
•Date Format - Allows you to select a yyyy/mm/dd (year/month/day) or dd/mm/yyyy
(day/month/year) date format (default is yyyy/mm/dd).
•Time Servers - List of IP addresses or host names with optional TCP port number of
Time Servers. Each entry with optional port number is specified as Name-or-IP:port,
where :port is optional. If not specified, port 80 is used. Locations can be supplied
through user profiles if user profiles are used. The Time Servers provide the thin client
time based on the settings of time zone and daylight saving information. If DHCP is
used, locations can be supplied through DHCP.
Use the Custom Info tab to enter configuration str ings for use by Wyse Device Manager
(WDM) software. The configuration strings can contain information about the location,
user, administrator, and so on.
Clicking OK transfers the custom field information you enter in the dialog box to the
Windows registry. The information is then available to the WDM Client Manager.
For more information on using WDM for remote administration and upgrading thin client
software, see "Using Wyse Device Manager Software For Remote Administration."
For details on using Custom Field information, see th e WDM documentation.
Page 44
38Chapter 5
Display
The Display dialog box allows you to select the re solution and refr esh rate for the monitor
used with the thin client. It also allows you to configure the way two monitors display.
Tip
The number of icons that can be displayed on the desktop depends on the
desktop resolution and administrator configuration. On thin clients that only
support 8 bit color, the 1280 x 1024 resolution will be used to display full
screen connections. The 1280 x 1024 resolution will not be used to display
the desktop, windowed connections, or sea m les s con ne ct i ons.
Use the following guidelines for the General tab:
•Select best display setting on DDC monitor - If the monitor is VESA DDC2B
(Display Data Channel) compatible, selection of this option allows the thin client to
automatically select the best resolution and refresh rate. If your monitor is not DDC
compatible, a Monitor does not support Plug and Play message is displayed (click OK
to acknowledge the message and remove it from the screen).
•DDC table - If the monitor is VESA DDC2B (Display Data Channel) compatible,
selection of this option allows you to select the resolution and refresh rate you want
from the list.
•User defined display setting - Select this option and select the resolution and refresh
rate supported by your monitor (all combinations are allowed):
Resolution list selections include:
640 x 480
800 x 600
1024 x 768
1152 x 864
1280 x 720
1280 x 768
1280 x 1024
1360 x 768
1368 x 768
1440 x 900
1600 x 900
1600 x 1200
1680 x 1050
1920 x 1080
1920 x 1200
•Rotation - Select a rotation option (either None, Left turn (Experimental), or Right
turn (Experimental)). Note that left or right rotations provide a 90 degree rotation.
•Desktop Color - Select the Desktop Color (either 16 bit or 32 bit).
•Usage Help area - Contains brief instructions for using the Display dialog box and
running the test. No operator entry can be made in this box. Make note of the
instructions in the area regarding v-key reset usage in case of display failure.
Use the following guidelines for the Dual Head tab (Supported Dual Mo nitor Ca p able Thin Clients Only):
•Dual Head - Select Disable to have the two monitors work in a matching state, or
Enable to have the two monitors work separately (second is extended from first).
•Main Screen - Select which of the two monitors you want to be the main screen
(Screen1 or Screen2). The other screen is extended from the main screen.
•Orientation - Select how you want the two monitors to be oriented to each other
(Horizontal where you mouse between the monitors from the left and right of the
screens or Vertical where you mouse between the monitors from the top and bottom of
the screens).
•(Classic Desktop O nly) Taskbar - Select under which screen you want the Taskbar to
appear (Whole Screen or Main Screen).
Page 46
40Chapter 5
Peripherals
The Peripherals dialog box allows you to select the peripherals settings such as
keyboard, mouse, volume, and touch screen settings.
Use the following guidelines for the Keyboard tab:
•Character Set - Select the character set (Each character is represented by a number.
The ASCII character set, for example, uses the numbers 0 through 127 to repr esent all
English characters as well as special control characters. European ISO character sets
are similar to ASCII, but they contain additional characters for European languages).
•Keyboard Language - Currently the following keyboard languages are supported
(default is English (United States)).
Croatian
Czech
Danish
Dutch
Dutch (Belgian)
English (Australian)
English (3270 Australian)
English (New Zealand)
English (United Kingdom)
English (United States)
Finnish
French (Belgian)
French (Canadian)
French (France)
French (Swiss)
German
German (IBM)
German (Swiss)
Greek
Hungarian
Italian
Italian (Swiss)
Japanese
Korean
Norwegian
Polish (214)
Polish Programmers
Portuguese
Portuguese (Brazil)
Romanian
Slovakian
Slovakian (Qwerty)
Slovenian
Spanish
Spanish (Mexican)
Swedish
Turkish
Turkish (QWERTY)
U.S. International
Page 47
Configuring Local Settings Options41
•Delay before repeat - Repeat parameters for held-down key. Select the Delay before
repeat (either 1/5 second, 1/4 second, 1/3 second, 1/2 second, 1 second, 2 seconds, or No Repeat). The default is 1/3 second.
•Repeat Rate - Select Slow, Medium, or Fast. The default is Medium.
Use the Mouse tab to select the Mouse Speed and mouse orientation (you can swap
mouse buttons for left-handed operation by selecting Swap left and right mouse buttons).
Use the Volume tab to select the volume settings for connected devices.
Use the following guidelines for the Serial tab:
•Select Port - Select the port to which this setup definition applies. Either COM 1, COM
2, COM 3, or COM 4 can be selected (default is Port COM 1). For Models SX0 and
VX0, COM 1 or COM 2 selects from either the USB or serial device.
•Baud Rate - Either 1200, 2400, 4800, 9600, 19200, 38400, 57600, or 115200 baud
can be selected (default is 9600).
•Parity - Either None, Even, or Odd can be selected (default is None).
•Stop - Either 1, 1.5, or 2 stop bits can be selected (default is 1).
Page 48
42Chapter 5
•Size - Character size 5, 6, 7, or 8 bits can be selected (default is 8).
•Flow Control - Either None, XON/XOFF, CTS/RTS, or Both can be selected (default
is None).
•Serial Touch Screen selections - Select the proper touch screen ELO, MicroTouch or FastPoint from the list.
•Touch Screen on - Select the proper serial port (COM port) or None from the list.
Use the Touch Screen tab to configure touch screens that are connected to the thin client
(USB). The tab is available (not grayed out) when the thin client detects that a touch
screen is attached through a USB port and the setup (or calibration) has not been
performed. The Touch Setup window prompts you to touch two circles on the screen to
make the necessary calibration adjustment. Once calibrated, the adjustment values are
saved in the local terminal NVRAM until the system is reset to factory default, or another
type of touch monitor is connected.
Page 49
Printers
Configuring Local Settings Options43
The Printer Setup dialog box allows configuration of network printers and local printers
that are connected to the thin client. Through its USB ports, a thin client can support
multiple printers. If more than one printer is to be used and another p ort is not available on
your thin client and the port that is to be used must be shared with a USB modem
converter, connect a USB hub to the port.
Tip
If required, USB-to-Parallel converter cables are available from Wyse. Port
LPT1 or LPT2 selects the connection to a USB printer or parallel printer
through a USB-to-Parallel cable. For ordering information, refer to the Wyse
Web site at:
•Select Port - Select the port you want from the list.
•Printer Name - This is a required entry. If Enable LPD service for the printer is
selected, the printer name becomes the queue name for other clients using LPR to
print to this printer.
•Printer Identification - Enter the type or model of the printer. This name should be
either the device driver name for the printer under the Microsoft Windows system, or a
key to map to the device driver. If not specified, the name will be defaulted to the
printer-supplied identification for standard direct-connected USB printers or Generic / Text Only for non-USB connected printers upon connection to Windows hosts. The
driver name mapping takes place either through a printer-mapping file read by the
system as part of the global profile (wnos.ini) or by MetaFrame servers through the
MetaFrame printer configuration file (\winnt\system32\wtsprnt.inf).
Tip
Most USB direct-connected printers or parallel printers connected through
USB-to-parallel cable converters do report their printer identifications. Port
LPT1 or LPT2 selects the connection to a USB printer or parallel printer
through a USB-to-Parallel cable.
•Printer Class - Select the printer class from the list (PCL5, PS, or TXT).
•Enable the printer device - Must be selected to enable the directly-connected printer.
Page 50
44Chapter 5
•Enable LPD service for the printer - Select this to make the thin client an LPD (Line
Printer Daemon) server for LPD printing requests from the network (see
LPD Services").
Tip
If the thin client is to be used as an LPD printer server, DHCP must not be
used and a static IP address must be assigned to the thin client (see
“Network Setup” ).
"Configuring
Use the following guidelines for the LPDs tab:
•Select LPD - Select the port you want from the list.
•Printer Name - Enter the printer name.
•Printer Identification - Enter the type or model of the printer. This name should be
either the device driver name for the printer under the Microsoft Windows system, or a
key to map to the device driver. If not specified, the name will be defaulted to the
printer-supplied identification for standard direct-connected USB printers or Generic / Text for non-USB connected printers upon connection to Windows hosts. The driver
name mapping takes place either throug h a pr inter-mapp ing file read by the system as
part of the global profile (wnos.ini) or by MetaFrame servers through the MetaFrame
printer configuration file (\winnt\system32\wtsprnt.inf).
•LPD Hosts - The DNS or WINS name of the server for the network printe r. An IP
address can also be entered.
Tip
If the printer is attached to another thin client on your network, the entry in
the LPD Hosts box is the name or address of that thin client.
•LPD Queue Name - An LPD host maintains a named queue for each supported
printer. Enter the name of the queue associated with the printer to be used.
Tip
The LPD Queue Name must match the content of the Printer Name box on
the thin client with the printer attached.
•Printer Class - Select the printer class from the list.
•Enable the printer device - Must be selected to enable the directly-connected printer.
Page 51
Configuring Local Settings Options45
Use the following guidelines for the SMBs tab:
•Select SMB - Select the SMB you want from the list.
•Printer Name - Enter the printer name.
•Printer Identification - Enter the type or model of the printer. This name should be
either the device driver name for the printer under the Microsoft Windows system, or a
key to map to the device driver. If not specified, the name will be defaulted to the
printer-supplied identification for standard direct-connected USB printers or Generic / Text for non-USB connected printers upon connection to Windows hosts. The driver
name mapping takes place either throug h a pr inter-mapp ing file read by the system as
part of the global profile (wnos.ini) or by MetaFrame servers through the MetaFrame
printer configuration file (\winnt\system32\wtsprnt.inf).
•\\Host\Printer - Enter the Host\Printer or use Browse next to the box to make the
selection you want.
•Printer Class - Select the printer class from the list.
•Enable the printer device - Must be selected to enable the directly-connected printer.
•Enable LPD service - Select this to make the thin client an LPD (Line Printer Daemon)
server for LPD printing requests from the network (see
"Configuring LPD Services").
Use the following guidelines for the Options tab:
•Default Printer - Select the printer you want to be the default printer from the list.
•Enable .print Client and Port - If you want to enable .print Client, select Enable .print Client and then enter the Port.
Page 52
46Chapter 5
The Help tab contains printer help information.
Configuring LPD Services
A thin client can be configured to provide LPD (Line Printer Daemon) services, making the
thin client a printer server on the network.
Set-up the thin client that is to provide LPD print services as follows:
1. Open the Network Setup dialog box (Desktop Menu > System Setup > Network)
and enter a static IP address for the thin client.
2. Open the Printer Setup dialog box (Desktop Menu > System Setup > Printer) and
select any of the listed ports.
3. Name the printer in the Printer Name box.
4. Select Enable LPD service for the printer.
5. Select Enable the Printer Device.
6. Set up the application server as described in either “Setting Up Windows NT4 Serv ers”
or “Setting Up Windows 2003/2008 Servers” .
Setting Up Windows NT4 Servers
1. Navigate to Control Panel > Network > Services and ensure that the Microsoft TCP/
IP Printing service is installed. If it is not, install it using the Microsoft installation
instructions.
2. Add the thin client as the LPD printer by completing the following:
a. Navigate to Control Panel > Printers > Add Printers > My Computer > Add Port
and double-click LPR PORT (if you do not see LPR Port, ensure that the Microsoft
TCP/IP Printing service is installed correctly).
b. Type the thin client IP address or DNS name in the Name or address of host
providing LPD box.
c. Type the printer name (assigned in “Configuring LPD Services” ) in the Name of
printer on that machine box.
d. Click OK, and then click NEXT.
3. After you have selected the printer, you can perform your normal printer setup for the
application server. For example, select the manufacturer printer type and printer name.
Page 53
Configuring Local Settings Options47
Setting Up Windows 2003/2008 Servers
1. Navigate to Control Panel > Administrative Tools > Services and ensure the
Microsoft TCP/IP Printing service is installed. If it is not, install it using the Microsoft
installation instructions.
2. Add the thin client as the LPD printer by completing the following:
a. Navigate to Control Panel > Printers > Add Printers > Local Printer > Create a
new port and select LPR PORT.
Tip
If you do not see LPR Port, ensure that the Microsof t TCP/IP Printing service
is installed correctly.
b. Type the thin client IP address or DNS name in the Name or address of host
providing LPD box.
c. Type the printer name (assigned in “Configuring LPD Services” ) in the Name of
printer on that machine box.
d. Click OK, and then click NEXT.
3. After you have selected the printer, you can perform your normal printer setup for the
application server. For example, select the manufacturer printer type and printer name.
Page 54
48Chapter 5
This page intentionally blank.
Page 55
6Performing Diagnostics
You can use the following diagnostic tools:
•“System Tools”
•“Network Tools”
To access Diagnostics options:
•Wyse Zero Desktop - click the System Settings icon on the Wyse Zero Toolbar
(administrators can also click the Admin Mode button on the Login dialog box).
•Classic Desktop - click User Name (User Name is the user who is logged-on and is
located at the bottom-left side of the taskbar), and select either Network Test (for
network tools Ping and Trace Route) or View INI Settings (for system tools to
configure Trace and Event log settings, and to view INI files).
Page 56
50Chapter 6
System Tools
The System Tools dialog box allows you to configure Trace and Event log settings. It also
allows you to view wnos.ini and user.ini cached information for troubleshooting purposes.
Use the Trace and Event log options on the General tab to configure the settings you
want.
Network Tools
Using Ping
Use the Global INI tab to view wnos.ini information.
Use the user.ini tab to view user.ini information.
The Network Tools dialog box allows you to use Ping (Packet InterNet Groper) and Trace Route for checking the integrity of the network connection (ping also checks the usability
of the network configuration and the availability of all equipment required to communicate
between the thin client and the ping destination) . Ge ne ra lly, Ping and Trace Route are
used for system diagnostics by, or under the direction of, a network administrator.
The Ping dialog box executes the ping diagnostic utility and displays response messages.
Ping is a diagnostic tool that sends an echo request to a networ k host. The host pa rameter
is either a valid host name or an IP address. If the host is operational and on the network,
it responds to the echo request. By default, echo requests are sent until interrupted (by
clicking Stop in the Ping dialog box). The ping utility sends one echo request per second
and calculates round trip times and packet loss statistics, and then displays a brief
summary upon completion of the calculation.
The ping utility can be used to:
•Determine the status of the network and various foreign hosts
•Track and isolate hardware and software problems
•Test, measure, and manage networks
•Determine the IP address of a host if only the hostname is known
Note
Not all network equipment will respond to ping packets, since this is a
common mechanism used in denial-of-service attacks. Lack of response
Page 57
Performing Diagnostics51
does not necessarily indicate that the target of the ping is unusable for other
purposes.
Use the following guidelines:
•Enter Hostname or IP - Enter the IP address, DNS-registered host name, or
WINS-registered host name of the target to be pinged.
•Data area - Displays ping response messages. The ping command sends one echo
request per second, calculates round trip times and packet loss st atistics, and displays
a brief summary upon completing the calculation.
•Start - Executes the ping command. If the host is operational and on the network, it
responds to the echo request. By default, echo requests are sent until interrupted by
clicking Stop.
•Stop - Terminates the ping request and leaves the Ping dialog box open (so you can
read the summary posted in the data area).
Using Trace Route
The Trace Route dialog box executes the tracert diagnostic utility and displays response
messages. The tracert utility traces the path from your thin client to a network host. The
host parameter is either a valid host name or an IP address. The tracert utility sends out a
packet of information three times to each device (routers and computers) in the path and
displays the round trip response times and identifying information in the message box.
Page 58
52Chapter 6
Use the following guidelines:
•Enter Hostname or IP - Enter the IP address, DNS-registered host name, or
WINS-registered host name of the target to be traced.
•Data area - Displays round-trip response time and identifying information for each
device in the path.
•Start - Executes the tracert command.
•Stop - Terminates the tra cert command and leaves the Trace Route dialog box open
(so you can read the information posted in the data area).
Page 59
ACentral Configuration: Automating
Up dates and Configurations
This appendix contains information on the network architecture and enterprise server
environment needed to provide network and se ssion services for Wyse thin clients running
Wyse ThinOS. It also includes information to help you address important considerations
when configuring the services to be provided by the server environment. Use this chapter
in conjunction with the Getting Started Guide: Wyse ThinOS
Wyse ThinOS
It includes:
•"Understanding How to Configure Your Network Services"
•"Configuring Network Services"
•"Configuring Session Services"
TM
INI Files to set up and configure your Wyse ThinOS server environment.
Understanding How to Configure Your Network Services
Network services used by the thin client can include DHCP, FTP file services, Virtual
Desktop file services, DNS, and so on. How you configure your network services depends
on what you have available in your Wyse ThinOS environment and how you want to
design and manage it.
TM
and the Reference Guide:
The following topics in this section provide important overview information on the
supported service situations you may have when configuring the network services for your
Wyse ThinOS environment (after becoming familiar with your environment requirements,
refer to "Configuring Network Services" for detailed instructions):
•"DHCP and FTP Servers Available"
•"FTP Server Available (DHCP Server Unavailable)"
•"DHCP and Virtual Desktop Servers Available"
•"Virtual Desktop Server Available (DHCP Server Unavailable)"
•"FTP and Virtual Desktop Servers Unavailable (Stand-alone User or PNAgent/
PNLite-only User)"
Caution
If a thin client accesses the enterprise intranet through PPPoE or PPTP VPN
and the thin client is locked-down, a non-privileged or low-privileged user
attempting to reboot to Stand-alone user mode will disable the Network Setup dialog box and system reset capabilities. The user will not be able to
re-access the enterprise intranet through this path. If this happens, the thin
client must be moved to a location where it can access the enterprise intranet
directly (Ethernet cable) and reboot so that an administrator can make any
required changes to the thin client operating configurations through the user
profiles (for example, set the user profile to unlock the thin client).
Page 60
54Appendix A
DHCP and FTP Servers Available
As a network administrator in an environment where DHCP and FTP servers are
available, you can set up both DHCP and FTP network services and create “global” and
“user” INI files as described in the Reference Guide: Wyse ThinOS
Tip
A thin client is initially (new-thin client or reset thin client to default
configurations) configured to obtain its IP address and the location of the
FTP server from a DHCP server. DHCP can only be used for the Ethernet
Direct access and Wireless Direct access configurations.
A wnos.ini file contains the “global” parameters you want that will affect all
thin clients accessing the file server. A {username}.ini file contains the
user-specific or “user profile” parameters you want that will comprise the
connection profile for an individual user. For information on constructing
these INI files, refer to the Reference Guide: Wyse ThinOS
TM
TM
INI Files.
INI Files.
If Wireless Direct access is used, the Wireless Setup dialog box must also be configured
locally (see the Users Guide: Wyse ThinOS
TM
for wireless configuration instructions).
After DHCP and FTP servers are configured and available, simply connect the thin client
to the network (either directly through a network cable or through a wireless network
device), turn it on, and begin using the thin client. A sign-on name and password may be
required for access to the session services. If applications (published by Citrix PNAgent/
PNLite services) are available, a Domain name mu st be ente re d or sele cte d from the list.
Connections or applications may start automatically if they are configured to automatically
start in the INI files.
Tip
If session connections or published applications are designated to open
automatically on start-up, upon accessing the enterprise server environment
you will see a session server log-in or server application window instead of
the thin client desktop. Use CTRL+ALT+UPARROW to toggle between
window display modes. Use CTRL+ALT+DOWNARROW to open a selection
box for toggling between the desktop, the Connect Manager, and
currently-active connections.
If the thin client accesses the enterprise server environment through a manually initiated
Dial-up, PPPoE, and/or PPTP VPN, the automation provided by a DHCP server is not
available. In such cases, refer to "FTP Server Available (DHCP Server Unavailable)" and
"FTP and Virtual Desktop Servers Unavailable (S t and-alone User or PNAgent/PNLite-only
User)" for configuration information.
Tip
If Dial-up, PPPoE, and/or PPTP VPN are automatically started, FTP server
services can be accessed through these connections.
Page 61
Central Configuration: Automating Updates and Configurations55
FTP Server Available (DHCP Server Unavailable)
In an environment where a DHCP server is not available but an FTP server is available,
the thin client user must locally enter (using the Network Setup dialog box) network
information that would otherwise be supplied by the DHCP server.
If the thin client is configured for DHCP (new-thin client or reset thin client to default
configurations) but DHCP is not detected on the network, the Network Setup dialog box
automatically opens when the thin client is started. You can also open the Network Setup
dialog box manually by clicking on the desktop background, selecting System Setup from
the desktop menu, and then clicking Network. In the Network Setup dialog box, select
the Statically specified IP Address option and configure the dialog box for the following
information (any remaining information will be automatically populated from the INI files
when the FTP server is contacted):
•Static IP address of the thin client
•Subnet Mask
•Default Gateway
•DNS Domain Name (not necessary if DNS is not used)
•DNS Server Address (not necessary if DNS is not used)
•File Server IP address or DNS name of the FTP server on which the INI files reside
and the FTP path on the server to /wnos.
•PNAgent/PNLite Servers list (If PNAgent/PNLite is deployed on the network
environment, enter the IP address or Host name with optional TCP port number of one
or more PNAgent/PNLite servers that will provide published applications on the
network)
•Ethernet S peed
•WINS Server Address (not necessary if WINS is not used)
•Username and Password for login to the FTP server
•Rapport Server Address (not necessary if Rapport server is not used)
•Time Server
Tip
A wnos.ini file contains the “global” parameters you want that will affect all
thin clients accessing the file server. A {username}.ini file contains the
user-specific or “user profile” parameters you want that will comprise the
connection profile for an individual user. For information on constructing
these INI files, refer to the Reference Guide: Wyse ThinOS
TM
INI Files.
After the network settings are configured, reboot the thin client before using it. A sign-on
name and password may be required for access to the session services. If applications
(published by Citrix PNAgent/PNLite services) are available, a Domain name must be
entered or selected from the list. Connections or applications may start automatically if
they are configured to automatically start in the INI files.
Page 62
56Appendix A
DHCP and Virtual Desktop Servers Available
A thin client is initially (new-thin client or reset thin client to default configurations)
configured to obtain its IP address and the location of the Virtual Desktop server from a
DHCP server. DHCP can only be used for the Et he rn et Direct access and Wir eless Dire ct
access configurations.
As a network administrator in an environment where DHCP and Virtual Desktop servers
are available, you can set up both DHCP and Virtual Desktop network services and create
“global” and “user” INI files (in the Virtual Desktop Broker) as described in the Reference
Guide: Wyse ThinOS
Tip
A thin client is initially (new-thin client or reset thin client to default
configurations) configured to obtain its IP address and the location of the
Virtual Desktop server from a DHCP server. DHCP can only be used for the
Ethernet Direct access and Wireless Direct access configurations.
A wnos.ini file contains the “global” parameters you want that will affect all
thin clients accessing the file server. A {username}.ini file contains the
user-specific or “user profile” parameters you want that will comprise the
connection profile for an individual user. For information on constructing
these INI files, refer to the Reference Guide: Wyse ThinOS
TM
INI Files.
TM
INI Files.
If Wireless Direct access is used, the Wireless Setup dialog box must also be configured
locally (see the Users Guide: Wyse ThinOS
TM
for wireless configuration instructions).
After DHCP and Virtual Desktop servers are configured and available, simply connect the
thin client to the network (either directly through a network cable or through a wireless
network device), turn it on, and begin using the thin client. A sign-on name and password
may be required for access to the session services. If applications (published by Citrix
PNAgent/PNLite services) are available, a Doma in na m e mu st be ente re d or sele cte d
from the list. Connections or applications may start automatically if they are configured to
automatically start in the INI files.
Tip
If session connections or published applications are designated to open
automatically on start-up, upon accessing the enterprise server environment
you will see a session server log-in or server application window instead of
the thin client desktop. Use CTRL+ALT+UPARROW to toggle between
window display modes. Use CTRL+ALT+DOWNARROW to open a selection
box for toggling between the desktop, the Connect Manager, and
currently-active connections.
If the thin client accesses the enterprise server environment through a manually initiated
Dial-up, PPPoE, and/or PPTP VPN, the automation provided by a DHCP server is not
available. In such cases, refer to "Virtual Desktop Server Available (DHCP Server
Unavailable)" for configuration information.
Tip
If Dial-up, PPPoE, and/or PPTP VPN are automatically started, Virtual
Desktop server services can be accessed through these connections.
Page 63
Central Configuration: Automating Updates and Configurations57
Virtual Desktop Server Available (DHCP Server Unavailable)
In an environment where a DHCP server is not available but an Virtual Desktop server is
available, the thin client user must locally enter (using the Network Setup dialog box)
network information that would otherwise be supplied by the DHCP server.
If the thin client is configured for DHCP (new-thin client or reset thin client to default
configurations) but DHCP is not detected on the network, the Network Setup dialog box
automatically opens when the thin client is started. You can also open the Network Setup
dialog box manually by clicking on the desktop background, selecting System Setup from
the desktop menu, and then clicking Network. In the Network Setup dialog box, select
the Statically specified IP Address option and configure the dialog box for the following
information (any remaining information will be automatically populated from the INI files
when the Virtual Desktop server is contacted):
•Static IP address of the thin client
•Subnet Mask
•Default Gateway
•DNS Domain Name (not necessary if DNS is not used)
•DNS Server Address (not necessary if DNS is not used)
•Ethernet S peed
•WINS Server Address (not necessary if WINS is not used)
•Username and Password for login to the FTP server
•Rapport Server Address (not necessary if Rapport server is not used)
•Time Server
•VDI Server
Tip
A wnos.ini file contains the “global” parameters you want that will affect all
thin clients accessing the file server. A {username}.ini file contains the
user-specific or “user profile” parameters you want that will comprise the
connection profile for an individual user. For information on constructing
these INI files, refer to the Reference Guide: Wyse ThinOS
TM
INI Files.
After the network settings are configured, reboot the thin client before using it. A sign-on
name and password may be required for access to the session services. If applications
(published by Citrix PNAgent/PNLite services) are available, a Domain name must be
entered or selected from the list. Connections or applications may start automatically if
they are configured to automatically start in the INI files.
Page 64
58Appendix A
FTP and Virtual Desktop Servers Unavailable (Stand-alone User or PNAgent/
PNLite-only User)
In an environment where FTP and Virtual Desktop Broker servers are not available (for
example, Stand-alone User or PNAgent/PNLite-only User situations), configuration files
are not available and network information must be entered locally at the thin client as
follows:
•Stand-alone User - This user does not access user profiles or PNAgent/
PNLite-published applications. New and Settings command buttons appear in the
Connect Manager for use (if the Connect Manager does not open automatically, open it
from Desktop menu). These command buttons are also available to low-privileged and
non-privileged users. Locally entered connection defini tions (using these command
buttons) are preserved for the next thin client use after the thin client is powered off and
restated (automatic software upda tes, however, are not available when the thin client is
powered on again).
•PNAgent/PNLite-only User - This user does not access user profiles, but applications
(published by Citrix PNAgent/PNLite services) are available (the IP address of a
PNAgent/PNLite server and Domain are entered into the Network Setup dialog box or
available through DHCP options 181 and 182). A log-on dialog box (similar to the
standard log-on dialog box) opens for logging on to the PNAgent/PNLite server.
Applications published by PNAgent/PNLite are listed in the Connect Manager
(Published applications that add a shortcut to the client desktop will have an icon on
the desktop which you can double-click to open). Locally entered connection
definitions are not preserved for the next thin client use after the thin client is powered
off and restated.
Configuring Network Services
Before you use the information in this section to configure your network services, be sure
you have read "Understanding How to Configure Your Network Services" and remember
the following important issues:
•Restrictions to Network Services can Exist - Thin client network services reside on
the enterprise intranet. When setting up thin client network services, remember that if
thin clients are to access the enterprise intranet through Dial-up, PPPoE, or PPTP
VPN, restrictions imposed by these access paths must be considered.
•Know How Your Environment Works - Either the FTP server or the Virtual Desktop
server (depending on your environment) holds the INI files, while the FTP server (if
available) holds the current and upgrade versions of the thin client software.
The thin client software is acquired from either local flash memory or the FTP server.
During the boot process, the local image is transferred to RAM and executed far
enough for the thin client to check the image and the INI files on the file servers. Under
direction of the INI files and the version of the remote image, the image in RAM can be
replaced with the remote image; and sep arately , the remote image can update the local
flash-memory.
•Functionality Depends on You - The Wyse ThinOS INI files contain the parameters
and associated values necessary for the various functionality you want. The INI files
(wnos.ini file and {username}.ini file) are constructed and maintained by you and are
stored on the file server for use with thin clients running Wyse ThinOS.
Page 65
Central Configuration: Automating Updates and Configurations59
Tip
The INI files contain connection definitions and thin client settings. These
text-based files must be created and maintained by using an ASCII text
editor. If the INI files are omitted or they cannot be accessed because a file
server is not used, the thin client user must enter connection definitions
locally (or for FTP servers, use what is published by PNAgent/PNLite servers
residing on the network).
Y ou can also de fine connections in the INI files which are to be stored in local
NV-RAM and used in case s where the file server fails.
A wnos.ini file contains the “global” parameters you want that will affect all thin clients
accessing the file server. A {username}.ini file contains the user-specific or “user
profile” parameters you want that will comprise the connection profile for an individual
user. The thin client accesses the wnos.ini file upon thin client initialization and
accesses any individual {username}.ini file when the user logs on (if user login is
required, the {username}.ini file must exist before that user can log in). For information
on constructing these INI files, refer to the Reference Guide: Wyse ThinOS
TM
INI Files.
To configure network services, use the information in the following sections:
Before you use the information in this section to configure your FTP server, be sure you
understand and use the following guidelines:
•General Guidelines - When the thin client boots, it accesses the software update
images and INI files from the FTP server. The FTP server and path to the software
update files are available through DHCP vendor options 161 and 162 (see
DHCP (DHCP Options)"). If these are not specified, the default FTP server is the
DHCP server from which the thin client receives its IP address and the default directory
(\wyse\wnos for Windows FTP servers, or /wyse/wnos for Linux FTP servers).
The FTP server and path to the software update files can also be specified locally on
the thin client. DHCP options 184 and 185 can be used to provide the User ID and
Password for non-anonymous access to the FTP server in Wyse ThinOS version 4.3
and later. For Wyse ThinOS versions earlier than 4.3, the file server must have
anonymous login capability and provide at least file read privilege for the anonymous
user (it must also provide file write privilege if users are allowed to change their
passwords).
•Non-Anonymous Access Guidelines - You must first create a local account (name
the account so that you remember it is a non-anonymous account) on the FTP server
defined between the DHCP vendor options 161 and 162 (DHCP server). Then, add
DHCP options 184 and 185 to provide the User ID and Password for non-anonymous
access to the FTP server. Ensure that option 184 is the account User ID and that
option 185 is the account Password, and that you keep consistency with FTP server
"Configuring
Page 66
60Appendix A
DHCP vendor options (for example, ensure that the 184 and 185 options are string
parameters). Then provide the non-anonymous account with read-only permissions
through the entire FTP server path. Be sure to modify these guidelines according to
your specific security environment and configuration.
•Windows FTP Server Guidelines - You can use the FTP tools available on the
Windows server. For Wyse ThinOS versions earlier than 4.3, be sure the Windows
server supports the anonymous log-in capability. For Wyse ThinOS version 4.3 and
later, this suppor t is not necessa ry because of the User Interface ( UI)/DHCP feature to
specify the login ID and password.
•Linux FTP Server Guidelines - Be aware of the following:
•The FTP server must be configured to offer FTP services (by adding the following
line or equivalent to the /etc/inetd.conf file, if it is not already present):
ftp stream tcp nowait root /usr/sbin/tcpd in.proftpd
•The FTP server must be configured to support anonymous FTP. For most FTP
servers, this requires establishment of an FTP login account by adding the following
line or equivalent to the /etc/password file:
The shell file /dev/null/ftp-shell need not exist, but some FTP servers
require that it be listed in the /etc/shells file to allow FTP connections on this
account.
•Depending on which Linux distribution you are using, additional modifications to a
central configuration file for the FTP daemon may be necessary to enable
anonymous FTP. You can try man protftp, man wuftpd, or man ftpd to access
information applicable to your particular FTP daemon.
•A Linux server used for FTP must support passive FTP.
•FTP Folder Structure Guidelines - The FTP folder structure that is required by thin
clients running Wyse ThinOS is \wyse\wnos and must be placed under the FTP root
folder (if DHCP option tag 162 is not used) or under the folder which has been
specified by DHCP option 162. For example, if DHCP option tag 162 has been
configured with the name ThinClients and DHCP option tag 161 has been configured
with IP address 192.168.1.1, then the thin client will check the folder
<FTPRoot>\ThinClients\wyse\wnos for a wnos.ini and firmware on the FTP server with
the IP address (192.168.1.1). The sub-folder \bitmap must be placed under the \wnos
folder and can contain graphical images for icons and background images. The
sub-folder \cacerts can be placed under the \wnos folder and can contain you r CA
certificates. The sub-folder \inc can be placed under the \wnos folder and can contain
the mac.ini files (note that the use of the parameter
mac-address.ini” so that you can use inc in the folder structure and use $MAC.ini).
sub-folder \trace can be placed under the \wnos folder and can contain the trace files
that you can capture and play back (be sure to en ab le th e parame te r,
EnableTrace=yes). The following figure shows an example of the folder structure of an
FTP server for Wyse ThinOS.
Include=$mac.ini will load “/wnos/inc/
The
Page 67
Central Configuration: Automating Updates and Configurations61
To configure an FTP server, complete the following procedures:
1. Create the following directory structure on your FTP server:
<path from anonymous user FTP root>\wyse\wnos\
<path from anonymous user FTP root>\wyse\wnos\bitmap\
<path from anonymous user FTP root>\wyse\wnos\cacerts\
<path from anonymous user FTP root>\wyse\wnos\inc\
<path from anonymous user FTP root>\wyse\wnos\trace\
Tip
There is a difference between a path obtained from the DHCP server and a
path entered in the UI. If the path is obtained from DHCP, /wyse/wnos are
appended. If the path is obtained from th e UI, the /wyse portion is not
appended; only /wnos is automatically inserted. As written in this first step,
the configuration procedure will only work in conjunction with a DHCP server.
2. If you need to upgrade the firmware for your thin client, you must have a Software
Maintenance agreement to download the files (for details, go to http://www.wyse.com/
products/software/os/index.asp). Copy the RCA_boot and RCA_wnos (if you have an
S10) or V10L_boot and V10L_WNOS (if you have a V10L) and place it in the wnos
subdirectory of your FTP server.
3. Obtain the Sample User INI files (go to http://www.wyse.com/manuals
, search for
sample.ini, click the reference guide link, and then click the sample ini link to open and
use the file download dialog box to save the compressed file to a folder you want) and
unpack them into a directory from which they can be examined and modified using an
ASCII text editor. These sample files are annotated to allow you to use them as a
starter set on your FTP server and can be modified to suit your needs. The
compressed file includes:
•wnos.kiosk - Example wnos.ini file for a kiosk configuration
•wnos.login - Example wnos.ini file to enable multiple user accounts
•user.ini - Template for {username}.ini for individual user profiles
4. Determine whether all the thin clients served by this FTP server will be used as kiosks
or will support individual user accounts. You must rename the downloaded files so that
there will be one wnos.ini file available to all users globally; and for a multiple user
account configuration there will be a unique {username}.ini file for each user. In
addition:
•If the kiosk configuration is to be used - Change the name of wnos.kiosk to
wnos.ini. Otherwise, for multiple user accounts, change the name of
wnos.login to wnos.ini.
•If the individual user account configuration is to be used - Make a copy of the
user.ini file for each user name as {username}.ini (where {username} is the
name of the user) and place the files in the subdirectory ini of wnos. The files must
have read permission enabled, and if users are to be allowed to change their
passwords, the files also must have write permission enabled (so that the thin
clients can write the encrypted user passwords to them). For Linux servers, use
the chmod command to set the read/write permissions. For Micro soft se rvers, use
the Properties dialog box to set read/write permissions.
5. If desired, you can customize the INI files to match the local environment using the
instructions in the Reference Guide: Wyse ThinOS
files to include icons and logos, be sure to place the images in the FTP server/wnos/bitmap subdirectory.
When the thin client boots, it accesses the INI files from a Virtual Desktop Infrastructure
(VDI) server. VDI servers are available through DHCP vendor option 188 (see
"Configuring DHCP (DHCP Options)").
The thin client communicates with a Virtual Desktop Broker server by the sysinit, signon, signoff, and shutdown commands. When the thin client boots and
successfully connects in a Virtual Desktop environment, it sends the sysinit command
to the Virtual Desktop Broker, which then sends back the wnos.ini file (if a broker
connection cannot be made, the thin client will attempt to connect to an FTP or PNLite
server). After the thin client successfully receives the wnos.ini from the Virtual Desktop
Broker, a sign-on window displays, prompting the user for username and password
credentials. The thin client then sends the signon command to the Virtual Desktop
Broker with the username and password as it s parameter. If the sign-on is successful, the
Virtual Desktop Broker server will send back the {username}.ini file (if the sign-on is
unsuccessful, the user is prompted again for username and password credentials). The
signoff command will be sent when a user disconnects from the connection. The
shutdown command will be sent when a user turns off the thin client power.
Configuring XenDesktop Support
XenDesktop is supported in Wyse ThinOS without the need to use a Web br owser. To
connect to XenDesktop, do not use the VDI Broker parameter. Instea d, use the same
parameter and configuration that is used when connecting to a PNAgent/Lite server.
Configuring DHCP (DHCP Options)
Before you use the information in this section to configure your DHCP server, be sure you
understand and use the following guidelines:
•General Guidelines - The DHCP service provides all thin clients on the network with
their IP addresses and related network information when the thin clients boot. DHCP
also supplies the IP address and directory path to the thin client software images and
user profiles located on the file servers.
Use of DHCP is recommended. However, if a DHCP server is not available, fixed IP
addresses can be assigned (this does, however, reduce the stateless functionality of
the thin clients) and the fixed IP addresses must be entered locally for each device
using the thin client Network Setup dialog box as described in
(DHCP Server Unavailable)" and "Virtual Desktop Server Available (DHCP Server
Unavailable)").
Many DHCP options correspond to places in the network configuration UI where the
thin client user can enter information manually. Be aware that wherever there is
information in the UI and the thin client receives information about the same function
from one or more DHCP options, the information received from the DHCP server will
replace the information contained in the UI. Howe ve r, if the thin client does not receive
information from the DHCP server about a particular function, the information manually
entered in the UI will remain and will be used.
•LPD Print Server Guidelines - If a particular thin client is to function as an LPD print
server, it can be assigned a fixed IP add ress. However, you can also guarantee that an
LPD server will always have the same IP address by making a reservation for that thin
client in the DHCP server. In that way , you can preserve the stateless nature of the thin
client and still guarantee a fixed address for the server. In fact, you can assign a
"FTP Server Available
Page 69
Central Configuration: Automating Updates and Configurations63
symbolic name to the reservation address so that other thin clients can reference the
LPD server by name rather than by static IP address (the symbolic name must be
registered with a DNS server before other thin clients will be able to locate this LPD
server). The thin client does not dynamically register its name and the DNS registration
must be manual.
•Wyse Device ManagerTM (WDM) Guidelines - If you use WDM, the thin client uses
port 80 as the default to access a WDM server (formerly known as Rapp ort server). If a
port other than 80 is used to access a WDM server, use option 187 in the list of DHCP
options in
Table 5 (option for a WDM server is option 186 in the list of DHCP options in
Table 5). WDM options are the only options used by the thin client that are not in text
form.
•PNAgent/PNLite Server Guidelines - If you use a a PNAgent/PNLite server, the thin
client uses port 80 as the default to access a PNAgent/PNLite server. If a port other
than 80 is used to access a PNAgent/PNLite server , the port number must be specified
explicitly with the server location in the form IP:port or name:port (option for a
PNAgent/PNLite server is option 181 in the list of DHCP options in
Table 5).
•Windows DHCP Server Guidelines - You can use the DHCP tools available on the
Windows server.
•Linux DHCP Server Guidelines - For Linux servers, enter DHCP options 161 an d 162
(described in
Table 5) in /etc/dhcpd.conf (refer to the manual page man dhcpd.conf for more information on DHCP and the syntax of this file). For example, if
you want the computer to search ftp://132.237.16.157/pub/
serversoftware/wnos, add the following line to /etc/dhcpd.conf:
option option-161 132.237.16.157;option option-162 "pub/
serversoftware$";
As mentioned in Table 5, the /wnos suffix is automatically appended to the FTP path,
so you should not specify it explicitly. In this case, the actual directory searched will be
pub/serversoftware/wnos.
•DHCP Options Guidelines - Wyse ThinOS uses several DHCP option tags. These
option tags must be created, activated within the DHCP scope(s), and then added for
the thin clients to use them. The following figure shows the Windows DHCP Server
Predefined Options and Values dialog box that is displayed when right-clicking the
DHCP server and selecting Set Predefined Options. The most commonly used tags
are 161 and 186. Depending on the Terminal Server environment, more options can be
added using the Predefined Options and Values dialog box.
Page 70
64Appendix A
Use the guidelines shown in Table 5 when creating and adding the DHCP option tags you
need for your thin clients.
Tip
Ensure that within the DHCP scope these new DHCP option tags you create
are activated (this can be done using the Configure Options command),
before you add them.
Table 5 DHCP Options
OptionDescriptionNotes
1Subnet MaskRequired. However , it is not is not required unless
2Time OffsetOptional.
3RouterOptional, but recommended. It is not required
the thin client must interact with servers on a
different subnet (MS DHCP requires a subnet
mask and will always send one).
unless the thin client must interact with servers on
a different subnet.
6Doma in Nam e Server
(DNS)
15Domain NameOptional, but recommended. See Option 6.
28Broadcast AddressOptional.
44WINS servers IP
Address
51Lease TimeOptional, but recommended.
52Option OverloadOptional.
53DHCP Message TypeRecom m en d ed .
54DHCP Server IP
Address
55Parameter Request
List
57Maximum DHCP
Message Size
58T1 (renew) TimeOptional, but recommended.
59T2 (rebind) TimeOptional, but recommended.
Optional, but recommended.
Optional.
Recommended.
Sent by thin client.
Optional (always sent by thin client).
61Client identifierAlways sent.
161FTP server listOptional string. Can be either the name or the IP
address of the FTP server. If a name is given, the
name must be resolvable by the DNS server(s)
specified in Option 6. If the option provided by the
server is blank or the server provides no value for
the field, the machine on which the DHCP server
resides is assumed to also be the FTP server.
Page 71
Central Configuration: Automating Updates and Configurations65
Table 5 DHCP Options, Continued
OptionDescriptionNotes
162Root path to the FTP
files
Optional string. If the option provided by the
server is blank and the server prov ide s no valu e
for the field, a null string is used.
\wyse\wnos is automatically appended to the
search path. For example, if you enter
pub\serversoftware, the path searched will
be pub\serversoftware\wyse\wnos.
Note: You ca n ha ve the \wyse automatic
component of the search path omitted by
appending a dollar sign ($) to the entered path.
For example, if you enter
pub\serversoftware$, the path searched will
be pub\serversoftware\wnos.
Note: The usage or omission of a leading slash
(\) on the path is critical on some servers. Some
servers limit access to the root path of the user
specified at login. For those servers, the usage of
the leading slash is optional. Some *NIX servers
can be configured to allow the FTP user acce ss to
the entire file system. For those servers,
specifying a leading slash specifies that access is
to start at the root file system. Proper matching of
the file specification to the FTP server in use is
critical to ensuring proper operation. A secured
Windows server requires the slash be specified in
order to complete proper access.
181PNAgent/PNLite server
list
Optional string. The thin client uses the server to
authenticate the Windows credentials of the user
and to obtain a list of ICA published applications
valid for the validated credentials. The user
supplies those credentials when logging in to the
thin client.
182NT domain list for
PNAgent/PNLite
Optional string. The thin client creates a pull-down
list of domains from the information supplied in
option 182. This list is presented at thin client login
in the order specified in the DHCP option (for
example, the first domain specified becomes the
default). The selected domain is the one which
must authenticate the user ID and password. Only
the selected domain is used in the authentication
process. If the domain list is incomplete and the
user credentials must be verified against a domain
not in the list (assuming that the server in option
181 is capable of authenticating against a domain
not in the list), the user has the option of not using
any of the domains specified in option 182 and
typing a different domain name at the time of
login.
184FTP UsernameOptional string. Wyse ThinOS version 4.3 and
later only.
185FTP PasswordOptional string. Wyse ThinOS version 4.3 and
later only.
Page 72
66Appendix A
Table 5 DHCP Options, Continued
OptionDescriptionNotes
186Wyse Device Manager
(WDM) server list
(formerly know as
Rapport)
187WDM server port
(formerly know as
Rapport)
188Virtual Desktop Broker
port
190WDM secure port
(formerly know as
Rapport)
192WDM server port
(formerly know as
Rapport)
Optional binary IP addresses of WDM. This option
can specify up to two Wyse Device Manager
servers. If two are specified, at boot time the thin
client will attempt to check-in to the first server. If it
cannot contact the first server it will try to check-in
to the second server. Wyse ThinOS version 4.3
and later only.
Optional number. Byte, word, or two-bytes array.
NOTE: The value of this option tag, when not
embedded in Ve ndor Class Specific Information
option, is interpreted in reverse order when it is
sent as 2 bytes (for example, the value of 0x0050
was interpreted as 0x5000). This option tag was
used by old Wyse ThinOS releases. New Wyse
ThinOS releases still accept this option tag for
backward compatibility.
Optional string.
Optional number. Word, or two-bytes array.
Specifies to use HTTPS to communicate with
WDM instead of HTTP.
Optional number. Word, or two-bytes array.
NOTE: The value of this option tag represen t s the
same information as option tag 187. The
difference is that Wyse ThinOS interprets the
value of this option tag in correct order (for
example, the value of 0x0050 is interpreted as
0x0050). If the DHCP server provides both option
tag 192 and 187, option tag 192 takes
precedence.
Tip
The thin client conforms to both RFC-compliant DHCP servers (RFC
numbers 2131 and 2132) and RFC-noncompliant Microsoft servers (which
NULL terminate strings sent to the thin client). The thin clie nt su pp o rts both
infinite leases and leases that expire (per RFC 2131 and others).
Tip
Not all options in the range 128-254 are strings. Options 186, 190, and 192
are employed for all Wyse product s that use WDM. Their for mat and conten t
are determined by the WDM product.
Page 73
Central Configuration: Automating Updates and Configurations67
Configuring DNS
Thin clients accept valid DNS names registered on a DNS server available to the
enterprise intranet. In most cases, DNS is not required but may be used to allow hosts to
be accessed by their registered DNS names rather than their IP addresses. Every
Windows DNS server in Windows 2000 and later includes Dynamic DNS (DDNS) and
every server registers dynamically with the DNS server. There are also DDNS
implementations available for *NIX environments. However, the thin client does not do
dynamic registration, and therefore, requires a static or non-variant IP address and
manual DNS registration in order to provide LPD support by name (for example, in the
case where the thin client is used as an LPD printer server or if DHCP is not available).
For DHCP entry of DNS domain and server location information, refer to "Configuring
DHCP (DHCP Options)."
Configuring WINS
The thin client does not do dynamic registration and therefore, requires a static or
non-variant IP address and manual Windows Internet Naming Service (WINS)
registration. Use the network address of an available WINS name server. WINS allows the
thin client user to specify remote systems by their host names rather than IP addresses. If
a specific IP address (instead of a name) is entered for a connection, it rather than WINS
will be used to make the connection. These entries are supplied through DHCP , if DHCP is
used.
Tip
You may use two WINS server addresses, separated by a semicolon,
comma, or space. The first address is for the primary WINS server and th e
second address is for a backup WINS server.
Configuring Wyse Device Manager Servers
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). Use the IP addresses or host names with optional TCP port
number for WDM servers. Each entry with optional port number is specified in the form
IP:port or name:port, where :port is optional (if not specified, port 80 is used).
Configuring Wireless Access
Thin clients running Wyse ThinOS can support 802.11b/g/n wireless connections. WEP is
used as the encryption method in 802.11b wireless access. WEP, WPA-Personal,
WPA2-Personal, WP A-Enterprise and WPA2-Enterprise are used as the encryption and
authentication methods in 802.11g/n wireless access. For a wireless access point, Cisco,
TP-Link, and D-Link products are recommended. For a Radius server used in EAP-TLS,
the IAS, FreeRadius and Cisco ACS are recommended.
Tip
Internet Authentication Service (IAS) is the Microsoft implementation of a
Remote Authentication Dial-in User Service (RADIUS) server and proxy. As
a RADIUS server, IAS performs centralized connection authentication,
Page 74
68Appendix A
authorization, and accounting for many types of network access; including
wireless and virtual private network (VPN) connections.
The FreeRADIUS Server is a daemon for unix and unix-like operating
systems which allows you to set up a radius protocol server (which can be
used for authentication and accounting for various types of network access).
Cisco Secure Access Control Server (ACS) for Windows provides a
centralized identity networking solution and simplified user management
experience across all Cisco devices and security management applications.
Configuring for Transport Layer Security (TLS) Connections Over a LAN
The IEEE 802.1x standard allows a switch port to remain wired or enabled but not permit
traffic to traverse the switch until the identity of the client is confirmed. IEEE 802.1x is a
security feature. It defines the process of authenticating a wired or wireless client to allow
the client to communicate with the network. Wyse ThinOS supports IEEE 802.1x for thin
clients to be authenticated to access an Ethernet network. To enable this connection, you
must download certificates from a Certificate Authority (CA), and then install and configur e
them for the thin client.
To configure the authentication options:
1. Open the Network Setup dialog box (click the desktop to open the menu, select
System Setup, and then click Network).
2. Click the Authentication tab.
3. Select either the Wire or Wireless Authentication Mode option (Wire is the default
mode).
4. Select the Enable IEEE802.1x Authentication check box.
5. In the EAP Type drop-down list, select an Extensible Authentication Protocol option
(either TLS, LEAP, or PEAP.
Tip
In Wire mode, only the TLS EAP type is available; in Wireless mode, the
TLS, LEAP, and PEAP EAP types are available.
6. Use the following guidelines to configure the EAP Type option you selected:
•TLS - If you select the TLS option, click Properties to open and configure the
Authentication Properties dialog box (you can use Browse to find and select the
Client Certificate file and Private Key file you want). Note that the CA certificate
must be installed in the device.
•LEAP - If you select the LEAP option, click Properties to open and configure the
Authentication Properties dialog box (be sure to use the correct Username and
Password for authentication). Note that the maximum length for the username or
the password is 64 characters.
•PEAP - If you select the PEAP option, click Properties to open and configure the
Authentication Properties dialog box (be sure to select either EAP_GTC or
EAP_MSCHAPv2, and then use the correct Username, Password, and Domain, if
necessary, for authentication). To configure EAP-GTC, enter the username only,
and the password or PIN will be asked when authenticating. To configure
EAP-MSCHAPv2, enter the username, password, and domain (domain\username
in the username box is supported, but you must leave the domain box blank). Note
that the CA certificate must be installed in the device (the server certificate is forced
to be validated).
Page 75
Central Configuration: Automating Updates and Configurations69
7. In the Network Setup dialog box, select an Import From option (either USB Key -the
default - or File Server) to configure where a user can import a new certificate, click
Import, and then use the following guidelines to configure the option you selected:
·USB Key: Select a certificate and click OK to import it to local memory.
·File Server: Enter the path to the certificate, and then enter a username and
password.
8. (Wireless Networks Only) Click Wireless Setup to open the WirelessSetup dialog
box and use the following guidelines:
Tip
The on-board NIC is “favored” if a valid link is detected, and the USB wireless
will not be activated; otherwise, USB wireless becomes the system’s LAN, all
configured network settings apply to the wireless network, and the USB
wireless controls the NIC and functions such as the local Ethernet. Curr ently,
only the Action Tec USB wireless card is supported.
·Mode: Select either the Infrastructure or Ad Hoc option.
Infrastructure - Select Infrastructure for access point wireless networks in which
thin clients connect to access points as they move from place to place (for example,
from floor to floor) or require a new access point due to traffic congestion.
Ad Hoc - Select Ad Hoc for computer-to-computer wireless networks in which th in
clients connect to one another directly.
·SSID: Enter the name of the wireless network to which the thin client will connect
(32 characters maximum).
·Channel: Select a channel number from 1 to 14.
·Encryption: Select one of eight user-defined WEP/WPA keys.
·Algorithms: Select either Open or Shared Key for WEP encryption.
·Key: Depending on which WEP/WPA key you selected, use the following
guidelines:
None - Enter no characters.
WEP Key 1-4 - Enter 5 or 13 characters for the 64-bit or 128-bit encryption key, or
10 or 26 hex-decimal digits.
WPA_PSK or WPA2_PSK - Enter any value from 8 to 63 characters, or specify the
numbers as 128 hex-decimal digits.
WPA_Enterprise or WPA2_Enterprise - Enter no characters.
Page 76
70Appendix A
Configuring Session Services
Before you use the information in this section to configure your ICA and RDP session
services, be sure you understand and use the following guidelines:
•General Guidelines - Be aware of the following:
•The Thin-client session services are made available by servers hosting Citrix ICA
and Microsoft RDP software products.
•A browser must be available through one of the session services to access any
on-line help documentation for users.
•There can be more connections than desktop space to display them.
•Connections can be defined in persistent memory (with a statement reading
enablelocal=yes in the wnos.ini file). These connections can be displayed as
desktop icons only in Stand-alone mode with a Non-privileged user.
•Only the connections defined in an INI file and containing an icon= clause will be
displayed on the desktop (assuming there is adequate desktop space).
•Connections can be displayed on the desktop without requiring a sign-on (when
you define these connections in a wnos.ini file or whe n th e wno s. i ni file doe s not
contain a SignOn=yes statement).
•ICA Guidelines - Independent Computing Architecture (ICA) is a three-tier,
server-based computing technology that separates the logic of an application from its
user interface. The ICA client software installed on the thin client allows the user to
interact with the application GUI, while all of the application processes are executed on
the server. ICA connects to NT TSE, Windows Server 2003, or Windows Server 2008
Server hosts that have a Citrix MetaFrame server, Citrix Presentation server, or CDS
installed. Load balancing is included. ICA browsing or DNS can be used to resolve the
server name. For information on configuring ICA, refer to
Services." For detailed information on the supported parameters (in the INI files) that
you can use for ICA connections, refer to the Reference Guide: Wyse ThinOSTM INI
Files.
"Configuring ICA Session
Tip
The ICA server must be licensed from Citrix Systems, Inc. You must
purchase enough client licenses to support the total concurrent thin client
load placed on the Citrix server farm. A failure to connect when all client
seats are occupied does not represent a failure of Wyse equipment. The ICA
client software is installed on the thin client.
•RDP Guidelines - Remote Desktop Protocol (RDP), like ICA, is a network protocol that
allows a thin client to communicate with the Terminal Server or Windows 2003/2008
Server with Terminal Services over the network. This protocol is based on the T.120
protocol suite, an international standard multi-channel conferencing protocol. The thin
client supports both RDP version 4.x and version 5.x. For information on configuring
RDP, refer to
supported parameters (in the INI files) that you can use for RDP connections, refer to
the Reference Guide: Wyse ThinOS
"Configuring RDP Session Services." For detailed information on the
TM
INI Files.
Page 77
Central Configuration: Automating Updates and Configurations71
About Wyse TCX Software
Wyse® TCX Software™ provides an enrichment layer above ICA and RDP connections
that enable multiple monitor awareness, rich multimedia playback, high quality
bidirectional audio capabilities, and seamless USB device access for Wyse thin clients.
Wyse ThinOS has built-in support for the following Wyse TCX solutions (a license may be
required to activate a feature):
•Wyse® TCX Multi-Display™
•Wyse® TCX Multimedia™
•Wyse® TCX Rich Sound™
•Wyse® TCX USB Virtualizer™
•Wyse® TCX Flash Redirection™
For more information about Wyse TCX software and support platforms, visit
www.wyse.com/tcx
.
About Wyse Virtual Desktop Accelerator Software
Wyse® Virtual Desktop Accelerator (VDA) is a software product that, when used with
Wyse thin clients, provides an “accelerated” user experie nce on remote d esktop sessio ns
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 thin clients “feels” similar to a
non-accelerated session with a server located just a few hundred miles from your thin
clients.
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
Page 78
72Appendix A
Configuring ICA Session Services
Before you use the information in this section to configure your ICA session services, be
sure you have read "Configuring Session Services."
ICA session services can be made available on the network using either Windows 2003/
2008 Server with Terminal Services and one of the following installed:
•Citrix MetaFrame XP
•Citrix Presentation Server
Tip
If PNAgent/PNLite-published application services are to be made available to
the thin clients, refer to
installing Citrix MetaFrame XP.
When using the instructions accompanying these products to install them and make
sessions and applications available to the thin clients sharing the server environment, be
aware of the following:
•If a Windows 2003/2008 Server is used, a Terminal Services Client Access License
(TSCAL) server must also reside somewhere accessible on the network. The server
will grant a temporary (120-day) license on an individual device basis. Beyond the
temporary (120-day) license, you must purchase TSCALs and install them on the
TSCAL server (you will not be able to make a connection without a temporary or
permanent license).
•It is recommended that any ICA connection which traverses a Dial-up or WAN
connection have Lowband=yes set in the INI files or the Optimize for low speed link
option selected in the Connection Settings (ICA) dialog box.
•If an ICA connection is created using the Connect Manager and the Host Names or
Application Name text box is left blank, a message appears prompting the user to
enter the IP Address or Server Name of the ICA server to which to connect.
•An audio input port is available (Audio can be recorded).
"PNAgent/PNLite Installation Guidelines" when
PNAgent/PNLite Installation Guidelines
PNAgent/PNLite is a component of the Citrix XML publishing service. PNAgent/PNLite is
an ICA connection mode that enables the thin client to connect to applications available
(published) on an ICA server without having to configure connections for individual
published applications.
Use the following guidelines during installation:
•MetaFrame XP - Installing MetaFrame XP supports XML publishing services. During
installation, a series of prompts appear for you to follow. When you are prompted to
install the XML Publishing Service, be aware that clicking Yes to this option allows you
to change the default port (80) used by the service.
•Citrix Presentation Server - Installing Citrix Presentation Server supports XML
publishing services. During installation, a series of prompts appear for you to follow.
The port to be used for XML publishing services must be known for making appropriate
PNAgent/PNLite server location entries required by the operating mode (for related
information, refer to "Configuring DHCP (DHCP Options)," the Users Guide: Wyse
ThinOS
the Reference Guide: Wyse ThinOS
default port, but if a port other than 80 is used, the port number must be specified explicitly
with the PNAgent/PNLite server location in the form IP:port or name:port, where :port is
optional.
TM
(for locally configuring the thin client using the Network Setup dialog box) , and
TM
INI Files). The thin client uses port 80 as the
Page 79
Central Configuration: Automating Updates and Configurations73
Configuring RDP Session Services
Before you use the information in this section to configure your RDP session services, be
sure you have read "Configuring Session Services."
RDP session services can be made available on the network using any of the following:
•Windows 2003/2008 Server with Terminal Services installed
•Windows NT 4.0 Terminal Services (WTS) Edition
•Windows XP
When using the instructions accompanying these products to install them and make
sessions and applications available to the thin clients sharing the server environment, be
aware of the following:
•If a Windows 2003/2008 Server is used, a Terminal Services Client Access License
(TSCAL) server must also reside somewhere accessible on the network. The server
will grant a temporary (90-day) license on an individual device basis. Beyond the
temporary (90-day) license, you must purchase TSCALs and install them on the
TSCAL server (you will not be able to make a connection without a temporary or
permanent license).
•It is recommended that any RDP connection which traverses a Dial-up or WAN
connection have Lowband=yes set in the INI files or the Optimize for low speed link
option selected in the Connection Settings (RDP) dialog box.
•If an RDP connection is created using the Connect Manager and the Host Names or
Application Name text box is left blank, a message appears prompting the user to
enter the IP Address or Server Name of the RDP server to which to connect.
•Wyse ThinOS version 4.2 and later supports an RDP connection with no encryption
(found in older versions of Microsoft NT4-TSE servers).
•Wyse ThinOS version 4.2 and later supports server browsing over Server Message
Block (SMB) when defining an RDP connection. SMB browsing restrictions mean that
the server desired may not be listed, in which case the user will need to know either the
name or IP address of the targ et ser ver and en ter th at infor ma tion in to the te xt b ox ( as
it will not appear in the pull-down list).
Page 80
74Appendix A
This page intentionally blank.
Page 81
BRemote System Administration
This appendix provides remote system administration information to help you perform the
routine tasks needed to maintain your Wyse ThinOS environment.
It includes:
•"Using Wyse Device Manager Software For Remote Administration"
•"Updating Software"
•"Managing Icons and Logos"
•"Understanding and Using System Lockdown Operations"
•"Configuring Virtual Access Suite Support"
Using Wyse Device Manager Software For Remote Administration
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). Ordering information for WDM is available on the Wyse
Web site at: http://www.wyse.com/products/software/rapport
.
Updating Software
The software version is embedded in both the RAM and flash memory images. This
version information is used to compare the images on the FTP server to the
currently-loaded flash image on the thin client. A major revision number supersedes a
minor revision number when making the comparison. In turn the minor version number
takes precedence over the build number. The image names and date-time stamps
determine whether or not the update is newer than the version currently installed on the
thin client.
After obtaining software updates from Wyse, you must replace the existing software
images in the wnos subdirectory on the FTP server to allow the thin clients to
Tip
The code identifier is split into 4 parts, the major release identifier, the minor
release identifier, the build number identifier, and the sub-build number
identifier (if the sub-build number is 0, it will not be displayed). Each part is
compared against the current code internal identifier in the same format. If
the file identifier is greater , the update is performed. If th e file identifier is less,
the update is abandoned. If the file identifier is equal, the next term is
examined until the build identifiers are found to be equal and the update is
abandoned. This comparison process using the build number can be
important in cases where you are using a beta release, or in cases where
you need to reinstall a release with the same major and minor numbers but
with an updated build.
Page 82
76Appendix B
automatically detect and self-install the new software (upon thin client system start). The
FTP server address and exact path to these files are specified in DHCP Options 161 and
162 (if DHCP is not used, the path is specified in the Network Setup dialog box on the
thin client).
Each time a thin client boots, it checks the software images on the FTP server, and if
configured, automatically performs an update if a newer version is detected. Whether or
not an update is performed depends on the AutoLoad p arameter setting in the wnos.ini file
as described in the Reference Guide: Wyse ThinOS
Be aware that there is a significant distinction between using DHCP and not using DHCP
to access the various necessary files as follows:
•If DHCP is used, thin client software automatically inserts the path command /wyse
following what it receives from the DHCP server (unless the path is terminated by a $);
this is done only if a value is received from DHCP. The dollar sign character ($) acts as
a flag that notifies Wyse ThinOS that the absolute path has been given (that is, where it
expects to find Wyse ThinOS configuration files inside a “wnos” folder) instead of the
relative path (where it expects to find the general “wyse” configuration folder).
•If DHCP is not used and the configuration is done manually, the full path up to the wnos
component must be inserted; there is no automatic /wyse insertion and no $
processing.
•For users familiar with Wyse 3 series thin clients, the Wyse 3 series equipment does
processing on both DHCP and manual input, as well as $ processing (as $ is a legal
meta-character in manually entered strings). Wyse ThinOS software does not
recognize a $ terminator as a legal meta-character in a locally entered string.
TM
INI Files.
Tip
Citrix does not supply an ICA client for the Wyse thin client platforms. Citrix
ICA Auto-Update does not function for the ICA client installed on the thin
client; the ICA client is fully contained in the thin client system and can only
be updated by changing that entire system. The RDP client is also not
replaceable.
Caution
Interrupting power during the update process can corrupt the FLASH on the
thin client. Thin clients with corrupted FLASH must be shipped to Wyse for
service.
Tip
Note the following thin client update processes:
Model SX0: (Step 1) If called for, the thin client first searches in the wnos
directory for RCA_wnos. If this file exists with a different internally encoded
version number than the image currently in flash memory, and depending on
the wnos.ini file AutoLoad parameter setting, the thin client will load this
image into flash and reboot. (Step 2) The thin client will then (regardless of
any circumstance in step 1) check for a file named express.rom and begin
updates, if appropriate. If an update is done, the thin client will again reboot.
Model VX0: (Step 1) If called for, the thin client first searches in the wnos
directory for a file named VL10_wnos. If this file exists with a different
internally encoded version number than the image curr ently in flash memory,
and depending on the wnos.ini file AutoLoad parameter setting, the thin
client will load this image into flash and reboot. (Step 2) The thin client will
then (regardless of any circumstance in step 1) check for a file named
express.rom and begin updates if appropriate. If an update is done, the thin
client will again reboot.
Page 83
Remote System Administration77
Managing Icons and Logos
Icons and logos specified in the INI files must be placed in the file server /wnos/bitmap
subdirectory. Icons are specified in the Icon clause of the connection statement and logos
are specified in the FormURL statement. Supported image file types include .ico (icon),
.bmp (bitmap), .jpg (JPEG), and .gif(GIF). Color depth for logos can be up to 256 colors.
Color depth for icons can be 16 colors. It is recommended that .jpg format not be used for
desktop icons.
Use the following guidelines:
•Typical desktop icons are 64 x 48 pixels.
•Typical sign-on logos are 100 x 61 pixels, with transparent background.
•Maximum size for sign-on logos is 352 x 80 pixels (if smaller than this, it will be
positioned in the upper-left corner).
Understanding and Using System Lockdown Operations
Lockdown status for a thin client is set or removed using the LockDown clause of the
Privilege statement in the INI files. Lockdown establishes the default privilege level
following thin client boot and before any privilege statement is read from an INI file.
Access to many facilities is affected by the privilege level.
•Non-Lockdown Operation - For normal operation, Low-privileged and Non- privileged
users may access the Network Setup dialog box by temporarily disconnecting the
Ethernet cable from the thin client and rebooting to Stand-alone user mode. The
Network Setup dialog box can also be accessed after resetting the thin client to
factory defaults (by a G-key reset to factory default or using the Reset the system setting to factory defaults check box in the Sign-off/Shutdown window of any user
with sufficient privilege to the Sign-off/Shutdown window.
•Lockdown Operation - In most cases, access to the resources available when the
system is not locked down is desirable; however, network environments requiring
maximum security should not permit uncontrolled changes to thin client network
access. Most facilities would include a Privilege with LockDown statement in the
wnos.ini file and might override the privilege in a {username}.ini file without modifying
the lockdown privilege. Thus, an administrator could log into any unit and have
sufficient privilege to modify the configuration of that unit without altering the default
privilege at the next reboot.
Caution
If the unit is configured for Dial-up access, ther e mu st be an RAS serv er
answering the configured telephone number. Otherwise, the unit will require
factory attention to recover it.
Page 84
78Appendix B
Configuring Virtual Access Suite Support
This section explains how to support the Wyse ThinOS with Provision Networks Virtual
Access Suite (VAS). To support Wyse ThinOS with VAS, you must do the following:
•Download Wyse ThinOS firmware version 5.3.0_14 or later and store it on all
Connection Brokers under the WNOS directory (see
Firmware (VAS Support)” ).
•Download hotfix 5 for VAS 5.8 (Release 8) from the Provision Networks Web site and
install the hotfix on all Connection Brokers.
Installing the VAS Hotfix
Hotfix 5 for VAS 5.8 (Release 8) includes: PNCONSOLE.EXE (5.8.208.15),
PNBRKSVC.EXE (5.8.200.64), and sample INI files. After you download and install the
hotfix, set the DHCP server option tags 161 and 188 to the IP address(es) of the
Connection Broker(s) using the following syntax (see "Configuring DHCP"):
<protocol>://<iplist>:port>
•protocol: http or https. This parameter is optional. If omitted, http is automatically
used.
•iplist: The list of IP addresses corresponding to the Connection Brokers. The specified
IP addresses must be separated by commas or semicolons.
•port: The TCP port that the Connection Broker(s) is/are configured to listen on. This
parameter is optional. If omitted, ports 80 (http) and 443 (https) are automatically used.
“Updating the Wyse ThinOS
Tip
Option tag 161 is used to specify the servers from which the Wyse ThinOS
firmware updates can be downloaded to the thin client, while option tag 188
is used to specify VDI brokers. Because the VAS Connection Brokers are
capable of fulfilling both functions, option tags 161 and 188 may be
configured identically.
On each Connection Broker, the hotfix creates a directory named WYSE under the VAS
installation directory, a directory named WNOS under the WYSE directory, and two
directories named bitmap and ini under the WNOS directory., as follows:
The bitmap directory is used to store optional bitmap files (such as a corporate logo to be
displayed on the thin client desktop) referenced in a wnos.ini file.
The wnos.ini file in the WNOS directory contains various WYSE commands and
parameters. It is sent from the Connection Broker to the thin client upon boot-up. For
detailed information on wnos.ini files, refer to the Reference Guide: Wyse ThinOS
Files.
TM
INI
Page 85
Remote System Administration79
Enabling HTTP and HTTPS Support on the Connection Brokers (VAS Support)
The Connection Broker can be configured to accept http and https request s
simultaneously. To support https requests, however, you must first obtain a Web server
certificate for each Connection Broker.
Installing Connection Broker Web Server Certificates (VAS Support)
For https support, obtain a Web server certificate for each Connection Broker. You can
obtain a certificate issued by an external certificate authority (such as Microsoft Certificate
Server) or an external certificate authority (such as VeriSign or Entrust). After obtaining
the certificates, use the following guidelines to install each certificate:
1. Display the left-hand pane in the Provision Management Console.
2. Expand the Connection Brokers node.
3. Right-click the node corresponding to the Connection Broker.
4. On the General tab, click Configuration, and then click Server Certificate.
5. Select the desired certificate from the list for installation.
Configuring the Connection Broker HTTP and HTTPS Ports (VAS
Support)
To configure the Connection Broker http and https ports, use the following guidelines:
1. Display the left-hand pane In the Provision Management Console.
2. Expand the Servers node.
3. Right-click Connection Brokers and select Properties.
4. Select one or both protocol options (http and/or https).
5. Specify the corresponding TCP port numbers.
Warning
If IIS is installed on the same server, be sure to select non-conflicting TCP
ports.
Configuring {username}.ini Files and RDP Connection Parameters (VAS
Support)
After a user is successfully authenticated, the Connection Broker dynamically ge nerates a
user-specific configuration file named {username}.ini and sends it to the thin client. This
file is generated entirely in memory and contains a list of RDP connection parameters
referencing the authorized published desktop of the user.
The dynamically generated {username}.ini file contains the following list of mandatory
RDP connection parameters:
•Application: Name of published desktop
•Description: Description of published desktop
•Icon: The icon displayed on WYSE desktop
•Username: User account name
•Password: User password
•Domainname: Windows domain
Page 86
80Appendix B
To specify additional RDP connection parameters to the dynamically generated
{username}.ini file, you must configure a custom RDP. ini file under the WNOS directory
(for a list of optional RDP connection parameters that can be used, refer to the Reference
Guide: Wyse ThinOS
Connection Broker automatically merges its contents into the dynamically generated
{username}.ini after authenticating the user. The final {username}.ini file (containing the
merged parameters) is then sent to the thin client for use.
Tip
Optionally, additional parameters can be automatically appended to the
dynamically generated {username}.ini. To append additional parameters,
manually create {username}.ini files under the ini directory. If a manually
created {username}.ini file exists in the ini directory, the Connection Broker
merges its contents into the dynamically generated {username}.ini after
authenticating the user. The final {username}.ini file (containing the merged
parameters) is then sent to the thin client for use.
Updating the Wyse ThinOS Firmware (VAS Support)
To update the thin clients to the latest Wyse ThinOS firmware, obtain the latest Wyse
ThinOS firmware file (RCA_wnos) and store it in the WNOS directory. Upon rebooting the
thin clients, the firmware will be automatically updated, if necessary.
TM
INI Files). If an RDP. ini file exists under the WNOS directory, the
Option tag 161 must already be configured for the firmware update process to work (see
"Configuring DHCP").
Page 87
CLocal System Administration
This appendix provides local (at the thin client) system administration information to help
you perform the routine tasks needed to maintain your Wyse ThinOS envir onment.
It includes:
•"Resetting to Factory Defaults Using G-Key Reset"
•"Resetting to Factory Defaults Using Shutdown Reset"
•"Resetting Display Settings Using V-Key Reset"
•"Accessing Thin Client BIOS Settings"
•"Enabling a Disabled Network Setup Dialog Box"
•"Configuring ThinPrint"
Resetting to Factory Defaults Using G-Key Reset
High-privileged or Stand-alone users can reset the thin client to factory default settings
using the G-key reset feature.
To reset the thin client to factory default settings, restart the thin client and continuously
tap the G key during the restart process. G-key reset impacts all configuration items,
including, but not limited to, both network co nfig u ra tio n an d co nne c tio ns defi ne d in loca l
NV-RAM.
Tip
G-key reset is disabled for Low-privileged and Non-privileged users in
Lockdown mode.
Resetting to Factory Defaults Using Shutdown Reset
A High-privileged or Stand-alone user can reset the thin client to factory default settings
from the Sign-off/Shutdown window as follows:
1. Select either Shutdown and Restart the system or Shutdown the system.
2. Select the Reset the system setting to factory defaults check box.
3. Click OK.
Shutdown reset impacts all configuration items, including, but not limited to, both network
configuration and connections defined in local NV-RAM (Terminal name will not change).
Tip
Shutdown reset is disabled for Low-privileged and Non-privileged users,
regardless of lockdown state.
Page 88
82Appendix C
Resetting Display Settings Using V-Key Reset
If the display settings are inappropriate for the particular monitor that is connected, it is
possible that the display will not function properly when the thin client restarts. To correct
this, power-on the thin client while continuously ta pping th e V key. This will restart the thin
client with a display resolution of 640 x 480 pixels and a 60 Hz refresh rate.
Accessing Thin Client BIOS Settings
While starting a Wyse thin client you will see a Wyse logo for a short period of time. During
this start-up you can press Del to enter the BIOS of the thin client to make your
modifications (enter Fireport as the password).
Enabling a Disabled Network Setup Dialog Box
Although there are privileges and user modes associated with user access to thin client
resources, access to network setup (using the Network Setup dialog box) depends upon
privilege level. A Stand-alone user either is by default a user with High privilege or has a
thin client that is locked down. A Guest user has an implicit privilege of None and all
access is governed by that privilege. A PNAgent/PNLite-only user has whatever privilege
was set in the wnos.ini file at thin client boot, whatever privilege was locked down at the
last access of a wnos.ini file, or High privilege (by default).
If the Privilege parameter is set to Low or None in the INI files, the thin client Network Setup dialog box will be disabled (th e user cannot access i t). In such a case, there may be
occasion to access the Network Setup dialog box without wanting to change the INI files.
For example, an occasion when you need to change to another FTP or Virtual Desktop file
server or add to the PNAgent/PNLite servers list. To access the Network Setup dialog
box in such a case, disconnect the network cable and reboot the thin client to Stand-alone
user mode. The Network Setup dialog box displays after the thin client initializes and you
can then make the required entries (be sure to reconnect the network cable and reboot
when finished).
Caution
If a thin client accesses the enterprise intranet through Dial-up, PPPoE, or
PPTP VPN and the thin client is locked-down, a Non-privileged or
Low-privileged user attempting to reboot to Stand-alone User mode will
disable the Network Setup dialog box and System Reset capabilities. The
user will then be unable to re-access the enterprise intranet through this
path. If this happens, the thin client must be moved to a location where it can
access the enterprise intranet directly (Ethernet cable) and reboot so that
you as an administrator can make any required changes to the thin client
operating configurations (for example, set the INI files to unlock the thin
client).
If the thin client is configured for Dial-up access, there must be an RAS
server answering the configured telephone number. Otherwise, the thin client
will require factory attention to recover it.
Page 89
Local System Administration83
Configuring ThinPrint
No ThinPrint-specific configuration is available on the thin clients. Thus to be able to use
ThinPrint, users must first set up their printers according to the user documentation, and
then configure ThinPrint on the thin client (by clicking on the desktop background,
selecting System Setup from the menu to open the Network Setup dialog box, and then
clicking Printer to open and use the printer configurations).
Use the following guidelines:
•Use the Printer Identification field to enter a printer class (you can change the printer
name as needed).
•Printer IDs are assigned (depending on the physical port) as follows:
•COM1 = 1
•COM2 = 2
•LPT1 = 3 (USB printers are detected automatically on LPT1)
•LPT2 = 4
•LPD0 = 5 (The LPD Queue name is transmitted as the printer name; the Printer
Identification as class)
•LPD1 = 6 (The LPD Queue name is transmitted as the printer name; the Printer
Identification as class)
•LPD2 = 7 (The LPD Queue name is transmitted as the printer name; the Printer
Identification as class)
•LPD3 = 8 (The LPD Queue name is transmitted as the printer name; the Printer
Identification as class)
•SMB1 = 9 (In the form \\host\printershare)
•SMB2 = 10
•SMB3 = 11
•SMB4 = 12
To install the relevant ThinPrint product on the server use the following guidelines:
•Printer Object(s) Created Manually by the Administrator - After you install .print
Engine, create a printer object on the server to use the native driver and ThinPort as a
printer port. You can use any protocol (TCP, RDP, or ICA) because Wyse ThinOS has
.print clients for all of the protocols. The printer object needs to observe ThinPrint
naming conventions (for examp l e, HPLJ5#_:2, in which case print jobs will be sent to
the local printer that has ID number .2) by referring to .print client port ID. If no ID
number is present, the .print client sends the print job to the printer set as current.
•Printer Object(s) Created Automatically by ThinPrint AutoConnect - When using
ThinPrint AutoConnect, the thin client identifies with the thin client ID number 84 (and
thus is recognized as a thin client without a local spooler). You can also set up a
template on the server that uses a native driver (for example, HPLJ5) and ThinPort,
and then name this template as you want in the form _#AnyName. You can then make
sure that the rules (on ThinPrint Autoconnect [1]) have been set to assign the desired
local printers to use this server template. The assigned printer will then be shown in the
user session using the HPLJ5 driver and ThinPort; it will be named automatically
according to ThinPrint naming convention with the printer name from the client side
included. Alternatively, you can also define a template name according to the client
printer name (replace .AnyName. with printer name 4. and 5. above [for example, _#HP Laserjet 5]) so that the local printer object .HP Laserjet 5. will be mapped to this
template without any rules defined on the ThinPrint Autoconnect.