Requisitos

O Qisutu 1.0.2 é instalado num servidor Linux. A preparação do sistema é executada como root porque configura pacotes, configurações do Apache, serviços systemd, utilizadores e permissões de ficheiros.

Sistemas suportados

A plataforma de referência recomendada é o Ubuntu Server LTS. O install.sh fornecido também possui procedimentos de instalação próprios para Debian, RHEL, Rocky Linux, AlmaLinux, CentOS, Fedora, openSUSE e SLES. Uma distribuição desconhecida não é tratada silenciosamente como Ubuntu; o script termina com uma mensagem de erro compreensível.

Verificações preliminares

Antes de começar, têm de ser cumpridas as seguintes condições:

  • Acesso root ou shell de root

  • Acesso de rede às fontes de pacotes da distribuição

  • Resolução de nomes funcional e servidor Web acessível

  • Um caminho de instalação sem espaços

  • Espaço suficiente para o programa, a base de dados, os anexos, os registos e as cópias de segurança

  • Uma base de dados própria ou identificador de instância único por instalação

Para ligações OAuth2 ao Microsoft 365 ou Google será posteriormente necessário um URL base HTTPS acessível externamente. Um endereço apenas HTTP é suficiente para uma primeira instalação local, mas não deve ser utilizado em produção.

Software necessário

O script de instalação instala ou verifica o Apache, o MariaDB ou as ferramentas de cliente MySQL necessárias, o Perl e os módulos Perl exigidos para base de dados, e-mail, LDAP, TLS e OAuth. Por isso, não é necessário procurar os pacotes individualmente com antecedência.

Servidor existente

Antes da instalação, verifique se já existem VirtualHosts próprios do Apache, regras de firewall, políticas SELinux ou políticas de base de dados. O Qisutu cria configurações específicas da instância, mas não substitui uma configuração do operador alterada intencionalmente.