Table of Contents

3. Installation

3.1. Overview

3.2. Server Requirements

3.2.1. Operating System and Software Requirements

3.2.2. Server Sizing

3.2.3. Supported Application Types

3.2.4. Supported Protocols

3.2.5. Supported Authentication Mechanisms

3.3. Preparing the Network for ThinLinc Installation

3.3.1. A Simple ThinLinc Setup

3.3.2. ThinLinc in a Novell Network

3.3.3. ThinLinc in a Windows Network

3.3.4. ThinLinc in a NAT/Split-DNS Environment

3.3.5. Using the Browser Clients

3.3.6. Other Services Required by ThinLinc Servers

3.4. Installing the ThinLinc Terminal Server

3.4.1. Starting the Installation Program

3.5. Upgrading an Old Installation

3.5.1. Acquire New Licenses

3.5.2. Run the Installation Program

3.5.3. Update Configuration Files

3.5.4. Run tl-setup

3.6. Platform Specific Notes

3.6.1. SELinux enabled distributions

3.6.2. AppArmor enabled distributions

3.6.3. Red Hat Enterprise Linux 4

3.6.4. Red Hat Linux 9, Fedora Core 1

3.6.5. Fedora Core 2

3.6.6. Fedora Core 3

3.6.7. Fedora Core 4

3.6.8. Fedora Core 6

3.6.9. All SUSE Linux variants, including SLES and SLED

3.6.10. SUSE Linux 9.1

3.6.11. SUSE Linux Enterprise Desktop 10

3.6.12. Java Desktop System 2003

3.6.13. Debian 3.1 and Ubuntu

3.6.14. Sun Solaris

3.7. The ThinLinc WTS Tools Package

3.7.1. Overview

3.7.2. Installing the WTS Tools Package on Windows Terminal Servers

4. License Handling

4.1. Overview

4.2. License Counting

4.3. Location and format of License Files

4.4. Log Files and E-mail Messages

4.5. Checking the Number of Valid Licenses

5. Printer Features

5.1. Overview of ThinLinc Printer Features

5.2. Printer Configuration Overview

5.2.1. CUPS Browsing

5.2.2. CUPS configuration on the Machine Running VSM Server

5.2.3. CUPS configuration on the Machine running VSM Agent

5.3. Local printer support

5.3.1. Theory of operation

5.3.2. Device independent mode

5.3.3. Device dependent mode

5.3.4. Installation and Configuration

5.3.5. Parallel port emulation

5.4. Nearest printer support

5.4.1. Administration of the Nearest Printer Feature in ThinLinc

5.4.2. Nearest Printer Selection Algorithm

5.4.3. Printer Drivers

5.5. Printer Access Control

5.5.1. Theory of Operation

5.5.2. Requirements

5.5.3. Activating the Printer Access Control Feature

5.5.4. Configuration

5.6. Printer Configuration on Windows Terminal Servers

5.6.1. Configuration

5.6.2. Persistent Printer Settings

5.7. CUPS

5.7.1. Theory of operation

5.7.2. ThinLinc and CUPS

5.7.3. CUPS configuration

5.7.4. Common CUPS configuration operations

6. High Availability (HA)

6.1. Overview

6.1.1. Background - Reasons For a HA Setup

6.1.2. Solution - Elimination of Single Point of Failure

6.1.3. Theory of Operation

6.2. Configuration of ThinLinc for HA Operations

6.2.1. Installation of a New HA Cluster

6.2.2. Reconfiguring an existing ThinLinc Installation into HA mode

6.3. Validating HA Operation

6.3.1. Validation of Heartbeat Operations

6.3.2. Validation of Network Connectivity

6.3.3. Validating Operations on the Active Node

6.4. Testing Correct Failover Behavior

6.4.1. Testing Failover by Stopping Heartbeat

6.4.2. Testing Correct Failover Because of Hardware Failure

6.5. Recovering from hardware failures

6.5.1. Recovering from Minor Failures

6.5.2. Recovering from Catastrophic Failure

6.6. ThinLinc HA and Other Services

6.6.1. User database

6.6.2. Home Directories and other File Resources

6.6.3. Printing

6.7. Detailed Instructions on Heartbeat Configuration

6.7.1. Configuration by Editing Configuration Files

6.7.2. Configuring Heartbeat Using the Webmin Module

7. The ThinLinc Client

7.1. Client usage

7.1.1. The started ThinLinc client

7.1.2. Logging in to a ThinLinc server

7.1.3. Language Settings

7.1.4. The ThinLinc session life cycle

7.1.5. The session menu

7.2. Running the ThinLinc client from the command line

7.3. Local device export

7.3.1. Sound device (Windows and UNIX only)

7.3.2. Serial ports (Windows and UNIX only)

7.3.3. Drives (Windows and UNIX only)

7.3.4. Printer (Windows and UNIX only)

7.3.5. Smart Card Readers (Windows and UNIX only)

7.4. Client configuration

7.4.1. Options tab

7.4.2. Local Devices tab

7.4.3. Screen tab

7.4.4. Optimization tab

7.4.5. Security tab

7.5. The XDM mode (UNIX only)

7.5.1. The XDM mode Control Panel

7.6. Antivirus Verification

