Wyse Technology 060413 User Manual
Administrators Guide
Wyse® Enhanced UbuntuTM Linux
Products: T50
Issue: 060413
PN: 883840-51 Rev. D
Copyright Notices
© 2013, Wyse Technology LLC. 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
agreement. By copying, using, or installing the software or the product, you agree to be bound by those terms.
Trademarks
The Wyse and PocketCloud logos and Wyse and PocketCloud are trademarks of Wyse Technology LLC. Other
product names mentioned herein are for identification purposes only and may be trademarks and/or registered
trademarks of their respective companies. Specifications subject to change without notice.
Patents
This product and/or associated software are protected by copyright, international treaties, and various patents,
including the following U.S. patents: 6,836,885 and 5,918,039.
Restricted Rights Legend
You acknowledge that the Software is of U.S. origin. You agree to comply with all applicable international and
national laws that apply to the Software, including the U.S. Export Administration Regulations, as well as end-user,
end-use and country destination restrictions issued by U.S. and other governments. For additional information on
exporting the Software, see http://www.microsoft.com/exporting
as of the purchase date is the controlling licensing
.
Ordering Information
For availability, pricing, and ordering information in the United States and Canada, call 1-800-GET-WYSE
(1-800-438-9973) or visit us at wyse.com. In all other countries, contact your sales representative.
FCC Statement
This equipment has been tested and found to comply with the limits for either Class A or Class B digital devices,
pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful
interference in a residential installation. This equipment generates, uses, and can radiate radio frequency energy
and, if not installed and used in accordance with the instructions, may cause harmful interference to radio
communications. However, there is no guarantee that interference will not occur in a particular installation. If this
equipment does cause harmful interference to radio or television reception, which can be determined by turning
the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following
measures:
• Reorient or relocate the receiving antenna.
• Increase the separation between the equipment and the receiver.
• Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
• Consult the dealer or an experienced radio/TV technician for help.
Shielded interconnect cables and shielded AC power cable must be employed with this equipment to insure
compliance with the pertinent RF emission limits governing this device. Changes or modifications not expressly
approved by the system’s manufacturer could void the user’s authority to operate the equipment.
CAUTION: Modifications made to the product, unless expressly approved by Wyse Technology, could void the
user’s authority to operate the equipment.
Regulatory Compliance for Thin Clients
Basic EMC and Safety Requirements
Wyse appliances are compliant with the regulatory requirements in the regions listed below.
U.S.A.—FCC Part 15 (class B), cUL 60950
Canada—IC ICES-003, CAN/CSA-C22 No. 60950
Europe—EN 55022 (class B); EN 55024
Canadian DOC Notices
Class A - This digital apparatus does not exceed the Class A limits for radio noise emissions from digital apparatus
set out in the Radio Interference Regulations of the Canadian Department of Communications.
Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites applicables aux
appareils numériques de la classe A prescrites dans le Réglement sur le brouillage radioélectrique édicté par le
Ministère des Communications du Canada.
Class B - This digital apparatus does not exceed the Class B limits for radio noise emissions from digital apparatus
set out in the Radio Interference Regulations of the Canadian Department of Communications.
Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites applicables aux
appareils numériques de la classe B prescrites dans le Réglement sur le brouillage radioélectrique édicté par le
Ministère des Communications du Canada.
Wireless Usage and Requirements
Radio transmitting type devices (RF module) are present in models with the wireless option. These devices
operate in the 2.4 GHz band (i.e. 802.11B/G/N LAN & Bluetooth).
As a general guideline, a separation of 20 cm (8 inches) between the wireless device and the body, for use of a
wireless device near the body (this does not include extremities) is typical. This device should be used more than
20 cm (8 inches) from the body when wireless devices are on and transmitting.
Some circumstances require restrictions on wireless devices. Examples of common restrictions include:
• When in environments where you are uncertain of the sanction to use wireless devices, ask the applicable
authority for authorization prior to use or turning on the wireless device.
• Every country has different restrictions on the use of wireless devices. Since your system is equipped with a
wireless device, when traveling between countries with your system, check with the local Radio Approval
authorities prior to any move or trip for any restrictions on the use of a wireless device in the destination
country.
• Wireless devices are not user-serviceable. Do not modify them in any way. Modification to a wireless device
will void the authorization to use it. Please contact the manufacturer for service.
Device Power Supply
Use only the external power supply that comes with your thin client. For power and voltage ratings, see the serial
number label or regulatory label on your device. For power adapter replacement, contact your Wyse Service
Representative. For proper replacement compare the labels on both mobile thin client and power adapter to
ensure that their voltages match.
WARNING: Use of any other power adapter may damage your mobile thin client or the power adapter. The
damage caused by an improper power adapter is not covered by warranty.
Battery Information
Model Tx0 contains an internal button cell battery replaceable by Wyse or one of our Authorized Service Centers.
For service, visit http://www.wyse.com/support/authorized-service-centers
WARNING: There is a risk of explosion if the battery is replaced by an incorrect type. Always dispose of used
batteries according to the instructions accompanying the battery.
Perchlorate Materials - Special Handling May Be Required under California Code of Regulations, title 22. (Only
required within the U.S.A.)
.
This page intentionally blank.
Content s
1 Introduction 1
About this Guide 1
Finding the Information You Need in this Guide 1
Wyse Technical Support 1
Related Documentation and Services 1
Enhancing Your Experience with Wyse Software 2
Wyse Online Community 2
2 Getting Started: Quickly Learning the Basics 3
Logging In 3
Using Your Home Screen 4
Home Screen Keyboard Shortcuts 6
Configuring Thin Client Settings and Connections 6
Connecting to Network and Session Services 7
Connecting to a Printer 7
Connecting to a Monitor 7
Locking, Logging Out, Shutting Down, Restarting, and Suspen d ing 8
Additional Getting Started Details 8
Viewing System Information 8
Using Wyse Terminal 9
Restoring Default Settings with WLoader Setup 9
Accessing Thin Client Boot Order Settings 9
Restoring the Complete Image 9
3 Configuring System Settings 11
Accessibility 12
Appearance 12
Background 13
Citrix Settings (Global Settings) 14
Network 14
Drive Mapping 15
Adding Drives 15
Editing and Deleting Drives 15
Hotkeys 16
Display 16
Firewall 17
Trusted Server Configuration 17
Date & Time 18
Device Settings 19
Terminal Name 19
Hosts 19
Ethernet Speed 20
Diagnostics 20
Display 21
Ericom PowerTerm
INI (Source) Settings 22
®
TEC (Managing Servers Available for Connections) 21
vi Contents
Import Certificates 23
Adding Certificates from a Remote Server 23
Adding Certificates from a Local Device 24
Keyboard 24
Language Support 25
Mixer 25
Mouse 26
Network Connections 26
Network Proxy 27
Printers 28
Installing a Network Printer 29
Installing a Local Printer 30
RDP Settings 31
RD Broker 31
Window 31
Screensaver 32
TCX Audio 32
TCX USB Virtualizer 33
User Administration 34
VNC Server 34
WDM 35
4 Configuring Connections 37
Citrix 38
Network 38
Connection 39
Window 39
Application 39
Login 39
Auto Reconnect 39
Firewall 40
Custom 41
Application 41
Auto Reconnect 41
Ericom PowerTerm
Network 42
Window 42
Connection 42
Setting 43
Remote Configuration 43
View 43
RDP 44
Network 44
Window 44
Login 44
Connection 45
Experience 45
Auto Reconnect 45
Application 45
Drive Mapping 46
Adding Share Names 46
Editing and Deleting Share Names 46
Device Mapping 47
Adding Devices 47
Deleting Devices 47
®
TEC 42
Contents vii
SSH 48
Network 48
Connection 48
VMware View Client 49
Network 49
Secure Preferences 49
Connection 49
Desktop 50
Login 50
VNC Viewer 51
Network 51
Connection 51
Window 51
Login 51
Web Browse r 52
Network 52
Window 52
Auto Reconnect 52
A Central Configuration: Automating Configurations 53
How INI Files are Employed 53
How to Set Up Automatic Configuration 54
Step 1: Prepare the Root Directory and Folder Structure on the Server 54
Step 2: Direct the Thin Client to the Server 56
Using DHCP 56
Manually Configuring the Server Location 58
Step 3: Reboot the Thin Client 58
viii Contents
This page intentionally blank.
1 Introduction
Wyse® Enhanced Ubuntu™ Linux combines the security, flexibility, and market-leading
usability of Ubuntu™ (trademark of Canonical Group Limited) with Wyse’s 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 Wyse thin clients running Wyse Enhanced
Ubuntu Linux. It provides information and detailed system configurations to help you
design and manage a Wyse Enhanced Ubuntu Linux environment. Depending on your
hardware and software configurations, the figures you see may be different than the
example figures 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 Wyse
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:
http://www.ubuntu.com/support
.
Finding the Information You Need in this Guide
You can use either the Search window or Find toolbar to locate a word, serie s of words, o r
partial word in an active PDF document. For detailed information on using these features,
refer to the Help in your PDF reader.
Wyse Technical Support
To access Wyse technical resources, visit http://www.wyse.com/support. If you still have
questions, you can submit your questions using the Wyse Self-Service Center at
http://support.wyse.com/selfservice.html
(toll free in U.S. and Canada). Hours of operation are from 6:00 A.M. to 5:00 P.M. Pacific
Time, Monday through Friday.
To access international support, visit http://www.wyse.com/global
Related Documentation and Services
Fact Sheets containing the features of hardware products are available on the Wyse Web
site. Go to http://www.wyse.com/products
download the Fact Sheet for your hardware product.
or call Customer Support at 1-800-800-WYSE
.
and use the Cloud clients tab to locate and
2 Chapter 1
Reference Guide: Wyse
administrators of Wyse thin clients running Wyse Enhanced Ubuntu Linux. It provides the
detailed information you need to help you understand and use the Wyse Enhanced
Ubuntu Linux INI files. It contains information on the differ ent INI files you can use and th e
rules for constructing the files. It also provides the parameter details you need (with
working examples) to get the most out of your INI files. It is available at:
http://www.wyse.com/manuals
Wyse Cloud Software is available on the Wyse Web site at:
http://www.wyse.com/products/software
Enhancing Your Experience with Wyse Software
Wyse provides several software products that are specifically designed to enhance your
thin client experience. Wyse Thin Computing Software is available on the Wyse Web site
at: http://www.wyse.com/products/software
Wyse Online Community
Wyse maintains an online community where users of our products can see k and exchange
information on user forums. Visit the Wyse Online Community forums at:
http://community.wyse.com/forum
®
Enhanced Ubuntu™ Linux INI Files is intended for
.
.
.
.
2 Getting St arted: Quickly Learning
the Basics
Use the following information to quickly 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"
TIP: While it can be used in environments without central configuration for basic
connectivity needs, 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 (see "Central Configuration: Automating
Configurations").
Logging In
TIP: On your initial connection to central configuration it is recommended that yo u connect
using a “wired connection” (plug in the network-connected ethernet cable to your thin
client before starting the thin client) to obtain the configurations desired by the
administrator (connections, system settings, required certificates and so on). This “wired
connection” will also provide any wireless configurations provided by the administrator
through the INI files.
If you must initially connect to central configuration through wireless, use the Edit
Wireless Connection dialog box (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 (see "Network
Connections").
After your thin client starts, Administrators (high privilege) can log in to your Home screen
using the default user name admin and the default case-sensitive password admin. It is
highly recommended that you change the default password by using the User
Administration dialog box in System Settings (see "User Administration").
Note that Thinuser users (low privilege for locked mode end-user) can use the de fault user
name thinuser and the default case-sensitive password thinuser; Guest users (no
privileges Kiosk type setup) can use default user name guest and do not need a
password.
4 Chapter 2
Using Your Home Screen
The Wyse Enhanced Ubuntu Linux Home screen is designed for efficiency and usability.
Use the following guidelines (depending on user privilege, some options may not be
available for use):
TIP: Each icon has a pop-up description for easy identification.
Table 1 Menu bar icons
Icon What It Does
Home Displays your Home screen (useful when many windows are
open and you want to quickly access your Home screen).
Open Applications
and Connections
Network Manager Manages your wired and wireless network connections (see
Volume Controls the audio volume (use the slider, click Mute All or
Calendar Lists the time, day of the week, and date. You can click the
Currently open application and connection icons are
displayed in the menu bar for convenient access.
"Connecting to Network and Session Services") .
Unmute as needed; Note that for these settings to take
effect, sound must be supported and enabled on the server
used for ICA or RDP connections).
calendar to display the calendar window.
System Settings Sets up your thin client hardware, look and feel, and system
settings (see "Configuring System Settings").
Getting Started: Quickly Learning the Basics 5
Table 1 Menu bar icons, Continued
Icon What It Does
System Information Opens the System Information dialog box. Use this dialog
box to view system information about the thin client (see
"Viewing System Information").
Quit Opens the Shutdown dialog box. Use this dialog bo x to lock,
logout, shutdown, restart, or suspend your thin client (see
"Locking, Logging Out, Shutting Down, Restarting, and
Suspending").
The Home screen also contains:
• 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 applicatio n and connection
icon opens the connections made available by an administrator. For example, a
browser, the terminal emulator window (see
connections (see "Configuring Connections").
"Using Wyse Terminal"), or other available
• Enter Edit Mode button - Enters the Home screen edit mode allowing you to
(depending on user privilege level, some edit mode features may not be available for
use; to exit edit mode, click the Exit Edit Mode icon):
· Edit connections - Click an icon and configure (see "Configuring Connections")
· Delete connections - Click the delete button of an icon and confirm.
· Add new connections - Click the Add Item icon, click the connection you want to
add, and then configure (see
"Configuring Connections").
6 Chapter 2
Home Screen Keyboard Shortcuts
Depending on the type of application window you are using (full screen, standard, or
seamless), you can use shortcut keys (see Table 2) to manage windows. Note that you
can also define shortcuts for launching applications (see "Keyboard").
TIP: The shortcut keys Alt+DownArrow (allows you to switch windows using a dialog box)
and Alt+Ctrl+DownArrow (minimizes or maximizes all windows) are useful for navigating
multiple remote sessions without having to log out.
CAUTION: If inside a session, some connection types will grab all the keystrokes and the
shortcuts may not always work. Be sure to check product release notes for the latest
details.
Table 2 Window-related Shortcut Keys
Window Action Press
Maximize window Alt+F10
Switch windows using a dialog box. Alt+DownArrow
Minimize/maximize all windows Alt+Ctrl+DownArrow
Move window with arrow keys Alt+F7 and press an arrow key
Resize window Alt+F8 and press an arrow key
Close the window Alt+F4
Configuring Thin Client Settings and Connections
While the use of Wyse INI files is recommended to configure thin client settings and
connections available to users (see "Central Configuration: Automating Configurations"),
you can use dialog boxes on a thin client to:
• Set up your thin client hardware, look and feel, and system settings (see "Configuring
System Settings").
• Configure and add connections to your Home screen for use (see "Configuring
Connections").
Getting Started: Quickly Learning the Basics 7
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:
• Click the Network Manager icon to display the Wired Network and Wireless Network
menus. For example you can click the Network Manager icon, and then select an
available wired or wireless network to use.
• Right-click the Network Manager icon to display the Enable Networking, Enable
Wireless, Enable Notifications, Connection Information, and About options. For
example, you can right-click the Network Manager icon, and then click Enable
Wireless to remove the check and disable wireless.
• Hover your mouse pointer over the icon to view a message displaying the status (No
Network Connection, Wired Network Connection Active, and Wireless Network
Connection Active) and name of the network to which your thin client is conne cted. For
example, connecting your thin client to a wired network (by attaching the network cable
to your thin client) displays the Wired Network Connection Active status.
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 bo x. Afte r authentication , the
wireless network is available for use.
TIP: For information on importing certificates that your network may require (according to
your administrator), see "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 "Printers."
Connecting to a Monitor
Monitor connections can be made using the DVI (digital) monitor port and the proper Wyse
monitor cables/splitters. For VGA (analog) monito r connections, you must use the
included DVI-to-VGA adapter. For information on configuring display settings, see
"Display."
TIP: Dual Monitors - When using a DVI to DVI/VGA splitter with VGA and DVI monitors at
the same time, note that the VGA monitor will be the primary monitor.
8 Chapter 2
Locking, Logging Out, Shutting Down, Restarting, and Suspending
After using your thin client, you can click the Quit icon and select one of the following
(depending on user privilege, some options may not be available for use; note also that
the shutdown screen is not configurable using INI parameters):
• Lock - Locks your thin client (display is blank 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.
• Suspend - Places the thin client in Standby mode to preserve power. To exit Standby
mode, click the mouse, or press the space bar o n the keyboard, or press the retur n key
on the keyboard.
Additional Getting Started Details
This section includes additional details on the following:
• "Viewing System Information"
• "Using Wyse Terminal"
• "Restoring Default Settings with WLoader Setup"
Viewing System Information
Use the System Information dialog box (click the System Information icon in the Menu
Bar) to view Identity, Network, Package, System Log, and Copyright information:
• 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.
• 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.
• Packages tab - Displays the Package information, including packages names,
versions, and sizes that are installed on the thin client.
• System Log tab - Displays the System Log information, including various messages
generated during the operation of the thin client.
• Copyright tab - Displays the software copyright and patent notices.
Getting Started: Quickly Learning the Basics 9
Using 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 (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: Terminal is for various low level administrative
purposes. It is available only to users with high privileges. It is recommended for
experienced administrators who ha ve ex tensive knowledge of the Linux system.
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.
3. When the Activity light (next to the Power button) blinks, release the Power button.
4. When the BIOS password prompt is displayed, release the Delete key.
5. 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.
3. When the Activity light (next to the Power button) blinks, release the Power button.
4. When the BIOS password prompt is displayed, type Fireport as the password.
5. When the one-time boot menu of options is displayed, select the Recovery option and
then press Enter (restores the complete image and removes any updated package).
10 Chapter 2
This page intentionally blank.
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):
TIP: While it is not recommended 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 (smaller
environments). In general, it is recommended tha t you use cen tral configur ation to en able
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 (see "Enhancing Your Experience with Wyse Software").
• "Accessibility"
• "Appearance"
• "Background"
• "Date & Time"
• "Device Settings"
• "Diagnostics"
• "Display"
• "Ericom PowerTerm® TEC (Managing Servers Available for Connections)"
• "Citrix Settings (Global Settings)"
• "Import Certificates"
• "INI (Source) Settings"
• "Keyboard"
• "Language Support"
• "Mixer"
• "Mouse"
• "Network Connections"
• "Network Proxy"
• "Printers"
• "RDP Settings"
• "Screensaver"
• "TCX Audio"
• "TCX USB Virtualizer"
• "User Administration"
• "VNC Server"
• "WDM"
12 Chapter 3
Accessibility
Use the Accessibility dialog box (click Accessibility) to set S ticky Keys, Slow Keys, and
Bounce Keys options.
Appearance
Use the Appearance dialog box (click Appearance) to customize your Home screen
(Style, Icons, and Fonts).
Background
Configuring System Settings 13
Use the Background dialog box (click Background) to customize your desktop
background.
TIP: 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).
Loading...