Requisitos¶
O Qisutu 1.0.2 é instalado em um servidor Linux. A preparação do sistema é executada como root
porque configura pacotes, configurações do Apache, serviços systemd, usuários e permissões de
arquivos.
Sistemas suportados¶
A plataforma de referência recomendada é o Ubuntu Server LTS. O install.sh fornecido também
possui caminhos 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, as seguintes condições devem ser atendidas:
Acesso root ou shell de root
Acesso de rede aos repositórios 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 programa, banco de dados, anexos, logs e backups
Um banco de dados próprio ou identificador de instância exclusivo por instalação
Para conexões OAuth2 com Microsoft 365 ou Google será necessária posteriormente uma URL base HTTPS acessível externamente. Um endereço apenas HTTP basta para uma instalação local inicial, mas não deve ser usado em produção.
Software necessário¶
O script de instalação instala ou verifica Apache, MariaDB ou as ferramentas cliente MySQL necessárias, Perl e os módulos Perl exigidos para banco de dados, e-mail, LDAP, TLS e OAuth. Portanto, não é preciso procurar os pacotes individualmente antes.
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 banco de dados. O Qisutu cria configurações específicas da instância, mas não substitui uma configuração do operador alterada intencionalmente.