Arşivi indirme ve sistemi hazırlama

Aşağıdaki komutlar Qisutu 1.0.2’i öngörülen /opt/qisutu dizinine kurar. Bunları root olarak veya root kabuğunda çalıştırın.

Arşivi indirme ve çıkarma

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

Dizin adı teknik olarak önemlidir: standart /opt/qisutu kurulumunda buradan qisutu örnek kimliği ve /qisutu web yolu oluşturulur. Boşluk içeren yol kullanmayın.

Sistem kullanıcısını hazırlama

Debian ve Ubuntu’da Qisutu sistem kullanıcısı aşağıdaki şekilde oluşturulur ve web sunucusu grubuna eklenir:

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

Kullanıcı zaten varsa useradd yeniden çalıştırılmamalıdır. Kurulum betiği gerekli kullanıcıyı ve grup üyeliğini de denetler ve tamamlar. RHEL tabanlı sistemlerde web sunucusu grubu genellikle apache, openSUSE/SLES’te www adını taşır.

Kurulum betiğini çalıştırma

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

install.sh root yetkileriyle çalışmalıdır. Dağıtımı algılar, gerekli paketleri kurar, Apache ve systemd’yi yapılandırır, dosya izinlerini düzeltir ve var/install/instance.conf altında örneğe özel yapılandırma oluşturur.

Tamamen hazırlanmamış sunucuya kurulum

Qisutu sözde çıplak bir sunucuya da kurulabilir. Apache ve MariaDB’nin önceden elle kurulması veya yapılandırılması gerekmez. Kurulum betiği gerekli paketleri kurar ve MariaDB’yi de yapılandırır.

Yerel yeni kurulumda install.sh önce veritabanına parolasız root kullanıcısı olarak yerel bağlanır. Ardından rastgele parolalı geçici bir veritabanı kurucusu oluşturur. Gerekli erişim bilgileri geçici olarak şu dosyada saklanır:

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

Bu dosya yalnızca web kurucusuna aktarım içindir. Başarılı kurulumdan sonra Qisutu hem geçici veritabanı kullanıcısını hem de dosyayı otomatik siler.

Standart kurulumda diğerlerinin yanı sıra şunlar oluşturulur:

  • Web yolu /qisutu

  • Apache yapılandırması qisutu.conf

  • Hizmet qisutu-daemon.service

  • Veritabanı ve veritabanı kullanıcısı qisutu

  • Oturum çerezi QISUTU_SESSION

Başarılı hazırlıktan sonra betik web kurucusunun adresini gösterir. Tipik çağrı:

http://SERVER/qisutu/install.pl

Sorun giderme

Bir kesinti olursa önce var/log/install.log dosyasını okuyun. Yaygın nedenler root yetkilerinin olmaması, boşluklu yol, erişilemeyen paket kaynakları, daha önce kullanılmış Apache yapılandırma adı veya desteklenmeyen dağıtımdır. Betiği yalnızca nedeni giderdikten sonra yeniden çalıştırın; tamamen kurulmuş bir örnek yeni kurulum olarak üzerine yazılmaz.