Scaricare l’archivio e preparare il sistema

I comandi seguenti installano Qisutu 1.0.2 nella directory prevista /opt/qisutu. Eseguirli come root o in una shell root.

Scaricare ed estrarre l’archivio

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

Il nome della directory è tecnicamente rilevante: con l’installazione standard /opt/qisutu diventa l’identificatore dell’istanza qisutu e il percorso web /qisutu. Non utilizzare un percorso con spazi.

Preparare l’utente di sistema

Su Debian e Ubuntu, l’utente di sistema Qisutu viene creato e aggiunto al gruppo del server web come segue:

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

Se l’utente esiste già, useradd non deve essere eseguito di nuovo. Lo script di installazione controlla e completa anche l’utente e l’appartenenza al gruppo necessari. Nei sistemi basati su RHEL il gruppo del server web si chiama solitamente apache, in openSUSE/SLES www.

Avviare lo script di installazione

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

install.sh deve essere eseguito con privilegi root. Rileva la distribuzione, installa i pacchetti necessari, configura Apache e systemd, corregge i permessi dei file e crea una configurazione specifica dell’istanza in var/install/instance.conf.

Installazione su un server completamente non preparato

Qisutu può essere installato anche su un cosiddetto server bare. Non è necessario installare o configurare manualmente Apache e MariaDB in precedenza. Lo script di installazione installa i pacchetti necessari e configura anche MariaDB.

In una nuova installazione locale, install.sh accede prima localmente al database come utente root senza password. Successivamente crea un installer temporaneo del database con una password casuale. Le credenziali necessarie vengono salvate temporaneamente nel seguente file:

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

Questo file è destinato esclusivamente al passaggio al programma di installazione web. Dopo la configurazione riuscita, Qisutu rimuove automaticamente sia l’utente temporaneo del database sia il file.

L’installazione standard crea, tra l’altro:

  • Percorso web /qisutu

  • Configurazione Apache qisutu.conf

  • Servizio qisutu-daemon.service

  • Database e utente del database qisutu

  • Cookie di sessione QISUTU_SESSION

Dopo la preparazione riuscita, lo script mostra l’indirizzo del programma di installazione web. Chiamata tipica:

http://SERVER/qisutu/install.pl

Risoluzione dei problemi

In caso di interruzione, leggere prima var/log/install.log. Cause frequenti sono privilegi root mancanti, un percorso con spazi, repository dei pacchetti non raggiungibili, un nome di configurazione Apache già in uso o una distribuzione non supportata. Riavviare lo script solo dopo aver risolto la causa; un’istanza già completamente installata non viene sovrascritta come nuova installazione.