Transferir o arquivo e preparar o sistema

Os comandos seguintes instalam o Qisutu 1.0.2 no diretório previsto /opt/qisutu. Execute-os como root ou numa shell de root.

Transferir 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 relevante: na instalação padrão /opt/qisutu, torna-se o identificador da instância qisutu e o caminho Web /qisutu. Não utilize um caminho com espaços.

Preparar o utilizador do sistema

No Debian e Ubuntu, o utilizador 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 utilizador já existir, useradd não deve ser executado novamente. O script de instalação também verifica e completa o utilizador e a associação ao grupo necessários. Em sistemas baseados em RHEL, o grupo do servidor Web chama-se geralmente apache; no openSUSE/SLES, www.

Executar o script de instalação

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

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

Instalação num servidor totalmente não preparado

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

Numa nova instalação local, install.sh inicia primeiro sessão localmente como utilizador da base de dados root sem palavra-passe. Em seguida, cria um instalador temporário da base de dados com uma palavra-passe aleatória. Os dados de acesso necessários são guardados temporariamente no seguinte ficheiro:

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

Este ficheiro destina-se apenas à passagem de dados ao instalador Web. Após a configuração bem-sucedida, o Qisutu remove automaticamente o utilizador temporário da base de dados e o ficheiro.

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

  • Caminho Web /qisutu

  • Configuração do Apache qisutu.conf

  • Serviço qisutu-daemon.service

  • Base de dados e utilizador da base de dados qisutu

  • Cookie de sessão QISUTU_SESSION

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

http://SERVER/qisutu/install.pl

Resolução de problemas

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