HP T5125 - Compaq Thin Client Service manual

Administrator’s Guide
Linux-based Image for HP Compaq
t5125 and t5525 Thin Clients
Document Part Number: 395346-001
June 2005
This guide provides network administrators with basic instructions
for configuring Linux-based thin clients.

© Copyright 2005 Hewlett-Packard Development Company, L.P.
The information contained herein is subject to change without notice.
Microsoft, MS-DOS, Windows, and Windows NT are trademarks of Microsoft
Corporation in the U.S. and other countries.
Adobe, Acrobat, and Acrobat Reader are trademarks or registered trademarks of
Adobe Systems Incorporated.
The only warranties for HP products and services are set forth in the express
warranty statements accompanying such products and services. Nothing herein
should be construed as constituting an additional warranty. HP shall not be liable
for technical or editorial errors or omissions contained herein.
This document contains proprietary information that is protected by copyright.
No part of this document may be photocopied, reproduced, or translated to
another language without the prior written consent of Hewlett-Packard
Company.
ÅWARNING: Text set off in this manner indicates that failure to follow
directions could result in bodily harm or loss of life.
ÄCAUTION: Text set off in this manner indicates that failure to follow
directions could result in damage to equipment or loss of information.
Administrator’s Guide
Linux-based Image for HP Compaq t5125 and t5525 Thin Clients
First Edition (June 2005)
Document Part Number: 395346-001

Administrator’s Guide www.hp.com iii
Contents
1Introduction
Thin Client Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2
Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
HP Compaq t5125 Thin Client Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
HP Compaq t5525 Thin Client Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–5
Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–8
Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–8
Web Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–9
Citrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–9
HP Connection Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–9
VNC Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–9
VNC Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–10
Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–11
HP Desktop Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–12
Linux Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–13
Image Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–13
2HP Connection Administrator
HP Connection Administrator Window Field Definitions . . . . . . . . . . . . . . . . . . . . . . 2–2
Advanced Configuration Window Field Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . 2–4
Assign Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–5
Global UI Kiosk Settings (Advanced) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–7
Adding, Editing, And Deleting Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–8
Connection Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–10
Assigning Connections to Users in the Advanced Configuration Window . . . . . 2–19
Designating Connections as Primary or Secondary . . . . . . . . . . . . . . . . . . . . . . . 2–19
Making a Connection Automatically Connect when HP Connection Administrator is
Launched. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–20
Making a Connection Automatically Reconnect if it Disconnects. . . . . . . . . . . . 2–21

