Skip to Content
Last modified by Tobias Wintrich on 2023/11/24 10:05
From version 29.2
edited by Ulrich Mertz
on 2023/04/05 11:38
Change comment: There is no comment for this version
To version 6.1
edited by Patrick Theil
on 2022/11/25 14:38
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.UlrichMertz
1 +XWiki.ptheil
Content
... ... @@ -1,52 +1,73 @@
1 1  {{info}}
2 2  Vorraussetzungen:
3 3  
4 -**Firmware und Software:**
4 +**Firmware und Software (empfohlen):**
5 5  
6 -**RangeeOS:**
6 +**RangeeOS**
7 7  
8 -**Firmware:** x64 -11.00 Build: 276
8 +Firmware: x64 -11.00 Build: 276
9 +TCMS Version: tcms_1.7-x64-11.00 Build: 70
10 +{{/info}}
9 9  
10 -**RangeeTCMS:**
11 11  
12 -**Firmware:** x64 -11.00 Build: 276
13 -**TCMS Version:** tcms_1.7-x64-11.00 Build: 70
14 -{{/info}}
13 +~1. Alternative TCMS Adresse propagieren:
15 15  
15 +Die Thin Clients verwenden im Auslieferungszustand den Namen defaulttcms um sich am TCMS zu registrieren. Diese Einstellung wird im TC bei der ersten TCMS Registrierung automatisch geändert.
16 16  
17 -Die ThinClients verwenden im Auslieferungszustand den Port 443 (https), um sich am TCMS zu registrieren. Weil der Port 443 ein Standard Port für Internetbrowser ist, lässt sich bei Portweiterleitung die Thin Client / TCMS Kommunikation nicht eindeutig festlegen. Dazu sollte für die Kommunikation zwischen TCMS und TC eine abweichende Portnummer verwendet werden, die eine eindeutige Zuordnung und Weiterleitung ermöglicht.
17 +Sie können eine abweichende TCMS Adresse (öffentlicher Name oder die IP Adresse) für alle Clients in den Basiseinstellungen des TCMS einstellen:
18 18  
19 -Um dies umzusetzen, können sie einen zusätzlichen API-Port nutzen. Über diesen API-Port ist das Webinterface des TCMS nicht erreichbar, er ermöglicht aber die Kommunikation zwischen TCMS und den ThinClients. Die Einstellungen für den zusätzlichen API-Port finden sie in der TCMS-Oberfläche unter {{status title="Bearbeiten"/}} → {{status title="Einstellungen"/}} → {{status title="Basiseinstellungen"/}} → {{status title="Zusätzlicher API-Port"/}}.
19 +Öffnen Sie die TCMS Oberfläche (Https:~/~/IP-Adresse/tcms) und gehen Sie unter Bearbeiten -> Einstellungen -> Basiseinstellungen. Hier kann ein abweichende Adresse eingegeben werden.
20 20  
21 -{{warning}}
22 -Nach Ändern oder Aktivieren des zusätzlichen API Ports oder des Repository über diesen Port ist ein kompletter Neustart der TCMS erforderlich!
23 -{{/warning}}
21 +2. Alternative TCMS Port propagieren:
24 24  
25 -(% class="wikigeneratedid" %)
26 -[[TCMS Basiseinstellungen>>image:1674722912396-905.png||data-xwiki-image-style-border="true" height="378" id="I1674722912396-905.png" width="650"]]
23 +Die Thin Clients verwenden im Auslieferungszustand den Port 443 (https), um sich am TCMS zu registrieren. Weil der Port 443 ein Standardport für Internetbrowser ist, lässt sich bei Portweiterleitung die Thin Client / TCMS Kommunikation nicht eindeutig festlegen. Dazu sollte für die Kommunikation zweichen TCMS und TC eine abweichende Portnummer verwendet werden, die eine eineindeutige Zugeordnung und Weiterleitung ermöglicht.
27 27  
28 -Auf den ThinClients hinterlegen sie den API-Port unter {{status title="Kommbox"/}} → {{status title="Remote-Administration"/}} → {{status title="TCMS-Einstellungen"/}}.
25 +Diese Einstellung kann am TC bei der ersten TCMS Registrierung automatisch geändert werden.
29 29  
30 -(% class="wikigeneratedid" %)
31 -[[ThinClient TCMS-Einstellungen>>image:1674722946782-852.png||data-xwiki-image-style-border="true" height="223" id="I1674722946782-852.png" width="650"]]
27 +Sie können einen abweichende TCMS Port für alle Clients in den Basiseinstellungen des TCMS einstellen:
32 32  
33 -Es ist ihnen auch möglich, den Zugriff auf das TCMS Repository über den Zusätzlichen API-Port zuzulassen. So können die Clients ihre Updates vom TCMS über den API-Port beziehen. Dazu aktivieren sie in der TCMS-Oberfläche unter {{status title="Bearbeiten"/}} → {{status title="Einstellungen"/}} → {{status title="Basiseinstellungen"/}} die Einstellung "**Repository Zugriff über den zusätzlichen API-Port zulassen**".
29 +Öffnen Sie die TCMS Oberfläche (Https:~/~/IP-Adresse/tcms) und gehen Sie unter Bearbeiten -> Einstellungen -> Basiseinstellungen. Hier kann ein abweichende Portnummer eingegeben werden.
34 34  
35 -(% class="wikigeneratedid" %)
36 -[[TCMS Basiseinstellungen>>image:1674722965890-156.png||data-xwiki-image-style-border="true" height="376" id="I1674722965890-156.png" width="650"]]
31 +3. Abweichende TCMS Adresse und Port für Firmwareupdate und Softweareupdate aktivieren:
37 37  
38 -(% class="wikigeneratedid" %)
39 -Anschließend müssen sie die Updateserver-Einstellungen auf den ThinClients anpassen. Diese Finden sie unter {{status title="Kommbox"/}} → {{status title="Software-Aktualisierung"/}} → {{status title="Updateserver-Einstellungen"/}}.
33 +Die Thin Clients verwenden im Auslieferungszustand den Port 443 (https), um Updates vom TCMS zu laden. Diese Einstellung kann bei der ersten Registrierung geändert werden.
40 40  
41 -[[Updateserver-Einstellungen auf den ThinClients>>image:image-20230126124222-1.png||data-xwiki-image-style-border="true" height="315" width="650"]]
35 +Sie können einen abweichende TCMS Port für alle Clients in den Basiseinstellungen des TCMS einstellen:
42 42  
43 -(% class="wikigeneratedid" %)
44 -(% style="color:inherit; font-size:29px" %)TCMS Firewall Konfiguration
37 +Öffnen Sie die TCMS Oberfläche (Https:~/~/IP-Adresse/tcms) und gehen Sie unter Bearbeiten -> Einstellungen -> Basiseinstellungen. Hier kann die Updatefunktion für die darüber definierte Adresse und Portnummer aktiviert werden.
45 45  
46 -Den TCMS können Sie anschließend über einen Reverse Proxy oder eine einfache Portweiterleitung im Internet verfügbar machen. Beachten Sie hierzu unsere Hinweise zur sicheren TCMS Kommunikation im [[RangeeOS - Sicherheitsguide>>doc:HowTos.RangeeOS - Sicherheitsguide.WebHome]].
47 47  
48 -Der Thin Client selbst kann anschließend direkt über die Öffentliche IP-Adresse bzw. einen Auflösbaren Hostnamen mit dem TCMS über das Internet kommunizieren.
49 49  
41 +Wenn sie den TCMS-Server von außerhalb ihres lokalen Netzes erreichbar machen wollen gibt es 2 Optionen.
50 50  
51 -(% class="wikigeneratedid" %)
52 -[[ThinClient TCMS-Einstellungen>>image:1674722998480-893.png||data-xwiki-image-style-border="true" height="283" id="I1674722998480-893.png" width="650"]]
43 +**Option 1:** Die Verwendung eines Port Forwarding von Port 443 auf den TCMS-Server.
44 +
45 +Dazu müssen sie eine Port-Freigabe mit folgenden Daten anlegen:
46 +
47 + Protokoll:              **TCP**
48 +
49 + Quell Port:                            **443**
50 +
51 + Ziel Port:                               **443**
52 +
53 + IP-Adresse:           Lokale IP-Adresse des TCMS
54 +
55 +Auf den Clients tragen sie unter den TCMS-Einstellungen der Kommbox bei Server die öffentliche IPv4 Adresse ihres Netzwerks ein.
56 +
57 +
58 +[[image:1665122796182-647.png||height="239" width="634"]]
59 +
60 +**Option 2:** Die Verwendung eines Reverse Proxys
61 +
62 +Voraussetzung hierfür sind ein registrierter Domainname sowie ein vorhandener Reverse Proxy Server und funktionierende Portweiterleitungen auf dessen Port 443. Im Reverse Proxy muss anschließend ein Eintrag mit dem Domainname und der lokalen IP-Adresse des TCMS hinterlegt werden.
63 +
64 +Auch bei dieser Option tragen sie unter den TCMS-Einstellungen der Clients die öffentliche IPv4 Adresse ihres Netzwerks ein.
65 +
66 +[[image:image-20221007080616-2.png]]
67 +
68 +
69 +Mit Option 2 ist es optional auch möglich, nur die Registrierung der Clients beim TCMS zu erlauben, gleichzeitig aber den Zugriff aufs Admin Interface zu verbieten. Hierbei sind folgende Einstiegspunkte zuzulassen (Static URL Hardening):
70 +
71 +* /api/xmlrpc/v1/
72 +* /api/xmlrpc/v1/*
73 +* /
1674722912396-905.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ptheil
Size
... ... @@ -1,1 +1,0 @@
1 -129.7 KB
Content
1674722946782-852.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ptheil
Size
... ... @@ -1,1 +1,0 @@
1 -68.3 KB
Content
1674722965890-156.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ptheil
Size
... ... @@ -1,1 +1,0 @@
1 -130.3 KB
Content
1674722984528-950.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ptheil
Size
... ... @@ -1,1 +1,0 @@
1 -68.9 KB
Content
1674722998480-893.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ptheil
Size
... ... @@ -1,1 +1,0 @@
1 -68.9 KB
Content
image-20230126124222-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ptheil
Size
... ... @@ -1,1 +1,0 @@
1 -16.6 KB
Content
tcms.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ptheil
Size
... ... @@ -1,1 +1,0 @@
1 -42.9 KB
Content