Dell Wyse Enhanced Ubuntu Linux

Administrators Guide for T50

Notes, cautions, and warnings
NOTE: A NOTE indicates important information that helps you make better use of your computer.

CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you
how to avoid the problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.

Copyright 2015 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and
intellectual property laws. Dell and the Dell logo are trademarks of Dell Inc. in the United States and/or other
jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.

2015 - 07

Rev. A00
Contents
1 Introduction........................................................................................................... 5
About this Guide.................................................................................................................................... 5
Dell Wyse Technical Support................................................................................................................ 5
Dell Wyse Online Community...............................................................................................................5

2 Getting Started: Quickly Learning the Basics..................................................6

Logging In..............................................................................................................................................6
Using Your Home Screen...................................................................................................................... 7
Home screen Options..................................................................................................................... 8
Home Screen Keyboard Shortcuts................................................................................................. 8
Configuring Thin Client Settings and Connections............................................................................. 9
Connecting to Network and Session Services..................................................................................... 9
Connecting to a Printer.......................................................................................................................10
Connecting to a Monitor.................................................................................................................... 10
Locking, Logging Out, Shutting Down, Restarting.............................................................................10
Additional Details.................................................................................................................................10
Viewing System Information..........................................................................................................11
Using the Wyse Terminal...............................................................................................................15
Restoring Default Settings with WLoader Setup.......................................................................... 16

3 Configuring System Settings ........................................................................... 17

Configuring the Accessibility ............................................................................................................. 18
Configuring the Appearance...............................................................................................................19
Background Configurations................................................................................................................22
Configuring the Date and Time Settings............................................................................................22
Configuring the Device Settings.........................................................................................................24
Using the Diagnostics..........................................................................................................................27
Setting the Monitor Display Preferences........................................................................................... 30
Configuring the Ericom PowerTerm Terminal Emulation Servers.................................................... 31
Configuring the Citrix Settings........................................................................................................... 32
Managing the Import Certificates.......................................................................................................38
Configuring the INI and Upgrade Settings.........................................................................................40
Configuring the Keyboard Settings.................................................................................................... 42
Language Support...............................................................................................................................45
Configuring the Mixer Settings........................................................................................................... 45
Configuring the Network Connections............................................................................................. 46
Configuring the Printer Settings......................................................................................................... 47
Configuring the Screensaver Settings................................................................................................49

3
 Configuring the RDP Settings.............................................................................................................50
Configuring the Network Proxy Settings............................................................................................ 51
Configuring the TCX Audio settings................................................................................................... 52
TCX USB Virtualizer............................................................................................................................. 53
User Administration.............................................................................................................................54
Configuring the VNC Server Settings................................................................................................. 57
Configuring the WDM Settings........................................................................................................... 57

4 Configuring the Connections.......................................................................... 59

Configuring the Citrix connections....................................................................................................59
Configuring the Custom Connection Settings.................................................................................. 65
Configuring the Ericom PowerTerm TEC Settings............................................................................ 67
Configuring the RDP Client Settings.................................................................................................. 72
Configuring the SSH Connection Settings......................................................................................... 77
Configuring the VMware View Client Settings...................................................................................79
Configuring the VNC Viewer.............................................................................................................. 84
Configuring the Web Browser Connection Settings.........................................................................88
A Central Configuration: Automating Configurations....................................91
How INI Files are Employed................................................................................................................ 91
How to Set Up Automatic Configuration...........................................................................................92
Prepare the Root Directory and Folder Structure on the Server.................................................92
Direct the Thin Client to the Server..............................................................................................93
Reboot the Thin Client..................................................................................................................96

4
 1
Introduction
Dell Wyse Enhanced Ubuntu Linux combines the security, flexibility, and market-leading usability of
Ubuntu trademark of Canonical Group Limited, with Dells cloud computing optimizations in
management and user experience. It is ideal for organizations that want to run server-based, web-based,
or local applications including legacy applications without the deployment and security concerns of a
non-standard Linux distribution.

About this Guide

This guide is intended for administrators of thin clients running Dell Wyse Enhanced Ubuntu Linux. It
provides information and detailed system configurations to help you design and manage a Dell Wyse
Enhanced Ubuntu Linux environment. Depending on your hardware and software configurations, the
images you see may be different than the example images shown in this guide.

This guide supplements the standard Ubuntu documentation supplied by Canonical Inc. and explains the
differences, enhancements, and additional features provided by Dell with the thin client. It does not
attempt to describe the standard features found in Ubuntu.

Ubuntu help can be accessed from the Ubuntu Support Web site at: www.ubuntu.com/index_roadshow

Finding the Information You Need in this Guide

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

Dell Wyse Technical Support

To access Dell Wyse technical resources, visit http://www.wyse.com/support. For more information, you
can submit your questions by using the Dell Wyse Self-Service Center at http://support.wyse.com/
selfservice.html or call Customer Support at 877-459-7304, Extension: 5137801. 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.

Dell Wyse Online Community

Dell Wyse maintains an online community where users of our products can seek and exchange
information about user forums. Visit the Dell Wyse Online Community forums at: https://
community.wyse.com/forum/.

5
 2
Getting Started: Quickly Learning the
Basics
This section contains information that will help you to learn the basics and get started using your thin
client.

Logging In
Using Your Home Screen
Configuring Thin Client Settings and Connections
Connecting to Network and Session Services
Connecting to a Printer
Connecting to a Monitor
Locking, Logging Out, Shutting Down, Restarting, and Suspending
Additional Getting Started Details

NOTE: While it can be used in environments without central configuration for basic connectivity
needs, Dell Wyse Enhanced Ubuntu Linux is designed to be centrally managed and configured using
INI files. In general, it is recommended that you use central configuration to enable you to
automatically push any desired default configuration to all supported thin clients in your
environment. For more information, see Central Configuration: Automating Configurations.

Logging In
NOTE: While configuring your initial connection to Central Configuration, it is recommended that
you connect using a wired connection. Plug in the ethernet cable that is connected to your local
area network (LAN) before you start your thin client. After you start the thin client, it obtains the
configurations desired by the administrator, such as connections, system settings, required
certificates, and so on.

To initially connect to Central Configuration through wireless:

1. Open the Edit Wireless Connection dialog box.

2. Click System Settings Network Connections Wireless tab Add to create a wireless
connection where you can enter the SSID and encryption configurations required/set up by the
network administrator. For more information, see Configuring Network Connections

To log in to your thin client:

1. Start your thin client. The Home screen is displayed.

6
2. Enter you default user name admin and the default case-sensitive password admin.

After your thin client starts and displays the login screen, you can log in to your desktop using the default
user name admin, and the default password admin. We recommend that you change the default
password by using the User Administration dialog box in the System Settings. For more information. see
User Administration.

NOTE: If you want to log in as a thin client user with lesser privileges to access the locked mode,
the default user name is thinuser and the default case-sensitive password is thinuser. If you want to
log in as a guest user, the default user name is guest, and you do not need a password. For a Kiosk
type setup, there are no privileges for guest users.

Using Your Home Screen

The Dell Wyse Enhanced Ubuntu Linux Home screen is designed for efficiency and usability.

The guidelines given in the table below help you to use your home screen. Depending on your privilege
some options may not be available for use.

NOTE: Each icon has a tool tip for easy identification.

Icon Function
Home Displays your Home screen. It is useful when many
windows are open and you want to quickly access
your Home screen.

Open Applications and Connections Displays currently open applications and

connection icons in the menu bar for easy access.

Network Manager Manages your wired and wireless network

connections, For more information see
Connecting to Network and Session Services.

7
Volume Controls the audio volume. Use the slider to adjust
the volume. Click Mute All or Unmute as needed.
NOTE: For these settings to take effect sound
must be supported and enabled on the server
used for ICA or RDP connections.

Calendar Lists the time, day of the week, and date. You can
click the calendar to display the calendar window.

System Settings Sets up your thin client hardware, look and feel,
and system settings, see Configuring System
Settings.

System Information Opens the System Information dialog box. Use

this dialog box to view system information about
the thin client, For more information, see Viewing
System Information

Quit Opens the Shutdown dialog box. Use this dialog

