Descargar el archivo y preparar el sistema

Los siguientes comandos instalan Qisutu 1.0.2 en el directorio previsto /opt/qisutu. Ejecútelos como root o en una shell de root.

Descargar y extraer el archivo

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

El nombre del directorio es técnicamente relevante: con la instalación estándar /opt/qisutu se convierte en el identificador de instancia qisutu y la ruta web /qisutu. No use una ruta con espacios.

Preparar el usuario del sistema

En Debian y Ubuntu, el usuario del sistema Qisutu se crea y añade al grupo del servidor web del siguiente modo:

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

Si el usuario ya existe, useradd no debe ejecutarse de nuevo. El script de instalación también comprueba y completa el usuario y la pertenencia al grupo necesarios. En sistemas basados en RHEL, el grupo del servidor web suele llamarse apache; en openSUSE/SLES, www.

Ejecutar el script de instalación

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

install.sh debe ejecutarse con privilegios de root. Detecta la distribución, instala los paquetes necesarios, configura Apache y systemd, corrige los permisos de archivos y crea una configuración específica de la instancia en var/install/instance.conf.

Instalación en un servidor completamente sin preparar

Qisutu también puede instalarse en un servidor denominado bare. No es necesario instalar ni configurar manualmente Apache y MariaDB de antemano. El script de instalación instala los paquetes necesarios y también configura MariaDB.

En una instalación local nueva, install.sh inicia primero sesión localmente como usuario de base de datos root sin contraseña. A continuación crea un instalador temporal de base de datos con una contraseña aleatoria. Los datos de acceso necesarios se guardan temporalmente en el siguiente archivo:

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

Este archivo está destinado únicamente a transferir los datos al instalador web. Tras la configuración correcta, Qisutu elimina automáticamente tanto el usuario temporal de la base de datos como el archivo.

La instalación estándar crea, entre otros:

  • Ruta web /qisutu

  • Configuración de Apache qisutu.conf

  • Servicio qisutu-daemon.service

  • Base de datos y usuario de base de datos qisutu

  • Cookie de sesión QISUTU_SESSION

Tras la preparación correcta, el script muestra la dirección del instalador web. Llamada típica:

http://SERVER/qisutu/install.pl

Solución de problemas

En caso de interrupción, lea primero var/log/install.log. Las causas frecuentes son falta de privilegios de root, una ruta con espacios, repositorios de paquetes inaccesibles, un nombre de configuración de Apache ya utilizado o una distribución no compatible. Vuelva a ejecutar el script solo después de resolver la causa; una instancia ya instalada por completo no se sobrescribe como instalación nueva.