William Matthew Limited WML Linux User manual

WML Linux Thin Client User Guide
Manual Version 1.1b
September 2008
WML Linux Thin Client User Guide
© 2008 William Matthew Limited. All ri hts reserved.
WML Linux Thin Client OS Release 2.5.1
All Trademarks observed.
pa e 1/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
WML Linux Thin Client User Guide

WML Linux Thin Client User Guide
Acknowled ements: William Matthew Limited reco nises and acknowled es all re istered Trade
Marks and copyri ht of all products mentioned within this uide.
E&OE
Software Licence and Copyri ht
The Software is copyri ht Embedded Software Foundry Limited. It is sold under licence by William Matthew
Limited, 22 Haxey Lane, Haxey, Doncaster, South Yorkshire, DN9 2NE. UK. Email [e-mail]
“The Software” refers to the Client Connection Manager and the Client Setup Manager. The operatin system
source code is released under various free software licences, and may be obtained from William Matthew
Limited on request.
IMPORTANT: Before usin the Software installed on the WML Linux Thin Client please read the licence
a reement carefully, the ri ht to use this software is ranted only if the Customer a rees to the terms of this
Licence. If you do not a ree to the terms of this Licence, please return the product unused.
Use of the Software is your acceptance of our terms and conditions of the license.
1. The Software has been developed for use with the WML Linux Thin Client Product ran e, The Licence is to
be used without any time limit and maybe subject to chan e.
2. The Software may not be duplicated, copied, resold, or re-branded without the written consent of William
Matthew Limited.
3. It is the responsibility of any user, reseller, Distributor, OEM and other third party to protect William Matthew
Limited ri hts a ainst violation of this Software Licence.
4. William Matthew will consider any attempt to duplicate the functionality of any application provided by the
software will constitute a breach of software licence, and may insti ate le al proceedin s to protect the
intellectual property ri hts of the WML Linux Thin Client and William Matthew Limited.
5. This Licence and the Software product may be transferred to a third party provided the third party a rees to
all the terms of this licence and that no copies of the Software are retained by the transferrin party.
6. William Matthew reserves the ri ht to terminate this Licence upon breach.
7. In the event of a termination, all copies of the software must be returned to William Matthew Ltd
8. Any disputes In respect of the Software Licence will be considered a breach of copyri ht and is subject to
En lish Law.
pa e 2/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved

WML Linux Thin Client User Guide
Table of Contents
Introduction to WML Linux Thin Client..................................................................................................5
Technical Data...........................................................................................................................................6
Connectivity Ports............................................................................................................................6
Powering on/o ...............................................................................................................................6
Monitors...........................................................................................................................................6
Initial Setup Wizard...................................................................................................................................7
Client Connection Manager.....................................................................................................................12
Connections Tab – Overview.............................................................................................................13
Con iguration Tab – Overview...........................................................................................................15
Creating a new Connection................................................................................................................16
Editing a Connection..........................................................................................................................18
NoMachine NX.........................................................................................................................18
Citrix ICA..................................................................................................................................18
NoMachine NX...................................................................................................................................19
NoMachine NX: Network Tab.......................................................................................................19
Optional: NX key...........................................................................................................................20
NoMachine NX: Desktop Tab.......................................................................................................21
Launching an NX Connection.......................................................................................................22
Editing an existing NX connection................................................................................................26
Citrix ICA...........................................................................................................................................27
Sound support................................................................................................................................27
Local USB storage device access..................................................................................................27
RDP: Remote Desktop Protocol.........................................................................................................29
GraphOn GoGlobal For Windows......................................................................................................30
X Windows - XDMCP........................................................................................................................32
XDMCP Broadcast........................................................................................................................32
X Font Servers...............................................................................................................................33
VNC – TightVNC...............................................................................................................................34
Secure Shell - SSH..............................................................................................................................35
Telnet...................................................................................................................................................36
Web Browser.......................................................................................................................................37
Fire ox settings...............................................................................................................................37
Custom programs................................................................................................................................38
Sun Secure Global Desktop................................................................................................................39
Client Setup Manager..............................................................................................................................40
System.................................................................................................................................................41
Saving and Loading System Settings............................................................................................41
Restoring Factory De ault Settings...............................................................................................43
Network-wide con iguration..........................................................................................................43
Locale..................................................................................................................................................45
Network...............................................................................................................................................46
Remote access to the WML Linux Thin Client.............................................................................46
Remote SSH access...................................................................................................................46
Remote VNC access..................................................................................................................47
Speci ying X Font Server (x s)......................................................................................................47
Wireless networking......................................................................................................................48
Display................................................................................................................................................51
pa e 3/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved

