Télécharger l’archive et préparer le système

Les commandes suivantes installent Qisutu 1.0.2 dans le répertoire prévu /opt/qisutu. Exécutez-les en tant que root ou dans un shell root.

Télécharger et extraire l’archive

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

Le nom du répertoire est techniquement important : avec l’installation standard /opt/qisutu, il devient l’identifiant d’instance qisutu et le chemin web /qisutu. N’utilisez pas de chemin contenant des espaces.

Préparer l’utilisateur système

Sous Debian et Ubuntu, l’utilisateur système Qisutu est créé puis ajouté au groupe du serveur web comme suit :

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

Si l’utilisateur existe déjà, useradd ne doit pas être exécuté à nouveau. Le script d’installation vérifie et complète également l’utilisateur requis et son appartenance au groupe. Sur les systèmes basés sur RHEL, le groupe du serveur web s’appelle généralement apache et sous openSUSE/SLES www.

Lancer le script d’installation

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

install.sh doit être exécuté avec les droits root. Il détecte la distribution, installe les paquets nécessaires, configure Apache et systemd, corrige les droits des fichiers et crée une configuration propre à l’instance dans var/install/instance.conf.

Installation sur un serveur totalement non préparé

Qisutu peut également être installé sur un serveur dit « nu ». Apache et MariaDB ne doivent pas être installés ni configurés manuellement au préalable. Le script d’installation installe les paquets nécessaires et configure aussi MariaDB.

Lors d’une nouvelle installation locale, install.sh se connecte d’abord localement à la base de données en tant qu’utilisateur root sans mot de passe. Il crée ensuite un installateur de base de données temporaire avec un mot de passe aléatoire. Les identifiants nécessaires sont temporairement enregistrés dans le fichier suivant :

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

Ce fichier sert uniquement à transmettre les informations à l’installateur web. Une fois la configuration terminée, Qisutu supprime automatiquement l’utilisateur temporaire de la base de données ainsi que le fichier.

L’installation standard crée notamment :

  • Chemin web /qisutu

  • Configuration Apache qisutu.conf

  • Service qisutu-daemon.service

  • Base de données et utilisateur de base de données qisutu

  • Cookie de session QISUTU_SESSION

Après une préparation réussie, le script affiche l’adresse de l’installateur web. Appel typique :

http://SERVER/qisutu/install.pl

Résolution des erreurs

En cas d’interruption, consultez d’abord var/log/install.log. Les causes fréquentes sont l’absence de droits root, un chemin contenant des espaces, des sources de paquets inaccessibles, un nom de configuration Apache déjà utilisé ou une distribution non prise en charge. Ne relancez le script qu’après avoir corrigé la cause ; une instance déjà entièrement installée ne sera pas écrasée comme nouvelle installation.