box to lock, logout, shutdown, restart your thin
client, For more information, see Locking, Logging
Out, Shutting Down, Restarting..

Home screen Options

Right-click menu Right-clicking the menu bar provides options to customize your menu bar and
panel. For example, the Customize Panel option allows you to move your menu bar to the top, left,
bottom, or right of your Home screen.
Home Screen Application and Connection icons Each application and connection icon opens the
connections made available by an administrator. For example, a browser, the terminal emulator
window, or other available connections. For more information, see Using Wyse Terminal and
Configuring Connections.
Enter Edit Mode button Opens the Home screen in edit mode allowing you to edit some features.
Some options may not be available for use depending on your user privilege. To exit the edit mode,
click the Exit Edit Mode icon.

Edit connections Click this icon to configure connections. See Configuring Connections.
Delete connections Click this icon to delete a connection .
Add new connections Click this icon to add a connection, and then configure it. See
Configuring Connections.

Home Screen Keyboard Shortcuts

Depending on the type of application window you are using, either full screen, standard, or seamless, you
can use shortcut keys to manage the windows. Note that you can also define shortcuts for launching
applications. For more information, see Configuring the Keyboard Settings

8
 NOTE:

The shortcut keys Alt+Down Arrow allows you to switch windows using a dialog box, and Alt
+Ctrl+Down Arrow minimizes or maximizes all windows. These shortcut keys are useful for
navigating multiple remote sessions without having to log out.
If you are in a session, some connection types may grab all the keystrokes and the shortcuts may
not always work.

Window Action Shortcut Keys

Maximize window Alt+F10
Switch windows using a dialog box Alt+Down Arrow
Minimize or maximize all windows Alt+Ctrl+Down Arrow
Move window with arrow keys Alt+F7 and press an arrow key
Resize the window Alt+F8 and press an arrow key
Close the window Alt+F4

Configuring Thin Client Settings and Connections

While the use of Dell Wyse INI files is recommended to configure thin client settings and connections
available to users, you can use dialog boxes on a thin client to:

Set up your thin client hardware, look and feel, and system settings. For more information, see
Configuring System Settings.
Configure and add connections to your Home screen. For more information, see Configuring
Connections.

Connecting to Network and Session Services

Use the Network Manager icon, located on the right side of the Menu bar, to display information about
the status of your network connection and to connect or disconnect.

Use the following guidelines:

1. Click the Network Manager icon to display the Wired Network and Wireless Network menus.
2. Click the Network Manager icon, and then select an available wired or wireless network to use.
3. Right-click the Network Manager icon to display following options:
Enable Networking
Enable Wireless
Enable Notifications
Connection Information
About

9
 You can select or unselect any of the above options to enable or disable the functionality.
4. Hover your mouse pointer over any icon to view the status of the connections The various statuses
are:
No Network Connection
Wired Network Connection active
Wireless Network Connection active

The message also displays the name of the network to which your thin client is connected.

For wireless connections (802.11b/g/n Wireless LAN), you can click the Wireless Network Connection
icon or click the Network Manager icon in the menu bar to see if a wireless network connection is
available. You can click an available wireless network connection to open and use the Wireless Network
Authentication dialog box. After authentication, the wireless network is available for use.

For information on importing certificates that your network may require, see Managing the Import
Certificates.

Connecting to a Printer
To connect a printer to your thin client through a USB port, you will need a USB-to-printer adapter cable
(not included). Before use, you may need to install the driver for the printer by following the printer driver
installation instructions. For information on connecting to printers, refer to Configuring the Printer
Settings

Connecting to a Monitor
Depending on your thin client model, connections to monitors can be made using either a VGA (analog)
monitor port, a DVI (digital) monitor port, and the proper Dell monitor cables/splitters/adapters. For
information on configuring dual display settings, see Setting the Monitor Display Preference.

Locking, Logging Out, Shutting Down, Restarting.

After using your thin client, you can click the Quit icon and select one of the following options.
depending on your user privileges. The shutdown screen is not configurable using INI parameters.

Lock Locks your thin client display after you click the icon. To unlock your thin client, move the
mouse, enter your credentials, and then click Unlock.
Logout Logs you out of your session.However, the thin client continues to run.
Shutdown Shuts down and turns off your thin client.
Restart Shuts down and restarts your thin client.

Additional Details
This section includes additional details on the following:

Viewing System Information

Using Wyse Terminal

10
 Restoring Default Settings with WLoader Setup

Viewing System Information

Use the System Information dialog box to view Identity, Network, Package, System Log, and Copyright
information:
To View the System Information:

1. Click the System Information icon in the menu bar .

The System Information dialog box is displayed.

2. Use the following guidelines:

a. Identity tab Displays identity information such as Current User, Terminal Name, Product Name,
Platform, Build, Ubuntu, OS Version, Uptime, Processor, Processor Speed, Total Memory, Free
Memory, Flash Size, Serial Number, and BIOS Version.

11
 b. Network tab Displays network information for ethernet (eth0) and wireless LAN (wlan0) such
as MAC Address, Network Speed, MTU, IP Address, IPv6 Address,Subnet Mask, Gateway, Domain,
Primary DNS, Secondary DNS, DHCP Server, Lease, and Elapsed time.

c. Packages tab Displays the Package information, including packages names, versions, and sizes
that are installed on the thin client.

12
d. System Log tab Displays the System Log information, including various messages generated
during the operation of the thin client.

13
 e. Copyright tab Displays the software copyright and patent notices.

14
Using the Wyse Terminal
Clicking the Terminal icon on the Home screen opens the Wyse Terminal emulator window. Wyse
Terminal allows you access to a text terminal and all its applications such as command line interfaces
(CLI) and text user interface applications. You can click the Window menu, which is the upper left window
icon in the terminal window to open and use available menu options. You can type help and press Enter
to display a verbose message describing available options.

NOTE: This terminal is available only to users with high privileges. It is recommended for
experienced administrators who have extensive knowledge of the Linux system.

15
Restoring Default Settings with WLoader Setup
Depending on the default settings you want to restore on the thin client, you can use the :

WLoader Setup to restore various default values. see Accessing Thin Client Boot Order Settings
Recovery option to restore the complete image including removing any updated packages. see
Restoring the Complete Image

Accessing Thin Client Boot Order Settings

1. Power off the device.
2. Press and hold the Delete key while pressing and holding the Power button to power on the device.
When the Activity light next to the Power button blinks, release the Power button. When the BIOS
password prompt is displayed, release the Delete key.
3. Type Fireport as the password to enter and use the WLoader Setup. For example, you can use the
Boot Order to select the boot option you want.

Restoring the Complete Image

1. Power off the device.
2. Press and hold the P key while pressing and holding the Power button to power on the device. When
the Activity light (next to the Power button) blinks, release the Power button. When the BIOS
password prompt is displayed, type Fireport as the password.
3. When the one-time boot menu of options is displayed, select the Recovery option and then press
Enter it restores the complete image and removes any updated package.

16
 3
Configuring System Settings
Clicking the System Settings icon in the Menu bar displays the following System Settings options that you
can configure locally on a thin client using dialog boxes. Depending on user privilege level, some dialog
boxes and options may not be available for use.

While we recommend you not to use dialog boxes for configuring thin client system settings, 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 in smaller environments. In general, we recommend that you use
central configuration to enable you to automatically push any desired default configuration to all
supported thin clients in your environment. For more information, see Central Configuration: Automating
Configurations.

In addition, the Dell Wyse USB Firmware Tool also provides a simple USB imaging solution for supported
devices:

Configuring the Accessibility

Configuring the Appearance
Configuring the Background
Configuring the Date and Time Settings
Configuring the Device Settings
Using the Diagnostics
Setting the Monitor Display Preference
Configuring the Ericom PowerTerm Terminal Emulation Servers
Configuring the INI Settings
Managing the Import Certificates
Configuring the Keyboard Settings
Language Support
Configuring the Mixer Settings
Configuring the Mouse Settings
Configuring the Network Connections
Configuring the Network Proxy Settings
Configuring the Printer Settings
Configuring the RDP Settings
Configuring the Sceensaver Settings
Configuring the TCX Audio Settings
TCX USB Virtualizer
User Administration