WML Linux Thin Client User Guide
Mouse..................................................................................................................................................52
Printing................................................................................................................................................53
Firmware.............................................................................................................................................54
Manually Initiating a Firmware Upgrade......................................................................................54
Automatic Firmware Upgrades.....................................................................................................55
Installing a irmware upgrade ile on a LAN web server.............................................................56
Password.............................................................................................................................................58
Sound..................................................................................................................................................59
In ormation.........................................................................................................................................60
Administrator and Power User Tools......................................................................................................61
Startup script..................................................................................................................................61
Smartcard support....................................................................................................................................62
pa e 4/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved

WML Linux Thin Client User Guide
Introduction to WML Linux Thin Client
The WML Linux Thin Client is a revolutionary Linux based thin client that allows easy windows
style setup. The WML Linux Thin Client supports NoMachine NX, GraphOn GoGlobal or
Windows, Citrix ICA client version 9, RDP5 connections, SSH (openssh), VNC (tightVNC) and X
server (unix XDMCP).
The WML Linux Thin Client provides web browsing capabilities with Mozilla Fire ox 1.5. Numerous
embedded applications are provided or system admins and power users (scp, s tp, nano and vi).
Based on the Sumo Technologies ST166 and ST168 hardware plat orms, the WML Linux Thin Client
will provide years o trouble ree service.
A unique eature o the WML Linux Thin Client is that programs normally associated with Windows
based plat orms can be embedded. The inclusion o the Mono runtime environment makes this
possible. Mono is an implementation o the .NET 1.1 ramework. The WML Linux Thin Client
provides Mono with Win orms and GTK#. These .NET applications can reside on a local webserver
and the latest version o the application will be dynamically loaded on power up to every WML Linux
Thin Client box on the network. This eature will allow you to centrally manage the so tware
application and reduce the support required to maintain standard user desktops.
pa e 5/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved

WML Linux Thin Client User Guide
Technical Data
Connectivity Ports
The unit comes with our USB V1.1 ports or this particular model. You can use one or all
simultaneously or keyboard and mouse or other peripherals.
Powerin on/off
The on/o button is the sole means or powering the unit on or o . When the on/o button is pressed
while the unit is powered on, the WML Linux Thin Client will go into shutdown mode and will power
o a ter about 3 seconds. I the unit ails to power o , hold the on/o button down or 10 seconds.
Monitors
The WML Linux Thin Client requires that the connected monitor provides the DDC protocol which
allows the graphics so tware to determine the available resolution and requency settings or the
monitor. Most modern monitors are DDC compliant.
pa e 6/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved

WML Linux Thin Client User Guide
Initial Setup Wizard
Connect a monitor to the unit’s video port and a USB keyboard and mouse to any o the WML Linux
Thin Client USB ports. The network connection should be connected to your LAN hub/switch or
ADSL router using an RJ45 network cable.
Connect the supplied power adapter to the WML Linux Thin Client and press the on/o button and
the blue led should illuminate and the unit should boot.
Note: USE ONLY THE SUPPLIED POWER ADAPTER OR YOU WILL INVALIDATE ANY
WARRANTY.
The initial screen gives you the option o switching to your chosen locale. This will set the language
and keyboard setting to match your country. I you change the locale, then the Setup Manager will re-
start with the chosen keyboard and language.
pa e 7/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 1: Setup Wizard - Language and Keyboard Layout

WML Linux Thin Client User Guide
The second screen gives copyright in ormation about the thin client.
The third screen gives you the choice o allowing DHCP to set the network settings or the client
(selected by de ault) or con iguring the settings manually.
I “Set the network up manually” is chosen, you are presented with two screens to con igure the IP
address and the DNS settings.
pa e 8/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 3: Setup Wizard - Network Settings
Illustration 2: Setup Wizard - Initial Setup Window

WML Linux Thin Client User Guide
A ter the network window(s) have been illed in, the network settings are applied.
pa e 9/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 4: Setup Wizard - anual IP Settings
Illustration 5: Setup Wizard - anual DNS Settings

