xenith admin guide may2010

Administrators GuideWyse® XenithTM

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.

TrademarksThe Wyse logo and Wyse are trademarks of Wyse Technology Inc. Other product names mentioned herein are for identification purposes only and may be trademarks and/or registered trademarks of their respective companies. Specifications subject to change without notice.

PatentsThis 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 LegendYou acknowledge that the Software is of U.S. origin. You agree to comply with all applicable international and national laws that apply to the Software, including the U.S. Export Administration Regulations, as well as end-user, end-use and country destination restrictions issued by U.S. and other governments. For additional information on exporting the Software, see http://www.microsoft.com/exporting.

Ordering InformationFor availability, pricing, and ordering information in the United States and Canada, call 1-800-GET-WYSE (1-800-438-9973) or visit us at http://www.wyse.com. In all other countries, contact your sales representative.

FCC StatementThis 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.

CautionModifications made to the product, unless expressly approved by Wyse Technology, could void the user’s authority to operate the equipment.

http://www.wyse.com/license

http://www.microsoft.com/exporting

http://www.wyse.com/

Regulatory Compliance for Thin Clients

Basic EMC and Safety RequirementsWyse 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 NoticesClass 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 SupplyUse 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.

WarningUse 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 InformationWyse 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.

WarningThere 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.

WarningPerchlorate Materials – Special Handling May Be Required under California Code of Regulations, title 22. (Only required within the U.S.A.)

http://www.wyse.com/serviceandsupport/service/service.asp

This page intentionally blank.

Contents

1 Introduction 1About this Guide 1

Finding the Information You Need in this Guide 1Wyse Technical Support 2

Related Documentation and Services 2Wyse Online Community 2

2 Prerequisites 3Required: Citrix XenDesktop Server Environment 3Recommended: Central Configuration 3

Set Up Auto-Detection of the XenDesktop Server 3Set Up Automatic Updates 4

Adding DHCP Options #161 and #162 4

3 Getting Started 5Logging On to Your Desktop 5Using Your Desktop 7Signing Off and Shutting Down 8

4 Notable Wyse Xenith Features 9Logon Dialog Box Features 9Wyse Xenith Toolbar Features 10Using the List of Desktops 11

Editing Desktops 12Manually Configuring Global Connection Settings 15

5 Configuring Connectivity Options 17Network Setup 18Remote Connections 24Central Configuration 26

6 Configuring Local Settings Options 27System Preferences 28Display 30Peripherals 32Printer 34

7 Performing Diagnostics 39System Tools 40Network Tools 41

Using Ping 41Using Trace Route 42

vi Contents

A Central Configuration: Automating Updates and Configurations 43How to Set Up Automatic Updates and Configurations 43

Step 1: Preparing the Root Directory and Folder Structure on the File Server 44Step 2: Direct Wyse Xenith to the File Server Using DHCP Options 44Step 3: Reboot or Start Wyse Xenith 45

B Creating and Using xen.ini Files 47Downloading and Using Sample INI Files 47Rules and Recommendations for Constructing a xen.ini File 48Parameters for a xen.ini File 49

C Using DHCP Options 57

D Troubleshooting and FAQs 61Viewing System Information 61Directing Wyse Xenith to the XenDesktop Broker Server URL 62Changing Default Settings 62Resetting to Factory Defaults Without Proper Central Configuration 63About 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.

TipThe 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 GuideThis 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 GuideYou can use either the Search window or Find toolbar to locate a word, series of words, or partial word in an active PDF document. For detailed information on using these features, refer to the Help in your PDF reader.

2 Chapter 1

Wyse Technical SupportTo access Wyse technical resources, visit http://www.wyse.com/support. If you still have questions, you can submit your questions using the Wyse Self-Service Center (on the Wyse.com home page, go to Support | Knowledge Base | Home tab) or call Customer Support at 1-800-800-WYSE (toll free in U.S. and Canada). Hours of operation are from 6:00 A.M. to 5:00 P.M. Pacific Time, Monday through Friday.

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

Related Documentation and ServicesWyse 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 CommunityWyse maintains an online community where users of our products can seek and exchange information on user forums. Visit the Wyse Online Community forums at: http://community.wyse.com/forums.

http://www.wyse.com/manuals

http://www.wyse.com/support

http://www.wyse.com/products


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

http://www.wyse.com/global

http://community.wyse.com/forums


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

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 EnvironmentTo 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 ConfigurationCentral 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 ServerSetting 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).

http://support.citrix.com

http://www.wyse.com/kb


4 Chapter 2

Set Up Automatic UpdatesUsing 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.

TipFor 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 #162To add DHCP Option #161:


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).


To add DHCP Option #162:


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 DesktopUsually, 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

TipYou 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."

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.

Getting Started 7

Using Your DesktopWhat 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 DownAfter 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.

