08 · Cuando algo falla: tropiezos en el camino

La raíz encuentra una piedra. La rodea y sigue.

Los tropiezos más comunes, del más simple al más escondido. Los comandos son para escribir en la mucua (en su teclado, o de lejos por SSH, con el usuario mucua).

"El sitio no abre"

1. ¿El celular está en la misma red que la mucua? El Wi-Fi del encuentro, no el de la casa de al lado.
2. ¿Los datos móviles están encendidos? Apágalos un instante e intenta de nuevo.
3. Prueba con el número. La IP aparece en la pantalla de la mucua (capítulo 02) — http://10.42.0.1, por ejemplo. Si con el número abre y con el nombre no, la mucua está bien: el problema es solo el nombre (siguiente punto).

"Con el número abre, pero baobaxia.local no"

El .local lo anuncia la mucua en la red, y quien pregunta necesita saber escuchar:

• iPhone, Mac y Windows en general lo entienden.
• Muchos Android no entienden .local en el navegador. Usa la dirección con candado (local.baobaxia.net) o el número.
• En Linux, a veces falta el paquete libnss-mdns.
• Algunos routers (red de invitados, Wi-Fi de escuela o de empresa) bloquean ese anuncio entre los aparatos.
• Si hay dos mucuas en la red, la segunda pasa a ser baobaxia-2.local.

"local.baobaxia.net no abre"

• En la red que crea la mucua, siempre funciona — si no abre, el celular está usando otro camino (datos móviles, "DNS privado" de Android: apágalo en Ajustes → Red → DNS privado).
• En la red de otra persona (el router de la escuela), solo funciona si el router apunta el nombre a la mucua (capítulo 05). Usa baobaxia.local o el número.
• Si el navegador se queja del certificado, revisa el reloj de la mucua: con la fecha equivocada, el certificado parece vencido.

"Cambié baobaxia-rede.txt y no cambió nada"

El archivo se lee en el arranque. Para aplicarlo en el momento, desde dentro de la mucua:

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

"El chat no acepta la contraseña"

1. La dirección es usuario@dominio — con el mismo dominio que aparece en la página de llegada, no el de otra mucua.
2. La contraseña es la del sitio. Prueba entrar al sitio con ella.
3. Quien cuida la mucua revisa cuál es el dominio del chat:

   sudo baobaxia-xmpp status
   sudo baobaxia-certificado dominio

Si el certificado tiene varios nombres (local.baobaxia.net y arquivos.local.baobaxia.net), el principal tiene que ser el más corto. Para cambiarlo (el chat se reinicia junto):

   sudo baobaxia-certificado dominio local.baobaxia.net

"El primer arranque no terminó"

El primer arranque cuenta lo que hizo en un archivo:

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

• "necesita internet" / error de pip: la imagen se generó sin las piezas de Python incluidas (el --vendor-wheels de quien genera la imagen). Conecta la mucua a un cable con internet y reinicia: el primer arranque lo intenta de nuevo solo.
• "MUCUA_UUID no es un UUID": corrige la línea en baobaxia-rede.txt (capítulo 04), o bórrala para una mucua nueva.

Mientras no termine bien, el primer arranque lo intenta de nuevo en cada arranque.

"Salió un carácter raro en la pantalla"

La pantalla del arranque no muestra bien los acentos — por eso el menú y los mensajes están escritos sin ellos. Si algún mensaje de otro programa trae acento, puede salir un ? o un cuadradito en su lugar. No es una falla: en el sitio, todo aparece bien.

Para mirar de cerca

sudo baobaxia-rede status          # la red: modo, conexiones, IPs
sudo baobaxia-chegar status        # la página de llegada: apps, HTTPS, chat
sudo baobaxia-xmpp status          # el chat
sudo baobaxia-certificado status   # el certificado y cuántos días faltan
journalctl -u baobaxia-api -n 50   # lo que el sitio estuvo diciendo

Si nada de esto lo resuelve, la comunidad de la Rede Mocambos ayuda: lleva el mensaje de error y lo que ya intentaste.