Quando qualcosa non va: da dove cominciare

14 min · 12 sezioni

Questa guida è ordinata per ciò che vedi, non per ciò che si guasta. Cerca il sintomo, e da lì viene fuori cosa guardare e in quale ordine.

Una regola prima di tutto: il pannello dice ciò che sa e non tira a indovinare. Se una schermata ti dà un motivo, quel motivo è verificato; se ti dice «non è stato possibile guardare», è perché davvero non ha potuto, ed è lì che entra in gioco questa guida.

1. Non riesco ad aprire il pannello

La prima cosa è separare due cose molto diverse: il NAS non risponde o il tuo browser non vuole entrare. Si distinguono in dieci secondi.

1.1 È ancora a quell'indirizzo?

La causa numero uno di «non si apre» non è un guasto: è che l'IP è cambiato. Succede quando il router si riavvia e assegna di nuovo gli indirizzi.

Con un monitor e una tastiera collegati al NAS, o via SSH:

lgm

Mostra la versione, il nome del dispositivo e l'indirizzo del pannello. Se è diverso da quello che avevi salvato, il problema era quello, e la soluzione di fondo è dargli un indirizzo fisso: Pannello di controllo → Rete, o dalla console lgm set-ip.

1.2 Il servizio è in funzione?

systemctl status nas-backend nas-helper

Sono i due che contano: nas-backend è il pannello e nas-helper è il processo con i permessi che fa il lavoro di sistema. Se uno dei due è fermo:

sudo systemctl restart nas-backend
lgm log

lgm log mostra il registro del pannello, che è dove ci sarà il motivo.

⚠️ Se hai appena aggiornato e il pannello non torna, guarda la sezione 6.

1.3 «Il server NAS non risponde in questo momento (si sta riavviando?)»

Questo messaggio compare dentro il pannello: la pagina si è caricata, quindi il browser è arrivato al NAS almeno una volta. Due casi:

• Hai appena aggiornato o riavviato. È normale per qualche secondo; il pannello riprova da solo e torna.
• Compare appena apri e non se ne va. Allora la pagina che stai vedendo viene dalla copia salvata nel browser, non dal NAS. Di solito è il certificato: il browser rifiuta la connessione e non arriva mai a mostrarti il suo avviso, che è l'unica schermata da cui si accetta. Nel messaggio stesso hai il pulsante «Entra senza la copia salvata», che cancella quella copia e ricarica; allora compare l'avviso del certificato di sempre.

2. Entro, ma un'applicazione dice che non ho accesso

Non è un guasto: è la distribuzione delle applicazioni. Ogni account ha le sue e con quale livello —guardare o guardare e toccare—, e chi comanda è il NAS, non l'icona.

Chi amministra lo cambia in Pannello di controllo → Utenti e gruppi → l'account → Applicazioni. È spiegato per intero in Utenti, permessi e cosa vede ognuno.

Due cose che confondono:

• L'icona non c'è più. Togliendo un'applicazione sparisce anche dal desktop e dalla ricerca di quell'account. Non è stata disinstallata: non è sua.
• Posso vederlo ma non cambiarlo. È il livello «vedi». I pulsanti che scrivono non compaiono. In Telecamere, Backup e Archiviazione è il massimo che si può dare a un account che non amministra.

3. Non vedo il NAS da Windows, Mac o dal telefono

Vai in ordine, dal più comune al meno comune:

1. Quell'account ha accesso alla cartella? Condividere una cartella e dare accesso a qualcuno sono due cose diverse: Pannello di controllo → Cartelle della casa → la cartella → Permessi.
2. Il protocollo è acceso? SMB, NFS e WebDAV si accendono separatamente in Pannello di controllo → Servizi file, e inoltre bisogna segnarlo su ogni cartella.
3. La password di SMB non è quella del pannello se non l'hai mai impostata. Quando si crea l'account si impostano entrambe insieme, ma cambiarne una non cambia l'altra.
4. Scrivi l'indirizzo a mano invece di aspettare che compaia da solo: su Windows \\192.168.1.50, sul Mac smb://192.168.1.50. Il rilevamento automatico della rete è la prima cosa che fallisce e non significa nulla.
5. Manca solo «La mia unità»? Ha la sua riga in `Pannello di controllo → Cartelle della casa`: se è spenta, o senza il protocollo che usi, non compare. Via NFS, inoltre, la montano solo i dispositivi del suo elenco.

