Guide pratiche
Risoluzione dei problemi
Indaga sui problemi di avvio, rete e aggiornamento e prepara una segnalazione utile per il progetto.
Il supporto non si avvia
- Verifica il checksum della ISO come indicato nella guida di installazione.
- Conferma che l'immagine sia stata scritta sulla chiavetta USB e che il firmware stia avviando dalla voce UEFI corretta.
- In una VM, controlla UEFI, la memoria e il collegamento della ISO all'unità ottica.
- Annota il messaggio visualizzato, il modello della macchina e lo stato di Secure Boot.
Nessuna connessione di rete
Controlla il cavo o la connessione Wi-Fi nelle impostazioni. Su Server, conferma che la rete fornisca DHCP. Per consultare gli indirizzi delle interfacce:
ip -brief address
Se c'è un indirizzo ma i repository non rispondono, annota se l'errore menziona DNS, connessione o certificato. Controlla anche la data e l'ora del sistema. Queste informazioni aiutano a distinguere i problemi di rete dall'indisponibilità di un repository.
Un aggiornamento non è riuscito
Attendi che le altre operazioni sui pacchetti terminino e riprova. Non eliminare i file di blocco e non chiudere forzatamente il gestore. Copia il messaggio di errore e l'identificativo del repository coinvolto.
Consulta le indicazioni sulle origini dei pacchetti prima di accettare una nuova chiave, rimuovere repository o cambiare la base.
Raccogli informazioni sul sistema
Per identificare la versione, il kernel e i servizi non riusciti, esegui:
cat /etc/os-release
uname -r
systemctl --failed
Se la tua immagine include lyra-report, eseguilo come utente normale:
lyra-report
Lo strumento mostra i dati raccolti per la revisione prima di creare un file locale e non esegue alcun caricamento automatico. Se il comando non è disponibile, usa le informazioni di base indicate sopra; non è necessario installare componenti di sviluppo per segnalare un problema.
Segnala un problema riproducibile
Apri una issue nel repository corrispondente: Desktop, Server o Vega. Cerca prima una segnalazione simile.
Includi le informazioni seguenti:
Edizione e versione di Lyra OS:
Nome della ISO, se il problema si è verificato durante l'installazione:
Modello del computer o configurazione della VM:
UEFI e stato di Secure Boot:
Passaggi per riprodurre:
Risultato atteso:
Risultato osservato e messaggio di errore:
Rivedi screenshot e log prima di pubblicarli. Rimuovi password, token, chiavi e dati personali, anche quando lo strumento applica l'anonimizzazione. Condividi solo i file necessari per spiegare il problema.
Riferimento: diagnostica con lyra-report.