17
 Configuring the VNC Server
Configuring WDM Settings

Configuring the Accessibility

To configure the Accessibility Settings:

1. Click the System Settings Accessibility on the Desktop Menu.

The Accessibility dialog box is displayed.

2. Use the guidelines to configure the accessibility settings:

a. Sticky keysSelect the check box to use the sticky keys
If you want to Lock sticky keys.
If you want to Disable sticky keys if two keys are pressed.
b. Slow KeysSelect the check box to use slow keys.
Move the Slider to increase or decrease the Acceptance delay.
c. Bounce Keys Select the check box to use the bounce keys.
Move the Slider to increase or decrease the Keystroke delay.

18
Configuring the Appearance
Use the Appearance dialog box to customize your Home screen.

To configure the Appearance settings:

1. Click the System Settings icon Appearance on the desktop menu.

The Appearance dialog box is displayed.
2. Click Style tab to customize the theme of your desktop.
Default is Shiki- Brave.

3. Click Icons tab to customize the icons of the display of your desktop.
Default is Headley.

19
4. Click Fonts tab and use the following guidelines:

20
a. Default Font Select the size of the Default Font.
b. Rendering Select this options to enable anti-aliasing.
c. Hinting Select the Hint of the font from the drop-down list.
d. Sub-pixel order Select the Sub-pixel order of the font from the drop-down list.
e. DPI Select this option to Custom DPI settings.

21
Background Configurations
Use the Background dialog box (click Background) to customize your desktop background.

NOTE:
PNG files are recommended for most single monitor setups. However, on dual-monitor setups, a
JPG file is recommended as there is some color variance due to Y-Cable or DVI/VGA output when
using PNG files.

Configuring the Date and Time Settings

Use the Date/Time Properties dialog box to set Date and Time and Time Zone options.

To configure the Date and Time Settings:

1. Click the System Settings icon Date and Time on the desktop menu.
The Date and Time properties dialog box is displayed.

22
2. Click Date and Time tab and use the following guidelines:
a. Synchronize with a Network Time Protocol (NTP) server Select the check box to Synchronize
with a Network Time Protocol (NTP) server. Enter the IP Address or hostname of the NTP server
the current NTP server is shown to synchronize the clock time and date of the thin client.
b. Add Click Add to create the New NTP server.
c. Edit Click edit to make changes in the NTP server.
d. Delete Click Delete to delete the NTP server.
3. Click Time Zone tab and use the following guidelines:

23
 a. Select your time zone and whether or not to automatically enable daylight savings time from the
list.
b. System clock uses UTC Select this check box is the system clock uses co-ordinated Universal
Time (UTC).

Configuring the Device Settings

Use the Device Settings dialog box to set the parameters of your device such as Terminal Name, Hosts,
and Ethernet Speed.

To configure the Device Settings:

1. Click the System Settings icon Device Settings on the Desktop menu.
The Device Settings dialog box is displayed.

24
2. On the Device Settings dialog box, click the Terminal Name tab to obtain the device name and then
specify the following details:
Contact DHCP server Select this option to get the terminal name from the DHCP server.
Derive from MAC addressSelect this option to generate the name from the MAC address of the
device.
Use the following nameSelect this option to manually enter a name.
3. Click the Hosts tab to add mappings of IP addresses to hostnames that are not available through
DNS.

25
 NOTE: The names of mapped addresses appear on the Hosts tab.

Specify the following details:

a. Adding an IP addressClick Add to open the /etc hosts entry dialog box, enter an IP Address,
Hostname and optionally, Aliases, and then click OK.
b. Editing a HostSelect a host from the list, click Edit, and configure the host.
c. Deleting a HostSelect a host from the list and click Delete.
4. Click the Ethernet Speed tab to select the Ethernet speed from the available source buttons.

26
Using the Diagnostics
Use the Diagnostics dialog box to select and use a diagnostic tool:

1. Click the System Settings icon Diagnostics on the desktop menu.

The Diagnostics dialog box is displayed.

27
2. Ping Enter or select a destination from the Destination list and click Ping.
3. Trace Route Enter or select a destination from the Destination list and click Trace route.

4. Temporary Settings View the temporary settings of the thin client.

28
5. Permanent Settings View the permanent settings of the thin client.

6. wlx.ini/wnos.ini View the wlx.ini or wnos.ini file as copied to the thin client.

29
7. user.ini View the user.ini file as copied to the thin client.

Setting the Monitor Display Preferences

Use the Monitor Preferences dialog box to set the monitor display preferences such as Primary Display
Output, Resolution, Refresh Rate, and Rotation.

1. Click the System Settings icon Display on the desktop menu

The Monitor preferences dialog box is displayed.

30
2. Use Primary Display Output to set your preferred display.
3. From Resolution drop-down menu, select your preferred resolution.
4. From Refresh rate drop-down menu, select your preferred refresh rate.
The refresh rate is the number of times a display's image is repainted or refreshed per second. The
refresh rate for each display depends on the video card used.
5. From Rotation drop-down menu, select your preferred screen rotation.
6. Select the Same image in all monitors to display the same image in all monitors.
7. Click Apply.

Configuring the Ericom PowerTerm Terminal Emulation

Servers
Use the Ericom PowerTerm Terminal Emulation dialog box to view and manage the list of servers that are
presented when an Ericom PowerTerm TEC connection is being configured for thin client access to
network resources.

1. Click the System Settings icon Ericom PowerTerm on the desktop menu.
The Ericom PowerTerm Terminal Emulation Servers dialog box is displayed.

31
2. Use the following guidelines to add or delete a host name :
a. Adding a hostname Click Add to open the Add host dialog box, enter a Hostname, and then
click OK. The hostname is added to the Hostname list.
b. Deleting a hostname Select a hostname and click Delete. The hostname is removed from the
Hostname list.

Configuring the Citrix Settings

These settings are global settings and are applicable to the domain. When you logout and login, you are
prompted for credentials to log in to a Citrix session for the selected domain.
When you successfully login, all the applications and desktops on the remote session are listed on the
local desktop.
Use the Citrix Settings dialog box to configure the common settings you want for all ICA connections.

1. Click System Settings icon Citrix Settings on the desktop menu.

The Citrix Settings dialog box is displayed.
2. Click the Network tab to configure the servers and reconnection settings and then Specify the
following details:

32
 a. PN Agent ServerEnter the PN Agent Server you want to use.
This can be a list of servers with each server separated by a semi-colon.
b. Metaframe ServerEnter the Metaframe Server you want to use.
This can be a list of servers with each server separated by a semi-colon.
c. Browsing ProtocolSelect TCP/IP + HTTP server location, TCP/IP, or SSL/TLS + HTTPS server
location.
d. PN Logon DomainsEnter the PN logon domains.
e. Store NameEnter the Store Name you want to use.
Multiple store names are not supported.
f. PN Desktop SetupSelect the Show All Applications check box to display all published
applications on the desktop.
g. Window StyleSelect the check box if you want to select the window style as Seamless.
h. Application Reconnection Select the Automatic reconnection at logon check box to enable
reconnection, and then select the connect option you want.
3. Click the Drive Mapping tab to map drives on the server to devices on the thin client, and to view
and manage the list of current drives including the drive information that are mapped on the thin
client.

33
 To add a drive:

a. Clear the Dynamic Mapping check box, and then click Add to open the Citrix Drive Map dialog
box.
b. From the Drive Letter list, select a drive letter.
c. To enable or disable reading and writing for the drive, select or clear the Enable Read and Enable
Write check boxes.
d. From the Drive Type list, Select a drive type such as USB Floppy, USB CDROM, USB Disk or
Memory Stick, or Local or Mounted Disk.
e. Enter the directory on the USB device to access in the Base Directory text. Optional
f. Click OK to add the drive to the list of available drives.
To edit a drive:

a. Select a drive from the list of available drives.

b. Click Edit and then configure the drive.
To delete a drive:

a. Select a drive from the list of available drives.

b. Click Delete to remove the drive.
4. Click the Hotkeys tab to map hotkeys on the thin client.
Select a Hotkey option using the Hotkey lists for each function you want.

