Sumo WML Thin Client User manual

WML Sumo Thin Client User Guide
Manual Version 1.0c
August 2006
Sumo Thin Client User Guide
© 2006 William Matthew Limited. All rights reserved.
Sumo ersion 1 (OS Release 2)
Sumo is a registered Trademark.
All Trademarks observed.
page 1/54
Copyright © 2006 William Matthew Limited. All rights reserved
SUMO Thin Client User Guide

WML Sumo Thin Client User Guide
Acknowledge ents: Willia Matthew Li ited recognises and acknowledges all registered Trade
Marks and copyright of all products entioned within this guide.
E&OE
Software Licence and Copyright
The Software is copyright Embedded Software Foundry Limited. It is sold under licence by William Matthew
Limited, 22 Haxey Lane, Haxey, Doncaster, South Yorkshire, DN9 2NE. UK. Email [email protected]
“The Software” refers to the Client Connection Manager and the Client Setup Manager. The operating
system source code is released under various free software licences, and may be obtained from William
Matthew Limited on request.
IMPORTANT: Before using the Software installed on the Sumo Thin Client please read the licence
agreement carefully, the right to use this software is granted only if the Customer agrees to the terms of this
Licence. If you do not agree 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 Sumo Thin Client Product range, The Licence is
to be used without any time limit and maybe subject to change.
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 rights against 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 instigate legal proceedings to protect the
intellectual property rights of the Sumo Thin Client and William Matthew Limited.
5. This Licence and the Software product may be transferred to a third party provided the third party agrees
to all the terms of this licence and that no copies of the Software are retained by the transferring party.
6. William Matthew reserves the right 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 copyright and is subject to
English Law.
page 2/54
Copyright © 2006 William Matthew Limited. All rights reserved

WML Sumo Thin Client User Guide
Table of Contents
Introduction to Sumo Thin Client.........................................................................................................5
Technical Data......................................................................................................................................6
Connectivity Ports.......................................................................................................................6
Powering on/off...........................................................................................................................6
Monitors......................................................................................................................................6
Initial Setu Wizard..............................................................................................................................7
Client Connection Manager................................................................................................................12
Connections Tab – Overview........................................................................................................13
Configuration 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
O tional: NX key......................................................................................................................20
NoMachine NX: Deskto Tab..................................................................................................21
Launching an NX Connection...................................................................................................22
Editing an existing NX connection...........................................................................................26
Citrix ICA......................................................................................................................................27
Sound su ort...........................................................................................................................27
Local USB storage device access..............................................................................................27
RDP: Remote Deskto Protocol....................................................................................................29
X Windows - XDMCP...................................................................................................................30
XDMCP Broadcast...................................................................................................................30
X Font Servers..........................................................................................................................31
VNC – TightVNC..........................................................................................................................32
Secure Shell - SSH.........................................................................................................................33
Telnet.............................................................................................................................................34
Web Browser.................................................................................................................................35
Firefox settings..........................................................................................................................35
Custom .NET rogram...................................................................................................................36
Client Setu Manager.........................................................................................................................37
System............................................................................................................................................38
Saving and Loading System Settings........................................................................................38
Restoring Factory Default Settings...........................................................................................40
Network-wide configuration.....................................................................................................40
Locale.............................................................................................................................................42
Network.........................................................................................................................................43
Remote access to the Sumo.......................................................................................................43
Remote SSH access..............................................................................................................43
Remote VNC access.............................................................................................................44
S ecifying X Font Server (xfs).................................................................................................44
Dis lay...........................................................................................................................................45
Mouse.............................................................................................................................................46
Printing...........................................................................................................................................47
Firmware........................................................................................................................................48
page 3/54
Copyright © 2006 William Matthew Limited. All rights reserved

WML Sumo Thin Client User Guide
Password........................................................................................................................................50
Sound.............................................................................................................................................51
Information....................................................................................................................................52
Administrator and Power User Tools.................................................................................................53
Startu scri t.............................................................................................................................53
Smartcard su ort...............................................................................................................................54
page 4/54
Copyright © 2006 William Matthew Limited. All rights reserved

WML Sumo Thin Client User Guide
Introduction to Su o Thin Client
The Sumo Thin Client is a revolutionary Linux based thin client that allows easy windows style
setu . Sumo su orts NoMachine NX, Citrix ICA client version 9, RDP5 connections, SSH
(o enssh), VNC (tightVNC) and X server (unix XDMCP).
The Sumo rovides web browsing ca abilities with Mozilla Firefox 1.5. Numerous embedded
a lications are rovided for system admins and ower users (sc , sft , nano, vi and dillo).
A unique feature of the Sumo is that rograms normally associated with Windows based latforms
can be embedded. The inclusion of the Mono runtime environment makes this ossible. Mono is an
im lementation of the .NET 1.1 framework. The Sumo rovides Mono with Winforms and GTK#.
These .NET a lications can reside on a local webserver and the latest version of the a lication
will be dynamically loaded on ower u to every Sumo box on the network. This feature will allow
you to centrally manage the software a lication and reduce the su ort required to maintain
standard user deskto s.
page 5/54
Copyright © 2006 William Matthew Limited. All rights reserved