WML Linux Thin Client User Guide
The next screen allows you to choose your pre erred display resolution. The autodetected resolution
will be shown pre-selected. I you change the resolution, the monitor will switch resolution and a
con irmation window will appear. Click OK i the new resolution is unctioning, or “Revert” to
switch back to the original resolution. I the new resolution ails, and the display disappears, wait or
10 seconds, and the display will automatically revert back to the original autodetected resolution.
Printer setup will be displayed in the next window. I you require a locally connected printer on your
WML Linux Thin Client, connect the printer to one o the USB ports. In order to print to the printer
you will need to set up the print driver on a server and direct the print to the WML Linux Thin Client.
An example o this process is described on this window.
pa e 10/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 6: Setup Wizard - Display Resolution Settings
Illustration 7: Setup Wizard - Print Setup Information Window

WML Linux Thin Client User Guide
The inal window is a con irmation window in orming you that the setup process is complete. Click
“Finished” and the Setup Wizard will close, and the Connection Manager will be launched. You're
now ready to con igure your connections.
pa e 11/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 8: Setup Wizard - Setup is Complete

WML Linux Thin Client User Guide
Client Connection Mana er
The client connection manager runs every time the WML Linux Thin Client is powered up. It
manages all o your connections and provides an inter ace or you to con igure new connections. You
can always return to the Connection Manager using the key combination Ctrl-Alt-End (except when
initially running the Setup Wizard).
The connection manager manages the windows o each running connection and allows you to switch
between the windows using the key combination Ctrl-Alt-Down.
There are a variety o ways to connect to a local or remote server, WML recommend using No
Machine NX. No Machine is a very cost e ective and reliable method, it will allow multiple ull
graphic sessions to any machine that has the inexpensive No Machine server so tware loaded. With
No Machine NX you can also run a low per ormance session to a remote server using a dial up
modem, although this would be slow in terms o response times.
The connection manager also allows you to con igure Citrix ICA, RDP, VNC, SSH, telnet, www and
XDMCP connections. The setup o each connection is covered in the ollowing sections.
Tooltips are provided throughout the Connection and Setup Managers, giving you context sensitive
help.
pa e 12/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 9: A new, empty Connection anager

WML Linux Thin Client User Guide
Connections Tab – Overview
The “Connections” tab o the Connection Manager is available to any user o the thin client.
Illustration 10 shows a Connection Manager with two con igured connections. One connection is
called “Login to master server” and is o type xdmcp – it's an X windows connection. The second
connection is a secure shell login called “Admin secure shell login”. In this window, neither
connection is currently highlighted.
In Illustration 10, the numbered eatures o the inter ace are:
1. The Connect button. Launches the highlighted connection. I the highlighted connection is
already connected, then the connection becomes the current connection.
2. The Connections tab is a lighter gray, showing that it is the selected tab.
3. The Con igure tab is a darker shade o gray, showing that it is not selected.
4. The “Name” ield shows the name o the connection, as given by the administrator.
5. The “Type” ield shows the connection protocol.
6. The “Connected?” ield will be checked or any connections which are currently active.
7. The “Program output” ield shows the irst line o any output generated by the connection,
a ter it has inished. This can be use ul or diagnosing ailed connections due to network
problems.
8. The “Details” ield will be checked i the connection generates output. Click on the checkbox
to view the ull output in a separate screen.
9. The “Terminal” button is optional – it can be switched on in the Setup Manager. This is
intended or power users and administrators. Note that if the terminal is available, a user of
the W L Linux Thin Client cannot be prevented from manually editing the connection
configuration.
pa e 13/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 10: An overview of the Connections tab of the Connection anager

WML Linux Thin Client User Guide
In the example shown in Illustration 11, the output rom ssh is that server.network.com is an unknown
name, indicating that the domain name server couldn't resolve server.network.com into an IP address.
pa e 14/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 11: The Program output window