34
5. Click the Display tab to set the Display settings.

35
 Use the Display tab to set:

Scroll AdjustmentIf you encounter over-scrolling when using certain published applications,
increase the adjustment by 100 until the display improves

NOTE:
The maximum scroll adjustment is 1000.
6. Click the Firewall tab to set the firewall options on the thin client.

36
 Specify the following details:

a. Automatically detect proxyDetects proxy servers automatically.

b. Use Alternate Address for Firewalls Enables connections behind a firewall.
c. Proxy Type Select a Proxy Type from the list and if necessary use Secure (HTTPS) or SOCKS
and then enter the Proxy Address and Port.
7. Click the Trusted Server Configuration tab to set and enforce the trusted server configuration.

37
 To enforce a trusted server configuration:

a. Select the Enabled option.

b. Select the Enforce trusted server configuration check box.
c. Enter the Address of the trusted server.
d. Click OK.
You can also use the Enabled or Disabled options to quickly enable or disable the enforcement
configuration

Managing the Import Certificates

Use the Import Certificates dialog box to import and manage the ICA Digital Certificates

To manage the import certificates:

1. Click the System Settings icon Import Certificates on the Desktop menu.
The Import Certificates dialog box is displayed.

38
2. In the Import Certificates dialog box, use the following guidelines:
Certificate files you add from a remote server must end with the extension .crt, .cer, or .pem, and be
DER-encoded or Base64-encoded.
To Add Certificates from a Remote Server:

a. Click Add to open the Add Certificate dialog box.

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

39
 c. Select the Remote Certificate Source server option that contains the certificate you want. If you
select the Use the following Server option, enter the Import Server URL and the User name, and
Password required for that server.
The Supported protocols are ftp, http, and https.
d. Select the certificate file from the Certificate file list
If the Import Server URL, Username, and Password are entered correctly, this list automatically
displays the names of available certificates on the server.
e. Click Add after configuring the Remote Certificate Source server option.
To add certificates from a local device:

Click Add to open the Add Certificate dialog box.

Select the Local Server option, and then click Next to open the Open File dialog box.
Use the folders and command buttons to find and select the certificate you want to use.

Configuring the INI and Upgrade Settings

Use the INI and Upgrade Settings dialog box to direct the thin client to the source or the server location
of INI files and image updates.
NOTE: We recommend you to obtain INI files through a DHCP server using DHCP options rather
than through a static IP address. For information about how INI files and images are downloaded
from the server.

Dell devices also support INI updates through WDMs DDC. For more information, see Configuring the
WDM

1. Click the System Settings icon INI Settings on the desktop menu.

40
 The INI Settings dialog box is displayed.

2. In the INI Settings dialog box, use the following details

a. Do not use INI files Use this option when you want to use only locally configured settings by
using the thin client dialog boxes available and do not want to use available INI files on the
network or local INI files.
b. Use INI files from server only Use this option when you want to use INI files from the specified
server only, for example, you do not want to use local INI files or do not want to allow INI use
when disconnected from the server for security reasons. Use this option to direct the thin client
to the server location through either of the following ways:
DHCP Server Select the Get INI and Upgrade server details via DHCP check box. The DHCP
server directd the thin client to the server location where the INI files and image updates
reside.
Manually entered server address Clear the Get INI and Upgrade server details via DHCP
check box and enter the static INI Settings.

NOTE: The INI Server URL, and optionally the Username and Password of the server, if
selecting the Server requires authentication check box.
c. If server is available, use INI files from server only; otherwise use local INI files Use this option
when you want to use INI files from the specified server. However, local INI files can be used if
that server is unavailable. When using this option you can direct the thin client to the server
location through either of the following ways:
DHCP Server Select the Get INI and Upgrade server details via DHCP check box. The DHCP
server directs the thin client, using the DHCP options, to the server location where the INI files
and image updates reside.

41
 Manually entered server address Clear the Get INI and Upgrade server details via DHCP
check box and enter the INI Settings.
d. Use local INI files only Use this option when you want to use only local INI files and do not
want to use available INI files on the network.
NOTE: INI files can be cached locally if using the Enable Local and Local Copy INI
parameters; see Reference Guide: Dell Wyse Enhanced Ubuntu Linux INI Files.

Configuring the Keyboard Settings

Use the Keyboard dialog box to select Behavior , Application Shortcuts, and Layout.

1. Click the System Settings icon Keyboard on the desktop menu.

The Keyboard dialog box is displayed.

2. Click Behavior tab and use the following guidelines:

42
 a. Select the check box to Enable key repeat.
b. Repeat delay Move the Slider to increase or decrease the Repeat delay.
c. Repeat speed Move the slider to increase or decrease the Repeat speed.
d. Select the Show blinking to show the Cursor blinking.
e. Blink delay Move the slider to increase or decrease the amount of blink delay.
3. Click Application Shortcuts tab to define the Shortcuts for launching applications:

a. Click Add to add the Additional shortcuts

b. Click Remove to delete the selected shortcut key.
c. Click Reset to defaults to reset the default shortcut keys.
4. Click Layout tab and use the following guidelines:

43
 a. Use System defaults Select this option to use the system defaults.
b. Keyboard model Select the keyboard model from the drop-down list.
c. Keyboard layout Select the Keyboard layout from the drop-down list.
d. Click Add to add the Keyboard layout from Keyboard layout section.
e. Click Edit to edit the keyboard layout.
f. Click Delete to remove the Keyboard layout.

44
Language Support
Use the Language support dialog box (click Language Support) to select the language and text format
options of the User Interface (UI) from the list of supported languages.

NOTE: Currently only English is supported.

Configuring the Mixer Settings

Use the Mixer dialog box to configure Playback (Master system sounds) volume and other available
controls.

1. Click System Settings icon Mixer on the desktop menu.

The Mixer dialog box is displayed.

45
2. Select the Sound Card option you want and use the Select Controls dialog box to select the check
boxes of the audio controls you want visible (tabs) in the Mixer dialog box (available for
configuration).
For example, you can display a capture sound card option (for recording sounds), output sound
card (with playback, capture, and switches preferences), and so on.
Clicking the volume button toggles the mute on and off.

Clicking the link button toggles the select-all-sliders feature (all sliders move as one) on
3. Clicking the record button toggles the record sound on and off.
For these settings to take effect, sound must be supported and enabled on the server used for ICA
connections, RDP connections, or MPlayer. Sound requires significant bandwidth that may not be
available on some WAN and dial-up connections.

Configuring the Network Connections

Use the Network Connections dialog box to configure the settings you want for supported network
connections.

Click the System Settings icon Network connections on the desktop menu.

46
 Use the Wired, Wireless, Mobile Broadband, VPN, and DSL tabs to view and manage add, edit, and
deletethe list of network connections configured on the thin client
By default, your thin client obtains information from the DHCP server about network connections
(highly recommended), but you can manually enter connection information provided by your network
administrator to connect to other networks, for experienced users only.

Configuring the Printer Settings

Use the Printers dialog box for printer related tasks.

1. Click the System Settings Icon Printers on the Desktop Menu.

47
 The Printer Settings dialog box is displayed.

2. Click the CUPS and Home tabs use the following guidelines:
a. CUPS and Home tabs To View and access CUPS information. CUPS is the standard-based,
open source printing system developed by Apple Inc. for Mac OS X and other UNIX -like
operating systems.
3. Click the Administration tab and use the following guidelines:
Add Printer Add and configure a network or local printer .
Find New Printers To find available printers for use.
Manage Printers View the list of currently configured printers . In addition, you can: Select the
default printer .

NOTE: Administrators can specify system-wide and personal default printers.

Change printer settings right-click on a printer in the list, select Properties, and then click
Settings.
Change printer policies right-click on a printer in the list, select Properties, and then click
Policies.
Change user access to the printer right-click on a printer in the list, select Properties, and
then click Access Control.
Change printer job options right-click on a printer in the list, select Properties, and then
click Job Options.
Delete a printer right-click on a printer in the list, select Delete, and click OK.
4. Click the Class tab and use the following guidelines:
Add Class - Add and configure a Class of printers.
Manage Classes View the list of currently configured Classes of printers .
5. Click the Jobs and use the following guidelines