TipYou 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 setting to factory default

Appears for high-privileged users/administrators only. This option allows you to reset Wyse Xenith to factory defaults (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 FeaturesWhile 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."

TipBy 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 FeaturesThe 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).

TipAdministrators 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").

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.

Notable Wyse Xenith Features 11

Using the List of DesktopsOn 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 icon

Closes the desktop (the Close icon is grayed out for 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 Connection Settings

If you do not use INI files to provide global connection settings, you can click Global Connection Settings to open and use the Global Connection Settings dialog box to configure settings that affect all of the desktops in the list (see "Manually Configuring Global Connection Settings").

12 Chapter 4

Editing DesktopsIf 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.

CautionThe 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 SettingsIf 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.

TipFor 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).

TipICA 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"

TipWhile 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 SetupThe Network Setup dialog box allows you to configure Wyse Xenith network settings.

TipIf 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.

TipThe 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.

TipYou 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.

TipYou may enter two WINS Server addresses (primary and secondary), separated by a semicolon, comma, or space.


Use the following guidelines for the Options tab:• DHCP Option IDs - Enter the supported DHCP options (each value can only be used

once and must be between 128 and 254). For information on DHCP options, refer to "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:

TipWhile 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 ConnectionsThe 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.

TipThe 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 http://www.wyse.com/kb and search for 15508).

• 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 ConfigurationThe 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"

TipWhile 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 PreferencesThe System Preference dialog box allows you to select personal preferences such as screen saver, name, and time/date settings.

Use the following guidelines for the General tab:• Screen Saver - Allows you to select the type of screen saver you want. The default is

to Turn Off Screen. Other selections available include Flying Bubbles and Moving Image (which are screen savers with the monitor remaining on).

• Timer - Select a time after which the screen saver is to be activated (either 1 minute, 5 minutes, 10 minutes or default is 20 minutes). When 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.

Use the following guidelines for the General tab:• Select best display setting on DDC monitor - If the monitor is VESA DDC2B

(Display Data Channel) compatible, selection of this option allows 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)).

• 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.

Table 4 Supported Keyboard Languages

Supported Keyboard Languages

Arabic (Saudi Arabia) Arabic (Iraq) Arabic (Egypt) Arabic (Libya) Arabic (Algeria) Arabic (Morocco) Arabic (Tunisia) Arabic (Oman) Arabic (Yemen) Arabic (Syria) Arabic (Jordan) Arabic (Lebanon) Arabic (Kuwait) Arabic (U.A.E.) Arabic (Bahrain) Arabic (Qatar) Brazilian Canadian (Multilingual) Chinese (Simplified) Chinese (Traditional)

Croatian Czech Danish Dutch Dutch (Belgian) English (Australian) English (3270 Australian) English (New Zealand) English (United Kingdom) English (United States) Finnish French (Belgian) French (Canadian) French (France) French (Swiss) German German (IBM) German (Swiss) Greek Hungarian

Italian Italian (Swiss) Japanese Korean Norwegian Polish (214) Polish Programmers Portuguese Portuguese (Brazil) Romanian Slovakian Slovakian (Qwerty) Slovenian Spanish Spanish (Mexican) Swedish Turkish Turkish (QWERTY) U.S. International


• 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.

TipIf 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).

TipMost 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.

http://www.wyse.com/products/accessories/accessories.asp


• 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.

TipIf 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.• Printer Identification - Enter the type or model of the printer. This name should be

either the device driver name for the printer under the Microsoft Windows system, or a key to map to the device driver. If not specified, the name will be defaulted to the printer-supplied identification for standard direct-connected USB printers or Generic / Text for non-USB connected printers upon connection to Windows hosts. The driver name mapping takes place either 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.

TipIf 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.

TipThe 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.• Enable the printer device - Must be selected to enable the directly-connected printer.

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.• Printer Identification - Enter the type or model of the printer. This name should be

either the device driver name for the printer under the Microsoft Windows system, or a key to map to the device driver. If not specified, the name will be defaulted to the printer-supplied identification for standard direct-connected USB printers or Generic / Text for non-USB connected printers upon connection to Windows hosts. The driver name mapping takes place either 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 the printer device - Must be selected to enable the directly-connected printer.• Enable LPD service - Select this to make Wyse Xenith an LPD (Line Printer Daemon)

server for LPD printing requests from the network.


Use the following guidelines for the Options tab:• Default Printer - Select the printer you want to be the default printer from the list.• Enable .print Client and Port - If you want to enable .print Client, select Enable .print

Client and then enter the Port.

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 ToolsThe 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 ToolsThe 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 PingThe 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

TipNot 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 RouteThe 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 ConfigurationsThis appendix describes how to set up your environment to provide your Wyse Xenith with automatic updates and configurations in three simple steps.

TipWyse 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 ConfigurationsFor 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 ServerYou 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).

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 OptionsAfter 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.

