Bug 7884 - Hard to understand how to configure a simple cluster
Summary: Hard to understand how to configure a simple cluster
Status: CLOSED FIXED
Alias: None
Product: ThinLinc
Classification: Unclassified
Component: Documentation (show other bugs)
Version: trunk
Hardware: PC Unknown
: P2 Normal
Target Milestone: 4.18.0
Assignee: Bugzilla mail exporter
URL:
Keywords: linma_tester, relnotes
Depends on:
Blocks:
 
Reported: 2022-04-06 18:03 CEST by Samuel Mannehed
Modified: 2024-10-01 15:18 CEST (History)
2 users (show)

See Also:
Acceptance Criteria:


Attachments

Description Samuel Mannehed cendio 2022-04-06 18:03:02 CEST
https://www.cendio.com/resources/docs/tag-devel/html/config_cluster.html

The start of the section that explains how to set up a ThinLinc cluster says:

> When configuring ThinLinc servers as a cluster, one needs
> to configure both the master server and the agents. The
> master server needs configuration for subclusters (even if
> there is only one agent) and the agents need to know which
> server is the master for access control.

Then it goes on to explain that you need to set the parameters master_hostname and login_page. Lastly, it mentions that services need to be restarted.

The issue is that the bit about subclusters is unnecessarily obscure. Most clusters will not need to have different subclusters. Most clusters will be simple and only use the "Default" subcluster. How to do that is not trivial to deduce.

Below this section follows the large subcluster section.
Comment 1 Samuel Mannehed cendio 2022-04-06 18:04:40 CEST
Something like this would be better:

> When configuring ThinLinc servers as a cluster, one needs
> to configure both the master server and the agents. The
> master server needs a list of agents, and the agents need
> to know which server is the master for access control.
>
> To set up a simple cluster with multiple agents you begin
> by adding the addresses of the agents to the configuration
> parameter `/vsmserver/subclusters/Default/agents`.
> Options for more advanced setups are described in the
> Subcluster chapter below.
Comment 2 Samuel Mannehed cendio 2022-04-06 18:11:22 CEST
This is what this section looked like before we added subclusters:

>  When configuring ThinLinc servers as a cluster, there are two main
> configuration options which need to be set, one on the master and one on the
> agent(s):
> 
> /vsmserver/terminalservers
> 
>    This parameter is configured on the master, and contains a space-separated
> list of all agent servers which will be part of this cluster. Only servers in
> this list will be considered by the master as available to create sessions on.
> See Section 14.2.2, “ Parameters in /vsmserver/ ” for details.
> 
> /vsmagent/master_hostname 
> ...
Comment 4 William Sjöblom cendio 2024-09-11 11:17:21 CEST
The initial setup of a cluster has now been separated from configuration of a cluster (subcluster setup etc.)

These changes should make it way easier to configure a new cluster for a newbie.

Marking as resolved.
Comment 5 Linn cendio 2024-09-17 11:33:26 CEST
Read through the changes and the cluster documentation has been greatly improved. Marking as Closed.

Note You need to log in before you can comment on or make changes to this bug.