48
 Manage Jobs Change printer job options.
6. Click the Server tab and use the following guidelines:
Edit Configuration File Change the server configuration file.
View Access Log View the access log to the server.
View Error Log View the error log to the server .
Advanced Check Boxes Select or clear the check boxes you want in the Advanced list; after
making your selections. Make sure to click Change Settings.
7. Click the RSS Subscriptions: tab and use the following guidelines
Add Subscription Add and configure an RSS subscription.
Classes tab Search for printers of a class type.
Online Help tab Access CUPS online help interface.
Printers tab Search and display printers with printer details.

Configuring the Screensaver Settings

Use the Screensaver Preferences to Display Modes and Advanced display power management settings.

1. Click the System Settings Icon Screensaver on the desktop menu.

2. Click the Display tab and use the following guidelines:

49
 Mode Select the mode of the display from the drop-down list.
Select the check box to Lock the Screen and select the delay time from the drop-down menu.
3. Click the Advanced tab and select the check box to enable the Display Power Management
Settings.

Configuring the RDP Settings

Use the RDP Settings dialog box to configure the common settings you want for all RDP connections.

To Configure the RDP Settings:

1. Click System Settings Icon RDP on the Desktop menu.

2. Click the RD Broker and use the following guidelines:

a. RD Broker Server Enter the RD Broker Server you want, this can be a list of servers with each
server separated by a semi-colon.
b. Logon Domains Enter the Logon Domains, and then select your Verify SSL Certificate and
Verify Host in SSL Certificate settings.
3. Click the Window tab to select the Window Size you want, and to disable the panel, if you want the
window to appear without the panel while using the connection.

50
Configuring the Network Proxy Settings
Use the Network Proxy Preferences dialog box to configure the Proxy Configuration and Ignored Hosts
options you want for supported network connections.

To configure the Network Proxy Settings:

1. Click System Settings on the desktop menu.

The Network Proxy Preferences dialog page is displayed.

51
2. Use the Proxy Configuration and Ignored Hosts tabs to view and manage proxy settings.
3. list of hosts to ignore information provided by your network administrator for the network
connections configured on the thin client.

Configuring the TCX Audio settings

Use the Audio Devices dialog box to view and change the automatically-detected audio device.

1. Click the System Settings icon TCX Audio on the desktop menu.

52
2. From the Audio Deviceif you want to use for your audio output and a connected audio headset/
device will be automatically detected.

TCX USB Virtualizer

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

Click the System Settings icon TCX USB Virtualizer on the desktop menu.

Enabling USB devices Select the Enabled check box.

Allowing or denying USB device classes On the Configuration tab, select or clear the check box of
a device class in the Devices list to allow or deny its use. For example, select Smart Card Devices to
permit USB smart card devices to be used to log into virtual machines.

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

NOTE: You can obtain device Class, Sub Class, Protocol, Vendor ID, and Product ID information
by plugging the device into the USB port of your thin client and viewing the information
displayed in the USB Devices tab.
Allowing or denying a USB device - After you add a USB device, its name appears on the
Configuration tab. Select or clear a USB device check box to allow or deny its use.

NOTE: Use caution when using TCX USB Virtualizer on a terminal server, as allowing use of a USB
device is global and not session restricted.

User Administration
Use the User Administration dialog box to view and edit passwords for all users (built-in defaults) and to
enable automatic login for a user automatically log in a user at system start up. In addition, you can
manage SSH root User password and login.

1. Click the System Settings icon User Administration on the desktop menu.
The User Administration dialog page is displayed.

54
 NOTE:
While this dialog box allows you to edit the passwords and automatic login for users of the thin
client, you must use central configuration (INI files) to add or delete users beyond the built-in
default users provided. In general, it is recommended that you use user.ini files to manage users
for normal use cases. For example, a new user should be created through a user.ini file with the
appropriate privilege level defined in the text file.
2. To edit a user password, select the change password check box you want, and then enter a new
password in the New Password and Confirm Password boxes.
3. Autologin Setup Select this to Automatically login at startup.

55
 a. Autologin User select the User from the drop-down list.
b. Autologin Delay To Set the amount of delay in sec from the drop-down list.
4. To edit a SSH root user password, select the change password check box you want, and then enter a
new password in the New Password and Confirm Password boxes.
The Users tab can be a convenient way to locally change the password and enable automatic login
for a specific user.

56
Configuring the VNC Server Settings
Use the VNC Server Settings dialog box to enable and disable the VNC server, and to use and change the
server password.

To Configure the VNC Server Settings:

NOTE: The VNC server is enabled by default.

1. Click System Settings Icon VNC Server on the Desktop Menu.

The VNC Server dialog box is displayed.

2. Disable VNC Server Select the check box to disable the VNC Server.
3. Use Password Select the check box to Use the Password.
4. Change Password Select the check box to change the password.

Configuring the WDM Settings

Use the WDM Agent Configuration dialog box to configure the Wyse Device Manager server location.

To configure the WDM server location:

1. Click System Settings Icon WDM on the desktop menu.

The WDM dialog box is displayed.

57
2. Enter the WDM Server IP address.
3. Enter the Non-secure Port (HTTP) for client to server communication. default, is 80.
4. Enter the Secure Port (HTTPS) for client to server communication, default is 443.
5. Select the Discovery Settings you want. For more information on WDM, see your WDM
documentation.
6. Click OK to save the settings.
NOTE:
Note that you can also configure the WDM server location through INI files (wlx.ini) or the
DHCP Option tag 186. For information, see DHCP Options

58
 4
Configuring the Connections
This chapter provides instructions on configuring and adding connections to your Home screen for use
to access the enterprise server environment available to the thin clients.

NOTE:
While it is not recommended to use dialog boxes for configuring connections for thin client use,
they are available in case you want to temporarily override central default configurations in some
cases or you do not have the option to set up central configuration. In general, it is recommend that
you to use central configuration to enable you to automatically push any desired default
configuration to all supported thin clients in your environment, see Central Configuration:
Automating Configurations.

In addition, the Wyse USB Firmware Tool also provides a simple USB imaging solution for supported
devices.

Clicking Enter Edit Mode Add Item on the Home screen opens the Connection Manager. Use the
Connection Manager to add the following items to your Home screen for use for high privilege users
only:

Configuring the Citrix connections

Configuring the Custom Connection Settings
Configuring the Ericom PowerTerm TEC Settings
Configuring the RDP Client Settings
Configuring the SSH Connection
Configuring the VMware View Client
Configuring the VNC Viewer
Configuring the Web Browser connections settings

Configuring the Citrix connections

To configure the Citrix Connections:

1. Click Enter Edit Mode Add Item Citrix on the Desktop menu.
The Citrix Connections Settings page is displayed.

59
2. Click the Network tab and specify the following details:
a. ServerSelect this option to connect to your Citrix desktop on the Citrix Server.
This option also supports Smart Card login feature. The Smart Card Login check box is available in
the Login tab.
b. Published Application Select this option to directly launch a published application on your
Citrix Desktop when you connect to the Citrix Server.
If you select this option, then the Published Apps field is enabled in the Login tab, and you can
specify a published application.
c. Storefront This option is applicable only for Citrix XenDesktop 7.0 and above. Select this
option to specify the name of a Store Front server to display the applications available in that
sever.
This option also supports Smart Card login feature. The Smart Card Login check box is available in
the Login tab.
d. DescriptionEnter a description for the connection.
e. Network ProtocolSelect a network protocol.
f. Browser ServerEnter the Browser Server name that can be a list of server names with each
name separated by a semi-colon.
NOTE:
You do not need to enter a browser server name if you do not want to connect to either a
published application or a server by name. In addition, generating an ICA connection to a
server using a server name in the Server text box for the connection does not require a
Browser Server address, as long as the DNS information is properly entered.
g. Select a Server from the Server list,
a Published Application from the Application Name list, or a Store Name from the Store Name list.
If needed, click Refresh to refresh the list of servers or published applications.

60
 NOTE:
With a Storefront option you can also add a store. Click Add Store and follow the wizard.
You can enter the IP address of the target server as long as there is no need to resolve a
name.
3. Click Connection tab to configure the connection settings:

a. Enable compression Enables compression.

b. Low bandwidth Enables low-bandwidth optimization.
c. Enable sound Enables sound.
d. Ping before connect Pings the connection to see if it is reachable before the connection is
attempted.
e. Enable Middle Button Paste Enables middle button paste for the mouse.
f. Encryption Select an encryption type from the drop-down list. Default is Basic.
4. Click the Window tab to select the Window Colors and the Window Size you want.

61
5. Click the Application tab and specify the details:

a. Command LineEnter the command line for the program on the server.
b. Working DirectoryEnter the working directory for the program.
6. Click the Login tab and specify the following details to configure the credentials used to
automatically log in to the server:

62
If the Server option is selected in the Network tab then Login tab appears as shown here:
If the Storefront option is selected in the Network tab then Login tab appears as shown here:

NOTE:
The User Name, Password, Domain, and Serial Number fields are optional. If the User Name,
Password, and Domain fields are blank, interactive login is required and the you must enter
the information while logging in.
The User Name, Password, and Domain fields are disabled in the login tab when the
Storefront option is selected in the Network tab.

a. Select this to enable smart card login to the thin client. The User Name, Password, and Domain
are not required. The Smart Card Type field is enabled where you can select the type of smart
card you are using.
If you select Server option in the Network tab, the Smart Card Type field is disabled. You are
prompted to enter the Smart card login credentials after you connect to the server.
If you select Storefront option in the Network tab, the Smart Card Type field is enabled. Use
this option to select the type of smart card you are using.

NOTE: Smart Card Login is applicable only for Server and Storefront Connections.
b. User NameEnter a user name for the connection. This field is disabled if you enable Smart Card
Login.
c. PasswordEnter the password. This field is disabled if you enable Smart Card Login.
d. DomainEnter the domain name. This field is disabled if you enable Smart Card Login.
e. Smart Card Type This field is enabled when you select Smart Card Login. Select the type of
smart card you are using from the drop-down list.
NOTE: The Smart Card Type option is disabled, if you select the server option in the
Network tab.
f. Serial NumberEnter the serial number for Meta frame environments that require the thin client
license serial number.

63
 g. Connect automatically after loginEnables an automatic connection after successful login to
the thin client.
NOTE: If you select the Storefront option in the Network tab, and do not enable Smart Card
Login, then when you click Refresh against Published Apps, you are prompted to enter the
domain user name and password. After you enter the domain user name and password, the
Published Apps drop-down list displays the applications and desktops available on the
Storefront server.
7. Click the Auto Reconnect tab and follow the guidelines:

a. Select the Enable Auto Reconnect check box.

b. Select the amount of time in seconds to delay the reconnection attempt after a disconnection
occurs.
8. Click the Firewall tab to configure an alternate address for firewalls:

64
 a. Automatically detect proxySelect to automatically detect the proxy type.
b. Use Alternate Address for Firewalls Select Yes to use an alternate address for firewalls.
c. Proxy TypeSelect a proxy type.
d. Proxy Address and PortIf you select Secure (HTTPS) or SOCKS as the Proxy Type, you must
enter the Proxy Address and Port.

Configuring the Custom Connection Settings

Use the Custom Connection Configuration dialog box to set custom connection configurations.

To configure the Custom Connection Settings:

1. Click Enter Edit Mode Add Item Citrix on the Desktop menu.
The Custom Connections Settings page is displayed.

65
2. Click the Application tab and specify the details:
a. Description Enter the description.
b. Command Line Enter the command line for the program on the server.
c. Run in terminal window Select this check box to run the application in a terminal window. This
option is used with applications that require a terminal window such as console program.
d. Auto Connect Select this option to start the connection automatically after system startup.

3. Click the Auto Reconnect tab and follow the guidelines:

66
 a. Select the Enable Auto Reconnect check box.
b. Select the amount of time in seconds to delay the reconnection attempt after a disconnection
occurs.

Configuring the Ericom PowerTerm TEC Settings

Use the Terminal Emulator Configuration dialog box to configure the terminal emulator client settings.

To configure the terminal emulator client settings:

1. Click Enter Edit Mode Add Item Citrix on the Desktop menu.
The Terminal Emulator Configuration dialog box is displayed.

2. Click the Network tab and configure the network details:

a. Network Connection or Serial ConnectionSelect Network Connection for connections over
TCP/IP, or Serial Connection for connections through a serial.
b. DescriptionEnter a description for the connection.
c. Host Enter a host name or IP Address or select one from the list. Host can be populated from the
global Ericom PowerTerm TEC connection application.
d. PortEnter the port of the host.
e. Terminal TypeSelect a terminal type.
f. Terminal NameEnter a name for the terminal.
g. Save Configuration LocallySaves the font, color, key-mapping and other settings of the Ericom
PowerTerm TEC application locally.
3. Click the Window tab and select the Window Size you want.

67
4. Click the Connection tab and configure the connection settings:

68
 a. Auto ConnectStarts the connection automatically after system startup.
b. Ping Before ConnectPings the connection to see if it is reachable before the connection is
attempted.
c. Auto ReconnectReconnects automatically after a disconnection occurs.
d. Delay before retryingSelect the amount of time in seconds to delay the reconnection attempt
after a disconnection occurs.
5. Click the Settings tab and enter the script name and path to automatically run script during user
login.

69
6. Click the Remote Configuration tab and specify the details:

70
 a. Remote Configuration FilenameEnter the remote configuration filename for the connection.
b. Remote Configuration PathEnter the remote configuration path for the connection.
7. Click the View tab and select the check boxes for items that will be displayed when using the
connection.

71
Configuring the RDP Client Settings
Use the Remote Desktop (RDP) Configuration dialog box to configure the RDP client settings.

To configure the RDP client settings:

1. Click the Enter Edit Mode Add Item RDP on the Desktop Menu.
The Remote Desktop (RDP) Configuration dialog box is displayed.
2. Click the Network tab and configure the network settings

72
 a. DescriptionEnter a description for the connection.
b. ServerEnter a server name or IP address.
c. Ping Before ConnectPings the connection to see if it is reachable before the connection is
attempted.
d. Notify When DisconnectedNotifies you when the connection is disconnected.
3. Click the Window tab to select the Window Colors and the Window Size you want.

4. Click the Login tab and configure the credentials used to automatically log in to the connection.

73
 a. Use smart cardEnables the use of a smart card when connecting.
b. Network Level AuthenticationEnables Network Level Authentication (NLA) and is required if
NLA is enabled on your remote computer. Your remote computer requires NLA user
authentication before you establish a full Remote Desktop connection and the login screen is
displayed.
c. User NameEnter a user name for the connection.
d. PasswordEnter the password.
e. DomainEnter the domain name.
f. Connect automatically after login Enables an automatic connection after successful log in to
the thin client.
NOTE:
The Username, Password, and Domain fields are optional. If you leave any of these fields
blank, interactive login is required and users must enter the information at login.
g. Use RD Gateway SettingsSelect to enable and configure an RD Gateway to connect to your
remote computers, if required by your network administrator and then do one of the following:
RD Server, and then Use Remote Desktop Credentials for RD GatewayEnter the RD Server IP
address or URL of the Remote Desktop Gateway server, and then select the Use Remote Desktop
credentials for RD Gateway check box, if the server credentials are the same credentials as your
RDP host remote computer credentials.
RD Server, and then Manually enter RD User Name, RD Password, RD DomainEnter the RD
Server IP address or URL of the Remote Desktop Gateway server, clear the Use Remote Desktop
credentials for RD Gateway check box and then manually enter the Username, Password, and
Domain of the RD Gateway server, if required.

NOTE: An RD Gateway server is a type of gateway that enables authorized users to connect to
remote computers on a corporate network from any computer with an Internet connection. An
RD Gateway server enables Remote Desktop connections to a corporate network from the
Internet without having to set up virtual private network (VPN) connections. Ask your network
administrator whether you need to specify an RD Gateway server.
5. Click the Connection tab and configure the connection settings.

