Linux-Installer

Der Linux-Installer richtet Grafioschtrader (GT) als klassische Installation auf Debian oder Ubuntu ein: Das Backend läuft als Systemdienst, ein Webserver liefert die Oberfläche aus, und MariaDB speichert die Daten. Das Ergebnis entspricht einer manuellen Installation nach dem Wiki, mit den weiter unten beschriebenen Unterschieden. Wie der Installer gestartet und bedient wird, beschreibt das Wiki unter Installation with the Linux installer; diese Seite erklärt den Aufbau.

Aufbau der Installation

Das folgende Diagramm zeigt den Datenfluss im Betrieb. Nur der Webserver ist von aussen erreichbar.

graph LR
    U["Browser"]
    M["SMTP-Mailserver"]
    Q["Externe Datenquellen"]
    L["Let's Encrypt"]
    DNS["DuckDNS"]
    subgraph H["Rechner mit Debian oder Ubuntu"]
        direction LR
        W["nginx oder Apache<br/>Oberfläche"] -->|"API, GTNet und WebSocket"| B["Dienst grafioschtrader<br/>Backend auf 127.0.0.1"]
        B -->|"Datenbankzugriff"| D[("MariaDB")]
        C["certbot"]
        T["DuckDNS-Timer<br/>(optional)"]
    end
    U <-->|"HTTP/HTTPS"| W
    B -->|"E-Mail"| M
    B -->|"Kurse und Ereignisse"| Q
    C -.->|"Zertifikat"| L
    T -.->|"Aktualisiert die Domain"| DNS

Ablauf der Installation

Der Installer prüft zuerst den Rechner und stellt dann nur die Fragen, die für diesen Rechner gelten. Bevor er etwas verändert, zeigt er den vollständigen Plan mit allen Paketen, Dateien und Diensten; erst nach der Bestätigung führt er ihn aus. Jeder Schritt wird in einem Journal festgehalten. Bricht die Installation ab, etwa durch einen Stromausfall oder einen fehlgeschlagenen Schritt, setzt ein erneuter Aufruf an derselben Stelle fort, mit denselben Antworten und Passwörtern.

graph TD
    I["Prüfung des Rechners"] --> F["Fragen in Dialogen"]
    F --> P["Plan mit allen Änderungen"]
    P -->|"Bestätigung"| K["Kern: Pakete, Benutzer, Quellcode,<br/>Datenbank, verschlüsselte Konfiguration"]
    K --> A["Anwendung: Bau, Dienst,<br/>erster Start mit Datenbankmigration"]
    A --> W["Web und TLS: Sites, Zertifikat, DuckDNS"]
    W --> E["Mail-Prüfung"]
    E --> R["Ergebnis"]
    K -.->|"Abbruch"| N["Erneuter Aufruf setzt fort"]
    A -.->|"Abbruch"| N
    W -.->|"Abbruch"| N

Wo befinden sich Konfiguration und Daten?

Zusammenleben mit vorhandenen Diensten

Der Installer verändert nichts, was ihm nicht gehört. Eine vorhandene MariaDB wird weiterverwendet, auch wenn sich root nur mit Passwort anmelden kann; das Passwort wird einmal abgefragt. Andere Webseiten auf demselben nginx oder Apache, auch solche mit PHP, antworten nach der Installation wie zuvor; der Installer prüft dies vor und nach jedem Neuladen des Webservers. Andere Java- und Node.js-Versionen bleiben die Standardversion des Rechners, und belegte Ports werden durch freie ersetzt. Ein bereits laufender DuckDNS-Updater wird erkannt, sodass kein zweiter entsteht. Belegt ein anderer Proxy wie Caddy die Ports 80 und 443, richtet der Installer keinen eigenen Webserver ein und schreibt die Routen als Vorschlag für diesen Proxy in /root/gt-install-webserver.conf.

Update

Ein Update erfolgt wie bei jeder klassischen Installation mit ./gtupdate.sh als Benutzer grafioschtrader, siehe Update Grafioschtrader. Es holt den neuen Quellcode, übernimmt Ihre Werte aus application.properties in die neue Vorlage, lässt application-production.properties unverändert und baut Backend und Oberfläche neu.

Unterschiede zur manuellen Installation

Die manuelle Installation nach dem Wiki und der Linux-Installer führen zum selben Ergebnis. In einigen Punkten geht der Installer einen anderen Weg, damit er andere Programme auf dem Rechner nicht verändert und sich wieder vollständig entfernen lässt.