Pobierz archiwum i przygotuj system

Poniższe polecenia instalują Qisutu 1.0.2 w przeznaczonym katalogu /opt/qisutu. Uruchom je jako root lub w powłoce root.

Pobierz i rozpakuj archiwum

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

Nazwa katalogu ma znaczenie techniczne: przy standardowej instalacji /opt/qisutu powstaje z niej identyfikator instancji qisutu i ścieżka WWW /qisutu. Nie używaj ścieżki ze spacjami.

Przygotuj użytkownika systemowego

W Debianie i Ubuntu użytkownik systemowy Qisutu jest tworzony i dodawany do grupy serwera WWW w następujący sposób:

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

Jeśli użytkownik już istnieje, nie wolno ponownie wykonywać useradd. Skrypt instalacyjny również sprawdza i uzupełnia wymaganego użytkownika oraz członkostwo w grupie. W systemach opartych na RHEL grupa serwera WWW zwykle nazywa się apache, a w openSUSE/SLES www.

Uruchom skrypt instalacyjny

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

install.sh musi działać z uprawnieniami root. Rozpoznaje dystrybucję, instaluje potrzebne pakiety, konfiguruje Apache i systemd, poprawia uprawnienia plików i tworzy konfigurację instancji w var/install/instance.conf.

Instalacja na całkowicie nieprzygotowanym serwerze

Qisutu można także zainstalować na tak zwanym czystym serwerze. Nie trzeba wcześniej ręcznie instalować ani konfigurować Apache i MariaDB. Skrypt instalacyjny sam instaluje potrzebne pakiety i konfiguruje MariaDB.

Przy lokalnej nowej instalacji install.sh najpierw loguje się lokalnie jako użytkownik bazy danych root bez hasła. Następnie tworzy tymczasowego instalatora bazy danych z losowym hasłem. Potrzebne dane dostępowe są tymczasowo zapisywane w następującym pliku:

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

Ten plik służy wyłącznie do przekazania danych instalatorowi WWW. Po pomyślnej konfiguracji Qisutu automatycznie usuwa tymczasowego użytkownika bazy danych i plik.

W standardowej instalacji powstają między innymi:

  • Ścieżka WWW /qisutu

  • Konfiguracja Apache qisutu.conf

  • Usługa qisutu-daemon.service

  • Baza danych i użytkownik bazy danych qisutu

  • Plik cookie sesji QISUTU_SESSION

Po pomyślnym przygotowaniu skrypt wyświetla adres instalatora WWW. Typowe wywołanie:

http://SERVER/qisutu/install.pl

Rozwiązywanie problemów

W razie przerwania najpierw przeczytaj var/log/install.log. Częste przyczyny to brak uprawnień root, ścieżka ze spacjami, niedostępne źródła pakietów, zajęta nazwa konfiguracji Apache lub nieobsługiwana dystrybucja. Uruchom skrypt ponownie dopiero po usunięciu przyczyny; w pełni zainstalowana instancja nie zostanie nadpisana jako nowa instalacja.