Installation

Table of Contents

3. Installation

3.1. Overview

3.2. Server Requirements

3.2.1. ThinLinc System and Software Requirements

3.2.2. 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. Upgrading a Cluster

3.5.2. New Licenses

3.5.3. Upgrading the Packages

3.5.4. Configuration Migration

3.6. SELinux enabled distributions

3.7. VirtualGL

3.7.1. Overview

3.7.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

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 Linux 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. Client Touch Gestures

7.6. The XDM mode (Linux only)

7.7. Logfile placement

7.7.1. Linux log file

7.7.2. Windows log file

7.7.3. macOS log file

7.8. Client configuration storage

7.8.1. Overview and Parameters

7.8.2. Configuration Parameter Storage

7.8.3. Adding Custom Branding to 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 SSH Host Keys to settings.reg

7.10. Launching the Client from a Web Page

7.10.1. Requirements

7.10.2. Installation

7.10.3. Usage

7.10.4. The CGI Script tlclient.cgi

7.11. Advanced Topics

7.11.1. Hardware Address Reporting

7.11.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. macOS

8.2.1. Requirements

8.2.2. Installing the macOS Client

8.2.3. Running the macOS Client

8.2.4. Command and Alt Keys on macOS

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

9. ThinLinc Web Access

9.1. Overview

9.2. Requirements

9.3. Server Configuration

9.3.1. Certificates

9.4. Usage

9.4.1. Logging in to a ThinLinc server

9.4.2. The Toolbar

9.4.3. Extra Keys

9.4.4. Clipboard

9.4.5. Touch Gestures

9.4.6. Command and Alt Keys on macOS and iOS

10. Authentication in ThinLinc

10.1. Pluggable Authentication Modules

10.1.1. Configuration files for PAM

10.2. Limitations

10.3. Using Public Key Authentication

10.3.1. Introduction

10.3.2. Key Generation

10.3.3. Server Configuration

10.3.4. Client Configuration

10.4. Using Smart Card Public Key Authentication

10.4.1. Introduction

10.4.2. General Requirements

10.4.3. Key Generation

10.4.4. Server Configuration

10.4.5. Client Configuration

10.4.6. Automatic Connection

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

10.5. Using One Time Passwords

10.5.1. Introduction

10.5.2. General Requirements

10.5.3. Configuration for RSA SecurID

11. File Access

11.1. Accessing Windows File Servers

11.1.1. Introduction

11.1.2. Requirements

11.1.3. Mounting and Unmounting Shares

11.2. Restricting write access to users home directory

11.2.1. Introduction

11.2.2. Activation

11.2.3. Configuration

11.2.4. Security Considerations and Limitations