\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



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 XenithAfter 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 FilesWyse 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.

TipAfter 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 FileIn 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 FileTable 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=filenamepassword={plain text password}Password-enc={encrypted password}

Specifies a certificate file residing in the subfolder cacerts under the wnos folder to load on the nand flash device (on platforms with nand flash), or on 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}[admin-username=encrypted_username][admin-password=encrypted_password][Username=username][Password=password]

Yes/no option to password protect the use of the Admin Mode button on the Logon dialog box to configure settings. Set to yes to require a username and password to use the Admin Mode button to configure settings.Encrypted strings are used for admin-username and admin-password.

AutoLoad=[0, 1, 2, 101, 102, 201, 202][PXE= {imaging}]

Specifies the firmware update mode.0 — Disable checking for image1 — Enable firmware upgrade/downgrade (default)2 — Enable upgrade only101 — 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 appears102 — Enable upgrade only, but have a popup message box with OK/Cancel button appear before the process; after the process, a completion message appears201 — 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 appears202 — Enable upgrade only, but have a popup message with OK and Cancel command buttons appearing before the process; after the process, a completion message appearsIf 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

Device=audio[volume={high, middle, low} or {0-25}][[mute={0, 1, 2}]

Specifies the local Wyse Xenith audio volume.volume=high — maximum volumemiddle — medium volume (default)low — minimum volumeValues of 0-25 provide more exact volume level.mute=0 — no mute (default)1 — mutes audio 1 — mutes audio and system beep

Device=Wireless[Mode={Infrastructure, AdHoc}][SSID=ssid Channel={1-14}] [WepKey={None, 1-4}][Key1=k1][Key2=k2][Key3=k3][Key4=k4][Key1Enc=key1 encrypted][Key2Enc=key2 encrypted][Key3Enc=key3 encrypted][Key4Enc=key4 encrypted][RoamSensitive={high, medium, low}][Algorithm={Open, SharedKey}]

Device — Defines the wireless Ethernet device remotely and saves to the local NVRAM. Not all options are needed. For example, you can define Key1 to have a key of “k1” and leave out Key2 through Key4.k1 to k4 are any real values of 5 to 13 characters or 10 to 26 Hex digits.Encrypted keys will overwrite unencrypted keys. Thus, if Key1 and Key1Enc are both configured, then Key1Enc will overwrite Key1.RoamSensitive — defines the sensitivity level of wireless roaming with respect to launching the Roaming daemon: high - signal lower than -60 dBm medium - signal lower than -70 dBm low - signal lower than -80dBmThe RoamSensitive parameter is also used to enable wireless roaming. If it 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}[Mainscreen={1, 2}][Orientation={hort, vert}]

Dualhead — Yes/no option to support a dual-monitor display.Mainscreen — Sets which screen is used as the main screen.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 name}[Username=username][Password=password]

FileServer — Specifies the FTP or Web (http://) server IP address or DNS name that is entered into Wyse Xenith local setup (non-volatile memory); Wyse Xenith immediately uses this server to access files.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.

Table 5 Parameters for a xen.ini file , Continued



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 names, or URLs} [ReconnectAtLogon={0, 1, 2}][AutoConnectList={*/appname1;appname2; appname3...}][timeout=5…300]

PnliteServer — Specifies the list of IP addresses or host names with optional TCP port number or URLs of Citrix servers/PNLite servers (by default the list is empty).Each entry with optional port is specified as Name-or-IP:port, where :port is optional; if not specified, port 80 is used as the default. If a port other than 80 is used, the port number must be specified explicitly with the server 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 option1 — reconnects to disconnected sessions only2 — reconnects to active and disconnected sessionsAutoConnectList — 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} [Name=name] [PrinterID=window_driver] [Class=classname][Enabled={no, yes}] [EnableLPD={no, yes}]

Printer — Specifies the local printer to configure. Name — Specifies the name of the printer and is required. PrinterID — 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 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} [LocalName=name][Host= host][Queue=queue] [PrinterID=window_driver][Class=classname][Enabled={no, yes}]

Printer — Specifies the LPD printer to configure. LocalName — Specifies the name of the printer. If LocalName is not specified, the Queue name is used. Host — Specifies the host name of the printer.Queue — Specifies the queue name of the printer.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 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.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}[LocalName=name][Host=\[domain]\host] [Name=share_name] [PrinterID=window_driver][Class=classname][Enabled={no, yes}][EnableLPD={no, yes}][Username=username][Password=password][Domain=domain name]