Tutto il dettaglio, dispositivo per dispositivo, in Collegare i tuoi dispositivi al NAS.

4. È lento

Prima di toccare qualsiasi cosa, guarda chi sta lavorando: Monitor mostra CPU, memoria, rete e dischi dal vivo. Con questo, tre casi:

• I dischi al 100 % e tutto il resto tranquillo. Quasi sempre è uno scrub, un backup o l'indicizzatore delle foto. Finisce e passa; in Archiviazione e in Backup si vede cosa c'è in corso.
• La rete al massimo. Qualcuno sta copiando qualcosa, o c'è un torrent in upload. I limiti di velocità dei download sono nella loro app.
• Tutto tranquillo e comunque lento. Se è un torrent, guarda l'avviso della porta nell'app Download: con la porta chiusa scarichi solo dai peer a cui ti colleghi tu, ed è una frazione della velocità. Se è SMB, prova a copiare un file grande invece di tanti piccoli: mille file da 10 KB sono mille conversazioni, ed è lento su qualsiasi NAS.

5. Un disco dà errori

Non scollegarlo ancora. Con il RAID, togliere il disco sbagliato trasforma un problema in una perdita.

1. Archiviazione → Protezione → Salute e cifratura dice quale disco è e cosa ha (SMART). Annota il suo **numero di serie**, che è l'unica cosa che non si sposta; la lettera (sda, sdb) può cambiare al riavvio.
2. Se il volume continua a funzionare, fai un backup adesso prima di toccare qualsiasi cosa. Un disco che comincia a guastarsi di solito regge per ore.
3. La sostituzione si fa dal pannello ed è spiegata passo passo in [Ripristino di emergenza](disaster-recovery.md).

6. Ho aggiornato e qualcosa non va

lgm log e lgm progress raccontano cosa è successo nell'ultimo aggiornamento.

• Il pannello non torna. L'aggiornamento salva una copia delle unità prima di toccarle proprio per questo. systemctl status nas-backend dirà se è che non si avvia, e lgm log il motivo.
• Un'attività critica a metà. Se c'è un ripristino o un backup in corso, l'aggiornamento si rifiuta di cominciare. È voluto.

Tornare alla versione precedente

Se una versione nuova ti rompe qualcosa e non puoi aspettare la correzione, in Pannello di controllo → Aggiorna LGM-OS c'è un pulsante «Torna alla X» con la versione che c'era prima dell'ultimo aggiornamento. Riporta il pannello a quella versione in un minuto; i tuoi dati e le tue impostazioni restano come sono e le applicazioni continuano a funzionare. La versione ritirata non si reinstalla da sola: quando vuoi, «Installa comunque». Il pulsante non compare se l'aggiornamento ha cambiato la forma delle impostazioni (la versione precedente non le capirebbe); il pannello lo dice.

7. Il disco si è riempito

La prima cosa è sapere di quale disco parliamo: quello di sistema e quello dei dati sono diversi e si sistemano in modo diverso.

• Il volume dei dati. Pannello di controllo → Rapporto sullo spazio mostra dove va il disco e i duplicati. Attenzione alle istantanee: ciò che elimini continua a occupare finché c'è un'istantanea che lo ricorda.
• Il disco di sistema. Si riempie con registri, immagini Docker e download messi male. Il pulsante Pulisci del Centro pacchetti —che elimina immagini e volumi che nessuno usa più— e il cestino sono i primi due posti.

