Xenith Admin Guide MAY2010

Administrators Guide
Wyse Xenith
® TM
Issue: 053110
PN: 883940-01 Rev. A
Copyright Notices
© 2010, Wyse Technology Inc. All rights reserved.
This manual and the software and firmware described in it are copyrighted. You may not reproduce, transmit,
transcribe, store in a retrieval system, or translate into any language or computer language, in any form or by any
means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise, any part of this publication
without express written permission.
End User License Agreement (“License”)

A copy of the Wyse Technology End User License Agreement is included in the software and provided for your
reference only. The License at http://www.wyse.com/license as of the purchase date is the controlling licensing
agreement. By copying, using, or installing the software or the product, you agree to be bound by those terms.
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.
Ordering Information
For availability, pricing, and ordering information in the United States and Canada, call 1-800-GET-WYSE
(1-800-438-9973) or visit us at http://www.wyse.com. In all other countries, contact your sales representative.
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.
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 zero 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 zero client and power adapter to ensure that
their voltages match.
Warning
Use of any other power adapter may damage your zero client or the power adapter. The damage
caused by an improper power adapter is not covered by warranty.
Battery Information
Wyse Xenith contains 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.
Warning
Perchlorate Materials – Special Handling May Be Required under California Code of Regulations,
title 22. (Only required within the U.S.A.)
This page intentionally blank.
Contents
1 Introduction 1
About this Guide 1
Finding the Information You Need in this Guide 1
Wyse Technical Support 2
Related Documentation and Services 2
Wyse Online Community 2
2 Prerequisites 3
Required: Citrix XenDesktop Server Environment 3
Recommended: Central Configuration 3
Set Up Auto-Detection of the XenDesktop Server 3
Set Up Automatic Updates 4
Adding DHCP Options #161 and #162 4
3 Getting Started 5
Logging On to Your Desktop 5
Using Your Desktop 7
Signing Off and Shutting Down 8
4 Notable Wyse Xenith Features 9

Logon Dialog Box Features 9
Wyse Xenith Toolbar Features 10
Using the List of Desktops 11
Editing Desktops 12
Manually Configuring Global Connection Settings 15
5 Configuring Connectivity Options 17

Network Setup 18
Remote Connections 24
Central Configuration 26
6 Configuring Local Settings Options 27

System Preferences 28
Display 30
Peripherals 32
Printer 34
7 Performing Diagnostics 39
System Tools 40
Network Tools 41
Using Ping 41
Using Trace Route 42
vi Contents
A Central Configuration: Automating Updates and Configurations 43

How to Set Up Automatic Updates and Configurations 43
Step 1: Preparing the Root Directory and Folder Structure on the File Server 44
Step 2: Direct Wyse Xenith to the File Server Using DHCP Options 44
Step 3: Reboot or Start Wyse Xenith 45
B Creating and Using xen.ini Files 47

Downloading and Using Sample INI Files 47
Rules and Recommendations for Constructing a xen.ini File 48
Parameters for a xen.ini File 49
C Using DHCP Options 57
D Troubleshooting and FAQs 61

Viewing System Information 61
Directing Wyse Xenith to the XenDesktop Broker Server URL 62
Changing Default Settings 62
Resetting to Factory Defaults Without Proper Central Configuration 63
About Wyse Device Manager (WDM) 63
Tables 65
1 Introduction
Wyse® Xenith™ is a zero client built for Citrix XenDesktop and represents an entirely new
approach to delivering virtual desktops. Wyse Xenith delivers a Citrix HDX™ experience
with zero delays, zero management, zero security risks and (almost) zero energy use.
Users will benefit from an instant-on, plug-n-play, high performance zero client while
administrators can have peace of mind knowing they have a virus immune, hands-off,
self-updating zero client deployed.
Tip
The Citrix Receiver for Wyse Xenith comes pre-cached into the zero client,
allowing you to gain access to your Citrix XenDesktop environment and the
HDX experience seconds after taking it out of the box. If your environment is
properly set up (see "Recommended: Central Configuration"), Wyse Xenith
will always check for updates to the Citrix Receiver for Wyse Xenith and
automatically update the locally cached copy.
About this Guide

This guide is intended for administrators of Wyse Xenith. It provides step-by-step
instructions to configure Wyse Xenith to establish a connection to a virtual desktop. It also
contains information on configuring Wyse Xenith settings locally (manually on Wyse
Xenith) and remotely (using INI files).
Finding the Information You Need in this Guide

You can use either the Search window or Find toolbar to locate a word, series of words, or
partial word in an active PDF document. For detailed information on using these features,
refer to the Help in your PDF reader.
2 Chapter 1
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 (on the
Wyse.com home page, go to Support | Knowledge Base | Home tab) or call Customer
Support at 1-800-800-WYSE (toll free in U.S. and Canada). Hours of operation are from
6:00 A.M. to 5:00 P.M. Pacific Time, Monday through Friday.
To access international support, visit http://www.wyse.com/global.
Related Documentation and Services

Wyse Xenith features can be found in the Fact Sheet available on the Wyse Web site. Go
to http://www.wyse.com/products, click the Wyse Zero Clients link, click the Wyse Xenith
link, and then click the Wyse Xenith Fact Sheet link.
Sample INI files are intended for administrators of Wyse Xenith. These files are available
from the Wyse Web site (go to http://www.wyse.com/manuals, search for sample.ini, click
the reference guide link for Wyse Xenith, and then click the sample ini link to open and use
the file download dialog box to save the self-extracting sample INI file to a folder you
want). These sample files are annotated to allow you to use them as a “starter set” (that
you can modify for your users needs) to quickly get your file server up and running. For
detailed steps, see "Downloading and Using Sample INI Files."
Reference Guide: Wyse® Xenith™ INI Files is intended for administrators of Wyse Xenith.
It provides the detailed information you need to help you understand and use the Wyse
Xenith INI files. It contains information on the different 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 Xenith INI files. It is available at:
http://www.wyse.com/manuals.
Wyse Thin Computing Software is available on the Wyse Web site at:
http://www.wyse.com/products/software.
Wyse Online Community