74
 a. CompressionEnables compression.
b. NT4 compatibleEnables RDP protocol version 4.
c. Low bandwidthEnables low-bandwidth optimization.
d. SoundSelect an audio source from the list for the connection, either Local or Remote.
e. Encryption Level Select an encryption level, either Normal or None.
NOTE:
For servers with data encryption settings, you must select Normal for the encryption level.
6. Click the Experience tab to configure the experience settings for a user desktop.

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

To configure the experience settings, select the following check boxes:

a. Speed LevelSelect a speed level to describe the network connection.

b. Desktop BackgroundDisplays the desktop background.
c. Font SmoothingEnables font smoothing.

75
 d. Menu and window animationEnables menu and window animation.
e. RemoteFX Enables a RemoteFX session.
NOTE: To use an RDP USB redirection type you must use a RemoteFX session. RDP USB is
not supported using a standard RDP session.
f. Show contents of window while draggingShows the window content when the user drags the
window on screen.
g. Subsampling Enable color space conversion required for chroma subsampling.
Chroma Subsampling is the practice of encoding/compressing images for a higher transmission
experience.
7. Click the Auto Reconnect tab and follow the guidelines.

a. Select the Enable Auto Reconnect check box to enable automatic reconnect after a
disconnection.
b. Select the amount of time in seconds to delay the reconnection attempt after a disconnection
occurs.
8. Click the Drive Mapping tab and use it to map share names on the server to USB mass storage
devices attached to the thin client, and to view and manage the list of current server share names
including the drive information mapped on the thin client.

76
 To add a share name:

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

b. Enter a Share Name.
c. From the list, select the Drive type such as USB Floppy, USB CDROM, USB Disk or Memory Stick,
or Local or Mounted Disk.
d. If required, enter the directory on the USB device to access in the Base Directory text.
e. Click OK to add the Share Name to the list of available Share Names.
To edit or delete a Share Name, select a Share Name from the list of available Share Names and do
one of the following:

EditClick Edit and configure the Share Name.

DeleteClick Delete to remove the Share Name.

NOTE: If you select Redirect all USB drives to folders in Share named WyseUSB check box,
you can redirect all your USB drives such as USB Floppy, USB CDROM, USB Disk or Memory
stick, and local or mounted disk to the folders in share named WyseUSB.
9. Click the Device Mapping tab to map devices to ports on the thin client, and to view and manage the
list of current devices that are mapped on the thin client.

To add a device:

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

b. Select a port from the Port list.
c. Select the directory of the device to access from the Device list.
d. Click OK to add the device to the list of available devices.
To delete a device, select a device from the list of available devices, and click Delete.
10. Click OK to save the settings.

Configuring the SSH Connection Settings

Use the SSH Configuration dialog box to configure the SSH connections.

77
To configure the SSH connection:

1. Click Enter Edit Mode Add Item SSH on the Desktop menu.
The SSH Connection Configuration dialog box is displayed.

2. Click the Network tab and configure the network settings:

a. DescriptionEnter a description for the connection.
b. HostEnter a host name or IP address.
c. Remote UsernameEnter an username.
d. Remote CommandEnter the command to run on the server.
3. Click the Connection tab and configure the connection settings:

78
 a. Auto ConnectStarts the connection automatically after system startup.
b. Ping Before ConnectPings the connection to see if it is reachable before the connection is
attempted
c. Auto ReconnectReconnects automatically after a disconnection occurs.
d. Delay before retryingSelect the amount of time to delay the reconnection attempt after a
disconnection occurs.
4. Click OK to save the settings.

Configuring the VMware View Client Settings

Use the VMware View Client Settings dialog box to configure the VMware View Client settings.

To configure the VMware View Client settings:

1. Click Enter Edit Mode Add Item VMware on the Desktop menu.
The VMware View Client Settings dialog box is displayed.

79
2. Click the Network tab and specify the following details:
a. Description Enter a description for the connection.
b. Host Enter the host name or IP address of the VMware View Server.
c. Port Enter the port of the host.
d. Use Secure Connection (SSL) Select to use an SSL connection.
e. Enable interactive mode If you select this option, then after a successful connection to the
server, the View Client displays all the published application and desktop icons. You can launch
the applications or desktop sessions based on your choice.
If you do not select this option, then the Published Applications option is enabled in the Login tab,
and selecting that option enables you to directly launch the application or desktop you specify.
f. Lock the Server URL/Host field Select this option to lock the server URL.
3. Click the Secure Preferences tab and select any of the options that determine how the client should
proceed when it cannot verify that your connection to the server is secure.

80
 NOTE:
We recommend you not to change this setting unless instructed to do so by your system
administrator.
4. Click the Connection tab and specify the following details:

81
 a. Protocol Select PCOIP or RDP.
If you select RDP, then the Enable NLA option is enabled. Selecting this option enables Network
Level Authentication. However, for this option to work, the same option should be enabled on the
remote server as well.When this option is enabled, you must provide the username and password
in the Login tab while configuring.
b. Disable 32 bit color on RDP Select this option if you want to disable 32 bit color on RDP.
c. Ping Before Connect Select this option to ping the connection to see if it is reachable before
the connection is attempted.
d. Connect automatically after login Select this option to enable an automatic connection after
successful login to the thin client.
e. Auto Reconnect Select this option to reconnect automatically after a disconnection occurs.
f. Delay before retrying Select the time period in seconds to delay the reconnection attempt
after a disconnection occurs.
5. Click the Desktop tab and specify the following details:

82
 a. Launch (view client ) in full screen mode Select this option to launch (view client ) in full screen
mode.
b. Window Size Select a window size if you do not want to use the full screen.
c. Disable Fullscreen drop down menu bar Select this option to disable the drop-down menu bar
in the full screen mode.
d. Disable Exit on disconnect or when an error occurs while connecting Select this option if you
do not want the Horizon Client to retry connecting if there is a connection error. You can
typically select this option if you use kiosk mode.
6. Click the Login tab and specify the following details:

83
 a. User Name Enter a user name for the connection.
b. Password Enter the password.
c. Domain Name Enter the domain name.
d. Published Application This option is enabled only if you disable the Enable Interactive Mode
option in the Network tab. If you select this option, then the Desktop field changes to
Application.
Selecting this option directly launches the application you specify on the remote session.
e. Desktop Enter the desktop or application name.
7. Click OK to save the connection settings.
The VMware View Connection icon is displayed on the Connection Manager and is ready to use.

Configuring the VNC Viewer

Use the VNC Viewer Settings dialog box to configure the VNC Viewer settings.

To configure the VNC Viewer settings:

1. Click Enter Edit Mode Add Item VNC Viewer on the desktop menu.
The VNC Viewer Settings dialog box is displayed.

84
2. Click the Network tab and configure the network settings:
a. DescriptionEnter a description for the connection.
b. HostEnter a host name or IP address.
c. Connect toSelect a connection type of either Display number to enter the display number to
connect to the server, or Port number to enter the port number to connect to the server.
d. Ping Before ConnectPings the connection to see if it is reachable before the connection is
attempted.
3. Click the Connection tab and configure the connection settings:

85
 a. Compression LevelSelect a compression level for encoding.
b. SharedEnables or disables a shared connection.
c. View OnlyBlocks mouse and keyboard events for a view-only connection.
4. Click the Window tab and configure the window settings:

86
 a. Full ScreenOpens the connection in a full-screen window.
b. Disable Panel Select this option to disable the Panel.
c. Color DepthControls how many colors to display with each on-screen pixel.
d. JPEG QualitySpecifies the image quality for encoding.
5. Click the Login tab and configure credentials used to automatically log in to the VNC:

87
 a. PasswordEnter the password to connect to the VNC server.
b. Connect automatically after loginEnables an automatic connection after successful log in to
the thin client.
6. Click OK to save the settings.

Configuring the Web Browser Connection Settings

Use the Web Browser Configuration dialog box to set Web Browser connection configurations.

To configure the Web Browser Connection Settings:

1. Click Enter Edit mode Add Item Web Browser on the desktop menu.
The Web Browser Configuration dialog box is displayed.

