Installation

Table of Contents

3. Installation

3.1. Overview

3.2. Server Requirements

3.2.1. ThinLinc System and Software Requirements

3.2.2. Windows RDP Server Requirements

3.2.3. Server Sizing

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 ThinLinc Web Access

3.3.6. Other Services Required by ThinLinc Servers

3.4. Installing the ThinLinc Remote Desktop Server

3.4.1. Starting the Installation Program

3.5. Upgrading an Old Installation

3.5.1. Acquire New Licenses

3.5.2. Starting the Installation Program

3.6. SELinux enabled distributions

3.7. The ThinLinc WTS Tools Package

3.7.1. Overview

3.7.2. Installing the WTS Tools Package on Windows Remote Desktop Servers

3.8. VirtualGL

3.8.1. Overview

3.8.2. Installation and configuration

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 Remote Desktop Servers

5.6.1. Configuration

5.6.2. Persistent Printer Settings

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. Recovering from hardware failures

6.3.1. Recovering from Minor Failures

6.3.2. Recovering from Catastrophic Failure

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

7.3.2. Serial ports (Windows and UNIX only)

7.3.3. Drives

7.3.4. Printer

7.3.5. Smart Card Readers

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. Logfile placement

7.6.1. UNIX log file

7.6.2. Windows log file

7.7. Client configuration storage

7.7.1. Overview and Parameters

7.7.2. Configuration Parameter Storage

7.7.3. Adding Custom Branding to the ThinLinc Client Login Window

7.8. Client Customizer

7.8.1. Introduction

7.8.2. Installation

7.8.3. Building a Customized Client

7.8.4. Adding SSH Host Keys to settings.reg

7.9. Advanced Topics

7.9.1. Hardware Address Reporting

7.9.2. Client Update Notifications

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.2.4. Command and Alt Keys on Mac OS X

8.3. Linux PC

8.3.1. Requirements

8.3.2. Installing the Linux Client

8.3.3. Running the Linux Client

8.4. Thin Terminals

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

8.4.2. HP ThinPro Terminals

8.4.3. IGEL Universal Desktop

8.4.4. Dell Wyse-Enhanced SuSE Linux Terminals

8.4.5. Other Thin Terminals

8.5. Running ThinLinc on a Thinstation terminal

8.5.1. Installing and Building the Package

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

8.6. Web Integration and Web Access

8.6.1. Launching the Native Client From a Web Page

8.6.2. The CGI Script tlclient.cgi

8.6.3. ThinLinc Web Access (HTML5 Client)

9. Authentication in ThinLinc

9.1. Pluggable Authentication Modules

9.1.1. Configuration files for PAM

9.2. Limitations

9.3. Using Public Key Authentication

9.3.1. Introduction

9.3.2. Key Generation

9.3.3. Server Configuration

9.3.4. Client Configuration

9.4. Using Smart Card Public Key Authentication

9.4.1. Introduction

9.4.2. General Requirements

9.4.3. Key Generation

9.4.4. Server Configuration

9.4.5. Client Configuration

9.4.6. Automatic Connection

9.4.7. LDAP Automatic Update (tl-ldap-certalias)

9.5. Using One Time Passwords

9.5.1. Introduction

9.5.2. General Requirements

9.5.3. 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. Restricting write access to users home directory

10.2.1. Introduction

10.2.2. Activation

10.2.3. Configuration

10.2.4. Security Considerations and Limitations

11. Connecting to Windows Remote Desktop Servers

11.1. Introduction

11.2. Single Sign-On

11.2.1. Information

11.2.2. Smart card

11.3. Connection Modes

11.3.1. Running a Windows Desktop in a Window

11.3.2. Running a Windows Desktop in Fullscreen

11.3.3. Running a Windows application in Standard Mode

11.3.4. Running a Windows application in SeamlessRDP Mode