{
"meta": {
"title": "Stato e test SMART del disco | Documentazione ProxMenux",
"description": "Esegui controlli SMART e test dei dischi su Proxmox VE con ProxMenux. Supporta SATA/SAS con smartmontools e NVMe con nvme-cli, autotest brevi e lunghi ed esportazione JSON per ProxMenux Monitor.",
"ogTitle": "Stato e test SMART del disco | Documentazione ProxMenux",
"ogDescription": "SMART controlli di salute e auto-test per unità SATA / SAS e NVMe su Proxmox. Esportazione JSON per il Monitor."
},
"header": {
"title": "Integrità e test disco SMART",
"description": "Leggi i dati SMART e avvia autotest sui dischi fisici dell’host Proxmox. ProxMenux installa automaticamente smartmontools per SATA/SAS e nvme-cli per NVMe, avvia i test nel firmware del disco (i test lunghi continuano dopo la chiusura del terminale) ed esporta risultati JSON per ProxMenux Monitor.",
"section": "Disk Manager · Utilità"
},
"intro": {
"title": "A cosa serve",
"body": "SMART (Self-Monitoring, Analysis and Reporting Technology) consente al disco di segnalare il proprio stato ed eseguire autotest. Lo strumento mostra questi dati senza dover ricordare il comando smartctl o nvme corretto e conserva l’output in JSON perché il Monitor possa mostrare le tendenze nel tempo."
},
"howRuns": {
"heading": "Come funziona lo script",
"body": "Tutte le azioni qui non distruttive — SMART legge i contatori del firmware dell'unità, e i test di auto sono in coda all'interno dell'unità stessa. Non è necessaria alcuna separazione di fase. Il flusso è: controllo di dipendenza → selezione del disco → selezione di azione → invocazione degli strumenti (smartctl o nvme-cli a seconda del bus del disco) → uscita stampata più esportazione JSON per il monitor."
},
"deps": {
"heading": "Dipendenze",
"body": "Lo strumento installa automaticamente ciò di cui ha bisogno in prima esecuzione. Le unità SATA / SAS si basano su smartmontools; le unità NVMe si basano su nvme-cli. Entrambi:"
},
"actions": {
"heading": "Azioni disponibili",
"headerAction": "Azione",
"headerWhat": "Che cosa legge o esegue",
"headerDur": "Durata",
"rows": [
{
"action": "Situazione rapida della salute",
"whatRich": "Complessivamente PASSED/FAILED + attributi chiave.
smartctl -H + -A (SATA/SAS) o nvme smart-log (NVMe).",
"dur": "istantaneamente"
},
{
"action": "Rapporto completo",
"whatRich": "Dati SMART completi, scorrevoli. smartctl -x per SATA/SAS o nvme smart-log + id-ctrl per NVMe.",
"dur": "istantaneamente"
},
{
"action": "Test breve",
"what": "Superficie di base e controllo elettrico, in coda all'interno del firmware dell'unità.",
"dur": "~2 minuti"
},
{
"action": "Test lungo",
"what": "Controllo completo dell'intera superficie. Funziona sull'hardware dell'unità — persiste anche se si chiude il terminale.",
"dur": "Ore (dipendenti dalle dimensioni del disco)"
},
{
"action": "Verificare i progressi dei test",
"what": "Stato dell'autotest attivo o più recente.",
"dur": "istantaneamente"
}
],
"tipTitle": "I test lunghi sopravvivono alla chiusura del terminale",
"tipBody": "Un test lungo viene eseguito nel disco e non dipende dal processo ProxMenux. Puoi chiudere il terminale e tornare a Verifica avanzamento test. Un riavvio dell’host, un reset del controller o una perdita di alimentazione può interrompere il test e la raccolta dei risultati; non presumere che riprenda automaticamente."
},
"json": {
"heading": "JSON export per il Monitor",
"intro": "Le azioni di stato, test breve e avanzamento scrivono un JSON con data e ora in /usr/local/share/proxmenux/smart/<disk>/; i risultati dei test lunghi sono raccolti in background. Il rapporto completo viene solo visualizzato. La struttura è:",
"outro": "ProxMenux Monitor usa questi file per mostrare l’andamento dello stato dei dischi. I vecchi file vengono rimossi automaticamente al raggiungimento del limite di conservazione."
},
"steps": {
"heading": "Passo dopo passo",
"stepLabel": "Passaggio",
"list": [
{
"title": "Scegli un disco",
"body": "ProxMenux elenca ogni disco fisico sull'host con il suo modello e dimensione. A differenza dello strumento Formato, questo elenco non è filtrato dalla sicurezza — la lettura SMART è un'operazione non distruttiva.",
"img": "/disk/smart/disk-selection.png",
"alt": "Menu di selezione del disco SMART",
"caption": "Menu di selezione del disco SMART"
},
{
"title": "Scegli un'azione",
"body": "Scegliere tra stato di salute rapido, rapporto completo, test breve, test lungo o verifica progressi. Il menu rimane aperto dopo ogni azione in modo da poter incatenare diverse query contro lo stesso disco.",
"img": "/disk/smart/action-menu.png",
"alt": "Menu di azione SMART",
"caption": "SMART menu di azione (5 azioni + cancellazione)"
},
{
"title": "(Solo test lungo) Conferma l’esecuzione in background",
"body": "ProxMenux avvisa che il test continuerà dopo la chiusura del terminale e mostra dove verrà salvato il risultato JSON. Accetta per avviarlo.",
"img": "/disk/smart/long-test-warning.png",
"alt": "Finestra di conferma di prova lunga",
"caption": "Conferma di prova lunga — corre in background, risultato salvato a JSON"
},
{
"title": "Controlla i risultati",
"bodyRich": "Stato, test e avanzamento compaiono nel terminale; Rapporto completo si apre in una finestra scorrevole. L’esportazione JSON avviene per le azioni indicate sopra, non per Rapporto completo. Per i test lunghi torna a Verifica avanzamento test sullo stesso disco.",
"img": "/disk/smart/quick-status.png",
"alt": "Uscita rapida dello stato di salute",
"caption": "Uscita rapida dello stato di salute (SATA — smartctl -H + -A)"
}
]
},
"manual": {
"heading": "Equivalenti manuali",
"nvmeWarnTitle": "Gli autotest NVMe dipendono dal firmware del disco",
"nvmeWarnBody": "Non ogni unità NVMe supporta il comando breve/lungo self-test. Se un'unità rifiuta il test, il registro SMART e i dati del controller ID (nvme smart-log + id-ctrl) sono ancora il segnale sanitario più affidabile."
},
"troubleshoot": {
"heading": "Risoluzione dei problemi",
"noSmartTitle": "\"Impossibile leggere i dati SMART da /dev/sdX\"",
"noSmartBody": "Il disco è probabilmente dietro un controller RAID / SAS che non passa SMART attraverso. Con le carte a base di megaraid, prova a smartctl -d megaraid,N /dev/sdX. Per HBA in modalità IT l'invocazione diretta funziona.",
"longTitle": "Il lungo test non completa mai",
"longBody": "Il test viene eseguito nel firmware e un carico I/O elevato può ritardarlo. Prova in un periodo di inattività, ad esempio di notte. Su SATA, smartctl -c mostra la percentuale rimanente, su SAS smartctl -l selftest; il log degli autotest indica esito ed eventuali LBA difettosi. Un errore di lettura va indagato; la lentezza da sola non prova un settore danneggiato."
},
"related": {
"heading": "Correlati",
"items": [
{
"href": "/docs/disk-manager/format-disk",
"label": "Formatta o cancella un disco fisico",
"tail": "— riutilizzare un disco dopo aver confermato che è sano."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Comandi di archiviazione e dischi → Stato SMART",
"tail": "— riferimento copiabile smartctl / nvme."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "Comandi di gestione ZFS",
"tail": " — zpool scrub verifica i checksum dei dati ZFS e affianca i test SMART dell’hardware."
},
{
"href": "/docs/monitor/dashboard/storage",
"label": "ProxMenux Monitor — scheda Archiviazione",
"tail": " — vista dettagliata del disco che usa il JSON esportato qui: tabella SMART completa, cronologia e rapporto PDF."
},
{
"href": "/docs/monitor/dashboard/hardware",
"label": "ProxMenux Monitor — Scheda hardware",
"tail": "— Riepilogo di stoccaggio con modello, capacità e velocità di collegamento negoziata (corrente vs massima su NVMe)."
},
{
"href": "/docs/disk-manager",
"label": "Panoramica di Disk Manager",
"tail": "."
}
]
}
}