mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 19:02:31 +00:00
docs: review disk manager documentation in all seven translations
This commit is contained in:
Jonatan
@@ -0,0 +1,128 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Aggiungi controller o NVMe a VM | Documentazione ProxMenux",
|
||||
"description": "Passthrough PCI di un controller di archiviazione (HBA SATA/SAS) o di un dispositivo NVMe a una VM Proxmox con ProxMenux. Gestisce l’attivazione di IOMMU, il rilevamento dei conflitti e l’assegnazione con qm set --hostpci.",
|
||||
"ogTitle": "Aggiungi controller o NVMe a VM | Documentazione ProxMenux",
|
||||
"ogDescription": "Assegna un intero HBA SATA/SAS o un dispositivo NVMe a una VM Proxmox. ProxMenux gestisce IOMMU, il rilevamento dei conflitti e l’assegnazione hostpci."
|
||||
},
|
||||
"header": {
|
||||
"title": "Aggiungi controller o NVMe a VM",
|
||||
"description": "Assegna un intero adattatore bus host SATA/SAS (HBA) o un dispositivo NVMe a una VM Proxmox tramite passthrough PCI. ProxMenux verifica IOMMU e, con il tuo consenso, lo abilita, elenca i dispositivi idonei, esclude i conflitti e configura l’assegnazione con qm set --hostpci.",
|
||||
"section": "Gestione del disco · VM"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ciò che fa (e non fa)",
|
||||
"body": "Si tratta di <strong>passthrough a livello di dispositivo</strong>: la scheda PCIe esce dal controllo del kernel dell’host e viene associata a <code>vfio-pci</code>. La VM vede il controller stesso, anziché singoli dischi passati separatamente, e carica il proprio driver per quel modello. Tutti i dischi collegati lo seguono automaticamente, con dati SMART nativi, tutte le funzioni del firmware e nessuno strato Proxmox intermedio."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Come funziona lo script",
|
||||
"body": "Il flusso ha due fasi distinte: raccolta delle informazioni, verifica di IOMMU ed elenco dei candidati; poi assegnazione effettiva del dispositivo PCI. Fino alla conferma finale non viene scritto nulla nella configurazione della VM."
|
||||
},
|
||||
"iommu": {
|
||||
"heading": "Gruppi IOMMU: perché occorre considerare l’intera scheda",
|
||||
"body": "Il confine di isolamento del passthrough PCI è il <strong>gruppo IOMMU</strong>, la più piccola unità isolabile dall’IOMMU della CPU. I dispositivi nello stesso gruppo non possono essere isolati tra loro. Se un controller SATA condivide il gruppo con un controller USB, il passthrough SATA può richiedere di liberare anche l’USB dall’host oppure risultare impossibile. Non assegna automaticamente alla VM tutti i dispositivi del gruppo.",
|
||||
"outro": "ProxMenux mostra il gruppo IOMMU accanto a ogni dispositivo e avvisa se il gruppo comprende altri dispositivi oltre al controller desiderato. Puoi procedere se gli altri dispositivi sono accettabili, ad esempio se sono tutti controller disco, oppure annullare."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Prerequisiti",
|
||||
"items": [
|
||||
"<strong>CPU e scheda madre supportano</strong> VT-d (Intel) o AMD-Vi, e la funzione è abilitata nel firmware (BIOS/UEFI). ProxMenux può abilitare la parte kernel, ma non modificare l’impostazione del firmware.",
|
||||
"La VM di destinazione è <strong>spenta</strong> prima di collegare dispositivi PCI.",
|
||||
"Il controller/NVMe <strong>non ospita il filesystem root di Proxmox</strong>. Lo script nasconde tutto ciò che è in uso dall’host.",
|
||||
"Il sistema operativo guest dispone dei driver per il modello del controller. Linux supporta quasi tutti gli HBA senza driver aggiuntivi; Windows richiede il driver del produttore installato <em>prima</em> di avviare con il controller collegato."
|
||||
],
|
||||
"warnTitle": "La migrazione dal vivo non è possibile",
|
||||
"warnBody": "Un VM con passante PCI è legato al nodo che tiene fisicamente la scheda. La migrazione dal vivo attraverso i nodi fallirà. Pianifica backup / replica di conseguenza."
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo dopo passo",
|
||||
"stepLabel": "Passaggio",
|
||||
"list": [
|
||||
{
|
||||
"title": "Scegli la VM di destinazione",
|
||||
"bodyRich": "ProxMenux legge <code>qm list</code> e mostra tutte le VM. Scegli quella che riceverà il controller.",
|
||||
"img": "/disk/nvme-passthrough/vm-selection.png",
|
||||
"alt": "dialogo di selezione VM",
|
||||
"caption": "dialogo di selezione VM"
|
||||
},
|
||||
{
|
||||
"title": "Controllo IOMMU",
|
||||
"bodyRich": "Se IOMMU non è abilitato sul kernel cmdline, ProxMenux offre per abilitarlo. Modifica <code>/etc/kernel/cmdline</code> (per systemd-boot) o <code>/etc/default/grub</code> (per GRUB) e aggiunge il parametro corretto per il tuo CPU:",
|
||||
"items": [
|
||||
"<code>intel_iommu=on</code> per CPU Intel.",
|
||||
"<code>amd_iommu=on</code> per CPU AMD."
|
||||
],
|
||||
"outro": "Un riavvio è richiesto dopo questo cambiamento. Lo script richiede di riavviare ora o più tardi; il passthrough non può continuare fino a quando il nuovo kernel cmdline è attivo.",
|
||||
"img": "/disk/nvme-passthrough/iommu-warning.png",
|
||||
"alt": "Finestra IOMMU richiesto",
|
||||
"caption": "IOMMU richiesto — offerta per abilitare e riavviare"
|
||||
},
|
||||
{
|
||||
"title": "Enumerazione del dispositivo",
|
||||
"body": "ProxMenux elenca ogni controller di archiviazione (SATA / SAS HBA) e ogni dispositivo NVMe sul bus PCI. Per ogni dispositivo mostra:",
|
||||
"items": [
|
||||
"Indirizzo PCI (<code>00:17.0</code>, <code>01:00.0</code>, ...).",
|
||||
"Descrizione del produttore e del dispositivo.",
|
||||
"gruppo IOMMU — e un avviso ⚠ se il gruppo è condiviso con altri dispositivi non correlati.",
|
||||
"I dischi attualmente dietro il controller (quindi sai cosa lo seguirà al VM)."
|
||||
],
|
||||
"img": "/disk/nvme-passthrough/device-list.png",
|
||||
"alt": "Elenco dei controller e dei dispositivi NVMe",
|
||||
"caption": "Elenco dei controller e dei dispositivi NVMe con informazioni sui gruppi IOMMU"
|
||||
},
|
||||
{
|
||||
"title": "Rilevamento dei conflitti",
|
||||
"bodyRich": "Lo script blocca i dispositivi chiaramente non sicuri: quelli già assegnati a un’altra VM tramite <code>hostpci</code> nella relativa configurazione, quelli in uso dall’host come il controller del disco root e quelli in un gruppo IOMMU i cui altri membri non possono essere identificati con sicurezza. I dispositivi idonei sono disponibili per la selezione.",
|
||||
"img": "/disk/nvme-passthrough/conflict-warning.png",
|
||||
"alt": "Avvertenza di rilevamento conflitti",
|
||||
"caption": "Rilevamento di conflitti — dispositivo bloccato con ragione"
|
||||
},
|
||||
{
|
||||
"title": "Assegna e concludi",
|
||||
"bodyRich": "Per ogni dispositivo selezionato ProxMenux esegue <code>qm set <VMID> --hostpciN <pci-addr>,pcie=1</code>, scegliendo il successivo slot <code>hostpci</code> libero. Se IOMMU è stato abilitato durante questa sessione, viene ricordato di riavviare l’host prima di avviare la VM.",
|
||||
"img": "/disk/nvme-passthrough/assignment.png",
|
||||
"alt": "Riepilogo delle assegnazioni",
|
||||
"caption": "Riepilogo delle assegnazioni — slot hostpciN e indirizzi PCI allegati"
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manuale"
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Risoluzione dei problemi",
|
||||
"noGroupsTitle": "IOMMU abilitato ma nessun gruppo sotto /sys/kernel/iommu_groups/",
|
||||
"noGroupsBody": "È necessario riavviare perché la nuova riga di comando del kernel abbia effetto. Se i gruppi mancano ancora dopo il riavvio, VT-d/AMD-Vi è probabilmente disabilitato nel firmware: controlla le impostazioni BIOS/UEFI.",
|
||||
"busyTitle": "La VM non si avvia: \"hostpciN: device busy\"",
|
||||
"busyBody": "Un altro processo mantiene occupato il dispositivo PCI. Le cause più comuni sono una VM arrestatasi in modo anomalo senza liberarlo o il kernel dell’host che lo ha ripreso all’ultimo avvio. Esegui <code>lspci -nnk -s <addr></code> per vedere il driver associato: dovrebbe essere <code>vfio-pci</code>. Un riavvio completo dell’host solitamente risolve il problema.",
|
||||
"noDisksTitle": "Guest vede il controller ma non i dischi",
|
||||
"noDisksBody": "Nel guest manca il driver per il modello del controller. Su Linux succede raramente, su Windows sì: installa il driver del produttore, ad esempio LSI/Broadcom per i vecchi HBA SAS, mentre la scheda non è assegnata, poi riavvia con la scheda assegnata.",
|
||||
"sharedTitle": "Il gruppo IOMMU include un dispositivo non correlato",
|
||||
"sharedBody": "Opzioni: (a) spostare la scheda in una diversa slot PCIe per cambiare il suo gruppo, (b) abilitare <em>ACS override</em> nel kernel per dividere i gruppi (sicurezza trade-off - ricerca prima di applicare), o (c) scegliere una scheda diversa in un gruppo più pulito."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importa disco nella VM",
|
||||
"tail": "— modello alternativo: collegare un disco fisico tramite Proxmox senza passante PCIe completo."
|
||||
},
|
||||
{
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"label": "Aggiungi GPU a VM (Passthrough)",
|
||||
"tail": "— stessi concetti IOMMU / VFIO applicati a un GPU."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/gpu-commands",
|
||||
"label": "Comandi di passaggio GPU",
|
||||
"tail": "— I comandi di verifica IOMMU si applicano anche al controller / passthrough NVMe."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Panoramica di Disk Manager",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,142 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Formatta o cancella un disco fisico | Documentazione ProxMenux",
|
||||
"description": "Cancella e formatta dischi fisici su Proxmox VE con ProxMenux. Quattro modalità, filtri rigorosi che escludono i dischi di sistema, montati o in uso e doppia conferma con inserimento del percorso completo.",
|
||||
"ogTitle": "Formatta o cancella un disco fisico | Documentazione ProxMenux",
|
||||
"ogDescription": "Pulire in modo sicuro o formattare un disco fisico su Proxmox. Regole di visibilità sicure, modalità di funzionamento 4, doppia conferma."
|
||||
},
|
||||
"header": {
|
||||
"title": "Formatta o cancella un disco fisico",
|
||||
"description": "Cancella in modo sicuro o formatta un disco fisico sull’host Proxmox. ProxMenux mostra solo i dischi completamente liberi: nessun uso da parte del sistema, nessun riferimento nei guest e nessun filesystem montato. Prima di distruggere i dati richiede una doppia conferma: sì/no e inserimento del percorso completo del disco.",
|
||||
"section": "Disk Manager · Utilità"
|
||||
},
|
||||
"danger": {
|
||||
"title": "Strumento distruttivo",
|
||||
"body": "Ogni operazione scrive sul disco e non può essere annullata. ProxMenux applica filtri e conferme rigorosi, ma la responsabilità di scegliere il disco corretto è tua. Leggi il percorso del disco ad alta voce due volte prima di digitarlo."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Come funziona lo script",
|
||||
"body": "Il flusso ha due fasi con un filtro di sicurezza a tripla porta in mezzo. L'elenco dei dischi, la modalità di funzionamento e i dettagli del file system sono tutti raccolti in Fase 1; nulla è scritto fino a quando la Fase 2 passa una ri-validazione finale prima di eseguire."
|
||||
},
|
||||
"visibility": {
|
||||
"heading": "Regole di visibilità",
|
||||
"intro": "Prima che il menu venga visualizzato, ProxMenux filtra l'elenco dei dischi. Solo i candidati che sono provabilmente sicuri sono mostrati:",
|
||||
"items": [
|
||||
"<strong>Mostrati</strong>: dischi <em>non</em> usati dall’host (pool root, swap, filesystem montati, ZFS/LVM/RAID attivi) e <em>non</em> citati in configurazioni VM/LXC, sia avviate sia arrestate.",
|
||||
"<strong>Nascosti</strong>: dischi dell’host e di sistema.",
|
||||
"<strong>Nascosti</strong>: dischi citati in una configurazione VM/LXC."
|
||||
],
|
||||
"safetyTitle": "Sicurezza alla conferma e all'esecuzione",
|
||||
"safetyItems": [
|
||||
"I dischi con metadati obsoleti o attivi mostrano avvisi dettagliati <em>prima</em> della conferma.",
|
||||
"I dischi usati da una VM <strong>in esecuzione</strong> sono <strong>bloccati senza possibilità di procedere</strong> alla conferma.",
|
||||
"I dischi con partizioni montate sono <strong>bloccati senza possibilità di procedere</strong> all’esecuzione. Una nuova verifica avviene subito prima di qualsiasi scrittura.",
|
||||
"Sono sempre necessarie due conferme: una finestra <em>sì/no</em> e l’inserimento esatto del percorso completo del disco."
|
||||
]
|
||||
},
|
||||
"modes": {
|
||||
"heading": "Modalità di funzionamento",
|
||||
"intro": "Dopo aver scelto un disco si sceglie una delle quattro modalità. Essi differiscono in quello che distruggono e ciò che lasciano dietro:",
|
||||
"headerMode": "Modalità",
|
||||
"headerPart": "Tabella delle partizioni",
|
||||
"headerData": "Dati",
|
||||
"headerUseCase": "Caso di utilizzo",
|
||||
"rows": [
|
||||
{
|
||||
"mode": "1. Pulisci tutto",
|
||||
"part": "Distrutto",
|
||||
"data": "Firme cancellate",
|
||||
"useCase": "Rimuove partizionamento e metadati per preparare una nuova struttura. Non sovrascrive tutti i dati utente."
|
||||
},
|
||||
{
|
||||
"mode": "2. Rimuovere le etichette FS",
|
||||
"part": "Conservato",
|
||||
"data": "Conservato",
|
||||
"useCase": "Rimuove le vecchie firme ZFS / LVM / RAID per evitare l’acquisizione automatica del disco. I dati utente non vengono sovrascritti in massa, ma la rimozione delle firme può renderli inaccessibili."
|
||||
},
|
||||
{
|
||||
"mode": "3. Sovrascrivi i dati con zeri",
|
||||
"part": "Conservato",
|
||||
"data": "Distrutti (sovrascritti con zeri)",
|
||||
"useCase": "Sovrascrive con zeri le partizioni esistenti conservando la tabella delle partizioni. Non comprende lo spazio non allocato e le aree di riserva degli SSD; non garantisce una sanificazione completa del dispositivo."
|
||||
},
|
||||
{
|
||||
"mode": "4. Formattazione completa",
|
||||
"part": "Nuovo GPT",
|
||||
"data": "Distrutto",
|
||||
"useCase": "Disco pronto all'uso con una singola nuova partizione e un filesystem fresco."
|
||||
}
|
||||
],
|
||||
"fullFormatOutro": "<strong>Formattazione completa</strong> prosegue con altre due finestre:",
|
||||
"fullFormatItems": [
|
||||
"<strong>Filesystem</strong>: <code>ext4</code>, <code>xfs</code>, <code>exfat</code> (portabile) o <code>btrfs</code>. Se mancano strumenti come <code>mkfs.btrfs</code>, l’operazione si interrompe con un messaggio chiaro.",
|
||||
"<strong>Etichetta</strong>: etichetta facoltativa del filesystem per identificarlo."
|
||||
]
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo dopo passo",
|
||||
"stepLabel": "Passaggio",
|
||||
"list": [
|
||||
{
|
||||
"title": "Scegli un disco libero",
|
||||
"body": "ProxMenux elenca ogni disco che passa i filtri di visibilità sopra. I dischi con marcatori ⚠ portano metadati stanti e vengono mostrati con i dettagli in modo da sapere cosa stai per sovrascrivere."
|
||||
},
|
||||
{
|
||||
"title": "Scegli una modalità di funzionamento",
|
||||
"bodyRich": "Scegli <strong>Pulisci tutto</strong>, <strong>Rimuovere le etichette FS</strong>, <strong>Sovrascrivi i dati con zeri</strong> o <strong>Formattazione completa</strong> secondo la tabella sopra."
|
||||
},
|
||||
{
|
||||
"title": "(Solo formattazione completa) Scegli filesystem ed etichetta",
|
||||
"body": "ext4 / xfs / exfat / btrfs, più un'etichetta opzionale."
|
||||
},
|
||||
{
|
||||
"title": "Confermare due volte",
|
||||
"bodyRich": "ProxMenux mostra un riassunto di ciò che accadrà. Si accetta con una finestra di dialogo sì/no e <strong> digitare il percorso completo del disco</strong> esattamente come mostrato (ad esempio <code>/dev/sdc</code>). Tutto il resto si interrompe."
|
||||
},
|
||||
{
|
||||
"title": "Nuova verifica ed esecuzione",
|
||||
"body": "Subito prima di scrivere, lo script ricontrolla lo stato del disco. Se nel frattempo è stata montata una partizione o avviata una VM, l’esecuzione viene annullata. Altrimenti viene eseguita l’operazione scelta e mostrato un riepilogo finale."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalenti manuali",
|
||||
"body": "Se si preferisce eseguire i comandi equivalenti a mano:"
|
||||
},
|
||||
"troubleshoot": {
|
||||
"notListedTitle": "Disco non elencato nel menu",
|
||||
"notListedBody": "È stato filtrato per la sicurezza. Motivi comuni: è montato (anche a <code>/mnt/tmp</code>), è un membro attivo ZFS / LVM / RAID, è riferito da una configurazione VM o LXC, o è il disco radice Proxmox. Eseguire <code>lsblk -f</code> e <code>cat /proc/mdstat</code> sull'host per capire perché.",
|
||||
"busyTitle": "\"Disk may be busy\" / smontaggio non riuscito",
|
||||
"busyBody": "Un processo mantiene aperto un file in una partizione del disco, spesso un contenitore o una shell la cui directory corrente si trova nel punto di mount. Identificalo con <code>lsof | grep /dev/sdX</code> o <code>fuser -vm /dev/sdX1</code>, arrestalo e riesegui lo strumento."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/smart-disk-test",
|
||||
"label": "Integrità e test disco SMART",
|
||||
"tail": "— controllare un disco prima / dopo aver pulito per confermare che è sano."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importa disco nella VM",
|
||||
"tail": "— passare un disco appena formattato a un VM."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-local-disk",
|
||||
"label": "Aggiungere disco locale come archiviazione Proxmox",
|
||||
"tail": "— registrare un disco cancellato come un pool di archiviazione Proxmox."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Comandi di archiviazione e dischi",
|
||||
"tail": " — riferimento per lsblk, blkid e parted."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Panoramica di Disk Manager",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,110 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importa immagine del disco a VM | Documentazione ProxMenux",
|
||||
"description": "Importa un file immagine disco (.img / .qcow2 / .vmdk / .raw) in una VM Proxmox esistente con ProxMenux. Interfaccia, emulazione SSD e opzione di avvio per ogni immagine, tramite qm importdisk.",
|
||||
"ogTitle": "Importa immagine del disco a VM | Documentazione ProxMenux",
|
||||
"ogDescription": "Importare .img / .qcow2 / .vmdk / .raw immagini disco in un VM esistente con ProxMenux. Utilizza qm importdisk sotto il cofano."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importa immagine disco nella VM",
|
||||
"description": "Importa un file immagine disco (.img, .qcow2, .vmdk o .raw) in una VM Proxmox esistente. ProxMenux raccoglie prima tutte le scelte: VM di destinazione, storage Proxmox, directory sorgente, interfaccia, emulazione SSD e ordine di avvio. Poi esegue qm importdisk per ogni immagine selezionata.",
|
||||
"section": "Gestione del disco · VM"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa fa",
|
||||
"body": "A differenza di <em>Importa disco nella VM</em>, che collega un disco fisico direttamente, questa procedura usa un <strong>file</strong> sull’host, esportato da un altro hypervisor, scaricato come immagine cloud o estratto da un backup. Lo converte in un disco di VM Proxmox sullo storage scelto. Il file originale viene conservato: ProxMenux lo copia senza spostarlo."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Come funziona lo script",
|
||||
"body": "Il flusso ha due fasi. La prima raccoglie tutte le scelte tramite finestre di dialogo: VM, storage, directory sorgente, immagini e opzioni per ciascuna immagine. La seconda esegue <code>qm importdisk</code> per ogni immagine selezionata. Prima della seconda fase non viene copiato nulla né modificata la configurazione della VM."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Prerequisiti",
|
||||
"items": [
|
||||
"Almeno una VM è definita sull’host. La VM di destinazione dovrebbe essere <strong>spenta</strong>.",
|
||||
"Almeno un file di immagine di un formato supportato nella directory sorgente. Supportato: <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code>, <code>.raw</code>.",
|
||||
"Abbastanza spazio libero sullo storage Proxmox di destinazione per tenere ogni disco importato.",
|
||||
"ProxMenux cerca le immagini in <code>/var/lib/vz/template/iso</code> per impostazione predefinita. È possibile indicarlo a qualsiasi altra directory sull'host quando chiede."
|
||||
]
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo dopo passo",
|
||||
"stepLabel": "Passaggio",
|
||||
"list": [
|
||||
{
|
||||
"title": "Scegli la VM di destinazione",
|
||||
"bodyRich": "ProxMenux legge <code>qm list</code> e mostra tutte le VM. Scegli quella che riceverà i dischi importati."
|
||||
},
|
||||
{
|
||||
"title": "Scegli lo storage Proxmox",
|
||||
"bodyRich": "L'elenco contiene ogni archiviazione che ha il tipo di contenuto <code>images</code> abilitato. Se c'è solo un candidato è selezionato automaticamente e la finestra di dialogo è saltata."
|
||||
},
|
||||
{
|
||||
"title": "Scegli la directory sorgente",
|
||||
"bodyRich": "Scegliere la directory predefinita (<code>/var/lib/vz/template/iso</code>) o digitare un percorso personalizzato — in genere dove hai scaricato / caricato l'immagine. Lo script rifiuta i percorsi che non esistono."
|
||||
},
|
||||
{
|
||||
"title": "Scegli una o più immagini",
|
||||
"bodyRich": "La directory viene scansionata per i file <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code>. È possibile selezionare diversi in una sola volta; ognuno passerà attraverso le opzioni per-immagine nella fase successiva."
|
||||
},
|
||||
{
|
||||
"title": "Opzioni per immagine",
|
||||
"intro": "Per ogni immagine selezionata ProxMenux chiede:",
|
||||
"items": [
|
||||
"<strong>Interface</strong> — <code>scsi</code> (default), <code>virtio</code>, <code>sata</code> o <code>ide</code>. Corrisponde a come l'ospite vedrà il disco.",
|
||||
"<strong>Emulazione SSD</strong>: disponibile solo per interfacce diverse da VirtIO. Aggiunge <code>ssd=1</code> affinché il guest riconosca un disco a stato solido. Il supporto discard/TRIM va configurato separatamente.",
|
||||
"<strong>Avviabile</strong>: scegliendo sì, ProxMenux aggiunge il disco all’ordine di avvio come dispositivo principale della VM."
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Importa e collega",
|
||||
"bodyRich": "ProxMenux esegue <code>qm importdisk</code> per ogni immagine, convertendo il formato se necessario, e collega il disco al successivo slot libero (<code>scsiN</code>, <code>sataN</code>, …) con le opzioni scelte. Se hai segnato un disco come avviabile, aggiorna l’ordine di avvio. L’avanzamento compare nel terminale."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manuale",
|
||||
"body": "L’importazione di una singola immagine corrisponde a tre comandi <code>qm</code>:",
|
||||
"warnTitle": "Conversione formato immagine",
|
||||
"warnBody": "Quando lo storage di destinazione non può contenere il formato sorgente in modo nativo (ad esempio, lo storage LVM non può contenere <code>.qcow2</code>), <code>qm importdisk</code> converte l'immagine in modo trasparente. Questo può richiedere diversi minuti per immagini multi-GB; pianificare di conseguenza e non interrompere lo script."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Risoluzione dei problemi",
|
||||
"noImagesTitle": "\"Non sono state trovate immagini disco compatibili\"",
|
||||
"noImagesBody": "Lo script non ha trovato file <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code> o <code>.raw</code>. Controlla l’estensione, distinguendo maiuscole e minuscole, che il file sia direttamente nella directory scelta (le sottodirectory non vengono cercate) e che root possa leggerlo.",
|
||||
"slowTitle": "L'importazione è lenta",
|
||||
"slowBody": "Le conversioni tra VMDK, QCOW2 e raw possono essere limitate da CPU e I/O. La velocità dipende dalle letture all’origine, dalle scritture a destinazione e dall’eventuale decompressione. Preferisci sorgenti raw o qcow2 quando possibile.",
|
||||
"uefiTitle": "Il disco importato si avvia nella shell UEFI",
|
||||
"uefiBody": "L'immagine è stata costruita per legacy (SeaBIOS) ma il VM utilizza OVMF (o viceversa). O commutare il VM di BIOS in Proxmox per abbinare l'immagine, o ricostruire l'immagine nella modalità corretta prima dell'importazione."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importa disco nella VM",
|
||||
"tail": "— stesso flusso ma per dischi fisici grezzi (passthrough)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils/import-vm",
|
||||
"label": "Importa VM da OVA / OVF",
|
||||
"tail": "— quando hai un pacchetto completo VM, non solo un'immagine del disco."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils/UUp-Dump-ISO-Creator",
|
||||
"label": "Creatore di ISO UUP Dump",
|
||||
"tail": "— generare una ISO di Windows se ne avete bisogno per una nuova installazione."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Comandi di archiviazione e dischi",
|
||||
"tail": " — riferimento per qm importdisk e qemu-img convert."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Panoramica di Disk Manager",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,115 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importa disco in LXC | Documentazione ProxMenux",
|
||||
"description": "Collega un disco fisico a un contenitore LXC esistente su Proxmox VE con ProxMenux. Gestisce rilevamento e formattazione del filesystem, punto di mount, conversione da non privilegiato a privilegiato e percorsi persistenti dei dispositivi.",
|
||||
"ogTitle": "Importa disco in LXC | Documentazione ProxMenux",
|
||||
"ogDescription": "Collega un disco fisico a un contenitore LXC esistente. Gestisce filesystem, punto di mount e conversione da non privilegiato a privilegiato."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importa disco su LXC",
|
||||
"description": "Collegare un disco fisico a un contenitore LXC esistente sull'host Proxmox. ProxMenux rileva dischi liberi, li formatta facoltativamente con un filesystem supportato, e collega la partizione a un punto di montaggio all'interno del contenitore utilizzando percorsi di dispositivo persistenti.",
|
||||
"section": "Gestione del disco · LXC"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Passthrough VM e passthrough LXC",
|
||||
"body": "Questo passthrough LXC <strong>non fornisce un dispositivo a blocchi grezzo</strong>. Il contenitore riceve un <em>punto di mount</em>, cioè una directory su una partizione scelta nell’host. A differenza di una VM, usa il kernel dell’host: il filesystem (ext4/xfs/btrfs) viene quindi letto e gestito dall’host Proxmox ed esposto al contenitore."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Come funziona lo script",
|
||||
"body": "Il flusso ha due fasi distinte: raccolta di informazioni e scelte, poi modifica effettiva della configurazione del contenitore. Fino alla conferma finale non viene montato nulla nel CT.",
|
||||
"summary": "ProxMenux esclude il disco root, i dischi montati e quelli citati in configurazioni VM/LXC. I membri attivi ZFS/LVM/RAID sono nascosti; le vecchie firme sono segnalate con ⚠ per poterle cancellare prima della formattazione."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Prerequisiti",
|
||||
"items": [
|
||||
"Almeno un contenitore LXC definito sull'host.",
|
||||
"Il contenitore è <strong>privilegiato</strong> oppure accetti la conversione proposta dallo script.",
|
||||
"Almeno un disco fisico non in uso dall'host o da qualsiasi altro ospite."
|
||||
],
|
||||
"warnTitle": "Contenitore privilegiato richiesto",
|
||||
"warnBody": "Questo script richiede un contenitore <strong>privilegiato</strong> per collegare direttamente il disco. Se rileva <code>unprivileged: 1</code>, propone di modificare <code>/etc/pve/lxc/<CTID>.conf</code> sul posto. Ciò cambia il modello di sicurezza senza rimappare i proprietari dei file esistenti. Salva un backup e verifica i proprietari prima di accettare, oppure ricrea il contenitore come privilegiato."
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo dopo passo",
|
||||
"stepLabel": "Passaggio",
|
||||
"list": [
|
||||
{
|
||||
"title": "Scegli il contenitore di destinazione",
|
||||
"img": "/disk/select-container.png",
|
||||
"caption": "Menu di selezione del contenitore",
|
||||
"bodyRich": "ProxMenux elenca tutti i contenitori LXC sull’host (<code>pct list</code>). Scegli quello che riceverà il disco. Se non è privilegiato, viene proposta la conversione."
|
||||
},
|
||||
{
|
||||
"title": "Scegli il disco fisico",
|
||||
"img": "/disk/disk-selection-ct.png",
|
||||
"caption": "Dischi liberi rilevati sull’host, con ⚠ per i metadati obsoleti",
|
||||
"bodyRich": "Vengono mostrati solo candidati sicuri. A differenza della procedura per VM, questo script collega <strong>un disco per esecuzione</strong>. Rieseguilo per ogni disco aggiuntivo."
|
||||
},
|
||||
{
|
||||
"title": "Formatta o riutilizza",
|
||||
"intro": "Lo script ispeziona il disco:",
|
||||
"items": [
|
||||
"Se già trasporta un filesystem supportato (ext4 / xfs / btrfs) è possibile riutilizzarlo come-è (i file esistenti sono conservati).",
|
||||
"Se non ha un filesystem supportato, ti viene offerto di formattarlo. Scegli ext4 / xfs / btrfs."
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Scegli il punto di montaggio",
|
||||
"bodyRich": "Inserisci il percorso in cui il contenitore vedrà il disco, ad esempio <code>/mnt/data</code> o <code>/mnt/disk_passthrough</code>. È il percorso <em>all’interno</em> del contenitore; l’host vede già la partizione in <code>/dev/disk/by-id/…</code>."
|
||||
},
|
||||
{
|
||||
"title": "Collega e verifica",
|
||||
"img": "/disk/assignment-ct.png",
|
||||
"caption": "Assegnazione a CT",
|
||||
"bodyRich": "ProxMenux aggiunge una nuova voce <code>mpN:</code> alla configurazione del container, evitando gli indici già in uso, quindi rilegge la configurazione per verificarla. Se il container è in esecuzione, il montaggio viene applicato subito; altrimenti entrerà in funzione al prossimo avvio.",
|
||||
"extraImg": "/disk/result-point.png",
|
||||
"extraAlt": "Punto di montaggio creato con successo",
|
||||
"extraCaption": "Punto di montaggio creato e verificato"
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manuale",
|
||||
"body": "Lo script avvolge <code>pct set</code>. Un'invocazione diretta per un singolo disco sembra:"
|
||||
},
|
||||
"important": {
|
||||
"heading": "Considerazioni importanti",
|
||||
"items": [
|
||||
"<strong>Un disco per esecuzione</strong>. Riesegui lo script per ogni disco aggiuntivo.",
|
||||
"<strong>non</strong> collegare la stessa partizione a diversi contenitori che potrebbero montarla simultaneamente: le scritture simultanee corrompono il filesystem.",
|
||||
"<strong>I vecchi metadati</strong> (firme RAID/ZFS/LVM) vanno cancellati manualmente prima che lo script consenta di formattare, altrimenti <code>mkfs</code> rifiuta di sovrascrivere. Usa <wipeLink>Formatta o cancella un disco fisico</wipeLink>."
|
||||
]
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Risoluzione dei problemi",
|
||||
"unprivTitle": "\"Impossibile proseguire con un contenitore non privilegiato\"",
|
||||
"unprivBody": "Hai rifiutato la conversione. In <code>/etc/pve/lxc/<CTID>.conf</code> il valore passa da <code>unprivileged: 1</code> a <code>unprivileged: 0</code>, ma questo da solo non converte la proprietà UID/GID esistente. Salva un backup e gestisci la mappatura dei proprietari prima della conversione sul posto; in alternativa, ripristina o ricrea il contenitore come privilegiato.",
|
||||
"permsTitle": "Le autorizzazioni all'interno del contenitore sono sbagliate",
|
||||
"permsBody": "Montare una partizione in un contenitore privilegiato conserva i proprietari esistenti; un filesystem appena formattato appartiene spesso a <code>root:root</code>. Se il servizio usa un altro utente, ad esempio <code>www-data</code> per Nextcloud, controlla UID/GID e modifica i file necessari con <code>chown</code>/<code>chmod</code>. Le modifiche agiscono anche sul disco sottostante."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importa disco nella VM",
|
||||
"tail": "— flusso equivalente per le VM."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-mount-points",
|
||||
"label": "Punti di montaggio LXC (Host ↔ CT)",
|
||||
"tail": "— condividere directory host con un CT invece di allegare un disco intero."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/vm-ct-commands",
|
||||
"label": "Comandi di gestione VM e CT",
|
||||
"tail": "— pct config / push / pull reference."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Panoramica di Disk Manager",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,113 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importa disco in una VM | Documentazione ProxMenux",
|
||||
"description": "Collegare un disco fisico a un Proxmox VM esistente con ProxMenux. Rilevamento sicuro del disco (esclude il sistema, montato, in-uso, ZFS/RAID/LVM), persistenti percorsi /dev/disk/by-id e interfacce SATA / SCSI / VirtIO / IDE.",
|
||||
"ogTitle": "Importa disco in una VM | Documentazione ProxMenux",
|
||||
"ogDescription": "Collegare un disco fisico a un Proxmox VM esistente. Utilizza percorsi /dev/disk/by-id persistenti e supporta SATA / SCSI / VirtIO / IDE."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importa disco nella VM",
|
||||
"description": "Collegare un disco fisico che esiste già sull'host Proxmox ad una macchina virtuale esistente. ProxMenux rileva dischi liberi, consente di scegliere il target VM, il tipo di bus (SATA / SCSI / VirtIO / IDE) e allega tutto utilizzando percorsi /dev/disk/by-id persistenti in modo che la mappatura sopravviva ai riavvimenti e alle modifiche dell'ordine del dispositivo.",
|
||||
"section": "Gestione del disco · VM"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa fa",
|
||||
"body": "Collega un disco fisico grezzo come supporto di un’interfaccia disco virtuale. Il guest non riceve automaticamente i dati SMART nativi o le funzioni del controller fisico; usa il passthrough PCI del controller se servono. Il disco viene collegato tramite <code>/dev/disk/by-id/…</code>, non <code>/dev/sdX</code>, così un diverso ordine di enumerazione all’avvio non interrompe l’assegnazione."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Come funziona lo script",
|
||||
"body": "Il flusso ha due fasi distinte: raccolta delle informazioni e delle scelte, poi collegamento effettivo dei dischi alla VM. La configurazione resta invariata fino alla conferma finale.",
|
||||
"summary": "ProxMenux esclude i candidati non sicuri: disco root, dischi montati sull’host, membri attivi ZFS/LVM/RAID e dischi citati in configurazioni VM/LXC. I dischi con metadati <em>obsoleti</em>, cioè vecchie firme ZFS/RAID/LVM non più in uso, sono segnalati con ⚠ ma non bloccati."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Prerequisiti",
|
||||
"items": [
|
||||
"Almeno un VM definito sull'host (lo script invia direttamente a <code>qm list</code>).",
|
||||
"La <strong>VM di destinazione è spenta</strong>. Se è in esecuzione, lo script si interrompe con un messaggio; l’aggiunta a caldo dei dischi non rientra in questa procedura.",
|
||||
"Almeno un disco fisico sull'host che non è in uso dall'host o da qualsiasi altro ospite."
|
||||
]
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Passo dopo passo",
|
||||
"stepLabel": "Passaggio",
|
||||
"list": [
|
||||
{
|
||||
"title": "Scegli la VM di destinazione",
|
||||
"bodyRich": "ProxMenux elenca tutte le VM dell’host con <code>qm list</code>. Scegli quella che riceverà il disco. Se è in esecuzione, lo script si interrompe e chiede di spegnerla prima."
|
||||
},
|
||||
{
|
||||
"title": "Scegli i dischi fisici da collegare",
|
||||
"img": "/disk/disk-selection.png",
|
||||
"caption": "Dischi liberi rilevati sull’host, con ⚠ per i metadati obsoleti",
|
||||
"body": "Lo script esamina i dischi dell’host e propone solo quelli collegabili senza conflitti. Puoi selezionarne più di uno. I dischi con vecchie firme ZFS/LVM/RAID restano visibili con ⚠, per indicare che occorre cancellare le firme prima che il guest li formatti."
|
||||
},
|
||||
{
|
||||
"title": "Scegli l’interfaccia bus",
|
||||
"img": "/disk/disk-assigment.png",
|
||||
"caption": "Selezione dell'interfaccia bus",
|
||||
"intro": "Scegliere come l'ospite dovrebbe vedere il disco:",
|
||||
"items": [
|
||||
"<strong>SCSI</strong> — default moderno per Linux e Windows con driver VirtIO-SCSI installati.",
|
||||
"<strong>SATA</strong> — ampia compatibilità, funziona fuori dalla scatola praticamente ogni ospite.",
|
||||
"<strong>VirtIO</strong>: dispositivo a blocchi paravirtualizzato efficiente; richiede driver nel guest.",
|
||||
"<strong>IDE</strong> — per ospiti legacy che non hanno nessuno dei driver di cui sopra."
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Collega e verifica",
|
||||
"bodyRich": "ProxMenux collega ogni disco selezionato con il suo migliore percorso <code>/dev/disk/by-id/</code>, salta gli indici di slot che sono già in uso nella configurazione VM (<code>scsi0</code>, <code>sata0</code>, ...) e rilegge la configurazione per confermare l'assegnazione. Alla fine viene stampato un riassunto."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manuale",
|
||||
"body": "Lo script è un wrapper intorno a <code>qm set</code>. Il comando esatto per un singolo disco sembra questo:",
|
||||
"migrationTitle": "La migrazione dal vivo non è possibile",
|
||||
"migrationBody": "Una VM con un disco fisico collegato direttamente è <strong>legata all’host che espone quel disco</strong>. Un altro nodo normalmente non ha lo stesso percorso <code>/dev/disk/by-id/…</code> né i dati. Salva e trasferisci i dati separatamente, oppure usa dischi virtuali gestiti su storage condiviso o con replica supportata. Non presumere che la replica storage di Proxmox includa questo dispositivo.",
|
||||
"shareTitle": "Non condividere un disco fisico tra VM",
|
||||
"shareBody": "Attaccare lo stesso disco fisico a due VM allo stesso tempo corromperà i dati sulla prossima scrittura. ProxMenux rileva questa situazione e lo blocca, ma se si bypassa lo script (diretto <code>qm set</code>), assicurarsi che solo un ospite monta mai il disco."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Risoluzione dei problemi",
|
||||
"noDisksTitle": "\"Nessun disco disponibile per questo VM\"",
|
||||
"noDisksIntro": "Lo script ha trovato dei dischi, ma ogni candidato è stato filtrato. Motivi comuni:",
|
||||
"noDisksItems": [
|
||||
"Ogni disco rimanente è già citato nella configurazione di destinazione VM.",
|
||||
"Ogni disco rimanente è montato sull'host o fa parte di un ZFS attivo / LVM / RAID.",
|
||||
"L'host ha installato solo il disco root."
|
||||
],
|
||||
"noDisksOutro": "Eseguire <code>lsblk -f</code> sull'host per rivedere lo stato di ogni disco.",
|
||||
"noVisibleTitle": "VM non vede il disco dopo il boot",
|
||||
"noVisibleBody": "Con <strong>SCSI</strong> o <strong>VirtIO</strong> il guest richiede il driver corrispondente. Linux lo include nel kernel; su Windows installalo dall’ISO VirtIO (vedi <winLink>Crea VM: Windows</winLink>). Passare a SATA nella scheda Hardware della VM è una prova rapida per verificare l’assegnazione del disco."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-image-vm",
|
||||
"label": "Importa immagine disco nella VM",
|
||||
"tail": "— stesso flusso ma per file di immagine (qcow2 / vmdk / raw / img)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-lxc",
|
||||
"label": "Importa disco su LXC",
|
||||
"tail": "— flusso equivalente per contenitori LXC."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"label": "Aggiungi controller o NVMe a VM",
|
||||
"tail": "— quando è necessario PCIe completo / NVMe passante piuttosto che attaccare disco."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Comandi di archiviazione e dischi",
|
||||
"tail": "— qm importdisk e relativo riferimento shell."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Panoramica di Disk Manager",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,135 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Gestione dischi Proxmox: VM/LXC, test SMART e cancellazione | ProxMenux",
|
||||
"description": "Gestisci i dischi fisici di un host Proxmox VE con ProxMenux: collega dischi a VM o LXC (qm set scsi/sata/virtio, pct mp), importa immagini img / qcow2 / vmdk / raw, assegna interi HBA o controller NVMe, cancella dischi con controlli di sicurezza ed esegui autotest SMART.",
|
||||
"ogTitle": "Proxmox Disk Manager — Collegare dischi a VM / LXC, SMART Test, Wipe",
|
||||
"ogDescription": "Collega dischi a VM/LXC, importa immagini, usa il passthrough PCI dei controller, cancella con controlli di sicurezza ed esegui test SMART su Proxmox VE.",
|
||||
"twitterTitle": "Gestore dischi Proxmox | ProxMenux",
|
||||
"twitterDescription": "Collega dischi a VM/LXC, importa immagini, usa passthrough PCI, cancella con controlli di sicurezza ed esegui test SMART."
|
||||
},
|
||||
"header": {
|
||||
"title": "Gestione disco",
|
||||
"description": "Il menu Disk Manager raggruppa gli strumenti ProxMenux per la gestione di dischi fisici su un host Proxmox: collegare dischi a VM e contenitori LXC, importare immagini disco, passare attraverso un intero controller o dispositivo NVMe, pulire i dischi in modo sicuro ed eseguire test di salute SMART.",
|
||||
"section": "Gestione disco"
|
||||
},
|
||||
"intro": {
|
||||
"title": "A cosa serve questo menu",
|
||||
"body": "Questi strumenti operano su <strong>dischi fisici visibili all’host Proxmox e file immagine conservati su di esso</strong>. Il menu ha tre gruppi: <strong>VM</strong> (collegare dischi o importare immagini), <strong>LXC</strong> (collegare dischi a contenitori) e <strong>Utilità</strong> (formattazione e stato SMART). Collegamento e cancellazione nascondono o bloccano i dischi di sistema e in uso; SMART può esaminarli senza cancellarli."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Apertura del menu",
|
||||
"body": "Dal menu principale di ProxMenux, selezionare <strong>Disk Manager</strong>. Vedrai questo:",
|
||||
"imageAlt": "Menu Gestione disco con blocchi VM, LXC e Utilities"
|
||||
},
|
||||
"groups": {
|
||||
"heading": "Tre gruppi di utensili",
|
||||
"intro": "Il menu Disk Manager è organizzato in tre gruppi — <strong>VM</strong>, <strong>LXC</strong> e <strong>Utilities</strong>. Fare clic su una scheda per saltare dritto agli strumenti in quel gruppo.",
|
||||
"vmTitle": "VM",
|
||||
"vmBody": "Strumenti che operano su macchine virtuali esistenti. Il VM deve essere spento; ProxMenux lo convalida prima di toccare la configurazione.",
|
||||
"vmItems": [
|
||||
"Importa disco nella VM",
|
||||
"Importa immagine disco nella VM",
|
||||
"Aggiungi controller o NVMe a VM"
|
||||
],
|
||||
"lxcTitle": "LXC",
|
||||
"lxcBody": "Strumenti per contenitori LXC esistenti. Questo script richiede un contenitore privilegiato e propone di cambiare l’impostazione se necessario. Leggi prima le indicazioni su conversione e proprietari dei file nella pagina dello strumento.",
|
||||
"lxcItems": [
|
||||
"Importa disco su LXC"
|
||||
],
|
||||
"utilitiesTitle": "Utilità",
|
||||
"utilitiesBody": "Strumenti lato host che operano sui dischi stessi, indipendentemente da qualsiasi VM o contenitore.",
|
||||
"utilitiesItems": [
|
||||
"Formatta o cancella un disco fisico",
|
||||
"Integrità e test disco SMART"
|
||||
]
|
||||
},
|
||||
"vm": {
|
||||
"heading": "VM",
|
||||
"intro": "Strumenti che operano su macchine virtuali esistenti. Il VM deve essere spento; ProxMenux lo convalida prima di toccare la configurazione.",
|
||||
"options": [
|
||||
{
|
||||
"icon": "HardDrive",
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"title": "Importa disco nella VM",
|
||||
"description": "Collega un disco fisico non assegnato a una VM esistente. Supporta SATA/SCSI/VirtIO/IDE e usa percorsi persistenti /dev/disk/by-id."
|
||||
},
|
||||
{
|
||||
"icon": "FileDown",
|
||||
"href": "/docs/disk-manager/import-disk-image-vm",
|
||||
"title": "Importa immagine disco nella VM",
|
||||
"description": "Importa file di immagine del disco (.img / .qcow2 / .vmdk / .raw) in un VM esistente. Flusso bifase, qm importdisk sotto il cappuccio."
|
||||
},
|
||||
{
|
||||
"icon": "Cpu",
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"title": "Aggiungi controller o NVMe a VM",
|
||||
"description": "Passthrough PCI di un intero HBA SATA/SAS o dispositivo NVMe a una VM. Gestisce l’attivazione di IOMMU e il rilevamento dei conflitti."
|
||||
}
|
||||
]
|
||||
},
|
||||
"lxc": {
|
||||
"heading": "LXC",
|
||||
"intro": "Strumenti per contenitori LXC esistenti. Questo script richiede un contenitore privilegiato e propone di cambiare l’impostazione se necessario. Leggi prima le indicazioni su conversione e proprietari dei file nella pagina dello strumento.",
|
||||
"options": [
|
||||
{
|
||||
"icon": "Boxes",
|
||||
"href": "/docs/disk-manager/import-disk-lxc",
|
||||
"title": "Importa disco su LXC",
|
||||
"description": "Collega un disco fisico non assegnato a un contenitore LXC come punto di mount. Gestisce rilevamento e formattazione del filesystem e il passaggio alla modalità privilegiata."
|
||||
}
|
||||
]
|
||||
},
|
||||
"utilities": {
|
||||
"heading": "Utilità",
|
||||
"intro": "Strumenti lato host che operano sui dischi stessi, indipendentemente da qualsiasi VM o contenitore.",
|
||||
"options": [
|
||||
{
|
||||
"icon": "Eraser",
|
||||
"href": "/docs/disk-manager/format-disk",
|
||||
"title": "Formatta/Cancella disco fisico (sicuro)",
|
||||
"description": "Cancella dischi con controlli rigorosi: vengono mostrati solo dischi completamente liberi ed è sempre richiesta una doppia conferma."
|
||||
},
|
||||
{
|
||||
"icon": "Activity",
|
||||
"href": "/docs/disk-manager/smart-disk-test",
|
||||
"title": "Integrità e test disco SMART",
|
||||
"description": "Eseguire controlli sanitari SMART e test brevi / lunghi su drive SATA, SAS e NVMe. Esporta JSON per il Monitor."
|
||||
}
|
||||
]
|
||||
},
|
||||
"safety": {
|
||||
"title": "Regole di sicurezza per collegamento e cancellazione dei dischi",
|
||||
"intro": "Le operazioni di collegamento e cancellazione escludono i dispositivi che potrebbero danneggiare l’host:",
|
||||
"items": [
|
||||
"Il <strong>disco di sistema</strong>, il pool root, lo swap e i membri attivi ZFS/LVM/RAID sono sempre nascosti.",
|
||||
"I dischi <strong>montati</strong> in qualsiasi punto dell’host sono nascosti o bloccati all’esecuzione.",
|
||||
"I dischi <strong>riferiti da un VM in esecuzione o LXC</strong> non possono essere riassegnati o cancellati.",
|
||||
"Le operazioni che modificano lo stato dell’host, come attivare IOMMU o cancellare dischi, richiedono una conferma esplicita."
|
||||
]
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share",
|
||||
"label": "Gestore storage e condivisioni",
|
||||
"tail": "— registrare lo storage in Proxmox stesso (NFS / Samba / iSCSI / locale) e condividere le cartelle tra host e CT."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Comandi di archiviazione e dischi",
|
||||
"tail": "— dispositivi di blocco, LVM, pvesm, riferimento SMART."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"label": "Comandi di gestione ZFS",
|
||||
"tail": " — per ZFS pools e set di dati."
|
||||
},
|
||||
{
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"label": "Aggiungi GPU a VM (Passthrough)",
|
||||
"tail": "— stessi concetti IOMMU / VFIO applicati alle GPU."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,146 @@
|
||||
{
|
||||
"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 <code>smartctl</code> o <code>nvme</code> 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 <code>smartmontools</code>; le unità NVMe si basano su <code>nvme-cli</code>. 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.<br /><code>smartctl -H</code> + <code>-A</code> (SATA/SAS) o <code>nvme smart-log</code> (NVMe).",
|
||||
"dur": "istantaneamente"
|
||||
},
|
||||
{
|
||||
"action": "Rapporto completo",
|
||||
"whatRich": "Dati SMART completi, scorrevoli. <code>smartctl -x</code> per SATA/SAS o <code>nvme smart-log</code> + <code>id-ctrl</code> 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 <em>nel disco</em> e non dipende dal processo ProxMenux. Puoi chiudere il terminale e tornare a <strong>Verifica avanzamento test</strong>. 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 <code>/usr/local/share/proxmenux/smart/<disk>/</code>; 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 e rapporti compaiono nel terminale; l’esportazione JSON avviene per le azioni indicate sopra, non per Rapporto completo. Per i test lunghi torna a <strong>Verifica avanzamento test</strong> 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 (<code>nvme smart-log</code> + <code>id-ctrl</code>) 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 <code>smartctl -d megaraid,N /dev/sdX</code>. 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/SAS, <code>smartctl -c</code> mostra la percentuale rimanente; 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": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user