Wyse maintains an online community where users of our products can seek and exchange
information on user forums. Visit the Wyse Online Community forums at:
http://community.wyse.com/forums.
2 Prerequisites
To properly deliver a virtual XenDesktop environment to Wyse Xenith:
• A XenDesktop server environment is required (see "Required: Citrix XenDesktop
Server Environment")
• Central configuration is recommended (see "Recommended: Central Configuration").
Required: Citrix XenDesktop Server Environment

To deploy desktops to Wyse Xenith using the XenDesktop environment, a properly
configured Citrix XenDesktop 4.0 or later server environment is required. The XenDesktop
server delivers virtual desktops to Wyse Xenith, providing users a personalized desktop
each time they log on.
For detailed instructions on how to complete the installation of a XenDesktop server
environment, refer to the documentation provided by Citrix or to the Citrix Knowledge
Center at: http://support.citrix.com.
Recommended: Central Configuration

Central configuration allows your Wyse Xenith to automatically:
• Detect the XenDesktop Server (see "Set Up Auto-Detection of the XenDesktop
Server")
• Update itself (see "Set Up Automatic Updates")
Set Up Auto-Detection of the XenDesktop Server

Setting up a DHCP server to specify the XenDesktop Broker Server URL (DHCP Option
#181) allows a network connected Wyse Xenith to automatically detect the location of the
XenDesktop server where a user can log on and use their desktop. Without an automatic
detection set-up, an administrator must enter the address locally using the Remote
Connections dialog box (see "Remote Connections").
To add DHCP Option #181:
1. On your DHCP server, use the Predefined Options and Values dialog box to add a
DHCP Standard Option.
2. In the Option Type dialog box, enter the Name (for example, XenDesktop URL), Data
Type (String), Code (181), and Description (for example, Default XenDesktop).
3. Use the Scope Options dialog box to activate the option (select the 181 check box
and enter the String Value—IP Address of the server).
For detailed instructions on adding DHCP Option #181, refer to Wyse Knowledge Base
Solution #19575 (go to the Wyse Knowledge Base at http://www.wyse.com/kb and search
for 19575).
4 Chapter 2
Set Up Automatic Updates

Using DHCP (options 161 and 162) and Citrix DDC (Desktop Delivery Controller) to
implement INI files will enable you to automatically push firmware updates and any
desired default configuration to all Wyse Xeniths in your environment.
For Wyse Xenith to successfully access INI files and update itself from a file server, you
simply:
1. Set up a file server with the correct folder structure (where the INI files and other
update files are located). It is recommended to use Citrix DDC since it is already a Web
server. For details on setting up HTTP access (by adding a Wyse folder next to the
Citrix folder and activating the appropriate MIME Types) see "Central Configuration:
Automating Updates and Configurations."
2. Direct Wyse Xenith to the file server using DHCP (see "Adding DHCP Options #161
and #162").
3. Reboot or start your Wyse Xenith.
Tip
For details on these steps, see "Central Configuration: Automating Updates
and Configurations." For details on using INI files, see "Creating and Using
xen.ini Files."
Adding DHCP Options #161 and #162

2. In the Option Type dialog box, enter the Name (for example, Citrix Server), Data
Type (String), Code (161), and Description (for example, Citrix Server).
2. In the Option Type dialog box, enter the Name (for example, Server Starting Path),
Data Type (String), Code (162), and Description (for example, Server Starting Path).
For detailed instructions on adding DHCP Options #161 and #162, refer to Wyse
Knowledge Base Solution #16132 (go to the Wyse Knowledge Base at
http://www.wyse.com/kb and search for 16132).
3 Getting Started
Getting started includes:
• "Logging On to Your Desktop"
• "Using Your Desktop"
• "Signing Off and Shutting Down"
Logging On to Your Desktop

Usually, you will simply turn on a network connected Wyse Xenith and it will automatically
detect the location of the XenDesktop server where you can log on and use your desktop
(if you are set up for automatic detection, as described in "Recommended: Central
Configuration"). However, if you are not set up for automatic detection, you must enter the
XenDesktop Broker Server URL into a dialog box before you can log on.
1. Press the power button to turn on your Wyse Xenith to

see the XenDesktop Logon dialog box. Enter your User
name, Password, and Domain, and then click Log on.
After authentication is successful, your desktop is
presented for use (see "Using Your Desktop").
2. (Optional) If you do not see a Log on dialog box, you will

see a Notice! message (your environment is not set up
for Wyse Xenith to automatically detect the location of
your XenDesktop server).
Click OK.
6 Chapter 3
The Remote Connections dialog box appears.

Enter the XenDesktop Broker Server URL.
Click OK.
The Logon dialog box appears.

Enter the User name, Password, and Domain and click
Log on.
After authentication is successful, your desktop is
presented for use.
Tip
You only need to complete this URL configuration once (or after reboot to
factory defaults). After Wyse Xenith “knows” the location of your server, it
automatically connects to the server for logon when you start Wyse Xenith in
the future. For more details on using the Logon dialog box, see "Logon
Dialog Box Features."
Getting Started 7
Using Your Desktop

What you see after logging on to the XenDesktop server depends on the number of
desktops assigned to you and administrator configurations:
Users with a single desktop - will be automatically

connected to their desktop.
Users with multiple desktops - will see the Wyse Xenith

home screen and the Wyse Xenith Toolbar showing the
assigned list of desktops from which to select (see "Notable
Wyse Xenith Features").
To connect to a desktop, simply click on the desktop you
want from the list. To switch between desktops, click the
Connections icon on the Wyse Xenith Toolbar to open the
list available desktops, and then click the name of the
desktop you want. For more information on using the list of
desktops, see "Using the List of Desktops."
8 Chapter 3
Signing Off and Shutting Down

After closing all desktops, Wyse Xenith automatically returns to the Logon dialog box and
is ready for another user. You can also click the Shutdown button to open and use the
Shutdown dialog box.
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 xen.ini file (see "Creating
and Using xen.ini Files").
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 account Allows you to sign off from the current open account (the
Logon dialog box appears and is ready for another user).
Lock Terminal Locks Wyse Xenith from use until you log on again.
Shutdown the system Turns off Wyse Xenith.
Restart the system Logs off the user account (the Logon dialog box appears
after Wyse Xenith restarts).
Reset the system Appears for high-privileged users/administrators only. This

setting to factory option allows you to reset Wyse Xenith to factory defaults
default (see "Resetting to Factory Defaults Without Proper Central
Configuration").
4 Notable Wyse Xenith Features
This chapter includes information on:
• "Logon Dialog Box Features"
• "Wyse Xenith Toolbar Features"
• "Using the List of Desktops"
Logon Dialog Box Features

While the Logon dialog box allows you to log on to the server, it also allows you to:
• Obtain system information
• Shut down Wyse Xenith
• Configure Wyse Xenith settings
Use the following guidelines
• Sys Info - Click the Sys Info button to open the System Information dialog box and
view Wyse Xenith system information such as System Version, IP Address, information
on devices connected to your Wyse Xenith, event logs, and so on (see "Viewing
System Information").
• 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 defaults, and so on (see
"Signing Off and Shutting Down").
• Admin Mode - Click the Admin Mode button to configure various settings locally on
Wyse Xenith (not XenDesktop configurations). For example, you can choose to
manually configure the XenDesktop DDC URL (or override the URL that is centrally
defined by file servers) by using the Remote Connections dialog box as described in
"Remote Connections."
Tip
By default there is no password needed for Admin Mode button use. You
can password protect the Admin Mode button (to require logon credentials)
by using the AdminMode parameter in a xen.ini file (see "Creating and Using
xen.ini Files").
10 Chapter 4
Wyse Xenith Toolbar Features

The Wyse Xenith Toolbar usually appears at the left edge of the desktop. However,
depending 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
Connections Opens the list of available desktops (see "Using the List of
Desktops").
System Information Displays Wyse Xenith system information (see "Viewing

System Information").
System Settings Opens the System Settings menu to configure Wyse Xenith
system settings and perform diagnostics (see "Configuring
Connectivity Options," "Configuring Local Settings Options,"
and "Central Configuration: Automating Updates and
Configurations").
Shutdown Terminal Click the Shutdown Terminal icon to use the Shutdown
options available on Wyse Xenith (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 xen.ini file
(see "Parameters for a xen.ini File").
Notable Wyse Xenith Features 11
Using the List of Desktops

On the Wyse Xenith Toolbar, you can click the Connections icon to open your list of
assigned desktops (in some cases the list may contain only one desktop).
Use the following guidelines (depending on user privilege level, some options may not be
available for use):
Table 3 Desktop Options
Option What It Does
Name of the desktop Opens the desktop you want to use (all open desktops
display a blue icon to the left of the desktop name in the list).
Restart icon Restarts the connection to the desktop (useful when a

desktop is not functioning properly or you need to reboot the
desktop).
Quick Disconnect Closes the desktop (the Close icon is grayed out for
icon desktops that are not open).
Edit icon Opens the Edit Connections dialog box (see "Editing
Desktops") to change the connection options of the desktop.
Configuring Global If you do not use INI files to provide global connection
Connection Settings 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 desktops in the list
(see "Manually Configuring Global Connection Settings").
12 Chapter 4
Editing Desktops
If you want to edit the available connection, logon, and option settings for a desktop, you
can click the Edit icon to the right of the desktop name in the list of desktops to open and
use the Edit Desktops dialog box (depending on user privilege level, editing options may
not be available for use).
It is not recommended to change the default settings shown on the Connection tab. If you
wish to change connection settings and have them persist, it is recommended to use
Wyse Xenith INI files to provide configurations after each Wyse Xenith boot.
Caution
The encryption selection applies to the security of communications between
Wyse Xenith and the server only. It is independent of the security settings of
individual applications on the server. For example, most Web financial
transactions require Wyse Xenith to use 128-bit encryption. However,
transaction information could be exposed to a lower level of security if Wyse
Xenith encryption is not also set to 128 bits.
Use the following guidelines for 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 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.
Logon Mode - Select User-specified credentials, Smart Card, or Local User.
• 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.
14 Chapter 4
Use the following guidelines for the Options tab:

• Auto-connect to local devices - Select any options (Printers, USB, Smart Cards,
Sound, and Disks) to have Wyse Xenith automatically connect to the devices.
• Audio Quality - Select the option you want for audio quality. Be aware that higher
audio quality requires more bandwidth (to optimize for low-speed connections, reduce
the audio quality).
• 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 decreasing protocol-specific cache
size. Intended for a connection spanning a WAN link or using dialup.
• 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 Wyse Xenith upon
regaining connectivity. Session reliability is most relevant for wireless devices.
• Mouse queue timer - Specifies the default queue timer of a mouse event in a session
(in 1/100 of a second). It can be used to adjust the bandwidth of a network.
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 to open and use the Global
Connection Settings dialog box to configure settings that affect all of the desktops in the
list of desktops.
Tip
For information on configuring Wyse Xenith using INI files (recommended),
refer to "Creating and Using xen.ini Files." For information on configuring
Wyse Xenith locally using dialog boxes, refer to "Configuring Connectivity
Options" and "Configuring Local Settings Options."
Use the following guidelines:

• Settings common to all sessions - 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 VFAT File System only, be sure that the USB stick you 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 session mapping the USB
stick before removing the USB stick.
• Settings common to all ICA sessions - Select the check boxes you want for the
options that are available to all ICA sessions.
• Disk Mapping for all ICA Sessions -
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.
16 Chapter 4

5 Configuring Connectivity Options
To access Connectivity options, click the System Settings icon on the Wyse Xenith
Toolbar (administrators can also click the Admin Mode button on the Logon dialog box).
You can configure the following Connectivity options using Wyse Xenith 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 Wyse Xenith 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 Wyse Xeniths in your
environment (see "Central Configuration: Automating Updates and
Configurations").
18 Chapter 5
Network Setup
The Network Setup dialog box allows you to configure Wyse Xenith 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 on Wyse Xenith,
however, this mode may need to be negotiated through Auto-Detect.
• No local LAN, invoke PPPoE only - Select this option if Wyse Xenith will access a
network through a PPPoE connection.
• Dynamically allocated over DHCP/BOOTP - Selecting this option enables Wyse
Xenith 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
Configuring Connectivity Options 19
Default Gateway, whether specified through local configuration or through DHCP. Ask
the network administrator for this value.
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, Wyse Xenith can only address other systems on the same
subnet. Enter the address of the router that connects Wyse Xenith to the Internet. The
address must exist on the same subnet as Wyse Xenith 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.
20 Chapter 5
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 semicolon,
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, Wyse Xenith 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.

• 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
"Using 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:

• Enable IEEEE 802.1x authentication - Select this check box to enable this
authentication and activate the EAP Type list of options.
• EAP Type - 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 Wyse Xenith.
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.
22 Chapter 5
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 on Wyse Xenith (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 use 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 path 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 Wyse Xenith, be sure that the
corresponding entries are also be made on the enterprise access point.
• SSID - Enter the Service Set Identification (name of the wireless network) set up by the
network administrator for this wireless communication link (maximum is 32 characters).
• 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 Type - 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 Wyse Xenith.
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 on Wyse Xenith (the server certificate is forced to be validated).
24 Chapter 5
Remote Connections
The Remote Connections dialog box allows you to configure Wyse Xenith remote
connection settings such as broker server, visual, and general connection settings.
Use the following guidelines for the Broker Setup tab:

• XenDesktop Broker Server - IP address or host name. Locations can be supplied
through a xen.ini file if it is used. If DHCP is used, locations can be supplied through
DHCP. After making an entry, be sure to reboot Wyse Xenith to have the changes take
effect.
Tip
The broker supports both http and https, and depends on the XenDesktop
Broker server support. If http or https is not specified on the XenDesktop
Broker server, then http is used by default. If https is specified, the client side
must install a corresponding root certificate locally. For detailed instructions
on install a corresponding root certificate locally, refer to Wyse Knowledge
Base Solution #15508 (go to the Wyse Knowledge Base at
• Enable automatic reconnection at logon and Enable automatic reconnection

from button menu check boxes and options - Use these to further configure the
connection for automatic reconnection.
Use the Visual Experience tab options to configure the toolbar options and Connections
icon on the desktop.
Use the General Options tab options to select the action after you exit all open desktops
(by default, Wyse Xenith automatically returns to the Logon dialog box and is ready for
another user) and to set the default sign-on username and domain.
26 Chapter 5
Central Configuration
The Central Configuration dialog box allows you to configure Wyse Xenith central
connection settings such as file server and optional WDM 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 WDM is used. Locations can be
supplied through user profiles if user profiles are used. If DHCP is used, locations can
be supplied through DHCP.
6 Configuring Local Settings Options
To access Local Settings options, click the System Settings icon on the Wyse Xenith
Toolbar (administrators can also click the Admin Mode button on the Logon dialog box).
You can configure the following Local Settings options using Wyse Xenith dialog boxes
(depending on user privilege level, some options may not be available for use):
• "System Preferences"
• "Display"
• "Peripherals"
• "Printer"
Tip
While it is not recommended to use the Wyse Xenith 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 Wyse
Xeniths in your environment.
28 Chapter 6
System Preferences
The System Preference dialog box allows you to select personal preferences such as
screen saver, name, and time/date settings.

• 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 Wyse Xenith is left idle for the
specified idle time, the screen saver is initiated.
• Terminal Name - Allows entry of a name for Wyse Xenith. The default is a
14-character string composed of the letters WT followed by the Wyse Xenith 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 Wyse Xenith 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
Configuring Local Settings Options 29
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.
• 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 server(s) provide Wyse Xenith
time based on the settings of time zone and daylight saving information. If DHCP is
used, locations can be supplied through DHCP.
30 Chapter 6
Display
The Display dialog box allows you to select the resolution and refresh rate for the monitor
used with Wyse Xenith. It also allows you to configure the way two monitors display.

• Select best display setting on DDC monitor - If the monitor is VESA DDC2B
(Display Data Channel) compatible, selection of this option allows Wyse Xenith 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
Refresh rate list selections include:
60 Hz (default)
75 Hz
85 Hz
• 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:

• 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).
32 Chapter 6
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 represent 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)).
Table 4 Supported Keyboard Languages
Supported Keyboard Languages
Arabic (Saudi Arabia) Croatian Italian

Arabic (Iraq) Czech Italian (Swiss)
Arabic (Egypt) Danish Japanese
Arabic (Libya) Dutch Korean
Arabic (Algeria) Dutch (Belgian) Norwegian
Arabic (Morocco) English (Australian) Polish (214)
Arabic (Tunisia) English (3270 Australian) Polish Programmers
Arabic (Oman) English (New Zealand) Portuguese
Arabic (Yemen) English (United Kingdom) Portuguese (Brazil)
Arabic (Syria) English (United States) Romanian
Arabic (Jordan) Finnish Slovakian
Arabic (Lebanon) French (Belgian) Slovakian (Qwerty)
Arabic (Kuwait) French (Canadian) Slovenian
Arabic (U.A.E.) French (France) Spanish
Arabic (Bahrain) French (Swiss) Spanish (Mexican)
Arabic (Qatar) German Swedish
Brazilian German (IBM) Turkish
Canadian (Multilingual) German (Swiss) Turkish (QWERTY)
Chinese (Simplified) Greek U.S. International
Chinese (Traditional) Hungarian
• 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 Touch Screen tab to configure touch screens that are connected to Wyse Xenith
(USB). The tab is available (not grayed out) when Wyse Xenith 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.
34 Chapter 6
Printer
The Printer Setup dialog box allows configuration of network printers and local printers
that are connected to Wyse Xenith. Through its USB ports, Wyse Xenith can support
multiple printers. If more than one printer is to be used and another port is not available on
your Wyse Xenith 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
Technology. 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:
http://www.wyse.com/products/accessories/accessories.asp.
Use the following guidelines for the Ports tab:

• 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 (xen.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.
• Enable LPD service for the printer - Select this to make Wyse Xenith an LPD (Line
Printer Daemon) server for LPD printing requests from the network.
Tip
If Wyse Xenith is to be used as an LPD printer server, DHCP must not be
used and a static IP address must be assigned to Wyse Xenith (see “Network
Setup” for more details).
Use the following guidelines for the LPDs tab:

• Select LPD - Select the port you want from the list.
• Printer Name - Enter the printer name.
Text 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 (xen.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 printer. An IP
address can also be entered.
Tip
If the printer is attached to another Wyse Xenith on your network, the entry in
the LPD Hosts box is the name or address of that Wyse Xenith.
• 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 Wyse Xenith with the printer attached.
• Printer Class - Select the printer class from the list.

36 Chapter 6
Use the following guidelines for the SMBs tab:

• Select SMB - Select the SMB you want from the list.
• Printer Name - Enter the printer name.
Text 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 (xen.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 LPD service - Select this to make Wyse Xenith an LPD (Line Printer Daemon)
server for LPD printing requests from the network.

• 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.
The Help tab contains printer help information.

38 Chapter 6

7 Performing Diagnostics
To access Diagnostics options, click the System Settings icon on the Wyse Xenith
Toolbar (administrators can also click the Admin Mode button on the Logon dialog
box).You can use the following diagnostic tools:
• "System Tools"
• "Network Tools"
40 Chapter 7
System Tools
The System Tools dialog box allows you to configure Trace and Event log settings. It also
allows you to view xen.ini cached information for troubleshooting purposes.
Use the Trace and Event log options on the General tab to configure the settings you
want.
You can view xen.ini information on the Global INI tab.

Performing Diagnostics 41
Network Tools
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 Wyse Xenith and the ping destination). Generally, Ping and Trace Route are
used for system diagnostics by, or under the direction of, a network administrator.
Using Ping
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 network host. The host parameter
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 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
Tip
Not all network equipment will respond to ping packets, since this is a
common mechanism used in denial-of-service attacks. Lack of response
does not necessarily indicate that the target of the ping is unusable for other
purposes.
Use the following guidelines for the Ping tab:

• 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 statistics, and displays
a brief summary upon completing the calculation.
42 Chapter 7
• 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 Wyse Xenith 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.
Use the following guidelines for the Trace Route tab:

• 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 tracert command and leaves the Trace Route dialog box open
(so you can read the information posted in the data area).
A Central Configuration: Automating
Updates and Configurations
This appendix describes how to set up your environment to provide your Wyse Xenith with
automatic updates and configurations in three simple steps.
Tip
Wyse Xenith does not require device management software. It is configured
to obtain its IP address, as well as the location of firmware and configuration
instructions, from a DHCP server. However, you can use Wyse Device
Manager (WDM) for a more hands-on management of Wyse Xenith. For
information about configuring Wyse Xenith to communicate with a WDM
server, see the WDM related INI parameters in "Using DHCP Options."
How to Set Up Automatic Updates and Configurations

For Wyse Xenith to successfully access INI files and update itself from a file server, you
must set up the server with the correct folder structure (where the INI files and other
update files are located), direct Wyse Xenith to the file server, and then reboot or start
Wyse Xenith.
After DHCP and file servers are configured and available, Wyse Xenith checks (at each
boot up) to see whether or not any updates are available on a predefined file server
(DCHP Option #161specifies the file server URL, DCHP Option #162 specifies the root
path to the file server). If updates are available, the updates are automatically installed (for
example, Citrix Receiver for Wyse Xenith).
44 Appendix A
Step 1: Preparing the Root Directory and Folder Structure on the File Server
You can set up your file server on the Citrix DDC (recommended) or on a separate server.
Set up the following folder structure on your file server under the C:\inetpub\wwwroot
folder and place your xen.ini file and other necessary files inside the structure as noted
(this list describes the folder structure, starting with the root directory).
\wyse\ The root directory. It stores the wnos folder.
\wyse\wnos The main INI configuration folder. It stores the following:
• bitmap folder
• certs folder
• xen.ini file
\wyse\wnos\bitmap The folder where you can place custom images you plan to use.
\wyse\wnos\certs The folder where you can place the certificates that can be
imported to Wyse Xenith.
Note: Use the following INI parameters in the xen.ini file to
import the certificates:
• ImportCerts
• Certs
Be sure to create/activate the two required MIME Types (.ini and .) under IIS (on a per site
basis) to enable downloading. Also be sure your Web server can identify the file types
used by Wyse Xenith.
To create/activate .ini:
1. On your IIS server, use the File Types menu to add a New Type.
2. In the File Type dialog box, enter the Associated extension .ini and Content type
(MIME) text/plain.
3. Click OK to apply the settings.
To create/activate .ini:
1. On your IIS server, use the File Types menu to add a New Type.
2. In the File Type dialog box, enter the Associated extension . and Content type (MIME)
text/plain.
3. Click OK to apply the settings.
For detailed instructions on adding .ini and ., refer to Wyse Knowledge Base Solution
#15508 (go to the Wyse Knowledge Base at http://www.wyse.com/kb and search for
15508).
Step 2: Direct Wyse Xenith to the File Server Using DHCP Options
After you set up the folder structure and populate it with the correct files, you must then
direct Wyse Xenith to the location of the file server using DHCP.
Information about the server and root directory is obtained from the following DHCP
Options:
• 161 - The file server URL (full URL including the root path).
• 162 - Root path to the file server (ftp/http/https) (for backward compatibility).
• If no root path is defined, \wyse is assumed.
• If a root path is defined, the additional path will be appended to the URL supplied by
option 161.
Central Configuration: Automating Updates and Configurations 45
• 181 - The XenDesktop server URL (full URL including the root path). This can be an IP
Address or URL.
• 184 - (Optional) File server user name (to server specified in Option 161).
• 185 - (Optional) File server password (to server specified in Option 161).
Use the guidelines shown in Table 6 when creating and adding the DHCP Options you
need (see "Using DHCP Options").
Step 3: Reboot or Start Wyse Xenith

After you reboot or start Wyse Xenith, it will look in the defined root path for the latest
available image and update if necessary.
46 Appendix A

B Creating and Using xen.ini Files
This appendix contains the basic information you need to help you create and use the
xen.ini file that will provide your Wyse Xenith with automatic updates and configurations. It
contains information on the xen.ini file you will use and the rules and recommendations for
constructing the file. In addition, this appendix contains information on the Wyse Xenith
Sample INI files that you can download and modify to quickly get your file server up and
running for your Wyse Xenith environment.
Downloading and Using Sample INI Files

Wyse Xenith Sample INI files are available from Wyse and can be modified to suit the
individual connection profile needs for your users. These sample files are annotated to
allow you to use them as a “starter set” (that you can modify) to quickly get your file server
up and running.
To download and use the files:
1. From the file server machine on which you want to load the INI files for use, go to:
http://www.wyse.com/manuals.
2. On the Knowledge Base page, type sample.ini in the search box and click Go.
3. In the resulting solutions Title list, click the reference guide link for Wyse Xenith (for
example, Reference Guide - Wyse® Xenith™).
4. In the resulting attachments Name list, click the Sample INI link for the .exe file you
want (for example, Xenith_Sample_MAY2010.exe) to open and use the File
Download dialog box.
Tip
After downloading the self-extracting sample INI file to the file server you
want, double-click the Xen_Sample_May2010.ini file, and then modify the
file (using an ASCII text editor) as needed for your use. Be sure to rename
the sample file to xen.ini for use.
48 Appendix B
Rules and Recommendations for Constructing a xen.ini File

In general, xen.ini files follow currently accepted “standard” INI file formatting conventions.
xen.ini files consist of Wyse parameters. These parameters can be entered as necessary
for reference, but are not mandatory unless changes from defaults are required or the
parameter is noted as required in the tables. Every parameter has a name and a value
with the name appearing to the left of the equals sign (name=value). Number signs (#)
indicate the start of a comment. Comments can begin anywhere on a line. Everything
between the # and the End of Line is ignored. Along with these general formatting
conventions, use the following guidelines when constructing Wyse Xenith xen.ini files:
1. Use of Backslashes and White Spaces
Placing a backslash (\) at the end of a line indicates line continuation; that is, the
backslash means that the line and the following line are, for the purposes of reading
code, the same line. No white space can appear after the backslash; however, white
space between parameter entries must be maintained. Therefore, the line after a
backslash must either start with a space (not a tab) or concatenate with the first set of
characters from the previous line. To avoid confusion, starting each line with at least
one white space character is recommended. Starting all parameters at the left margin
and placing at least one leading space at the beginning of all continuation lines makes
an INI file easier to read.
2. Use of Blank Lines
Using blank lines is recommended for making code easier to read. The following
example is the suggested format for using blank lines:
AutoLoad=1
Vncprompt=0
deskcolor=”0 51 153”
TimeServer=cuckoo.nevada.edu \
timeformat=”12-hour format” \
DateFormat=”mm/dd/yyyy”
3. Use of Number Signs

As stated earlier, number signs (#) indicate the start of a comment. Comments can
begin anywhere on a line. Everything between the # and the End of Line is ignored.
4. Use of Quotation Marks
String parameters containing white spaces must be placed inside quotation marks (use
common-practice nesting rules). For example, the TimeFormat parameter contains a
space and requires quotation marks:
TimeServer=cuckoo.nevada.edu timeformat="12-hour format"
5. Use of List Separators

Use semicolons or commas for list separators. For example, a list of ICA browsers:
Pnliteserver=10.1.1.1;10.1.1.2;10.1.1.3
6. Use of Equivalent Parameter Values

For parameter values of type {0, 1}, the 0 indicates false or no, and the 1 indicates true
or yes, as applicable. The format {0, 1} is equivalent to, and can be used instead of, the
format {no, yes} for the parameters using these formats in the tables.
7. Use of the Home Directory
The home directory is the wnos subdirectory for the log-in. For example,
C:\inetpub\wwwroot\wyse\wnos (see "Step 1: Preparing the Root Directory and Folder
Structure on the File Server").
You can specify the username and password for file server access on the General tab
of the Central Configuration dialog box (see "Central Configuration"). If a file server
directive is processed, the same username and password already configured on Wyse
Xenith is usable for accessing files on the new file server.
Creating and Using xen.ini Files 49
Parameters for a xen.ini File

Table 5 contains the most commonly used parameters in a xen.ini file (for a full list of
parameters, refer to Reference Guide: Wyse® Xenith™ INI Files.).
Table 5 Parameters for a xen.ini file
Parameter Description
AddCertificate=filename Specifies a certificate file residing in the subfolder cacerts under the wnos
password={plain text password} folder to load on the nand flash device (on platforms with nand flash), or on
Password-enc={encrypted password} the memory. The length of the filename, including the trailing period and the
file extension, is limited to 64 characters.
This is required when configuring the Citrix Secure Gateway PNAgent
Interface (PNAgent/Lite servers) in the Network Setup dialog box. Adding
certificates are required if the user CSG environments use certificate agents
that are not covered by the built-in certificates. The certificates are used to
validate server identities by Wyse Xenith.
Supported files include .crt file on ICA CSG; .cer and .pfx in 802.1x.
password and Password-enc are used for .pfx files.
AdminMode={yes, no} Yes/no option to password protect the use of the Admin Mode button on the
[admin-username=encrypted_username] Logon dialog box to configure settings. Set to yes to require a username
[admin-password=encrypted_password] and password to use the Admin Mode button to configure settings.
[Username=username] Encrypted strings are used for admin-username and admin-password.
[Password=password]
AutoLoad=[0, 1, 2, 101, 102, 201, 202] Specifies the firmware update mode.
[PXE= {imaging}] 0 — Disable checking for image
1 — Enable firmware upgrade/downgrade (default)
2 — Enable upgrade only
101 — Enable firmware upgrade/downgrade process, but have a popup
message with OK and Cancel command buttons appearing before the
process; after the process, a completion message appears
102 — Enable upgrade only, but have a popup message box with OK/
Cancel button appear before the process; after the process, a completion
message appears
201 — Enable firmware upgrade/downgrade process, but have a popup
message with OK and Cancel command buttons appearing before the
process; after the process, a completion message appears
202 — Enable upgrade only, but have a popup message with OK and
Cancel command buttons appearing before the process; after the process,
a completion message appears
If PXE=imaging is specified, Wyse Xeniths that boot from PXE will flash the
image from the file server to the Wyse Xenith, otherwise the system runs in
a normal mode.
AutoSignoff={yes, no} Yes/no option to automatically sign-off a user when the last opened session
is closed.
Default is yes.
DesktopColorDepth={16, 32} DesktopColorDepth — Sets the desktop color to 16 or 32 bits.

Default is 32.
50 Appendix B
Table 5 Parameters for a xen.ini file , Continued
Device=audio Specifies the local Wyse Xenith audio volume.
[volume={high, middle, low} or {0-25}] volume=
[[mute={0, 1, 2}]
high — maximum volume
middle — medium volume (default)
low — minimum volume
Values of 0-25 provide more exact volume level.
mute=
0 — no mute (default)
1 — mutes audio
1 — mutes audio and system beep
Device=Wireless Device — Defines the wireless Ethernet device remotely and saves to the
[Mode={Infrastructure, AdHoc}] local NVRAM. Not all options are needed. For example, you can define
[SSID=ssid Channel={1-14}] Key1 to have a key of “k1” and leave out Key2 through Key4.
[WepKey={None, 1-4}] k1 to k4 are any real values of 5 to 13 characters or 10 to 26 Hex digits.
[Key1=k1]
Encrypted keys will overwrite unencrypted keys. Thus, if Key1 and Key1Enc
[Key2=k2]
are both configured, then Key1Enc will overwrite Key1.
[Key3=k3]
[Key4=k4] RoamSensitive — defines the sensitivity level of wireless roaming with
[Key1Enc=key1 encrypted] respect to launching the Roaming daemon:
[Key2Enc=key2 encrypted] high - signal lower than -60 dBm
[Key3Enc=key3 encrypted] medium - signal lower than -70 dBm
[Key4Enc=key4 encrypted] low - signal lower than -80dBm
[RoamSensitive={high, medium, low}] The RoamSensitive parameter is also used to enable wireless roaming. If it
[Algorithm={Open, SharedKey}] is not configured in the INI file, roaming will never be launched even if the
signal is lower than -80dbm, unless it totally loses a wireless signal.
Algorithm — specifies the authentication method of WEP between Wyse
Xenith and the access point. If set to Open, open authentication will be
selected. If set to ShareKey, shared key authentication will be selected.
DisableDomain={no, yes} Yes/no option to disable the drop-down domain list in the PNAgent/PNLite
Sign-on dialog box.
DomainList=List of NT domain names A list of domain names that will appear in the Logon dialog box as options to
help users in selecting the domain to sign-on to PNAgent/PNLite servers.
Once specified, it is saved in non-volatile memory.
NOTE: Be sure to enclose in quotation marks if spaces are included. For
example: DomainList=”North_America, SQA, test-domain”
Dualhead={no, yes} Dualhead — Yes/no option to support a dual-monitor display.

[Mainscreen={1, 2}] Mainscreen — Sets which screen is used as the main screen.
[Orientation={hort, vert}]
Orientation — Sets which style is used for display (hort means horizontal
and vert means vertical).
CAUTION: If Dualhead is changed to yes, the Wyse Xenith will require a
reboot to change the monitor display.
FileServer=List of {IP address, DNS FileServer — Specifies the FTP or Web (http://) server IP address or DNS
name} name that is entered into Wyse Xenith local setup (non-volatile memory);
[Username=username] Wyse Xenith immediately uses this server to access files.
[Password=password] Username — Specifies the username of the file server.
Password — Specifies the password of the file server.
NOTE: The target file server must support access using the same user
credentials used in the INI files.
MaxVNCD={no, yes} Yes/no option to enable VNC shadowing. Default value is yes which means
VNC shadowing is enabled. Note that only one VNC client session is
allowed.
PnliteServer=List of {IP address, DNS PnliteServer — Specifies the list of IP addresses or host names with
names, or URLs} optional TCP port number or URLs of Citrix servers/PNLite servers (by
[ReconnectAtLogon={0, 1, 2}] default the list is empty).
[AutoConnectList={*/ Each entry with optional port is specified as Name-or-IP:port, where :port is
appname1;appname2; optional; if not specified, port 80 is used as the default. If a port other than
appname3...}] 80 is used, the port number must be specified explicitly with the server
[timeout=5…300] location in the form IP:port or name:port. Once specified, it is saved in the
non-volatile memory.
The statement PNAgentServer and Web interface for Citrix MetaFrame
Server is equal to this statement.
NOTE: When Multifarm=yes, use # to separate failover servers, and use a
comma (,) or a semicolon (;) to separate servers that belong to different
farms.
ReconnectAtLogon — Specifies the reconnection function at log on.
0 — disables the option
1 — reconnects to disconnected sessions only
2 — reconnects to active and disconnected sessions
AutoConnectList — Specifies the PNA applications that will be automatically
launched when using PNA to sign on. If AutoConnectList=*, then all the
PNA applications will be automatically connected.
Timeout — Specifies the time (in seconds) a Wyse Xenith will try to
establish a connection before reporting that it is unreachable.
Printer={COM1, COM2, LPT1, LPT2} Printer — Specifies the local printer to configure.
[Name=name] [PrinterID=window_driver] Name — Specifies the name of the printer and is required.
[Class=classname]
PrinterID — If not specified, the default Generic/Text Only is used.
[Enabled={no, yes}]
[EnableLPD={no, yes}] Class — Used in ThinPrint print for TPAutoconnect (the ThinPrint
technology of mapping the printer from the client side). It can group printers
to use the same template on the ThinPrint server side. The strings PCL5,
PS, and TXT are pre-defined classes. Class can be a string with 7
characters.
Enabled — Yes/no option to enable the printer.
EnableLPD — Yes/no option to enable the LPD service.
NOTE: The parameters must be specified in the order shown.
52 Appendix B
Printer={LPD1, LPD2, LPD3, LPD4} Printer — Specifies the LPD printer to configure.
[LocalName=name] LocalName — Specifies the name of the printer. If LocalName is not
[Host= host] specified, the Queue name is used.
[Queue=queue]
Host — Specifies the host name of the printer.
[PrinterID=window_driver]
[Class=classname] Queue — Specifies the queue name of the printer.
[Enabled={no, yes}] PrinterID — Specifies the windows driver to use for the printer. If not
specified, the default Generic/Text Only is used.
Class — Used in ThinPrint print for TPAutoconnect (the ThinPrint
technology of mapping the printer from the client side). It can group printers
characters.
These settings in a xen.ini file will be saved into NVRAM if EnableLocal=yes
is set in the xen.ini file.
NOTE: The parameters must be specified in the order shown. For backward
compatibility, LPD is accepted as LPD1.
Printer={SMB1, SMB2, SMB3, SMB4} Printer — Specifies the shared Microsoft network printer to configure.
[LocalName=name] LocalName — Specifies the name of the shared printer.
[Host=\[domain]\host]
Host — Specifies the host name of the shared printer specified as
[Name=share_name]
\domain\host when the host is configured within a Microsoft domain
[PrinterID=window_driver]
(otherwise, host can be specified as \\host).
[Class=classname]
[Enabled={no, yes}] Name — Specifies the shared name of the shared printer.
[EnableLPD={no, yes}] PrinterID — Specifies the windows driver to use for the printer. If not
[Username=username] specified, the default Generic/Text Only is used.
[Password=password] Class — Used in ThinPrint print for TPAutoconnect (the ThinPrint
[Domain=domain name] technology of mapping the printer from the client side). It can group printers
characters.
EnableLPD — Yes/no option to enable the LPD printer.
Username — Specifies the username of a user who can use the SMB
printer.
Password — Specifies the password of a user who can use the SMB printer.
Domain — Specifies the domain name of the SMB printer.
PRIVILEGE=[None, Low, High] Privilege controls operator privileges and access to Wyse Xenith resources.
[LockDown= {no, yes}] None — This level of access is typical for kiosk or other restricted-use
[HideSysInfo={no, yes}] deployment. The System Settings icon is disabled (the System Settings
[HidePPP={no, yes}] submenu cannot be displayed). The Connections icon is disabled by default
[EnableNetworkTest={no, yes}] (the Connections icon can be enabled (visible) by using the
[EnableTrace={no, yes}] toolbar_no_conmgr=yes option, however, the user cannot create a new
[ShowDisplaySettings={no, yes}] connection or edit an existing connection). The user cannot reset Wyse
[EnableKeyboardMouseSettings= Xenith to factory defaults.
{no, yes}] Low — This access level is assigned to a typical user. The Network Setup
[KeepDHCPRequestIP={no, yes}] selection on the System Settings submenu is disabled (the Network Setup
dialog box cannot be opened). The user cannot reset Wyse Xenith to factory
defaults.
High — Administrator access level allows all Wyse Xenith resources to be
available with no restrictions. A user can reset to factory defaults.
NOTE: If None or Low is used, the Network Setup dialog box is disabled. If it
is necessary to access this dialog box and the setting None or Low is not
saved into NVRAM, remove the network connector and reboot.
LockDown — Yes/no option to allow lockdown of Wyse Xenith. If yes is
specified, the system saves the privilege level in flash. If no is specified, the
system clears the privilege level from flash to the default unlocked state.
CAUTION: If Wyse Xenith is set to LockDown without a High privilege level,
it will disable the G key reset on power-up.
NOTE: LockDown can be used to set the default privilege of Wyse Xenith.
For example, if LockDown=yes, then the privilege is saved in permanent
registry; if LockDown=no, then the privilege level is set to the default high in
the permanent registry. That is, the system has a default high privilege level,
which is stored in the permanent registry; if you do not specify a privilege in
either the xen.ini file or the {username}.ini file or the network is unavailable,
the setting of LockDown will take effect. It can be modified by a clause. For
example, privilege=<none|low|high> lockdown=yes in a xen.ini file sets the
default privilege to the specified level.
HideSysInfo — Yes/no option to hide the System Information from view.
HidePPP — Yes/no option to hide the Dialup Manager, PPPoE Manager,
and PPTP Manager from view.
HidePN — Yes/no option to hide the PNAgent or PNLite icon from view on
the taskbar.
NOTE: EnableNetworkTest — Yes/no option to enable the Network Test.
EnableTrace — Yes/no option to enable trace functionality (active items are
added to the desktop right-click menu in Privilege=High level).
ShowDisplaySettings — Yes/no option to enable the Display Settings in a
popup menu.
EnableKeyboardMouseSettings — Yes/no option to enable the keyboard
and mouse configuration preferences.
KeepDHCPREquest — Yes/no option to keep the same IP address that is
requested from the DHCP server after a request fails and does not invoke
the Network Setup dialog box.
RapportServer=server_list RapportServer — Specifies a list of IP addresses or DNS names (separated

[Retry=retry number] by using a comma) for the WDM servers. Once specified, it is saved in
non-volatile memory.
Retry — Determines the number of attempts to retry a contact to WDM
servers.
54 Appendix B
Resolution=[DDC, 1024x768, Resolution — Specifies the local display resolution. Option DDC can be
1280x1024, 1600x1200] [Refresh=60, specified to select default display resolution.
75, 85}] Refresh — Specifies the local display refresh rate.
CAUTION: If the Resolution or Refresh parameter values are changed,
Wyse Xenith will reboot without notice to the user.
RootPath=file server root path This file server root path is entered into Wyse Xenith local setup
(non-volatile memory). Wyse Xenith immediately uses this path to access
files. The directory name \wnos will be appended to the file server root path
entry before use.
SysMode=vdi SysMode specifies the vdi GUI style and allows changes to the Wyse Xenith
[toolbardisablemouse={yes, no}] Toolbar preferences. If SysMode is set in xen.ini, it will be stored into
[toobarclick={yes, no}] NVRAM.
[toolbardelay={0-4}] toolbardisablemouse — By default, the toolbar is hidden until a user hovers
[toolbar_no_conmgr={yes, no}] their mouse over the left side of the screen. The toolbardisablemouse=yes
[toolbardisablehotkey={yes, no}] will disable this function.
toolbarclick — toolbarclick=yes will pop up a toolbar only when a user clicks
on the left side of the screen.
toolbardelay — toolbardelay={0-4} will specify the seconds of the toolbar
staying visible. The value 0 will have no delay. Other values 1-4 will delay
0.5, 1, 1.5 and 2 seconds respectively.
toolbar_no_conmgr — The toolbar_no_conmgr=yes will make the
Connections icon invisible.
toolbardisablehotkey — By default, pressing Ctrl+Alt+Up also pops up the
toolbar regardless of the settings of toolbarclick and toolbardelay.The
toolbardisablehotkey=yes will disable this function.
TerminalName=name TerminalName — Name of Wyse Xenith comprising a 15-character string.

[reboot={no, yes}] reboot — Yes/no option to reboot Wyse Xenith if the terminal name is
changed.
TimeServer=server_list TimeServer — Specifies the SNTP time servers to use for time retrieval.
[TimeFormat={“24-hour format”, TimeFormat — Specifies the time format to use.
“12-hour format”}]
DateFormat — Specifies the date format to use.
[DateFormat={yyyy/mm/dd, mm/dd/
yyyy, dd/mm/yyyy}] GetBiosDT — Yes/no option to obtain time from BIOS/CMOS when the
[GetBiosDT={no, yes, 0, 1}] timeserver is not available or cannot be contacted.
TimeZone=zone TimeZone — Specifies the time zone if the zone is unspecified on Wyse
[ManualOverride={no, yes}] Xenith or is used with ManualOverride. Supported zones are listed in the
[daylight={no, yes}] System Preference dialog box (for example: ‘GMT – 12:00’ to ‘GMT + 13:00’
[start=mmwwdd end=mmwwdd] at one hour increment, ‘GMT + 03:30’, ‘GMT + 04:30’, ‘GMT + 05:30’, ‘GMT
[TimeZoneName=timezonename] + 05:45’, ‘GMT + 06:30’, ‘GMT + 09:30’, ‘GMT – 3:30’ and ‘Greenwich Mean
[DayLightName=daylightname] Time’).
ManualOverride — Yes/no option to override the Wyse Xenith System
Preference Menu setting with this TimeZone setting. TimeZone settings in
the wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the
wnos.ini file.
Daylight — Yes/no option to enable daylight saving time; mmwwd is a 6 digit
number to specify the start and the end of daylight saving time sing the
following:
Mm – 01 to 12 for the month of the year from January to December. For
example, 01 is January.
Ww – 01 to 04 for the week of the month, 05 is the last week. For example,
01 is 1st week.
Dd – 01 to 07 for the day in the week from Monday to Sunday. For example,
01 is Monday.
TimeZoneName — Display name sent to the ICA/RDP session (such as
Eastern Standard Time).
DayLightName — Display name for daylight saving time. If daylight saving
time is enabled, DayLightName should be named something similar to
Eastern Daylight Time, otherwise it should be the same as TimeZoneName.
NOTE: To configure daylight saving time for an RDP session, you must
enable the Allow Time Zone Redirection function. Use the following
guidelines:
Run gpedit.msc to open the Group Policy dialog box. Click Computer
Configuration in the Local Computer Policy tree. Expand the
Administrative Templates folder. Expand the Windows Components
folder. Expand the Terminal Services folder. Click Client/Server data
redirection to open the Setting list. Right-click Allow Time Zone
Redirection and select Properties to open the Allow Time Zone
Redirection Properties dialog box. Select the Enabled option, and then
click OK. Close the Group Policy dialog box.
VncPassword=password [encrypt={no, VncPassword=password — Specifies a string of up to 16 bytes as the

yes}] password used for shadowing.
encrypt — Yes/no option to encrypt the password; an encrypted string is
used as a password (ensures US HIPPA and Congress Acts compliance).
VNCPrompt={no, yes} VNCPrompt — Yes/no option to enable a VNC shadowing prompt to a user
[{Accept, Reject}={10 to 600} (seconds)] (VNCPrompt set to yes means the user will always be prompted before
[ViewOnly={no, yes}] shadowing starts and the user will then decline or accept VNC shadowing;
[ActiveVisible={no, yes}] VNCPrompt set to no means the user will not be able to decline or accept
shadowing).
Accept, Reject — Specifies the amount of time (in seconds) a user has to
accept or reject the VNC shadowing prompt before the client desktop is
shadowed.
ViewOnly — Yes/no option to specify that the desktop being shadowed can
only be viewed by the person who is shadowing (no keyboard or mouse
events are allowed to interfere with Wyse Xenith being shadowed).
ActiveVisible — Yes/no option to display a VNC session-end notice after the
VNC session ends.
56 Appendix B

C Using DHCP Options
This appendix contains the DHCP options available for use.
Caution
Ensure that within the DHCP scope the new DHCP option tags you create
are activated (this can be done using the Scope Options dialog box on the
DHCP server (after you add them) or the Configure Options command
(before you add them).
Tip
For detailed instructions on adding DHCP Option #181, refer to Wyse
Knowledge Base Solution #19575 (go to the Wyse Knowledge Base at
For detailed instructions on adding DHCP Options #161 and #162, refer to
Wyse Knowledge Base Solution #16132 (go to the Wyse Knowledge Base at
Table 6 DHCP Options
Option Description Notes
1 Subnet Mask Required. However, it is not is not required unless

Wyse Xenith must interact with servers on a
different subnet (MS DHCP requires a subnet
mask and will always send one).
2 Time Offset Optional.
3 Router Optional, but recommended. It is not required

unless Wyse Xenith must interact with servers on
a different subnet.
6 Domain Name Server Optional, but recommended.

(DNS)
15 Domain Name Optional, but recommended. See Option 6.
28 Broadcast Address Optional.
44 WINS servers IP Optional.

Address
51 Lease Time Optional, but recommended.
52 Option Overload Optional.
53 DHCP Message Type Recommended.

58 Appendix C
Table 6 DHCP Options, Continued
54 DHCP Server IP Recommended.

Address
55 Parameter Request Sent by Wyse Xenith.

List
57 Maximum DHCP Optional (always sent by Wyse Xenith).

Message Size
58 T1 (renew) Time Optional, but recommended.
59 T2 (rebind) Time Optional, but recommended.
61 Client identifier Always sent.
161 File server (ftp/http/ Optional string. Can be either the name or the IP
https) address of the file 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 file server.
162 Root path to the file Optional string. If the option provided by the
server (ftp/http/https) server is blank and the server provides no value
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 can have 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 file user access 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 file server in use is
critical to ensuring proper operation. A secured
Windows server requires the slash be specified in
order to complete proper access.
181 XenDesktop URL Optional string. Wyse Xenith uses the

XenDesktop server to authenticate the credentials
of the user and to obtain a list of desktops valid for
the validated credentials. The user supplies those
credentials when logging in to the XenDesktop
server.
Using DHCP Options 59
Table 6 DHCP Options, Continued
182 NT domain list for Optional string. Wyse Xenith creates a pull-down
PNAgent/PNLite list of domains from the information supplied in
option 182. This list is presented at Wyse Xenith
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.
184 File server Username Optional string. Username to use when

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

authenticating to the server specified in Option
161.
186 Wyse Device Manager Optional binary IP addresses of WDM. This option
(WDM) server list can specify up to two Wyse Device Manager
servers. If two are specified, at boot time Wyse
Xenith 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.
190 WDM secure port Optional number. Word, or two-bytes array.

Specifies to use HTTPS to communicate with
WDM instead of HTTP.
60 Appendix C

D Troubleshooting and FAQs
This appendix contains troubleshooting and frequently asked questions relating to your
Wyse Xenith.
It includes the following topics:
• "Viewing System Information"
• "Directing Wyse Xenith to the XenDesktop Broker Server URL"
• "Changing Default Settings"
• "Resetting to Factory Defaults Without Proper Central Configuration"
• "About Wyse Device Manager (WDM)"
Viewing System Information

How do I view Wyse Xenith system information?
The following system information is available from the Wyse Xenith Toolbar (click the
System Information icon):
• 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 such as the CPU Speed, ROM Size, Monitor,
Ethernet Speed, Memory Speed, NAND Size, Current Resolution, and the Wyse Xenith
MAC Address.
• Copyright/Patents Tab - Displays the software copyright and patent notices.
• Event Log Tab - Displays Wyse Xenith 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 Time, Wireless performance-related parameters, Free Memory,
and DHCP lease time remaining.
62 Appendix D
Directing Wyse Xenith to the XenDesktop Broker Server URL

How can I direct Wyse Xenith to the XenDesktop Broker Server URL?
You can direct Wyse Xenith to the XenDesktop Broker Server URL:
• Automatically: You can set up a DHCP server to specify the XenDesktop Broker
Server URL (DHCP Option #181) to allow a network connected Wyse Xenith to
automatically detect the location of the XenDesktop server (see "Set Up
Auto-Detection of the XenDesktop Server").
• Manually: You can manually enter the XenDesktop Broker Server URL using the
Remote Connections dialog box (see "Remote Connections").
The Remote Connections dialog box is available:
• After you click OK in the XenDesktop Environment Could Not be Detected
message.
• When using the Admin Mode button as described in "Logon Dialog Box Features."
• After a reboot to factory defaults as described in "Resetting to Factory Defaults
Without Proper Central Configuration."
Changing Default Settings

How do I change the Wyse Xenith default settings?
To change default settings, you can:
• Use the Admin Mode button as described in "Logon Dialog Box Features."
• Use the System Settings icon as described in "Configuring Connectivity Options" and
"Configuring Local Settings Options."
Troubleshooting and FAQs 63
Resetting to Factory Defaults Without Proper Central Configuration

What happens when I reset Wyse Xenith to factory defaults without proper central
configuration?
Depending on your environment, you must complete one of the following to reset Wyse
Xenith to factory defaults:
• If you have DHCP server but do not have it configured to direct you to the
XenDesktop server - When you reset to factory defaults in this environment, the
Remote Connections dialog box will appear and you must enter the XenDesktop
Broker Server URL to direct Wyse Xenith to the XenDesktop server (see "Remote
Connections").
• If you are resetting to factory defaults in a secure environment without a DHCP
server - When you reset to factory defaults in this environment, the Network Setup
dialog box will appear and you must complete the necessary information for your
environment using a static IP Address for Wyse Xenith (see "Network Setup"). After
completing the Network Setup dialog box, click OK and the Remote Connections
dialog box will appear. You must enter the XenDesktop Broker Server URL to direct
Wyse Xenith to the XenDesktop server (see "Remote Connections").
About Wyse Device Manager (WDM)

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

Tables
1 Shutdown dialog box options 8
2 Toolbar icons 10
3 Desktop Options 11
4 Supported Keyboard Languages 32
5 Parameters for a xen.ini file 49
6 DHCP Options 57
Administrators Guide
Wyse® XenithTM
Issue: 053110
Written and published by:

Wyse Technology Inc., May 2010
Created using FrameMaker® and Acrobat®

Xenith Admin Guide MAY2010

Enviado por

Dados do documento

Descrição original:

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Xenith Admin Guide MAY2010

Enviado por

Direitos autorais:

Formatos disponíveis

Administrators Guide

End User License Agreement (“License”)

Restricted Rights Legend

Basic EMC and Safety Requirements

Canadian DOC Notices

Device Power Supply

4 Notable Wyse Xenith Features 9

5 Configuring Connectivity Options 17

6 Configuring Local Settings Options 27

A Central Configuration: Automating Updates and Configurations 43

B Creating and Using xen.ini Files 47

C Using DHCP Options 57

D Troubleshooting and FAQs 61

About this Guide

Finding the Information You Need in this Guide

Wyse Technical Support

Related Documentation and Services

Wyse Online Community

Required: Citrix XenDesktop Server Environment

Recommended: Central Configuration

Set Up Auto-Detection of the XenDesktop Server

Set Up Automatic Updates

Adding DHCP Options #161 and #162

Logging On to Your Desktop

1. Press the power button to turn on your Wyse Xenith to

2. (Optional) If you do not see a Log on dialog box, you will

The Remote Connections dialog box appears.

The Logon dialog box appears.

Using Your Desktop

Users with a single desktop - will be automatically

Users with multiple desktops - will see the Wyse Xenith

Signing Off and Shutting Down

Table 1 Shutdown dialog box options

Option What It Does

Shutdown the system Turns off Wyse Xenith.

Reset the system Appears for high-privileged users/administrators only. This

Logon Dialog Box Features

Wyse Xenith Toolbar Features

Table 2 Toolbar icons

Icon What It Does

System Information Displays Wyse Xenith system information (see "Viewing

Using the List of Desktops

Table 3 Desktop Options

Option What It Does

Restart icon Restarts the connection to the desktop (useful when a

Use the following guidelines for the Logon tab:

Use the following guidelines for the Options tab:

Manually Configuring Global Connection Settings

Use the following guidelines:

This page intentionally blank.

Use the following guidelines for the General tab:

Use the following guidelines for the Name Servers tab:

Use the following guidelines for the Options tab:

Use the following guidelines for the Security tab:

Use the following guidelines for the Wireless tab:

WPA-Personal and WPA2-Personal - Wi-Fi Protected Access (WPA and WPA2)

Use the following guidelines for the Broker Setup tab:

• Enable automatic reconnection at logon and Enable automatic reconnection

Use the following guidelines:

Use the following guidelines for the General tab:

Use the following guidelines for the Time/Date tab:

Use the following guidelines for the General tab:

Use the following guidelines for the Dual Head tab: