08 · Quando algo falha: tropeços no caminho

Raiz encontra pedra. Contorna e segue.

Os tropeços mais comuns, do mais simples ao mais escondido. Os comandos são para digitar na mucua (no teclado dela, ou de longe por SSH, com o usuário mucua).

"O site não abre"

1. O celular está na mesma rede da mucua? O Wi-Fi do encontro, não o da casa ao lado.
2. Os dados móveis estão ligados? Desligue por um instante e tente de novo.
3. Tente pelo número. O IP aparece na tela da mucua (capítulo 02) — http://10.42.0.1, por exemplo. Se pelo número abre e pelo nome não, a mucua está bem: o problema é só o nome (próximo item).

"Pelo número abre, mas baobaxia.local não"

O .local é anunciado pela mucua na rede, e quem pergunta precisa saber ouvir:

• iPhone, Mac e Windows em geral entendem.
• Muitos Androids não entendem .local no navegador. Use o endereço com cadeado (local.baobaxia.net) ou o número.
• Em Linux, falta às vezes o pacote libnss-mdns.
• Alguns roteadores (rede de convidados, Wi-Fi de escola ou de empresa) bloqueiam esse anúncio entre os aparelhos.
• Se há duas mucuas na rede, a segunda vira baobaxia-2.local.

"local.baobaxia.net não abre"

• Na rede que a mucua cria, ele sempre funciona — se não abrir, o celular está usando outro caminho (dados móveis, "DNS privado" do Android: desligue em Configurações → Rede → DNS privado).
• Na rede de outra pessoa (o roteador da escola), ele só funciona se o roteador apontar o nome para a mucua (capítulo 05). Use baobaxia.local ou o número.
• Se o navegador reclamar do certificado, confira o relógio da mucua: com a data errada, o certificado parece vencido.

"Mudei o baobaxia-rede.txt e nada mudou"

O arquivo é lido no boot. Para aplicar na hora, de dentro da mucua:

sudo nano /boot/efi/baobaxia-rede.txt     # no Raspberry: /boot/firmware/
sudo baobaxia-rede
sudo baobaxia-rede status

"O chat não aceita a senha"

1. O endereço é usuario@domínio — com o mesmo domínio que aparece na página de chegada, não o de outra mucua.
2. A senha é a do site. Teste entrar no site com ela.
3. Quem cuida da mucua confere qual é o domínio do chat:

   sudo baobaxia-xmpp status
   sudo baobaxia-certificado dominio

Se o certificado tem vários nomes (local.baobaxia.net e arquivos.local.baobaxia.net), o principal tem que ser o mais curto. Para trocar (o chat é religado junto):

   sudo baobaxia-certificado dominio local.baobaxia.net

"O primeiro boot não terminou"

O primeiro boot conta o que fez num arquivo:

sudo tail -n 40 /var/log/baobaxia-primeiro-boot.log

• "precisa de internet" / erro do pip: a imagem foi gerada sem as peças do Python embutidas (o --vendor-wheels de quem gera a imagem). Ligue a mucua num cabo com internet e reinicie: o primeiro boot tenta de novo sozinho.
• "MUCUA_UUID não é um UUID": corrija a linha no baobaxia-rede.txt (capítulo 04), ou apague-a para uma mucua nova.

Enquanto não termina bem, o primeiro boot tenta de novo a cada boot.

"Saiu um caractere esquisito na tela"

A tela do boot não mostra acentos direito — por isso o menu e as mensagens são escritos sem eles. Se alguma mensagem de outro programa trouxer acento, pode sair um ? ou um quadradinho no lugar. Não é defeito: no site, tudo aparece certo.

Para olhar de perto

sudo baobaxia-rede status          # a rede: modo, conexões, IPs
sudo baobaxia-chegar status        # a página de chegada: apps, HTTPS, chat
sudo baobaxia-xmpp status          # o chat
sudo baobaxia-certificado status   # o certificado e quantos dias faltam
journalctl -u baobaxia-api -n 50   # o que o site andou dizendo

Se nada disso resolver, a comunidade da Rede Mocambos ajuda: leve a mensagem de erro e o que você já tentou.