Archief downloaden en systeem voorbereiden¶

De volgende opdrachten installeren Qisutu 1.0.2 in de bedoelde map /opt/qisutu. Voer ze uit als root of in een root-shell.

Archief downloaden en uitpakken¶

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

De mapnaam is technisch relevant: bij de standaardinstallatie /opt/qisutu worden hieruit de instantie-id qisutu en het webpad /qisutu afgeleid. Gebruik geen pad met spaties.

Systeemgebruiker voorbereiden¶

Onder Debian en Ubuntu wordt de Qisutu-systeemgebruiker als volgt gemaakt en aan de webservergroep toegevoegd:

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

Als de gebruiker al bestaat, mag useradd niet opnieuw worden uitgevoerd. Het installatiescript controleert en vult de benodigde gebruiker en groepslidmaatschap eveneens aan. Op RHEL-gebaseerde systemen heet de webservergroep meestal apache, op openSUSE/SLES www.

Installatiescript starten¶

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

install.sh moet met rootrechten worden uitgevoerd. Het herkent de distributie, installeert de benodigde pakketten, stelt Apache en systemd in, corrigeert bestandsrechten en maakt een instantiespecifieke configuratie onder var/install/instance.conf.

Installatie op een volledig onvoorbereide server¶

Qisutu kan ook op een zogeheten kale server worden geïnstalleerd. Apache en MariaDB hoeven vooraf niet handmatig te worden geïnstalleerd of geconfigureerd. Het installatiescript installeert de benodigde pakketten zelf en stelt ook MariaDB in.

Bij een lokale nieuwe installatie meldt install.sh zich eerst lokaal aan als databasegebruiker root zonder wachtwoord. Daarna maakt het een tijdelijke database-installer met een willekeurig wachtwoord. De benodigde toegangsgegevens worden tijdelijk in het volgende bestand opgeslagen:

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

Dit bestand is alleen bedoeld voor overdracht aan de webinstaller. Na een geslaagde installatie verwijdert Qisutu zowel de tijdelijke databasegebruiker als het bestand automatisch.

Bij de standaardinstallatie ontstaan onder meer:

Webpad /qisutu
Apache-configuratie qisutu.conf
Service qisutu-daemon.service
Database en databasegebruiker qisutu
Sessiecookie QISUTU_SESSION

Na een geslaagde voorbereiding toont het script het adres van de webinstaller. Typische aanroep:

http://SERVER/qisutu/install.pl

Problemen oplossen¶

Lees bij een afbreking eerst var/log/install.log. Veelvoorkomende oorzaken zijn ontbrekende rootrechten, een pad met spaties, onbereikbare pakketbronnen, een al gebruikte Apache-configuratienaam of een niet-ondersteunde distributie. Start het script pas opnieuw nadat de oorzaak is verholpen; een al volledig geïnstalleerde instantie wordt niet als nieuwe installatie overschreven.