88
2. Click the Network tab and specify the details:
a. Description Enter the Description of the browser.
b. URL Enter the URL of the browser.
c. Auto connect select this option to auto connect.
3. Click the Window tab and use the following guidelines:

Use the Window tab to configure how the browser window is displayed.

a. Kiosk Mode select this option to enable the Kiosk Mode. If you want the browser to appear in
fullscreen mode without any menus or toolbars.
b. Disable Panel Select this Option to disable the Panel. If you want the browser to appear
without the panel while using the connection.

89
 c. Window Size Select the Window Size from the Drop-down list.
4. Click Auto Reconnect tab and use the following guidelines:

Use the Auto Reconnect tab to enable automatic reconnect after a disconnection

a. Enable Auto Reconnect select this Option to enable the Auto Reconnection.
b. Delay before retrying Select the amount of delay in seconds from the drop-down list.

90
 A
Central Configuration: Automating
Configurations
This appendix describes how to set up your environment to provide your thin clients running Dell Wyse
Enhanced Ubuntu Linux with automatic configurations in three simple steps.

How INI Files are Employed

How to Set Up Automatic Configuration

NOTE:
Dell thin clients do not require device management software. They are configured to obtain their IP
address, as well as the location of configuration instructions, from a DHCP server. However, you
can use WDM for a more hands-on management of your thin clients. For information about
configuring your thin clients to communicate with a WDM server, see WDM and related INI
parameters in Reference Guide: Dell Wyse Enhanced Ubuntu Linux INI Files.

How INI Files are Employed

INI files created and maintained by the administrator determine how the thin client is configured. The thin
client accesses INI files from the server during the initialization process. Typically, INI files are accessed
through FTP, HTTP, and HTTPS; if no protocol is specified, the default is anonymous FTP.

INI files are employed as follows:

wlx.ini This is the global INI file. One wlx.ini file is available to all users. It contains global parameters
for all thin clients accessing the server. If the operating system cannot find wlx.ini, it defaults to
wnos.ini.
{username}.ini This file is unique to each user. The {username}.ini file contains the connection
profile for each user. Parameters in the user profile generally supersede the identically named global
parameters.
MAC.ini This file can be used for device-specific configuration. If the thin client locates this INI file
(it is stored in the same directory as wlx.ini), wlx.ini is not accessed, unless you use the include=wlx.ini
parameter.

When a thin client is initialized, it accesses the global wlx.ini file. When a user logs in, the thin client
accesses the users unique {username}.ini file. For detailed information on constructing and using Wyse
Enhanced Ubuntu Linux INI files, refer to Reference Guide: Dell Wyse Enhanced Ubuntu Linux INI Files.

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

91
How to Set Up Automatic Configuration
For a thin client running Dell Wyse Enhanced Ubuntu Linux to successfully access INI files and configure
itself from a server, you must set up the server with the correct folder structure, where the INI files and
other files are located, direct the thin client to the server, and then reboot or start the thin client.

After DHCP and servers are configured and available, the thin client checks at each boot up to see
whether or not any configuration changes are available on a predefined server DCHP Option #161
specifies the server URL, DCHP Option #162 specifies the root path to the server. If configuration
changes are available, the changes are automatically installed.

Prepare the Root Directory and Folder Structure on the Server

Set up the following folder structure on your server under the C:/inetpub/ftproot folder (for FTP) or C:/
inetpub/wwwroot folder (for HTTP or HTTPS) and place your INI files and other necessary files inside the
structure as noted this list describes the folder structure, starting with the root directory.

/wyse/ The root directory. It stores the wlx folder and the
addons folders.
/wyse/wlx The main INI configuration folder. It stores the
following:
wlx.ini file or MAC.ini file
bitmap folder
certs folder
ini folder

/wyse/wlx/bitmap The folder where you can place custom images

you plan to Use.
/wyse/wlx/certs The folder where you can place the CA certificates
that can be imported to a thin client.
NOTE: Use the Certs and ImportCerts INI
parameters in the wlx.ini file to import the
certificates to thin clients.

/wyse/wlx/ini The folder where you can place the {username}.ini

files.
/wyse/addons The folder where you can place the add-ons you
want to use. It also stores the directory file and the
*.deb packages available to be installed on the thin
client. The directory file should list all available
add-ons. The directory file is required in the
addons folder to guarantee that add-ons are
properly located.

92
 NOTE: If you want to do an update with the
Preserve changes option enabled, ensure that
your addons folder includes a copyof your
current add-ons. The system may require two
rebootsto fully update the add-ons while
preserving local changes.

To create/activate the .ini MIME Type:

On your IIS server, use the File Types menu to add a New Type.
In the File Type dialog box, enter the Associated extension .ini and Content type (MIME) text/plain.
Click OK to apply the settings.

To create/activate the . MIME Type:

On your IIS server, use the File Types menu to add a New Type.
In the File Type dialog box, enter the Associated extension . and Content type (MIME) text/plain.
Click OK to apply the settings.

Direct the Thin Client to the Server

After you set up the folder structure and populate it with the correct files, you must then direct the thin
client to the location of the server by one of the following ways:

Manually Configuring the Server Location

Using DHCP

NOTE: Using DHCP is strongly recommended.

Using DHCP
When using DHCP to direct the thin client to the location of the server (recommended), information
about the server and root directory is obtained from the following DHCP options:

161 - The server

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

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.
184 - (Optional) Server username to server specified in option 161.
185 - (Optional) Server password to server specified in option 161.

93
 NOTE:
Check-in for configuration changes is done early in the boot process. For that reason, changes in
DHCP information may not be propagated to a unit until a full boot is completed. However, you can
avoid this by forcing a renewing of the DHCP lease, which makes sure that the unit has the latest
file-server location before the next check. Simply, right-click the Network Manager icon, click
Enable Networking to disable it, right-click the Wireless Manager icon, and then click Enable
Networking to enable it again (the DHCP lease is renewed).

DHCP Options
Use the guidelines shown in Table when creating and adding the DHCP options you need.

Option Description Notes

1 Client identifier Always sent.
2 Time Offset Optional.
3 Router Optional but recommended. It is
not required unless the thin
client must interact with servers
on a different subnet.

6 Domain Name Server(DNS) Optional but recommended.

12 Host Name/Terminal Name Optional string. The host name
or terminal name to be set.

15 Domain Name Optional but recommended.

28 Broadcast Address Optional.
44 WINS servers IP address Optional.
51 Lease Time Optional but recommended.
52 Option Overload Optional.
53 DHCP Message Type Recommended.
54 DHCP Server IP Address Recommended.
55 Parameter Request List Sent by appliance.
57 Maximum DHCP Message Size Optional

58 T1 (renew) Time Optional but recommended.

59 T2 (rebind) Time Optional but recommended.
61 Client identifier Always sent.
161 Server (ftp/http/https) Optional string. If this is an IP
address or resolvable hostname,
the protocol is assumed to be
FTP; however, it may be the
leading portion of a URL that
specifies another protocol. If
using the URL form, it should not

94
 include a trailing slash, for
example, http://
server.example.com or ftp://
192.168.0.1.

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

181 Wyse PN Server Optional string. IP address or

FQDN of the PNLite server.

182 Wyse Admin List Optional string. DHCP equivalent

of the DomainList ini file
parameter.

184 Server Username Optional string. Username to use

when authenticating to the
server specified in Option

185 Server Password Optional string. Password to use

when authenticating to the
server specified in Option

186 WDM IP Address Optional binary IP address or

FQDN of the WDM server. This
option can specify up to one
Wyse Device Manager server.

Manually Configuring the Server Location

To manually configure the server location (not recommended), open the INI Settings dialog box and
enter the URL for HTTP or HTTPS; FTP URL is allowed for FTP) for the INI server in the INI Server URL text
box. For more information, see Configuring the INI Settings .

95
Reboot the Thin Client
After you reboot or start the thin client, the thin client will look in the defined root path for the latest
available configuration changes if necessary. Additionally, it will check the directory file in the addons
folder to see if any changes for installed add-ons are defined. Add-ons that exist in the addons folder but
are not listed in the directory file, will be ignored during check-in.

96