Installation

Sie erhalten den gepackten Ordner terratwin-2.0.1, den Sie direkt auf ihrem Webserver hosten können.

Ohne zusätzliche Anpassungen ist die Anwendung identisch zum Auslieferungszustand, vgl. demo.terratwin.de .

Installation auf Windows Server (IIS)

Installationsschritte

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

Installieren Sie das IIS Modul HttpPlatformHander 1.2 , falls noch nicht geschehen.
Entpacken Sie den Ordner terratwin-2.0.1 in einem geeigneten Verzeichnis auf Ihrem Server
Öffnen Sie den IIS-Manager (Internet Information Services (IIS) Manager)
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.
Erstellen Sie mit Rechtsklick auf die gewählte Site ein Neues virtuelles Verzeichnis an. Legen Sie den physischen Pfad zum Ordner terratwin-2.0.1 fest und für den virtuellen Pfad einen beliebigen Pfad unter der die Terratwin-Instanz unterhalb erreichbar sein soll.
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 sind und legen Sie diesen ggf. an.
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

Erweiterte Einstellungen für den Anwendungspool

Navigieren Sie in Ihrem virtuellen Verzeichnis zum Verzeichnis api und Konvertieren Sie dieses Verzeichnis in eine Anwendung.
Überprüfen Sie in den Handlerzuordnungen von api, ob der Handler httpPlatformHandler registriert ist.
Öffnen Sie den Explorer und navigieren Sie zum Verzeichnis terratwin-2.0.1/api/terratwin/settings.json. Öffnen Sie die Datei mit einem Texteditor und passen Sie die Eigenschaft root_path entsprechend Ihrem virtuellen Verzeichnis an. Soll Terratwin bspw. unter https://meinserver.de/gis/terratwin erreichbar sein, so müssen Sie den Wert von root_path auf /gis/terratwin setzen.

Stellen Sie sicher, dass der Benutzer IIS-Users Vollzugriff auf das Verzeichnis terratwin-2.0.1/api hat.

Stellen Sie außerdem sicher, dass in der Delegation von Features die Handlerzuordnungen unter dem Maschninenknoten (IIS-Startseite) auf Lesen/Schreiben gesetzt ist.

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

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