Allow /vsmagent/agent_hostname to be overridden

ansible_fqdn isn't always the right choice for
/vsmagent/agent_hostname. In setups with the Agent servers behind a
NAT firewall, you want your agent to advertise a externally-reachable
hostname rather than their internal hostname. This introduces a new
thinlinc_agent_hostname variable that allows you to set agent_hostname
to the address you prefer.

Author: derfian

README.md

@@ -70,6 +70,17 @@ thinlinc_webadm_password: "$6$7cc31a35e02e55ec$hm.1MsloeBJqNKljx9RH88Z/eRKZCka5Z
 ThinLinc Web Administration password. This default password is
 "thinlinc". Generate new hashes with `/opt/thinlinc/sbin/tl-gen-auth`.
 
+```yaml
+thinlinc_agent_hostname: null
+```
+
+This allows you to modify the hostname reported by the agent server to
+the client on connecting. See [ThinLinc in a NAT/Split-DNS
+Environment](https://www.cendio.com/resources/docs/tag/network.html#network_nat)
+for details. 
+
+Setting `thinlinc_agent_hostname` to null sets this parameter to `ansible_fqdn`.
+
 
 Examples
 --------

defaults/main.yml

@@ -21,3 +21,12 @@ thinlinc_webadm_password: "$6$7cc31a35e02e55ec$hm.1MsloeBJqNKljx9RH88Z/eRKZCka5Z
 #  - new: overwrite all local changes with new defaults
 #  - parameters: auto-migrate old to new configuration
 thinlinc_tlsetup_migrate_conf: "old"
+
+
+# The agent hostname to report to clients. If your server is behind a
+# firewall with NAT, this must be set to an address that forwards to
+# your server. See
+# https://www.cendio.com/resources/docs/tag/network.html#network_nat
+#
+# The default value is null, which is equal to ansible_fqdn.
+thinlinc_agent_hostname: null

tasks/main.yml

@@ -43,7 +43,7 @@
 - name: Configure /vsmagent/agent_hostname
   tlconfig:
     param: /vsmagent/agent_hostname
-    value: "{{ ansible_fqdn }}"
+    value: "{{ thinlinc_agent_hostname or ansible_fqdn }}"
   notify: restart vsmagent
   when: "'thinlinc-agents' in group_names"