Baixar o arquivo e preparar o sistema

Os comandos a seguir instalam o Qisutu 1.0.2 no diretório previsto /opt/qisutu. Execute-os como root ou em um shell de root.

Baixar e extrair o arquivo

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

O nome do diretório é tecnicamente importante: na instalação padrão /opt/qisutu, ele se torna o identificador da instância qisutu e o caminho web /qisutu. Não use um caminho com espaços.

Preparar o usuário do sistema

No Debian e Ubuntu, o usuário de sistema do Qisutu é criado e adicionado ao grupo do servidor web da seguinte forma:

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

Se o usuário já existir, useradd não deve ser executado novamente. O script de instalação também verifica e completa o usuário e a associação ao grupo necessários. Em sistemas baseados em RHEL, o grupo do servidor web geralmente se chama apache; no openSUSE/SLES, www.

Executar o script de instalação

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

install.sh deve ser executado com privilégios de root. Ele detecta a distribuição, instala os pacotes necessários, configura Apache e systemd, corrige permissões de arquivos e cria uma configuração específica da instância em var/install/instance.conf.

Instalação em um servidor totalmente não preparado

O Qisutu também pode ser instalado em um servidor chamado bare. Apache e MariaDB não precisam ser instalados nem configurados manualmente antes. O script de instalação instala os pacotes necessários e também configura o MariaDB.

Em uma nova instalação local, install.sh primeiro se conecta localmente como usuário de banco de dados root sem senha. Em seguida, cria um instalador temporário do banco de dados com uma senha aleatória. Os dados de acesso necessários são armazenados temporariamente no seguinte arquivo:

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

Esse arquivo serve apenas para transmitir os dados ao instalador web. Após a configuração bem-sucedida, o Qisutu remove automaticamente o usuário temporário do banco de dados e o arquivo.

A instalação padrão cria, entre outros:

  • Caminho web /qisutu

  • Configuração do Apache qisutu.conf

  • Serviço qisutu-daemon.service

  • Banco de dados e usuário de banco de dados qisutu

  • Cookie de sessão QISUTU_SESSION

Após a preparação bem-sucedida, o script exibe o endereço do instalador web. Chamada típica:

http://SERVER/qisutu/install.pl

Solução de problemas

Em caso de interrupção, leia primeiro var/log/install.log. Causas comuns são falta de privilégios de root, caminho com espaços, repositórios de pacotes inacessíveis, nome de configuração do Apache já usado ou distribuição não suportada. Execute o script novamente somente após resolver a causa; uma instância já totalmente instalada não é sobrescrita como nova instalação.