Printer — Specifies the shared Microsoft network printer to configure. LocalName — Specifies the name of the shared printer.Host — Specifies the host name of the shared printer specified as \domain\host when the host is configured within a Microsoft domain (otherwise, host can be specified as \\host).Name — Specifies the shared name of the shared printer.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 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 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] [LockDown= {no, yes}] [HideSysInfo={no, yes}] [HidePPP={no, yes}] [EnableNetworkTest={no, yes}][EnableTrace={no, yes}][ShowDisplaySettings={no, yes}][EnableKeyboardMouseSettings= {no, yes}][KeepDHCPRequestIP={no, yes}]

Privilege controls operator privileges and access to Wyse Xenith resources. None — This level of access is typical for kiosk or other restricted-use deployment. The System Settings icon is disabled (the System Settings submenu cannot be displayed). The Connections icon is disabled by default (the Connections icon can be enabled (visible) by using the toolbar_no_conmgr=yes option, however, the user cannot create a new connection or edit an existing connection). The user cannot reset Wyse Xenith to factory defaults. Low — This access level is assigned to a typical user. The Network Setup 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[Retry=retry number]

RapportServer — Specifies a list of IP addresses or DNS names (separated 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,1280x1024, 1600x1200] [Refresh=60, 75, 85}]

Resolution — Specifies the local display resolution. Option DDC can be specified to select default display resolution.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[toolbardisablemouse={yes, no}] [toobarclick={yes, no}] [toolbardelay={0-4}] [toolbar_no_conmgr={yes, no}] [toolbardisablehotkey={yes, no}]

SysMode specifies the vdi GUI style and allows changes to the Wyse Xenith Toolbar preferences. If SysMode is set in xen.ini, it will be stored into NVRAM. toolbardisablemouse — By default, the toolbar is hidden until a user hovers their mouse over the left side of the screen. The toolbardisablemouse=yes 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[reboot={no, yes}]

TerminalName — Name of Wyse Xenith comprising a 15-character string.reboot — Yes/no option to reboot Wyse Xenith if the terminal name is changed.

TimeServer=server_list [TimeFormat={“24-hour format”, “12-hour format”}] [DateFormat={yyyy/mm/dd, mm/dd/yyyy, dd/mm/yyyy}][GetBiosDT={no, yes, 0, 1}]

TimeServer — Specifies the SNTP time servers to use for time retrieval. TimeFormat — Specifies the time format to use. DateFormat — Specifies the date format to use.GetBiosDT — Yes/no option to obtain time from BIOS/CMOS when the timeserver is not available or cannot be contacted.




TimeZone=zone [ManualOverride={no, yes}] [daylight={no, yes}] [start=mmwwdd end=mmwwdd] [TimeZoneName=timezonename] [DayLightName=daylightname]

TimeZone — Specifies the time zone if the zone is unspecified on Wyse Xenith or is used with ManualOverride. Supported zones are listed in the System Preference dialog box (for example: ‘GMT – 12:00’ to ‘GMT + 13:00’ at one hour increment, ‘GMT + 03:30’, ‘GMT + 04:30’, ‘GMT + 05:30’, ‘GMT + 05:45’, ‘GMT + 06:30’, ‘GMT + 09:30’, ‘GMT – 3:30’ and ‘Greenwich Mean 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, yes}]

VncPassword=password — Specifies a string of up to 16 bytes as the 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} [{Accept, Reject}={10 to 600} (seconds)] [ViewOnly={no, yes}][ActiveVisible={no, yes}]

VNCPrompt — Yes/no option to enable a VNC shadowing prompt to a user (VNCPrompt set to yes means the user will always be prompted before shadowing starts and the user will then decline or accept VNC shadowing; 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.

CautionEnsure 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).

TipFor 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). 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).

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 (DNS)

Optional, but recommended.

15 Domain Name Optional, but recommended. See Option 6.

28 Broadcast Address Optional.

44 WINS servers IP Address

Optional.

51 Lease Time Optional, but recommended.

52 Option Overload Optional.

53 DHCP Message Type Recommended.





58 Appendix C

54 DHCP Server IP Address

Recommended.

55 Parameter Request List

Sent by Wyse Xenith.

57 Maximum DHCP Message Size

Optional (always sent by Wyse Xenith).

58 T1 (renew) Time Optional, but recommended.

59 T2 (rebind) Time Optional, but recommended.

61 Client identifier Always sent.

161 File server (ftp/http/https)

Optional string. Can be either the name or the IP 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 server (ftp/http/https)

Optional string. If the option provided by the 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.

Table 6 DHCP Options, Continued


Using DHCP Options 59

182 NT domain list for PNAgent/PNLite

Optional string. Wyse Xenith creates a pull-down 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 (WDM) server list

Optional binary IP addresses of WDM. This option 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.

Table 6 DHCP Options, Continued


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 InformationHow 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 URLHow 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 SettingsHow 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 ConfigurationWhat 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


Tables1 Shutdown dialog box options 82 Toolbar icons 103 Desktop Options 114 Supported Keyboard Languages 325 Parameters for a xen.ini file 496 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

Documents