iv www.hp.com Administrator’s Guide
Contents
3Citrix
Citrix (ICA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–1
Program Neighborhood Agent (PNAgent) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–2
Additional Citrix Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–2
4Settings
Date/Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–3
Desktop: backdrop. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–4
Desktop Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–5
VNC Shadow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–5
Display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–6
Screen Saver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–8
Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–9
Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–10
Network Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–11
Printer Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–12
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–14
Sound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–14
System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–15
General Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–16
Network Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–17
About Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–17
Taskbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–18
User Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–19
Managing a User Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–20
Managing a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–21
Windows Manager Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–23
Decoration Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–24
Keyboard and Focus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–25
Advanced . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–26
XFCE Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–27
5Support
Hardware Warranty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–1
Software Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–1
Image Updates and Add-ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–2

Administrator’s Guide www.hp.com v
Contents
Custom Image Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–2
Availability of Open Source Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–3
Additional Linux Resources on the Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–4

vi www.hp.com Administrator’s Guide
Contents

Administrator’s Guide www.hp.com 1-1
1
Introduction
This guide provides the network administrator with instructions for
local and remote configuration of the Linux-based thin client and
explains the various utilities used to accomplish this task. This guide
provides instructions for both the HP Compaq t5125 thin client and
the HP Compaq t5525 thin client.
✎Not all features described in this guide are available in all
Linux-based terminal models.
Typically, a terminal is configured locally and then used as a template
for other terminals, which then can be configured via remote
administration tools. Server and application connections can be
created through the Settings panel’s Network Settings dialog.
Chapters in this guide are specific to the desktop interface and
programs in Settings, which is the control panel for the Linux-based
image.
✎A default user account is pre-installed:
User name: root
Password: root
This default account is also the Administrator “rights” account for
Linux. Therefore, it is recommended you change the password, and
create a new separate user account for non-administrator users.

1-2 www.hp.com Administrator’s Guide
Introduction
Thin Client Linux
HP has developed this Linux image especially for thin client use by
integrating a comprehensive set of open source, commercial, and
custom-developed components. An Altiris client is provided for
remote management of the thin client and can be used for upgrading
the Linux image with feature enhancements, device drivers, and
maintenance updates.

Administrator’s Guide www.hp.com 1-3
Introduction
Desktop
The following sections provide information for the HP Compaq t5125
and HP Compaq t5525 thin clients.
HP Compaq t5125 Thin Client Desktop
The following is an example of the default t5125 desktop:
Default t5125 Desktop

1-4 www.hp.com Administrator’s Guide
Introduction
Desktop Menu
When you right-click on the desktop, a pop-up menu appears with
this list of programs that can be selected.
✎The Linux-based thin client image does not support desktop icons.
■Console
■VNCviewer
■Settings
Desktop Menu

Administrator’s Guide www.hp.com 1-5
Introduction
HP Compaq t5525 Thin Client Desktop
The following is an example of the default t5525 desktop:
Default t5525 Desktop

1-6 www.hp.com Administrator’s Guide
Introduction
Go Menu
To open the Go menu, click the Go button on the left side of the Panel
bar. The Go menu lists the following programs:
✎The Linux-based thin client image does not support desktop icons.
■Console
■Web browser
■Citrix
■HP Connection Administrator
■VNCviewer
■VNCserver
■Settings
Go Menu
Taskbar
The taskbar contains four separate workspace icons. When one of
these icons is clicked, the workspace (or session) will open. Each
workspace can have different programs running. By default, the
taskbar is automatically displayed at the top of the screen. However,
the taskbar can be configured so that it is hidden by opening the

Administrator’s Guide www.hp.com 1-7
Introduction
Taskbar dialog box under Settings and selecting the Auto hide check
box. If the Auto hide check box is selected, you must move the
pointer to the top of the screen to bring up the taskbar.
You can add or remove workspace icons from the taskbar by pressing
the middle mouse button (scroll wheel) anywhere on the desktop. If
you do not have a middle mouse button, you can add a workspace by
pressing Ctrl+Alt+Insert or remove a workspace by pressing
Ctrl+Alt+Delete.
✎When the task bar is hidden, you can press the middle mouse button
anywhere on the desktop to see the list of tasks that are running.
Panel Bar
By default, the panel bar appears at the bottom of the screen and
includes the following features:
■Go button: brings up the Go menu
■active task buttons: for programs that are currently running
■lock icon: locks the screen
■audio icon: adjusts volume
■clock: adjusts time and date
By default, the panel bar is automatically displayed. However, the
panel bar can be configured so that it is hidden by opening the Panel
dialog box under Settings and selecting the Auto hide check box. If
the Auto hide check box is selected, you must move the pointer to the
bottom of the screen to bring up the panel bar.

1-8 www.hp.com Administrator’s Guide
Introduction
Programs
The following sections describe the programs available in the
desktop. The programs are accessed differently depending on what
type of thin client you are using:
■t5125: Right-click on the desktop to open a pop-up menu with the
list of programs that can be selected.
■t5525: Click the Go button to access the list of programs.
The thin client can also be configured so that the user will have access
to these programs through HP Connection Administrator or through
Citrix.
Console
The Console provides a dialog box with a prompt “#” for entry of
various shell commands.
To start the Console, right-click anywhere on the desktop and select
Console.
The suite of commands provided are from the BusyBox suite. The
specific commands currently supported can be determined once the
Console dialog box is invoked. For a list of supported commands type
"busybox" in the Console dialog box. Complete documentation on the
commands syntax can be found at www.busybox.net.
BusyBox combines scaled down versions of many common UNIX
utilities into a single executable. The utilities in BusyBox generally
have fewer options than their full-featured GNU counterparts;
however, the options that are included in Busy Box provide the
expected functionality and behave very much like their GNU
counterparts.
Most BusyBox commands support the -h option to provide a terse
runtime description of their behavior.
Using Shell Commands
Shell commands are provided for administration of user management.
Use the Console dialog box for this purpose. User management shell
commands include:
■addgroup

Administrator’s Guide www.hp.com 1-9
Introduction
■adduser
■chgrp
■delgroup
■deluser
■passwd
■chown
■su
Web Browser
The HP Compaq t5525 thin client image includes the Firefox Web
browser. For more information about creating a Firefox connection,
refer to the “Firefox Connection” section in Chapter 2, “HP
Connection Administrator.”.
Citrix
The Citrix (ICA) program allows you to set up and configure Citrix
ICA client connections.
For more information about creating Citrix connections, please refer
to Chapter 3, “Citrix.”
HP Connection Administrator
HP Connection Administrator allows you to manage server and
application connections by setting up Web, RDP, XDM, and ICA
connections, setting up user accounts, and assigning connections to
users.
For information on seting up connections in, please refer to Chapter
2, “HP Connection Administrator.”
VNC Viewer
The VNC viewer dialog box provides connection to a VNC server.
This feature allows control of the desktop environment from another
thin client.

1-10 www.hp.com Administrator’s Guide
Introduction
The VNC viewer allows control of the desktop environment of
another thin client, PC, or server that has VNC service running. For
information on allowing the thin client to be controlled by another
unit, please refer to the “VNC Shadow” section in Chapter 4,
“Settings.”
VNC Server
Virtual Network Computing (VNC) is a remote control program that
allows you to view and interact with one computer (the "server")
using a simple program (the "viewer") on another computer anywhere
on the Internet.
The VNC Server runs as a service and therefore is available even
when the user is logged off the thin client.
Configure VNC Server on your thin client by checking the following
check boxes:
Check Box Explanation
Prompt local user to accept
incoming connections
The default is ENABLED and Auto
Accept should be ENABLED
Enable Viewer Cursor This setting allows the viewer to
show its cursor on the screen while
moving the mouse. The viewer
shows a small dot that points to the
actual location of the "hot spot" of
the remote cursor location.
Enabling this setting will show the
local cursor of the viewer;
however, the remote dot will lag
behind the local viewer cursor as it
tries to synchronize the local
viewer cursor.
Accept input events from clients Enabling this setting will allow the
viewer to control the keyboard and
mouse of the unit remotely.

Administrator’s Guide www.hp.com 1-11
Introduction
Additional information about VNC Server features can be found at:
http://www.realvnc.com/documentation.html
Settings
The Linux image includes a control panel called Settings. For more
information about Settings, please refer to Chapter 4, “Settings.”
Autoport Select This setting will be deprecated,
leaving only the "Accept
connections on port" and "Allow
HTTP connections on port".
Accept connections on port Defaults to the standard VNC port
of 5900.
Allow HTTP connections on port Defaults to the standard VNC port
of 5800 for JVM (Java) enabled
Web Browser Viewers.
Check Box Explanation

1-12 www.hp.com Administrator’s Guide
Introduction
HP Desktop Options
The Linux-based image features two desktop interface options: Citrix
ICA Client and the HP Connection Administrator.
HP Desktop Options
HP Connection Adminitrator is the default interface. To determine
which interface appears on the user’s desktop, the administrator can
perform the following steps:
1. Right-click anywhere on the desktop and select Settings to open
the Settings Manager.
2. From the Settings Manager window, select the HP Desktop
Options icon. From the HP Desktop Options window, the
administrator can select the preferred interface.
3. Click OK. The new interface will launch at reboot.
For instructions on configuring HP Connection Administrator, refer
to Chapter 2, “HP Connection Administrator” of this guide. For
instructions on configuring Citrix ICA Client, refer to Chapter 3,
“Citrix”.

Administrator’s Guide www.hp.com 1-13
Introduction
Linux Image
To obtain the Linux image version, click on the Settings button on HP
Connection Administrator, then click the System icon on the next
screen. Within the General dialog box, there is a list of system
information including the Image Version. The General page also
indicates the size of the flash memory.
For more information, please refer to the “System” section in Chapter
4, “Settings.”
Image Location
The image is stored in various formats. Upon the boot up process,
certain portions of the image are decompressed and loaded in RAM.
Some features and aspects of the image are not loaded until they are
needed. The image is stored in three partitions as follows:
■/dev/hda1 - ext2 - boot loader
■/dev/hda2 - cramfs - majority of the image
■/dev/hda3 - ext2 - optional components and home
directories

1-14 www.hp.com Administrator’s Guide
Introduction