Skip to Content
v2.4 (latest)🚀 Getting StartedInstallation
latest

Installation

Sie erhalten den gepackten Ordner terratwin-2.x.x, den Sie direkt auf Ihrem Webserver hosten können. Ohne zusätzliche Anpassungen ist die Anwendung identisch zum Auslieferungszustand, vgl. demo.terratwin.de .

Vorbemerkungen

Dateistruktur

Es bietet sich an, einen Stammordner bspw. terratwin anzulegen und darin jede Version in einem eigenen Unterordner abzulegen. So bleibt die zuvor installierte Version beim Update erhalten und kann bei Problemen sofort wieder aktiviert werden.

Staging-Umgebung

Es empfiehlt sich vor dem Produktivgang eine Staging-Instanz einzurichten, z. B. durch ein zusätzliches virtuelles Verzeichnis im IIS. So können Sie neue Versionen gefahrlos testen und notwendige Anpassungen vornehmen, bevor die Änderungen live gehen.

Installation auf Windows Server (IIS)

Die folgenden Schritte beschreiben die Standardinstallation auf einem Windows Server mit dem Internet Information Services (IIS). Andere Konstellationen sind möglich, werden hier aber nicht behandelt.

  1. Installieren Sie das .NET Hosting Bundle  falls noch nicht geschehen.
Neu ab Version 2.4.0

Bisherige Versionen von Terratwin setzten bei der Bereitstellung auf Windows Server auf den HttpPlatformHandler. Da dieser von Microsoft nicht länger maintained wird, setzt Terratwin ab Version 2.4.0 stattdessen auf das ASP.NET Core-Modul (ANCM), das mit dem .NET Hosting Bundle installiert wird.

  1. Entpacken Sie den Ordner terratwin-2.x.x in einem geeigneten Verzeichnis auf Ihrem Server
  2. Öffnen Sie den IIS-Manager (Internet Information Services (IIS) Manager)
  3. Navigieren Sie zu Default Website und stellen Sie sicher, dass diese an den Port 443 gebunden ist. Alternativ können Sie mit Rechtsklick auf Sites eine Neue Site hinzufügen.
  4. Legen Sie mit Rechtsklick auf die gewählte Site ein Neues virtuelles Verzeichnis an. Legen Sie den physischen Pfad zum Ordner terratwin-2.x.x fest und für den virtuellen Pfad einen beliebigen Pfad unter der die Terratwin-Instanz unterhalb erreichbar sein soll.
  5. Wählen Sie Ihre Site aus und navigieren Sie im Bereich Inhalt zu MIME-Types. Überprüfen Sie, ob der MIME-Type text/markdown mit der Dateiendung .md hinterlegt ist und legen Sie diesen ggf. an.
  6. Navigieren Sie zu Anwendungspools und erstellen Sie einen neuen Anwendungspool mit dem Namen TerratwinApiAppPool. Übernehmen Sie die Einstellungen wie in den Screenshots dargestellt:

Grundeinstellungen für den Anwendungspool
Grundeinstellungen für den Anwendungspool

Erweiterte Einstellungen für den Anwendungspool
Erweiterte Einstellungen für den Anwendungspool
  1. Navigieren Sie in Ihrem virtuellen Verzeichnis zum Verzeichnis api und konvertieren Sie dieses Verzeichnis in eine Anwendung.
  2. Überprüfen Sie in den Handlerzuordnungen von api, ob der Handler AspNetCoreModuleV2 registriert ist.
  3. Stellen Sie sicher, dass der Benutzer IIS_IUSRS Vollzugriff auf das Verzeichnis terratwin-2.x.x/api hat.
  4. Stellen Sie außerdem sicher, dass in der Delegation von Features die Handlerzuordnungen unter dem Maschinenknoten (IIS-Startseite) auf Lesen/Schreiben gesetzt ist.

Reverse-Proxy-Betrieb

Betreiben Sie Terratwin hinter einem Reverse Proxy, müssen alle erreichbaren Hostnamen - intern und extern - in den Systemeinstellungen unter security → allowed_hosts eingetragen sein.

Hinterlegen Sie zudem für jeden Host den passenden licenseKey in den Systemeinstellungen und speichern Sie die zugehörigen Lizenzdateien in api/terratwin/license/. Ohne gültige Lizenz startet die Anwendung nicht.

Lizenzkey-Beispiel
{
	[...]
	"licenseKey": [
		{
			"hostname": "example.com",
			"key": "40c10a4e-71d2-4892-b6e1-faa5a693e16f"
		},
		{
			"hostname": "example.de",
			"key": "b1c2d3e4-f5g6-7890-h1i2-j3k4l5m6n7o8"
		}
	],
	[...]
}

brotli für IIS konfigurieren

Befolgen Sie die Anleitung von Microsoft  zur Konfiguration von brotli für IIS. Beachten Sie, dass im Vorfeld die Rollen Static Content Compression und Dynamic Content Compression installiert sind.

Erforderliche Rollen für die Komprimierung in IIS
Erforderliche Rollen für die Komprimierung in IIS

WebSocket aktivieren

new@2.4.0

Für die Kommunikation des Chatbots mit Terratwin-AI ist das WebSocket Protokoll erforderlich. Installieren Sie dieses Feature für IIS, wenn noch nicht erfolgt.

Aktivieren der Serverrolle WebSocket Protocol
Aktivieren der Serverrolle WebSocket Protocol

Installation auf Linux Server

Für den Betrieb unter Linux wird Terratwin ausschließlich als Container-Image ausgeliefert; eine native Installation wie unter Windows ist nicht vorgesehen. Die Images liegen in einer privaten Registry, für die wir Ihnen auf Anfrage einen Zugang einrichten. Dort erhalten Sie auch die vollständige Einrichtungsanleitung samt vorbereiteter docker-compose.yml.

Da die Einrichtung von Ihrer Zielumgebung abhängt, stimmen wir sie individuell mit Ihnen ab. Wenn Sie Terratwin unter Linux betreiben möchten, sprechen Sie uns daher bitte vorab an: Kontakt aufnehmen

SystemvoraussetzungenUpdate