Archiv herunterladen und System vorbereiten

Die folgenden Befehle installieren Qisutu 1.0.1 im vorgesehenen Verzeichnis /opt/qisutu. Führen Sie sie als root oder in einer Root-Shell aus.

Archiv laden und entpacken

cd /opt
wget https://ftp.qisutu.de/qisutu-1.0.1.tar.gz
tar xzf qisutu-1.0.1.tar.gz
mv qisutu-1.0.1 qisutu

Der Verzeichnisname ist technisch relevant: Bei der Standardinstallation /opt/qisutu wird daraus die Instanzkennung qisutu und der Webpfad /qisutu. Verwenden Sie keinen Pfad mit Leerzeichen.

Systembenutzer vorbereiten

Unter Debian und Ubuntu wird der Qisutu-Systembenutzer wie folgt angelegt und in die Webservergruppe aufgenommen:

useradd -d /opt/qisutu -c 'Qisutu user' qisutu
usermod -G www-data qisutu
chown qisutu:www-data -R /opt/qisutu

Existiert der Benutzer bereits, darf useradd nicht erneut ausgeführt werden. Das Installationsskript prüft und ergänzt den benötigten Benutzer und die Gruppenmitgliedschaft ebenfalls. Auf RHEL-basierten Systemen heißt die Webservergruppe üblicherweise apache, auf openSUSE/SLES www.

Installationsskript starten

cd /opt/qisutu
chmod +x install.sh
./install.sh

install.sh muss mit Root-Rechten laufen. Es erkennt die Distribution, installiert die benötigten Pakete, richtet Apache und systemd ein, korrigiert die Dateirechte und erzeugt eine instanzbezogene Konfiguration unter var/install/instance.conf.

Installation auf einem vollständig unvorbereiteten Server

Qisutu kann auch auf einem sogenannten nackten Server installiert werden. Apache und MariaDB müssen vorher nicht manuell installiert oder konfiguriert werden. Das Installationsskript installiert die benötigten Pakete selbst und richtet auch MariaDB ein.

Bei einer lokalen Neuinstallation meldet sich install.sh zunächst lokal als Datenbankbenutzer root ohne Passwort an. Anschließend erzeugt es einen temporären Datenbank-Installer mit einem zufälligen Passwort. Die dafür benötigten Zugangsdaten werden vorübergehend in folgender Datei gespeichert:

/opt/qisutu/var/install/database-bootstrap.conf

Diese Datei ist nur für die Übergabe an den Webinstaller vorgesehen. Nach erfolgreicher Einrichtung entfernt Qisutu sowohl den temporären Datenbankbenutzer als auch die Datei automatisch.

Bei der Standardinstallation entstehen unter anderem:

  • Webpfad /qisutu

  • Apache-Konfiguration qisutu.conf

  • Dienst qisutu-daemon.service

  • Datenbank und Datenbankbenutzer qisutu

  • Session-Cookie QISUTU_SESSION

Nach erfolgreicher Vorbereitung gibt das Skript die Adresse des Webinstallers aus. Typischer Aufruf:

http://SERVER/qisutu/install.pl

Fehler beheben

Bei einem Abbruch lesen Sie zuerst var/log/install.log. Häufige Ursachen sind fehlende Root-Rechte, ein Pfad mit Leerzeichen, nicht erreichbare Paketquellen, ein bereits belegter Apache-Konfigurationsname oder eine nicht unterstützte Distribution. Starten Sie das Skript erst erneut, nachdem die Ursache behoben wurde; eine bereits vollständig installierte Instanz wird nicht als Neuinstallation überschrieben.