7.6.1. Configuration

7.7. Logfile placement

7.7.1. UNIX log file

7.7.2. Windows log file

7.8. Client configuration storage

7.8.1. Overview and Parameters

7.8.2. Configuration Parameter Storage

7.8.3. Customizing the Logo in the ThinLinc Client Login Window

7.9. Client Customizer

7.9.1. Introduction

7.9.2. Installation

7.9.3. Building a Customized Client

7.9.4. Adding Host Keys to settings.reg

7.10. Advanced Topics

7.10.1. Hardware Address Reporting

8. Client Platforms

8.1. Windows

8.1.1. Requirements

8.1.2. Installing the Windows Client

8.1.3. Running the Windows Client

8.2. Mac OS X

8.2.1. Requirements

8.2.2. Installing the Mac OS X Client

8.2.3. Running the Mac OS X Client

8.3. Linux PC

8.3.1. Requirements

8.3.2. Installing the Linux Client

8.3.3. Running the Linux Client

8.4. Solaris

8.4.1. Requirements

8.4.2. Installing the Solaris Client

8.4.3. Running the Solaris Client

8.5. Thin Terminals

8.5.1. Neoware NeoLinux

8.5.2. eLux-based Thin Terminals (Fujitsu-Siemens Futro et. al.)

8.5.3. VXL Itona

8.5.4. Tecnoworld Thin Terminals

8.5.5. HP t5000 terminals

8.5.6. IGEL Smart Terminals

8.5.7. Connec EZ800 Thin Terminal

8.5.8. Wyse Linux Terminals

8.5.9. Other Thin Terminals

8.6. The ThinLinc Client Operating System (TLCOS)

8.6.1. Requirements

8.6.2. Downloading the Distribution

8.6.3. Customizing the Kickstart File

8.6.4. Installing the ThinLinc Client Operating System

8.6.5. Using Local Drives with TLCOS

8.6.6. Using Local Printers with TLCOS

8.6.7. Getting Applications Using Ctrl-Alt-Fx to Work with TLCOS

8.6.8. Dealing with Sound Cards not found by Autodetection

8.6.9. Managing Network Connections with NetworkManager

8.7. Using X11 Terminals as ThinLinc Clients

8.7.1. Configuration

8.8. Using SunRay Appliances as ThinLinc Clients

8.8.1. Running the ThinLinc Client as a CAM Application

8.9. Running ThinLinc on a Thinstation terminal

8.9.1. Installing and Building the Package

8.9.2. Configuring the ThinLinc client when running on a Thinstation Terminal

8.10. Web Integration and Browser Clients

8.10.1. The Java Browser Client

8.10.2. Requirements

8.10.3. Installation

8.10.4. Launching the Native Client From a Web Page

8.10.5. The CGI Script tlclient.cgi

9. Authentication in ThinLinc

9.1. Pluggable Authentication Modules

9.1.1. Configuration files for PAM

9.2. Limitations

9.3. Authenticating users against Windows Active Directory

9.3.1. Single Machine or Cluster Setup

9.3.2. Requirements

9.3.3. Single Machine Setup

9.3.4. Verifying AD Integration

9.3.5. Cluster Configuration

9.4. Authentication against LDAP servers

9.4.1. ThinLinc Authenticating to LDAP - Theory of Operation

9.4.2. LDAP server configuration issues

9.4.3. Verifying LDAP Connectivity

9.4.4. Configuring a ThinLinc Server to use LDAP Lookups for Users and Groups

9.4.5. Using Novell eDirectory with ThinLinc

9.4.6. LDAP Query Performance Tuning

9.5. Limiting ThinLinc Access from Foreign Networks

9.6. Using Public Key Authentication

9.6.1. Introduction

9.6.2. General Requirements

9.6.3. Key Generation

9.6.4. Server Configuration

9.6.5. Client Configuration

9.7. Using Smart Card Public Key Authentication

9.7.1. Introduction

9.7.2. General Requirements

9.7.3. Key Generation

9.7.4. Server Configuration

9.7.5. Client Configuration

9.7.6. Automatic connection

9.8. Using One Time Passwords

9.8.1. Introduction

9.8.2. General Requirements

9.8.3. Configuration for NordicEdge One Time Password Server

9.8.4. Configuration for RSA SecurID

10. File Access

10.1. Accessing Windows File Servers

10.1.1. Introduction

10.1.2. Requirements

10.1.3. Mounting and Unmounting Shares

10.2. Accessing Novell Netware File Servers

10.2.1. Introduction

10.2.2. Using NCPFS to Access Novell File Servers

10.2.3. Using the Native Novell Client to Access Novell File Servers

10.2.4. Accessing Novell Netware File Servers using NFS

10.3. Restricting write access to users home directory

10.3.1. Introduction

10.3.2. Activation

10.3.3. Configuration

10.3.4. Security Considerations and Limitations

11. Connecting to Windows Terminal Servers

11.1. Introduction

11.2. Connection Modes

11.2.1. Running a Windows Desktop in a Window

11.2.2. Running a Windows Desktop in Fullscreen

11.2.3. Running a WTS application in Standard Mode

11.2.4. Running a WTS application in SeamlessRDP Mode