8. Come chiedere aiuto con dei dati

In Pannello di controllo → Verifica del sistema c'è un pulsante, Scarica il rapporto per l'assistenza, che scarica un file con tutto ciò che serve per capire cosa succede al dispositivo: la versione, com'è andato l'ultimo aggiornamento, la verifica dei servizi, i dischi, la rete, le applicazioni Docker, gli avvisi e le ultime righe del registro del pannello (al massimo 5.000, dell'ultimo giorno). Prepararlo può richiedere un minuto. Mandalo così com'è a chi ti sta aiutando; è ciò che risparmia le dieci domande di andata e ritorno. Non contiene password: né quelle degli account del NAS, né quelle delle telecamere, né quelle dei cloud. I campi che le conservano compaiono come [oculto].

Se preferisci guardarlo tu dalla console:

lgm info      # versione, dispositivo e indirizzo
lgm log       # il registro del pannello
systemctl status nas-backend nas-helper

E la sezione Test di rete della Verifica ha i controlli di rete —risolvere un nome, uscire su internet, guardare se una porta risponde— senza uscire dal browser.

⚠️ Prima di incollare un registro da qualsiasi parte, leggilo. Il pannello cancella le password dai messaggi che mostra, ma un registro di sistema è del sistema e può contenere indirizzi interni o nomi delle tue cartelle.

9. «L'impostazione … era danneggiata»

Le impostazioni del pannello vivono in file di /var/nas/state, uno per argomento: users.json gli account, shared_folders.json le cartelle della casa, e così via. Se uno non si può leggere, il pannello non cade: lo mette da parte come <nome>.json.corrupt, prosegue con i valori di fabbrica di quella parte e ti avvisa con «L'impostazione «…» era danneggiata». Ciò che noti dipende da quale:

⚠️ Finché non la recuperi, non creare né modificare nulla di quella parte del pannello: salveresti sopra i valori di fabbrica. Con shared_folders messo da parte, creare una cartella tornerebbe a pubblicare solo quella.

Quasi sempre il file sta bene. Fino alla 2.0.4, una lettura andata male metteva da parte file che su disco erano perfetti. Dalla 2.0.4 non succede più, e all'avvio il pannello rimette a posto da solo quelli che si leggono bene: vedrai «L'impostazione «…» si è recuperata da sola».

9.1 Recuperarla

Via SSH, o con un monitor e una tastiera collegati al NAS:

1. Con una versione precedente alla 2.0.4, aggiorna. All'avvio della versione nuova si rimette a posto da sola, e non serve altro:

sudo lgm update

1. Se hai già la 2.0.4 o successiva, riavvia il pannello; all'avvio guarda quelle messe da parte:

sudo systemctl restart nas-backend

1. A mano, senza aggiornare né riavviare. Incolla questo per intero. Rimette a posto ogni file messo da parte che sia un'impostazione buona, non calpesta uno che sia già stato salvato di nuovo e non tocca quelli rotti davvero:

sudo python3 - <<'EOF'
import glob, json, os
d = "/var/nas/state"
for apartado in sorted(glob.glob(d + "/*.json.corrupt")):
    nombre = os.path.basename(apartado)[:-len(".json.corrupt")]
    destino = f"{d}/{nombre}.json"
    if os.path.exists(destino):
        print(f"- {nombre}: ya hay uno nuevo, no se toca"); continue
    try:
        doc = json.loads(open(apartado, "rb").read().decode("utf-8"))
    except Exception as e:
        print(f"- {nombre}: roto de verdad, se deja ({e})"); continue
    if not isinstance(doc, dict):
        print(f"- {nombre}: no tiene forma de ajuste, se deja"); continue
    st = os.stat(apartado)
    tmp = destino + ".reponiendo"
    with open(tmp, "wb") as f:
        f.write(json.dumps(doc, indent=2, ensure_ascii=False).encode("utf-8")); f.flush(); os.fsync(f.fileno())
    os.chown(tmp, st.st_uid, st.st_gid); os.chmod(tmp, 0o600); os.replace(tmp, destino)
    print(f"+ {nombre}: repuesto")
EOF

Ogni riga con + è un'impostazione rimessa a posto (lo script la segna con «repuesto»), e si nota subito: con users, si può già entrare.

9.2 Se è rotta davvero

Se il passo 3 dice «roto de verdad» (rotta davvero), ciò che c'è nel file non si può recuperare e bisogna prenderla dal backup della configurazione.

• Puoi entrare nel pannello (quella rotta non è users): Pannello di controllo → Backup della configurazione → «Ripristina da file…».
• Non puoi entrare (quella rotta è users): si prende dal backup via SSH. Prima, il più recente:

sudo find /mnt /srv -name 'nas-config-*.tar.gz' -printf '%T+ %p\n' 2>/dev/null | sort | tail -3

E da lì, solo quell'impostazione (cambia il percorso con quello che è uscito sopra):

COPIA=/mnt/tank/backups/nas-config-XXXX.tar.gz
sudo tar -xzf "$COPIA" -C /tmp state/users.json
sudo install -o "$(stat -c %U /var/nas/state)" -g "$(stat -c %G /var/nas/state)" -m 600 \
  /tmp/state/users.json /var/nas/state/users.json
sudo rm -rf /tmp/state

• Senza backup degli account: riavvia il pannello (sudo systemctl restart nas-backend). Senza account, torna la procedura guidata del primo avvio; chiede il **codice di registrazione**, che si vede solo sullo schermo del NAS stesso o con sudo lgm alta. Crea l'amministratore e registra di nuovo gli altri account. I tuoi file e le tue cartelle non vengono toccati.

10. Un avviso di errori sul bus PCIe

Il NAS sorveglia il bus PCIe, da cui passano verso la scheda madre i dischi NVMe, i controller dei dischi, le schede di rete e la scheda grafica, e avvisa non appena uno inizia a dare errori, dicendo quale.

• «Errori corretti sul bus PCIe»: il sistema li ha corretti e per ora non si perde niente. Se l'avviso si ripete e il numero continua a crescere, di solito è un contatto allentato o un dispositivo che inizia a guastarsi: spegni il NAS e rimettilo bene nel suo slot.
• «Errori sul bus PCIe»: errori che il sistema non è riuscito a correggere. Di solito è un dispositivo inserito male, che si scalda o che inizia a guastarsi. Se è un disco, **fai subito un backup di ciò che conta**; poi spegni il NAS, rimetti bene il dispositivo e controlla che gli arrivi aria.

11. Le chiavi del pannello e il chip TPM

Le chiavi che il pannello conserva per funzionare — quella della VPN, del DNS dinamico, dell'UPS e altre — si salvano cifrate con il chip TPM 2.0 della scheda madre se il dispositivo ce l'ha. Non c'è niente da attivare, e su un dispositivo senza chip si salvano come sempre.

Se un giorno il chip smette di aprirle, il NAS si avvia comunque e avvisa con «Il chip di sicurezza non apre i segreti del pannello». Di solito succede dopo aver cambiato la scheda madre o cancellato il TPM nel BIOS. Nel frattempo la VPN, il DNS dinamico e tutto ciò che usa quelle chiavi non funziona.

• Non si è perso niente. Entra nel pannello con un account di amministratore digitando la sua password, e le chiavi si recuperano da sole. Lo conferma l'avviso «Segreti del pannello recuperati».
• Se il chip funziona, tornano a salvarsi con lui; se il dispositivo non ha più un chip funzionante, si salvano come prima, senza.

Vedi anche

• Ripristino di emergenza — quando è già successo qualcosa di grave.
• Utenti, permessi e cosa vede ognuno — quasi tutto ciò che riguarda «non posso vedere questo».
• Glossario — cosa significa ogni parola strana di quelle che compaiono qui.