WML Sumo Thin Client User Guide
Technical Data
Connectivity Ports
The unit comes with four USB V1.1 orts for this articular model. You can use one or all
simultaneously for keyboard and mouse or other eri herals.
Powering on/off
The on/off button is the sole means for owering the unit on or off. When the on/off button is
ressed while the unit is owered on, the Sumo will go into shutdown mode and will ower off after
about 3 seconds. If the unit fails to ower off, hold the on/off button down for 10 seconds.
Monitors
The Sumo requires that the connected monitor rovides the DDC rotocol which allows the Sumo
to determine the available resolution and frequency settings for the monitor. Most modern monitors
are DDC com liant.
page 6/54
Copyright © 2006 William Matthew Limited. All rights reserved

WML Sumo Thin Client User Guide
Initial Setup Wizard
Connect a monitor to the unit’s video ort and a USB keyboard and mouse to any of the Sumo USB
orts. The network connection should be connected to your LAN hub/switch or ADSL router using
an RJ45 network cable.
Connect the su lied ower ada ter to the Sumo and ress the on/off 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 o tion of switching to your chosen locale. This will set the language
and keyboard setting to match your country. If you change the locale, then the Setu Manager will
re-start with the chosen keyboard and language.
page 7/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 1: Setup Wizard - Language and Keyboard Layout

WML Sumo Thin Client User Guide
The second screen gives co yright information about the thin client.
The third screen gives you the choice of allowing DHCP to set the network settings for the client
(selected by default) or configuring the settings manually.
If “Set the network u manually” is chosen, you are resented with two screens to configure the IP
address and the DNS settings.
page 8/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 3: Setup Wizard - Network Settings
Illustration 2: Setup Wizard - Initial Setup Window

WML Sumo Thin Client User Guide
After the network window(s) have been filled in, the network settings are a lied.
page 9/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 4: Setup Wizard - anual IP Settings
Illustration 5: Setup Wizard - anual DNS Settings

WML Sumo Thin Client User Guide
The next screen allows you to choose your referred dis lay resolution. The autodetected resolution
will be shown re-selected. If you change the resolution, the monitor will switch resolution and a
confirmation window will a ear. Click OK if the new resolution is functioning, or “Revert” to
switch back to the original resolution. If the new resolution fails, and the dis lay disa ears, wait
for 10 seconds, and the dis lay will automatically revert back to the original autodetected
resolution.
Printer setu will be dis layed in the next window. If you require a locally connected rinter on
your Sumo, connect the rinter to one of the USB orts. In order to rint to the rinter you will need
to set u the rint driver on a server and direct the rint to the Sumo. An exam le of this rocess is
described on this window.
page 10/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 6: Setup Wizard - Display Resolution Settings
Illustration 7: Setup Wizard - Print Setup Information Window

WML Sumo Thin Client User Guide
The final window is a confirmation window informing you that the setu rocess is com lete. Click
“Finished” and the Setu Wizard will close, and the Connection Manager will be launched. You're
now ready to configure your connections.
page 11/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 8: Setup Wizard - Setup is Complete

WML Sumo Thin Client User Guide
Client Connection Manager
The client connection manager runs every time the Sumo thin client is owered u . It manages all
of your connections and rovides an interface for you to configure new connections. You can
always return to the Connection Manager using the key combination Ctrl-Alt-End (exce t when
initially running the Setu Wizard).
The connection manager manages the windows of each running connection and allows you to
switch between the windows using the key combination Ctrl-Alt-Down.
There are a variety of ways to connect to a local or remote server, WML recommend using No
Machine NX. No Machine is a very cost effective and reliable method, it will allow multi le full
gra hic sessions to any machine that has the inex ensive No Machine server software loaded. With
No Machine NX you can also run a low erformance session to a remote server using a dial u
modem, although this would be slow in terms of res onse times.
The connection manager also allows you to configure Citrix ICA, RDP, VNC, SSH, telnet, www
and XDMCP connections. The setu of each connection is covered in the following sections.
Toolti s are rovided throughout the Connection and Setu Managers, giving you context sensitive
hel .
page 12/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 9: A new, empty Connection anager

WML Sumo Thin Client User Guide
Connections Tab – Overview
The “Connections” tab of the Connection Manager is available to any user of the thin client.
Illustration 10 shows a Connection Manager with two configured connections. One connection is
called “Login to master server” and is of ty e xdmc – 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 features of the interface are:
1. The Connect button. Launches the highlighted connection. If 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 Configure tab is a darker shade of gray, showing that it is not selected.
4. The “Name” field shows the name of the connection, as given by the administrator.
5. The “Ty e” field shows the connection rotocol.
6. The “Connected?” field will be checked for any connections which are currently active.
7. The “Program out ut” field shows the first line of any out ut generated by the connection,
after it has finished. This can be useful for diagnosing failed connections due to network
roblems.
8. The “Details” field will be checked if the connection generates out ut. Click on the
checkbox to view the full out ut in a se arate screen.
9. The “Terminal” button is o tional – it can be switched on in the Setu Manager. This is
intended for ower users and administrators. Note that if the terminal is available, a user of
the Sumo cannot be prevented from manually editing the connection configuration.
page 13/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 10: An overview of the Connections tab of the Connection anager

