08 · Quando qualcosa non va: inciampi lungo il cammino

La radice incontra una pietra. La aggira e prosegue.

Gli inciampi più comuni, dal più semplice al più nascosto. I comandi vanno scritti sulla mucua (sulla sua tastiera, o da lontano via SSH, con l'utente mucua).

"Il sito non si apre"

1. Il telefono è sulla stessa rete della mucua? La Wi-Fi dell'incontro, non quella della casa accanto.
2. I dati mobili sono accesi? Spegnili un momento e riprova.
3. Prova con il numero. L'IP compare sullo schermo della mucua (capitolo 02) — http://10.42.0.1, per esempio. Se con il numero si apre e con il nome no, la mucua sta bene: il problema è solo il nome (punto successivo).

"Con il numero si apre, ma baobaxia.local no"

Il .local lo annuncia la mucua sulla rete, e chi chiede deve saper ascoltare:

• iPhone, Mac e Windows in genere lo capiscono.
• Molti Android non capiscono .local nel browser. Usa l'indirizzo con il lucchetto (local.baobaxia.net) o il numero.
• Su Linux, a volte manca il pacchetto libnss-mdns.
• Alcuni router (rete ospiti, Wi-Fi di scuola o di azienda) bloccano quell'annuncio tra i dispositivi.
• Se ci sono due mucua sulla rete, la seconda diventa baobaxia-2.local.

"local.baobaxia.net non si apre"

• Sulla rete che crea la mucua, funziona sempre — se non si apre, il telefono sta usando un'altra strada (dati mobili, "DNS privato" di Android: spegnilo in Impostazioni → Rete → DNS privato).
• Sulla rete di qualcun altro (il router della scuola), funziona solo se il router punta il nome sulla mucua (capitolo 05). Usa baobaxia.local o il numero.
• Se il browser si lamenta del certificato, controlla l'orologio della mucua: con la data sbagliata, il certificato sembra scaduto.

"Ho cambiato baobaxia-rede.txt e non è cambiato niente"

Il file viene letto all'avvio. Per applicarlo subito, dall'interno della mucua:

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

"La chat non accetta la password"

1. L'indirizzo è utente@dominio — con lo stesso dominio che compare sulla pagina di arrivo, non quello di un'altra mucua.
2. La password è quella del sito. Prova a entrare nel sito con quella.
3. Chi cura la mucua controlla qual è il dominio della chat:

   sudo baobaxia-xmpp status
   sudo baobaxia-certificado dominio

Se il certificato ha più nomi (local.baobaxia.net e arquivos.local.baobaxia.net), quello principale deve essere il più corto. Per cambiarlo (la chat viene riavviata insieme):

   sudo baobaxia-certificado dominio local.baobaxia.net

"Il primo avvio non è finito"

Il primo avvio racconta ciò che ha fatto in un file:

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

• "serve internet" / errore di pip: l'immagine è stata generata senza i pezzi di Python inclusi (il --vendor-wheels di chi genera l'immagine). Collega la mucua a un cavo con internet e riavvia: il primo avvio riprova da solo.
• "MUCUA_UUID non è un UUID": correggi la riga in baobaxia-rede.txt (capitolo 04), o cancellala per una mucua nuova.

Finché non finisce bene, il primo avvio riprova a ogni avvio.

"È comparso un carattere strano sullo schermo"

Lo schermo dell'avvio non mostra bene gli accenti — per questo il menu e i messaggi sono scritti senza. Se un messaggio di un altro programma porta un accento, al suo posto può comparire un ? o un quadratino. Non è un difetto: sul sito tutto si vede bene.

Per guardare da vicino

sudo baobaxia-rede status          # la rete: modalità, connessioni, IP
sudo baobaxia-chegar status        # la pagina di arrivo: app, HTTPS, chat
sudo baobaxia-xmpp status          # la chat
sudo baobaxia-certificado status   # il certificato e quanti giorni mancano
journalctl -u baobaxia-api -n 50   # che cosa ha detto il sito

Se niente di tutto questo risolve, la comunità della Rede Mocambos aiuta: porta il messaggio di errore e ciò che hai già provato.