Stáhnout archiv a připravit systém¶

Následující příkazy nainstalují Qisutu 1.0.2 do určeného adresáře /opt/qisutu. Spusťte je jako root nebo v root shellu.

Stáhnout a rozbalit archiv¶

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

Název adresáře je technicky důležitý: při standardní instalaci /opt/qisutu se z něj vytvoří identifikátor instance qisutu a webová cesta /qisutu. Nepoužívejte cestu s mezerami.

Připravit systémového uživatele¶

V Debianu a Ubuntu se systémový uživatel Qisutu vytvoří a přidá do skupiny webserveru následovně:

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

Pokud uživatel již existuje, nesmí se useradd spustit znovu. Instalační skript potřebného uživatele a členství ve skupině také kontroluje a doplňuje. V systémech založených na RHEL se skupina webserveru obvykle jmenuje apache, v openSUSE/SLES www.

Spustit instalační skript¶

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

install.sh musí běžet s oprávněními root. Rozpozná distribuci, nainstaluje potřebné balíčky, nastaví Apache a systemd, opraví oprávnění souborů a vytvoří konfiguraci instance v var/install/instance.conf.

Instalace na zcela nepřipravený server¶

Qisutu lze nainstalovat i na takzvaný holý server. Apache a MariaDB není nutné předem ručně instalovat ani konfigurovat. Instalační skript nainstaluje potřebné balíčky a nastaví také MariaDB.

Při místní nové instalaci se install.sh nejprve lokálně přihlásí jako databázový uživatel root bez hesla. Poté vytvoří dočasného instalátora databáze s náhodným heslem. Potřebné přístupové údaje se dočasně uloží do následujícího souboru:

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

Tento soubor je určen pouze k předání webovému instalátoru. Po úspěšném nastavení Qisutu automaticky odstraní jak dočasného databázového uživatele, tak tento soubor.

Při standardní instalaci vznikne mimo jiné:

Webová cesta /qisutu
Konfigurace Apache qisutu.conf
Služba qisutu-daemon.service
Databáze a databázový uživatel qisutu
Cookie relace QISUTU_SESSION

Po úspěšné přípravě skript vypíše adresu webového instalátoru. Typické volání:

http://SERVER/qisutu/install.pl

Odstraňování chyb¶

Při přerušení nejprve přečtěte var/log/install.log. Častými příčinami jsou chybějící oprávnění root, cesta s mezerami, nedostupné zdroje balíčků, již použitý název konfigurace Apache nebo nepodporovaná distribuce. Skript znovu spusťte až po odstranění příčiny; již plně nainstalovaná instance se nepřepíše jako nová instalace.