WML Sumo Thin Client User Guide
In the exam le shown in Illustration 11, the out ut from 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.
page 14/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 11: The Program output window

WML Sumo Thin Client User Guide
Configuration Tab – Overview
The Configuration tab is assword rotected and is intended for the use of administrators.
Illustration 12 shows the Configuration tab with the same connections configured as in Illustration
10
The features of the Configuration tab are:
1. The “Name” field shows the name of the connection, as given by the administrator.
2. The “Ty e” field shows the connection rotocol.
3. If the “At boot?” field is checked, the connection will be launched when the Sumo owers
u . You can check and uncheck this field without o ening the Connection Details window
for 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 ress
“Edit”).
6. The “Delete” button is used to delete a connection. Note that a running connection may not
be deleted – first shut it down, then highlight its entry in the list and ress the “Delete”
button.
7. The “Setu ” button launches the Setu Manager. This has the same effect as ressing the F2
key.
8. The “ICA Settings” button o ens a window to configure certain settings which are used by
the Citrix ICA client rogram for all ICA connections.
9. The “Logout” button ends your use of the Configuration tab. Once you have logged out, to
add, edit or delete connections, you'll need to re-enter your assword.
page 15/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 12: An overview of the Configuration tab of the Connection anager

WML Sumo Thin Client User Guide
Creating a new Connection
To set u any new connection, you need to switch to the “Configuration” tab of the Connection
manager. You will be asked for the administration assword, which is sim ly “ assword” for a
factory delivered box.
On the configuration tab, click on the “new” button to create a new connection.
page 16/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 13: Connection anager - Entering the administration password
Illustration 14: Connection anager – Clicking the “New” button to create a connection

WML Sumo Thin Client User Guide
A window will a ear with a dro -down menu from which you can choose the ty e of connection
you want to create. In Illustration 15, a Nomachine NX connection is highlighted. Press OK, and the
configuration window of the selected connection will a ear, and you can then enter the details for
the connection.
page 17/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 15: Choosing a Nomachine NX connection

WML Sumo Thin Client User Guide
Editing a Connection
To edit a reviously configured connection, select the “Configuration” tab again, entering the
assword if necessary. Highlight the connection to edit, and ress the “Edit” button. The relevant
connection details window will a ear and the configuration can be changed as normal.
NoMachine NX
If you are editing a Nomachine NX connection: If you reviously elected to save the assword of
the user, the act of editing the connection will delete the stored assword and the user will need to
re-enter the assword 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 of the connection. All other details of the connection may be
changed.
page 18/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 16: Choosing "Edit" for the highlighted connection

WML Sumo Thin Client User Guide
NoMachine NX
Create a new connection of ty e Nomachine NX. The NoMachine NX Connection Details window
will a ear with the “Network” Tab re-selected. This window rovides an interface to create the
NX session . When the session is launched, NoMachine's own NX Client rogram is used to launch
the connection.
NoMachine NX: Network Tab
The NoMachine NX Connection Details window has fields for the connection name and the
network details – server address, ort, username etc. You can also select a number of o tions to
control how the NX connection behaves.
In Connection Name, enter the name of the connection, as you want it to a ear in the Connection
Manager. The Connection Name may include s aces, but none of the characters: " ' = , . ; : / \.
In the address field, enter either the network name or the IP number of the NX server. The ort to
connect to is usually the same as the SSH ort (22) but this is not always the case. Enter the
username for the connection and check the checkbox if the assword should be stored on the thin
client between reboots. If stored, it will be ke t in hashed form in the connection's .nxs file.
page 19/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 17: Entering network details for Nomachine NX connection

WML Sumo Thin Client User Guide
Optional: NX key
NX connections use SSH to encry t the connection between the client and server and as such NX is
the most secure gra hical thin client connection available. The login rocess uses a two-stage
rocess. The first login uses a key-based login. A standard NX key is su lied as a default, and
using this key, a client can roceed to the second secure login, which uses a assword as
authentication token. If you use the default NX key on your server, then any client can ass the
stage 1 login, and can attem t to use assword based login to gain access to the server. This remains
secure, but relies on quality asswords.
To increase the security of your connection, you can re lace the default key on your NX server.
Please refer to Nomachine's documentation on setting u the NX server. Once you have generated a
non-standard key for the stage 1 login, you need to load it onto your Sumo thin client. Put the key
file on a USB en-drive and lug it into your Sumo. Press the “Manage Key” button in the NX
Connection Details window. The Public SSL Key window will a ear. While you could technically
ty e in the key, it would be a thankless task. Press the “Change Key” button to o en a file dialog,
which will allow you to find the key on your USB drive.
page 20/54
Copyright © 2006 William Matthew Limited. All rights reserved
Illustration 18: anaging the NX SSL key