ThinLinc Administrator’s Guide for ThinLinc 4.13.0 ThinLinc Administrator’s Guide for ThinLinc 4.13.0 Copyright © 2021 Cendio AB Table of Contents I. Introduction............................................................................................................................................1 1. Introduction....................................................................................................................................1 1.1. About the Documentation..................................................................................................1 1.2. Finding More Information.................................................................................................1 2. ThinLinc Architecture....................................................................................................................3 2.1. Session Overview..............................................................................................................4 II. Installation.............................................................................................................................................5 3. Installation......................................................................................................................................5 3.1. Overview...........................................................................................................................5 3.2. Server Requirements..........................................................................................................5 3.2.1. ThinLinc System and Software Requirements.....................................................5 3.2.2. Server Sizing.........................................................................................................6 3.3. Preparing the Network for ThinLinc Installation..............................................................6 3.3.1. A Simple ThinLinc Setup.....................................................................................7 3.3.2. ThinLinc in a Novell Network..............................................................................8 3.3.3. ThinLinc in a Windows Network..........................................................................8 3.3.4. ThinLinc in a NAT/Split-DNS Environment........................................................9 3.3.5. Using ThinLinc Web Access..............................................................................11 3.3.6. Other Services Required by ThinLinc Servers...................................................11 3.4. Installing the ThinLinc Remote Desktop Server.............................................................11 3.4.1. Starting the Installation Program........................................................................12 3.5. Upgrading an Old Installation.........................................................................................12 3.5.1. Upgrading a Cluster............................................................................................13 3.5.2. New Licenses......................................................................................................13 3.5.3. Upgrading the Packages......................................................................................13 3.5.4. Configuration Migration.....................................................................................14 3.6. SELinux enabled distributions.........................................................................................15 3.7. VirtualGL.........................................................................................................................15 3.7.1. Overview.............................................................................................................15 3.7.2. Installation and configuration.............................................................................15 4. License Handling.........................................................................................................................17 4.1. Overview.........................................................................................................................17 4.2. License Counting.............................................................................................................17 4.3. Location and format of License Files..............................................................................17 4.4. Log Files and E-mail Messages.......................................................................................17 4.5. Checking the Number of Valid Licenses.........................................................................18 5. Printer Features............................................................................................................................19 5.1. Overview of ThinLinc Printer Features...........................................................................19 5.2. Printer Configuration Overview......................................................................................19 5.2.1. CUPS Browsing..................................................................................................20 5.2.2. CUPS configuration on the Machine Running VSM Server..............................20 5.2.3. CUPS configuration on the Machine running VSM Agent................................20 5.3. Local printer support.......................................................................................................21 5.3.1. Theory of operation.............................................................................................21 5.3.2. Device independent mode...................................................................................21 5.3.3. Device dependent mode......................................................................................22 iii 5.3.4. Installation and Configuration.............................................................................22 5.3.5. Parallel port emulation........................................................................................22 5.4. Nearest printer support....................................................................................................23 5.4.1. Administration of the Nearest Printer Feature in ThinLinc................................23 5.4.2. Nearest Printer Selection Algorithm...................................................................23 5.4.3. Printer Drivers.....................................................................................................24 5.5. Printer Access Control.....................................................................................................24 5.5.1. Theory of Operation............................................................................................25 5.5.2. Requirements......................................................................................................25 5.5.3. Activating the Printer Access Control Feature...................................................25 5.5.4. Configuration......................................................................................................26 6. High Availability (HA).................................................................................................................27 6.1. Overview.........................................................................................................................27 6.1.1. Background - Reasons For a HA Setup..............................................................27 6.1.2. Solution - Elimination of Single Point of Failure...............................................28 6.1.3. Theory of Operation............................................................................................28 6.2. Configuration of ThinLinc for HA Operations................................................................29 6.2.1. Installation of a New HA Cluster........................................................................29 6.2.2. Reconfiguring an existing ThinLinc Installation into HA mode........................30 6.3. Recovering from hardware failures.................................................................................30 6.3.1. Recovering from Minor Failures.........................................................................30 6.3.2. Recovering from Catastrophic Failure................................................................31 7. The ThinLinc Client.....................................................................................................................33 7.1. Client usage.....................................................................................................................33 7.1.1. The started ThinLinc client.................................................................................33 7.1.2. Logging in to a ThinLinc server.........................................................................33 7.1.3. Language Settings...............................................................................................35 7.1.4. The ThinLinc session life cycle..........................................................................35 7.1.5. The session menu................................................................................................36 7.2. Running the ThinLinc client from the command line.....................................................36 7.3. Local device export.........................................................................................................39 7.3.1. Sound device.......................................................................................................39