Solução de problemas

O servidor continua Pendente

Nenhum agente se inscreveu ainda com o token deste servidor.

Um servidor ainda esperando seu agente

• O agente está rodando? No Linux, verifique com systemctl status scolah-agent e journalctl -u scolah-agent -f, ou veja o terminal onde você o iniciou.
• O servidor consegue alcançar a plataforma? No servidor, execute curl -I contra o endereço da plataforma que está no seu comando de instalação. Você deve receber uma resposta HTTP, não um tempo limite esgotado. Se estiver atrás de um proxy ou de um firewall restritivo, libere HTTPS de saída para esse endereço.
• O token já foi usado ou se perdeu? Cada token funciona uma vez. Abra o servidor, clique em Regenerar token e execute o novo comando de instalação.
• Você reutilizou uma pasta de estado? Se --state-dir apontar para uma pasta que outro servidor já usou, o agente pula a inscrição e roda como esse outro servidor. Dê a cada servidor sua própria pasta.

O servidor ficou Offline

O agente não se comunica há mais de 5 minutos. As instalações nele continuam rodando, mas o portal não consegue vê-las nem alterá-las.

• Verifique se a máquina está ligada e se o processo ou serviço do agente está rodando. Reinicie-o com sudo systemctl restart scolah-agent.
• Verifique a conexão do servidor com a internet e o acesso HTTPS de saída.
• Se o log do agente disser que ele foi bloqueado, um administrador bloqueou o servidor. Consulte Desbloquear.

Uma instalação está com o status Falhou ou Degradado

1. Abra a instalação. Na aba Status, encontre os serviços que não estão Saudável.
2. Abra a aba Atividade para ver qual etapa falhou e a mensagem de erro.
3. Causas comuns:
   • Disco ou memória insuficientes. Libere espaço, redimensione para um tamanho que caiba ou use um servidor maior.
   • Não foi possível baixar as imagens. O servidor perdeu o acesso à internet, ou o registro de imagens ficou indisponível por alguns instantes.
   • Um serviço fica reiniciando o tempo todo. Veja as mensagens desse serviço na aba Atividade. Para problemas no nível do aplicativo, entre em contato com o suporte da Scolah informando o nome da instalação.
4. Clique em Tentar novamente depois de corrigir a causa.

Uma implantação falha com um erro de bundle ou de assinatura

O agente se recusou a implantar porque o bundle do aplicativo não correspondia à sua assinatura. Isso protege seu servidor contra software adulterado. Nada foi alterado no servidor. Tente novamente uma vez. Se acontecer de novo, entre em contato com o suporte da Scolah: não tente contornar o problema.

Um domínio personalizado não é verificado

• Confirme que o registro TXT está exatamente em _scolah-verify.<seu nome de host> e que o valor corresponde ao do portal, incluindo o prefixo scolah-verify=.
• As alterações de DNS podem demorar a se propagar. Aguarde alguns minutos e clique em Verificar novamente.
• Alguns provedores de DNS acrescentam automaticamente seu domínio ao final dos nomes dos registros. Se for o caso do seu, digite apenas _scolah-verify.dashboards, não o nome completo.

O site abre por HTTP e não por HTTPS

O agente foi iniciado sem um e-mail do Let’s Encrypt, por isso o HTTPS automático está desativado. Acrescente ACME_EMAIL=you@your-organisation.org a /etc/scolah-agent/env (ou passe --acme-email) e reinicie o agente. Consulte Domínios e HTTPS.

Perdi a senha do primeiro acesso a um aplicativo

Ela só foi mostrada uma vez, quando você criou a instalação, e a plataforma não pode mostrá-la novamente. Use a redefinição de senha do próprio aplicativo, se houver. Se não houver, entre em contato com o suporte da Scolah.

Continua sem solução?

Entre em contato com o suporte da Scolah informando o nome da sua organização, o nome do servidor ou da instalação e o que a aba Atividade mostra.