Installation

Sie erhalten den gepackten terratwin-api-X.X Ordner, der den Backend-Zugriffspunkt für den Client darstellt. Dieser Ordner enthält alle erforderlichen Dateien, um die FastAPI-Anwendung zu betreiben.

Die API ist ein essenzieller Bestandteil der gesamten Anwendung, damit die volle Funktionalität gegeben ist.

Installation auf Windows Server (IIS)

1. Entpacken Sie den Ordner terratwin-api-X.X in einem geeigneten Verzeichnis auf Ihrem Server. Dieser Ordner enthält bereits eine Version von Python 3.10, die für die Anwendung genutzt wird.
2. Installieren Sie den HTTP Platform Handler (opens in a new tab)
3. Öffnen Sie den IIS-Manager (Internet Information Services (IIS) Manager)
4. Navigieren Sie zu Default Website und stellen Sie sicher, dass ihre diese an den Port 443 gebunden ist. Alternativ können Sie mit Rechtsklick auf Sites eine Neue Site hinzufügen.
5. Erstellen Sie mit Rechtsklick auf die gewählte Site eine Neue Anwendung. Legen Sie den physischen Pfad zum Ordner api fest und für den virtuellen Pfad terratwin-api.
6. Stellen Sie sicher dass die Nutzergruppe IIS_IUSRS Zugriff auf das Verzeichnis hat.
7. Stellen Sie sicher, dass im Serververzeichnis (bspw. WIN-7DCXXX unter "Startseite") in der Delegierung von Features die Handlerzuordnung auf Lesen / Schreiben gestellt ist.
8. Testen Sie Ihre Konfiguration:
   • Navigieren Sie im Browser zu Ihrer Site (IhreDomain.de/terratwin-api/)
   • Es sollte {"message": "Welcome to Terratwin"} dort stehen
9. Hinterlegen Sie in der appConfig.json den Pfad zur Backendschnittstelle beim Parameter terratwinApi.

Installation auf Linux Server

Dieser Teil wird bei Bedarf ergänzt.