WML Linux Thin Client User Guide
Configuration Tab – Overview
The Con iguration tab is password protected and is intended or the use o administrators. Illustration
12 shows the Con iguration tab with the same connections con igured as in Illustration 10
The eatures o the Con iguration tab are:
1. The “Name” ield shows the name o the connection, as given by the administrator.
2. The “Type” ield shows the connection protocol.
3. I the “At boot?” ield is checked, the connection will be launched when the WML Linux Thin
Client powers up. You can check and uncheck this ield without opening the Connection
Details window or the connection.
4. The “New” button is used to create a new connection.
5. The “Edit” button is used to edit an existing connection (highlight the connection then press
“Edit”).
6. The “Delete” button is used to delete a connection. Note that a running connection may not be
deleted – irst shut it down, then highlight its entry in the list and press the “Delete” button.
7. The “Setup” button launches the Setup Manager. This has the same e ect as pressing the F2
key.
8. The “ICA Settings” button opens a window to con igure certain settings which are used by the
Citrix ICA client program or all ICA connections.
9. The “Logout” button ends your use o the Con iguration tab. Once you have logged out, to
add, edit or delete connections, you'll need to re-enter your password.
pa e 15/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 12: An overview of the Configuration tab of the Connection anager

WML Linux Thin Client User Guide
Creating a new Connection
To set up any new connection, you need to switch to the “Con iguration” tab o the Connection
manager. You will be asked or the administration password, which is simply “password” or a actory
delivered box.
On the con iguration tab, click on the “new” button to create a new connection.
pa e 16/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 13: Connection anager - Entering the administration password
Illustration 14: Connection anager – Clicking the “New” button to create a connection

WML Linux Thin Client User Guide
A window will appear with a drop-down menu rom which you can choose the type o connection you
want to create. In Illustration 15, a Nomachine NX connection is highlighted. Press OK, and the
con iguration window o the selected connection will appear, and you can then enter the details or the
connection.
pa e 17/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 15: Choosing a Nomachine NX connection

WML Linux Thin Client User Guide
Editing a Connection
To edit a previously con igured connection, select the “Con iguration” tab again, entering the
password i necessary. Highlight the connection to edit, and press the “Edit” button. The relevant
connection details window will appear and the con iguration can be changed as normal.
NoMachine NX
I you are editing a Nomachine NX connection: I you previously elected to save the password o the
user, the act o editing the connection will delete the stored password and the user will need to re-
enter the password the next time the connection is run.
Citrix ICA
Once you have created an ICA connection with a given connection name, you can no longer change
that name when you edit the details o the connection. All other details o the connection may be
changed.
pa e 18/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 16: Choosing "Edit" for the highlighted connection

WML Linux Thin Client User Guide
NoMachine NX
Create a new connection o type Nomachine NX. The NoMachine NX Connection Details window
will appear with the “Network” Tab pre-selected. This window provides an inter ace to create the NX
session . When the session is launched, NoMachine's own NX Client program is used to launch the
connection.
NoMachine NX: Network Tab
The NoMachine NX Connection Details window has ields or the connection name and the network
details – server address, port, username etc. You can also select a number o options to control how
the NX connection behaves.
In Connection Name, enter the name o the connection, as you want it to appear in the Connection
Manager. The Connection Name may include spaces, but none o the characters: " ' = , . ; :
/ \.
In the address ield, enter either the network name or the IP number o the NX server. The port to
connect to is usually the same as the SSH port (22) but this is not always the case. Enter the username
or the connection and check the checkbox i the password should be stored on the thin client between
reboots. I stored, it will be kept in hashed orm in the connection's .nxs ile.
pa e 19/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 17: Entering network details for Nomachine NX connection

WML Linux Thin Client User Guide
Optional: NX key
NX connections use SSH to encrypt the connection between the client and server and as such NX is
the most secure graphical thin client connection available. The login process uses a two-stage process.
The irst login uses a key-based login. A standard NX key is supplied as a de ault, and using this key,
a client can proceed to the second secure login, which uses a password as authentication token. I you
use the de ault NX key on your server, then any client can pass the stage 1 login, and can attempt to
use password based login to gain access to the server. This remains secure, but relies on quality
passwords.
To increase the security o your connection, you can replace the de ault key on your NX server. Please
re er to Nomachine's documentation on setting up the NX server. Once you have generated a non-
standard key or the stage 1 login, you need to load it onto your WML Linux Thin Client. Put the key
ile on a USB pen-drive and plug it into your WML Linux Thin Client. Press the “Manage Key”
button in the NX Connection Details window. The Public SSL Key window will appear. While you
could technically type in the key, it would be a thankless task. Press the “Change Key” button to open
a ile dialog, which will allow you to ind the key on your USB drive.
pa e 20/62
Copyri ht © 2008 William Matthew Limited. All ri hts reserved
Illustration 18: anaging the NX SSL key