Linux Installer

Wichtige Hinweise

• Verwendung der Skripte geschieht auf eigene Gefahr.
• Führen Sie die Skripte nur auf einem Testsystem durch, bevor Sie es auf einem Produktivsystem verwenden.
• Stellen Sie sicher, dass alle Konfigurationen und Passwörter sicher gespeichert und aufbewahrt werden.
• Beachten Sie, dass das Skript eine Internetverbindung benötigt, um bestimmte Pakete herunterzuladen und zu installieren.

Voraussetzungen

• Ein Debian-basiertes Betriebssystem
• (weitere Linux-basierte Betriebssystem)
• Zugriff mit root-Rechten

Debian-basierte Systeme:

Unter unseren Githubseiten im Bereich Releases befindet sich das Installationsskript des SVWS-Server in der aktuellen Version für Debian-basierte Systeme.

install-x.y.z-sh

Bisher getestet unter:

• Debian 12
• Debian 13
• Ubuntu 22.04 LTS
• Ubuntu 24.04 LTS

Installation

• Laden Sie das Skript auf den Zielcomputer herunter.
• Öffnen Sie die Terminalanwendung und navigieren Sie zum Verzeichnis, in dem sich das Skript befindet.
• Geben Sie den Befehl chmod +x /install-x.y.z.sh ein und drücken Sie die Eingabetaste, um es ausführbar zu machen.
• Geben Sie den Befehl ./install-x.y.z.sh zur Ausführung ein und drücken Sie die Eingabetaste.
• Folgen Sie den Anweisungen im Skript.

Nach dem Durchlauf des Skripts haben Sie einen aktiv laufenden SVWS-Server!

Installationseinstellungen

Das Skript bietet verschiedene Installationsoptionen, die im Folgenden erläutert werden. Um die Installation zu vereinfachen, werden für alle Optionen sinnvolle Standardwerte vorgeschlagen. Bei Bedarf können diese jedoch individuell angepasst werden.

Die gewählten Parameter werden in der Datei .env gespeichert. Während der Installation werden die erforderlichen Werte aus dieser Datei ausgelesen. Auch bei einem Update dient sie zur Ermittlung der Installationspfade.

Existiert die Datei .env bereits, werden die Installationsoptionen nicht erneut abgefragt und die Installation startet unmittelbar. Dadurch lässt sich die Installation auch vollständig skriptgesteuert beziehungsweise automatisiert durchführen.

Folgende Konfigurationen können vorgenommen werden:

• MariaDB-Konfiguration
• Installationspfade
• Erstellung eines Keystores für TLS

Hier finden Sie einen beispielhaften Dialog:

MariaDB-Konfiguration:
Möchten Sie MariaDB installieren? (j/N): j
MARIADB_ROOT_PASSWORD (default: 'abcd1234'): abcd1234
MARIADB_DATABASE (default: 'svwsdb'): svwsdb
MARIADB_HOST (default: 'localhost'): localhost
MARIADB_USER (default: 'svwsadmin'): svwsadmin
MARIADB_PASSWORD (default: 'abcd1234'): abcd1234
Installationspfade:
APP_PATH (default: '/opt/app/svws'): /opt/app/svws
CONF_PATH (default: '/etc/app/svws/conf'): /etc/app/svws/conf
APP_PORT (default: 8443): 8443
Möchten Sie einen Keystore erstellen? (j/N): j
Keystore für TLS:
SVWS_TLS_KEYSTORE_PATH (default: '/etc/app/svws/conf/keystore'): /etc/app/svws/conf/keystore
SVWS_TLS_KEYSTORE_PASSWORD (default: 'abcd1234'): abcd1234
SVWS_TLS_KEY_ALIAS (default: ''): ''

Die Passwortvorschläge werden vom Skript generiert. Bitte sichern Sie unbedingt die verwendeten Passwörter. Diese Daten werden vom Skript nicht gespeichert!

Erläuterungen zu den einzelnen Punkten:

Variable	Erläuterung
MARIADB_ROOT_PASSWORD	Das Datenbank Passwort der Datenbankadministratoren
MARIADB_DATABASE	Name der Datenbank
MARIADB_HOST	Bei kleinen Installationen wird die Mariadb i.d.R. auf dem lokalen System (localhost) liegen. Ggf. kann hier auch die URL zu einem separaten MariaDB-Server eingetragen werden.
MARIADB_USER	Benutzer mit Vollzugriff auf die o.g. Datenbank
MARIADB_PASSWORD	Das Datenbank Passwort für MARIADB_USER
APP_PATH	Installationsverzeichnis des SVWS-Servers
CONF_PATH	Hier finden Sie die Konfigurationsdatei des SVWS-Servers
APP_PORT	Auf diesem Port ist der SVWS-Server erreichbar. i.d.R. ist dies einer der höheren Ports z.B. 8443, da für diese keine root-Rechte benötigt werden. Hier muss gegebenenfalls ein Reverse-Proxy oder eine Portumleitung eingerichtet werden, wenn man eine einfache URL verwenden möchte.
SVWS_TLS_KEYSTORE_PATH	Der Pfad des angelegten Keystores, um dort Daten zu speichern
SVWS_TLS_KEY_ALIAS	Alias des zu verwendenden Keys im Keystore

optional: Keystore

Optional kann ein eigener Keystore mit Zertifikat erstellt werden.

keytool -genkey -noprompt -alias alias1 -dname "CN=test, OU=test, O=test, L=test, S=test, C=test" -ext "SAN=DNS:localhost,IP:127.0.0.1,IP:10.1.0.1,DNS:meinserver,DNS:meinserver.mydomain.de" -keystore /etc/app/svws/conf/keystore -storepass test123 -keypass test123  -keyalg RSA

keytool -export -keystore /etc/app/svws/conf/keystore -alias alias1 -file ./SVWS.cer -storepass test123

Mit diesen Befehlen kann ein eigener Keystore mit einem Zertifikat erstellt werden. Der zweite Befehl exportiert das Zertifikat, welches dann unter den Windows-Client installiert werden kann, so dass die Warnmeldungen im Browser verschwinden.

Einrichtung

Sie haben nun einen laufenden SVWS-Server eingerichtet. Um den Server mit Daten zu befüllen und an die Anforderungen Ihrer Schule anzupassen, fahren Sie bitte mit dem Artikel Einrichtung fort.

Update

Update der Debian-Linux-Installation

• Laden Sie das Skript auf den Zielcomputer herunter.
• Öffnen Sie die Terminalanwendung und navigieren Sie zum Verzeichnis, in dem sich das Skript befindet.
• Geben Sie den Befehl chmod +x /install-x.y.z.sh ein und drücken Sie die Eingabetaste, um es ausfürbar zu machen.
• Achten Sie darauf, dass die Datei .env aus der Installation neben dem Install-Skript liegt.
• Geben Sie den Befehl ./install-x.y.z.sh --update zur Ausführung ein und drücken Sie die Eingabetaste.
• Danach sollte der SVWS-Server in der aktuellen Version laufen.

Weitere Linux-basierte Systeme

Hinweis: diese Systeme werden nicht offiziell supported.

Installation (RHL)

Die Installation unter RedHat-basierten Systemen kann hier nachgelesen werden:

Installation Redhat (RHL)

Bisher getestet unter:

• RedHat 9
• Rocky-Linux 9

NAS

Ein Proof of Concept zur Installation unter einem NAS-Systemen kann hier nachgelesen werden:

Installation NAS

Bisher getestet unter:

• Synologie 2025