Merge pull request #479 from jcastro/docs/review-disk-manager

docs: review disk manager documentation in all seven translations
This commit is contained in:
MacRimi
2026-10-18 14:03:15 +02:00
committed by GitHub
56 changed files with 5418 additions and 84 deletions
@@ -0,0 +1,128 @@
{
"meta": {
"title": "Hinzufügen von Controller oder NVMe zu VM | ProxMenux Dokumentation",
"description": "PCI-Passthrough eines Speichercontrollers (SATA-/SAS-HBA) oder NVMe-Geräts an eine Proxmox-VM mit ProxMenux. Das Werkzeug aktiviert IOMMU, erkennt Konflikte und richtet die Zuweisung mit qm set --hostpci ein.",
"ogTitle": "Hinzufügen von Controller oder NVMe zu VM | ProxMenux Dokumentation",
"ogDescription": "Weisen Sie einer Proxmox-VM einen vollständigen SATA-/SAS-HBA oder ein NVMe-Gerät zu. ProxMenux übernimmt IOMMU, Konflikterkennung und die hostpci-Zuweisung."
},
"header": {
"title": "Controller oder NVMe zu VM hinzufügen",
"description": "Weisen Sie einer Proxmox-VM einen vollständigen SATA-/SAS-Host-Bus-Adapter (HBA) oder ein NVMe-Gerät per PCI-Passthrough zu. ProxMenux prüft IOMMU und aktiviert es mit Ihrer Zustimmung, ermittelt geeignete Geräte, schließt Konflikte aus und trägt die Zuweisung mit qm set --hostpci ein.",
"section": "Datenträgerverwaltung · VM"
},
"intro": {
"title": "Was dies tut (und nicht tut)",
"body": "Dies ist <strong>Passthrough auf Geräteebene</strong>: Die PCIe-Karte wird der Kontrolle des Host-Kernels entzogen und an <code>vfio-pci</code> gebunden. Die VM sieht den Controller selbst statt einzeln durchgereichter Laufwerke und lädt ihren eigenen Treiber für dieses Modell. Alle am Controller angeschlossenen Laufwerke folgen automatisch, mit nativen SMART-Daten, vollständigen Firmware-Funktionen und ohne Proxmox-Zwischenschicht."
},
"howRuns": {
"heading": "Wie das Skript läuft",
"body": "Der Fluss hat zwei Phasen mit klarer Trennung zwischen \"Sammeln von Informationen, Überprüfen von IOMMU und Auflisten von Kandidaten\" und \"Tatsächliches Anbringen des PCI-Geräts\". Bis zur endgültigen Bestätigung wird nichts an die VM-Konfiguration geschrieben."
},
"iommu": {
"heading": "IOMMU-Gruppen - warum die gesamte Karte auf einmal geht",
"body": "Die Isolationsgrenze für PCI-Passthrough ist die <strong>IOMMU-Gruppe</strong>, die kleinste von der IOMMU der CPU isolierbare Einheit. Geräte derselben Gruppe lassen sich nicht voneinander isolieren. Teilt ein SATA-Controller die Gruppe mit einem USB-Controller, muss für SATA-Passthrough möglicherweise auch USB vom Host gelöst werden, oder Passthrough ist nicht möglich. Dabei werden nicht automatisch alle Geräte der Gruppe der VM zugewiesen.",
"outro": "ProxMenux zeigt die IOMMU-Gruppe neben jedem Gerät und warnt Sie, wenn eine Gruppe mehr als nur den gewünschten Controller trägt. Sie können weiterhin fortfahren, wenn die zusätzlichen Geräte in der Gruppe akzeptabel sind (z. B. alle Festplattencontroller) oder zurückgehen, wenn dies nicht der Fall ist."
},
"prereqs": {
"heading": "Voraussetzungen",
"items": [
"<strong>CPU und Mainboard unterstützen</strong> VT-d (Intel) oder AMD-Vi, und die Funktion ist in der Firmware (BIOS/UEFI) aktiviert. ProxMenux kann die Kernelkonfiguration aktivieren, aber keine Firmware-Einstellung umschalten.",
"Die Ziel-VM ist vor dem Anschließen von PCI-Geräten <strong>ausgeschaltet</strong>.",
"Der Controller/NVMe <strong> ist nicht derjenige, der das Proxmox Root-Dateisystem</strong> hält. Das Skript verbirgt alles, was vom Host verwendet wird.",
"Das Gastbetriebssystem hat Treiber für das Controllermodell. Linux unterstützt nahezu jeden HBA ab Werk; unter Windows muss der Herstellertreiber <em>vor</em> dem Start mit angeschlossenem Controller installiert sein."
],
"warnTitle": "Live Migration ist nicht möglich",
"warnBody": "Ein VM mit PCI-Durchgang ist an den Knoten gebunden, der die Karte physisch hält. Live-Migration über Knoten wird fehlschlagen. Planen Sie Backups / Replikation entsprechend."
},
"steps": {
"heading": "Schritt für Schritt",
"stepLabel": "Schritt",
"list": [
{
"title": "Ziel-VM auswählen",
"bodyRich": "ProxMenux liest <code>qm list</code> und zeigt alle VMs an. Wählen Sie die VM, die den Controller erhalten soll.",
"img": "/disk/nvme-passthrough/vm-selection.png",
"alt": "VM Auswahldialog",
"caption": "VM Auswahldialog"
},
{
"title": "IOMMU-Prüfung",
"bodyRich": "Wenn IOMMU auf der Kernel-Cmdline nicht aktiviert ist, bietet ProxMenux an, sie zu aktivieren. Es bearbeitet <code>/etc/kernel/cmdline</code> (für systemd-Boot) oder <code>/etc/default/grub</code> (für GRUB) und fügt den richtigen Parameter für Ihren CPU hinzu:",
"items": [
"<code>intel_iommu=on</code> für Intel CPUs.",
"<code>amd_iommu=on</code> für AMD CPUs."
],
"outro": "Nach dieser Änderung ist ein Neustart erforderlich. Das Skript bietet einen Neustart jetzt oder später an; Passthrough kann erst fortgesetzt werden, wenn die neue Kernel-Kommandozeile aktiv ist.",
"img": "/disk/nvme-passthrough/iommu-warning.png",
"alt": "Dialog „IOMMU erforderlich“",
"caption": "IOMMU Erforderlich — Angebot zum Aktivieren und Neustarten"
},
{
"title": "Geräteaufzählung",
"body": "ProxMenux listet jeden Speichercontroller (SATA / SAS HBA) und jedes NVMe-Gerät auf dem PCI-Bus auf. Für jedes Gerät zeigt es:",
"items": [
"PCI-Adresse (<code>00:17.0</code>, <code>01:00.0</code>, ...).",
"Hersteller- und Gerätebeschreibung.",
"IOMMU-Gruppe - und eine ⚠ Warnung, wenn die Gruppe mit anderen, nicht verwandten Geräten geteilt wird.",
"Die aktuell am Controller angeschlossenen Laufwerke, damit Sie wissen, welche zur VM wechseln."
],
"img": "/disk/nvme-passthrough/device-list.png",
"alt": "Controller / NVMe Geräteaufzählung",
"caption": "Controller / NVMe Geräteaufzählung mit IOMMU Gruppeninfo"
},
{
"title": "Konflikterkennung",
"bodyRich": "Das Skript sperrt eindeutig unsichere Geräte: bereits einer anderen VM über <code>hostpci</code> zugewiesene Geräte, vom Host verwendete Geräte wie den Root-Laufwerkscontroller sowie Geräte in IOMMU-Gruppen, deren andere Mitglieder nicht sicher erkannt werden können. Geeignete Geräte stehen zur Auswahl.",
"img": "/disk/nvme-passthrough/conflict-warning.png",
"alt": "Konflikterkennungswarnung",
"caption": "Konflikterkennung: Gerät mit Angabe des Grundes gesperrt"
},
{
"title": "Zuweisen und abschließen",
"bodyRich": "Für jedes gewählte Gerät führt ProxMenux <code>qm set &lt;VMID&gt; --hostpciN &lt;pci-addr&gt;,pcie=1</code> aus und verwendet den nächsten freien <code>hostpci</code>-Slot. Wurde IOMMU in dieser Sitzung aktiviert, wird vor dem Start der VM an den erforderlichen Neustart erinnert.",
"img": "/disk/nvme-passthrough/assignment.png",
"alt": "Zusammenfassung der Zuweisung",
"caption": "Zusammenfassung der Zuweisung: belegte hostpciN-Slots und zugewiesene PCI-Adressen"
}
]
},
"manual": {
"heading": "Manuelles Äquivalent"
},
"troubleshoot": {
"heading": "Fehlerbehebung",
"noGroupsTitle": "IOMMU aktiviert, aber keine Gruppen unter /sys/kernel/iommu_groups/",
"noGroupsBody": "Ein Neustart ist erforderlich, damit die Kernel-Cmdline wirksam wird. Wenn die Gruppen nach dem Neustart immer noch fehlen, ist VT-d / AMD-Vi wahrscheinlich in der Firmware deaktiviert - überprüfen Sie das BIOS / UEFI-Setup.",
"busyTitle": "VM startet nicht: \"hostpciN: device busy\"",
"busyBody": "Ein anderer Prozess hält das PCI-Gerät noch belegt. Häufige Ursachen sind eine abgestürzte VM, die es nicht freigegeben hat, oder der Host-Kernel, der es beim letzten Start wieder übernommen hat. Prüfen Sie mit <code>lspci -nnk -s &lt;addr&gt;</code> den gebundenen Treiber; es sollte <code>vfio-pci</code> sein. Ein vollständiger Neustart des Hosts behebt dies meist.",
"noDisksTitle": "Gast sieht den Controller, aber nicht die Festplatten",
"noDisksBody": "Im Gast fehlt der Treiber für das Controllermodell. Unter Linux tritt dies selten auf, unter Windows hingegen schon. Installieren Sie den Herstellertreiber, etwa von LSI/Broadcom für ältere SAS-HBAs, solange die Karte nicht zugewiesen ist, und starten Sie dann mit zugewiesener Karte neu.",
"sharedTitle": "Die IOMMU-Gruppe enthält ein nicht zugehöriges Gerät",
"sharedBody": "Möglichkeiten: (a) die Karte in einen anderen PCIe-Slot setzen, um ihre Gruppe zu ändern, (b) <em>ACS override</em> im Kernel aktivieren, um Gruppen aufzuteilen (Sicherheitskompromiss, vor der Anwendung recherchieren), oder (c) eine andere Karte in einer besser isolierten Gruppe wählen."
},
"related": {
"heading": "Verwandte Themen",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Datenträger in VM importieren",
"tail": "Alternatives Modell: Befestigen Sie eine physische Festplatte über Proxmox ohne vollständigen PCIe-Durchgang."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "GPU zu VM hinzufügen (Passthrough)",
"tail": "- gleiche IOMMU / VFIO-Konzepte, die auf einen GPU angewendet wurden."
},
{
"href": "/docs/help-info/gpu-commands",
"label": "GPU Durchgangsbefehle",
"tail": "IOMMU-Verifizierungsbefehle gelten auch für den Controller / NVMe-Durchgang."
},
{
"href": "/docs/disk-manager",
"label": "Übersicht Disk Manager",
"tail": "."
}
]
}
}
@@ -0,0 +1,142 @@
{
"meta": {
"title": "Physischen Datenträger formatieren oder löschen | ProxMenux-Dokumentation",
"description": "Physische Datenträger auf Proxmox VE mit ProxMenux löschen und formatieren. Vier Betriebsarten, strenge Sicherheitsfilter gegen Systemlaufwerke, eingehängte oder verwendete Laufwerke und doppelte Bestätigung mit Eingabe des vollständigen Pfads.",
"ogTitle": "Physischen Datenträger formatieren oder löschen | ProxMenux-Dokumentation",
"ogDescription": "Physische Datenträger auf Proxmox löschen oder formatieren. Sicherheitsfilter, vier Betriebsarten und doppelte Bestätigung."
},
"header": {
"title": "Physischen Datenträger formatieren / löschen",
"description": "Wischen oder formatieren Sie sicher eine physische Festplatte auf dem Proxmox-Host. ProxMenux zeigt nur Festplatten an, die völlig frei sind (keine Systemnutzung, keine Gastreferenz, keine Mounts) und erzwingt eine doppelte Bestätigung - ja / nein plus Eingabe des vollständigen Festplattenpfads -, bevor Daten zerstört werden.",
"section": "Disk Manager · Dienstprogramme"
},
"danger": {
"title": "Zerstörendes Werkzeug",
"body": "Jede Operation hier schreibt auf die Festplatte. Es gibt kein Rückgängigmachen. ProxMenux wendet strenge Sicherheitsfilter und Bestätigungen an, aber die Verantwortung für die Auswahl der richtigen Festplatte liegt bei Ihnen. Lesen Sie den Festplattenpfad zweimal laut aus, bevor Sie ihn eingeben."
},
"howRuns": {
"heading": "Wie das Skript läuft",
"body": "Der Ablauf hat zwei Phasen mit einer dreifachen Sicherheitsprüfung dazwischen. In Phase 1 werden Laufwerksauswahl, Betriebsart und Dateisystemdetails erfasst. Geschrieben wird erst, wenn Phase 2 unmittelbar vor der Ausführung eine abschließende erneute Prüfung bestanden hat."
},
"visibility": {
"heading": "Sichtbarkeitsregeln",
"intro": "Bevor das Menü überhaupt erscheint, filtert ProxMenux die Festplattenliste. Es werden nur Kandidaten gezeigt, die nachweislich sicher sind:",
"items": [
"<strong>Angezeigt</strong> werden Laufwerke, die <em>nicht</em> vom Host genutzt werden (Root-Pool, Swap, eingehängte Dateisysteme, aktives ZFS/LVM/RAID) und <em>nicht</em> in einer VM-/LXC-Konfiguration referenziert sind, unabhängig vom Betriebszustand des Gasts.",
"<strong>Ausgeblendet</strong>: Host- und Systemlaufwerke.",
"<strong>Ausgeblendet</strong>: in VM-/LXC-Konfigurationen referenzierte Laufwerke."
],
"safetyTitle": "Sicherheit bei Bestätigung und Ausführung",
"safetyItems": [
"Bei Laufwerken mit veralteten oder aktiven Metadaten erscheinen detaillierte Warnungen <em>vor</em> der Bestätigung.",
"Von einer <strong>laufenden</strong> VM genutzte Laufwerke werden bei der Bestätigung <strong>vollständig gesperrt</strong>.",
"Laufwerke mit eingehängten Partitionen werden bei der Ausführung <strong>vollständig gesperrt</strong>. Unmittelbar vor dem Schreiben erfolgt eine neue Prüfung.",
"Zwei Bestätigungen sind immer erforderlich: ein <em>Ja/Nein</em>-Dialog und die exakte Eingabe des vollständigen Laufwerkspfads."
]
},
"modes": {
"heading": "Betriebsarten",
"intro": "Nachdem Sie eine Festplatte ausgewählt haben, wählen Sie einen von vier Modi. Sie unterscheiden sich darin, was sie zerstören und was sie zurücklassen.",
"headerMode": "Modus",
"headerPart": "Partitionstabelle",
"headerData": "Daten",
"headerUseCase": "Anwendungsfall",
"rows": [
{
"mode": "1. Alles löschen",
"part": "Zerstört",
"data": "Signaturen gelöscht",
"useCase": "Entfernt die Partitionstabelle sowie Dateisystem- und RAID-Metadaten, überschreibt die ersten und letzten 16 MiB mit Nullen und führt bei Laufwerken mit Discard-Unterstützung ein TRIM über den gesamten Datenträger aus. Die übrigen Daten werden nicht überschrieben und können auf HDDs noch wiederherstellbar sein; dies ist kein sicheres Löschen."
},
{
"mode": "2. FS-Etiketten entfernen",
"part": "Erhalten",
"data": "Erhalten",
"useCase": "Entfernt alte ZFS-/LVM-/RAID-Signaturen, damit das Laufwerk nicht mehr automatisch eingebunden wird. Nutzdaten werden nicht flächig überschrieben, können durch das Entfernen der Signaturen aber unzugänglich werden."
},
{
"mode": "3. Daten mit Nullen überschreiben",
"part": "Erhalten",
"data": "Zerstört (mit Nullen überschrieben)",
"useCase": "Bestehende Partitionen mit Nullen überschreiben und die Partitionstabelle erhalten. Nicht zugewiesener Speicher und SSD-Reservebereiche sind nicht erfasst; dies garantiert keine vollständige Gerätesanitisierung."
},
{
"mode": "4. Vollformat",
"part": "Neue GPT",
"data": "Zerstört",
"useCase": "Einsatzbereites Laufwerk mit einer neuen Partition und einem neuen Dateisystem."
}
],
"fullFormatOutro": "<strong>Vollständiges Formatieren</strong> führt zu zwei weiteren Dialogen:",
"fullFormatItems": [
"<strong>Dateisystem</strong>: <code>ext4</code>, <code>xfs</code>, <code>exfat</code> (portabel) oder <code>btrfs</code>. Fehlen Werkzeuge wie <code>mkfs.btrfs</code>, wird mit einer klaren Meldung abgebrochen.",
"<strong>Label</strong> — optionales Dateisystem-Etikett zur Identifizierung."
]
},
"steps": {
"heading": "Schritt für Schritt",
"stepLabel": "Schritt",
"list": [
{
"title": "Freies Laufwerk wählen",
"body": "ProxMenux listet jede Festplatte auf, die die oben genannten Sichtbarkeitsfilter passiert. Festplatten mit ⚠-Markern tragen veraltete Metadaten und werden mit den Details angezeigt, damit Sie wissen, was Sie überschreiben möchten."
},
{
"title": "Wählen Sie einen Betriebsmodus",
"bodyRich": "Wählen Sie gemäß obiger Tabelle <strong>Alles löschen</strong>, <strong>FS-Etiketten entfernen</strong>, <strong>Daten mit Nullen überschreiben</strong> oder <strong>Vollständiges Formatieren</strong>."
},
{
"title": "(Nur Vollformat) Dateisystem und Label auswählen",
"body": "ext4 / xfs / exfat / btrfs, plus ein optionales Etikett."
},
{
"title": "Zweimal bestätigen",
"bodyRich": "ProxMenux zeigt eine Zusammenfassung der geplanten Aktion. Sie bestätigen im Ja/Nein-Dialog und <strong>geben den vollständigen Laufwerkspfad</strong> exakt wie angezeigt ein, etwa <code>/dev/sdc</code>. Jede andere Eingabe bricht ab."
},
{
"title": "Revalidierung und Ausführung",
"body": "Kurz vor dem Schreiben überprüft das Skript den Festplattenzustand erneut. Wurde zwischenzeitlich eine Partition gemountet oder ein VM gestartet, wird die Ausführung abgebrochen. Ansonsten läuft die gewählte Operation und eine Zusammenfassung wird am Ende gedruckt."
}
]
},
"manual": {
"heading": "Manuelle Äquivalente",
"body": "Wenn Sie es vorziehen, die entsprechenden Befehle von Hand auszuführen:"
},
"troubleshoot": {
"notListedTitle": "Disk nicht im Menü aufgeführt",
"notListedBody": "Das Laufwerk wurde aus Sicherheitsgründen ausgeblendet. Häufige Gründe: Es ist eingehängt, auch unter <code>/mnt/tmp</code>, aktives Mitglied von ZFS/LVM/RAID, in einer VM-/LXC-Konfiguration referenziert oder das Proxmox-Root-Laufwerk. Prüfen Sie auf dem Host <code>lsblk -f</code> und <code>cat /proc/mdstat</code>, um den Grund zu ermitteln.",
"busyTitle": "\"Disk may be busy\" / Unmount fehlgeschlagen",
"busyBody": "Etwas hält immer noch eine offene Datei auf einer Partition dieser Festplatte - meistens ein Container oder eine Shell, deren cwd sich in einem Mountpoint befindet. Identifizieren Sie es mit <code>lsof | grep /dev/sdX</code> oder <code>fuser -vm /dev/sdX1</code>, stoppen Sie es und führen Sie das Tool erneut aus."
},
"related": {
"heading": "Verwandte Themen",
"items": [
{
"href": "/docs/disk-manager/smart-disk-test",
"label": "SMART-Festplattenstatus und -test",
"tail": "Überprüfen Sie eine Festplatte vor / nach dem Wischen, um zu bestätigen, dass sie gesund ist."
},
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Datenträger in VM importieren",
"tail": "Übergeben Sie eine frisch formatierte Festplatte an eine VM."
},
{
"href": "/docs/storage-share/host-local-disk",
"label": "Lokale Festplatte als Proxmox-Speicher hinzufügen",
"tail": "Registrieren Sie eine gelöschte Festplatte als Proxmox-Speicherpool."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Speicher- und Festplattenbefehle",
"tail": " — Referenz für lsblk, blkid und parted."
},
{
"href": "/docs/disk-manager",
"label": "Übersicht Disk Manager",
"tail": "."
}
]
}
}
@@ -0,0 +1,110 @@
{
"meta": {
"title": "Datenträgerbild in VM importieren | ProxMenux Dokumentation",
"description": "Importieren Sie eine Disk-Image-Datei (.img / .qcow2 / .vmdk / .raw) mit ProxMenux in ein vorhandenes Proxmox VM. Per-Image-Schnittstelle, SSD-Emulation und bootfähiges Flag, mit qm importdisk unter der Haube.",
"ogTitle": "Datenträgerbild in VM importieren | ProxMenux Dokumentation",
"ogDescription": "Importieren Sie .img / .qcow2 / .vmdk / .raw Disk-Images in einen vorhandenen VM mit ProxMenux. Verwendet qm importdisk unter der Haube."
},
"header": {
"title": "Disk-Image in VM importieren",
"description": "Importieren Sie eine Disk-Image-Datei (.img, .qcow2, .vmdk oder .raw) in eine vorhandene Proxmox VM. ProxMenux sammelt jede Entscheidung im Voraus - Ziel VM, Proxmox-Speicher, Quellverzeichnis, Schnittstelle, SSD-Emulation, Boot-Order - und führt dann qm importdisk für jedes ausgewählte Image aus.",
"section": "Datenträgerverwaltung · VM"
},
"intro": {
"title": "Was das macht",
"body": "Anders als <em>Datenträger in VM importieren</em>, das ein physisches Laufwerk direkt zuweist, verwendet dieser Ablauf eine <strong>Datei</strong> auf dem Host, etwa einen Export eines anderen Hypervisors, ein heruntergeladenes Cloud-Image oder ein aus einer Sicherung extrahiertes Image. Sie wird in ein Proxmox-VM-Laufwerk auf dem gewählten Speicher umgewandelt. Die Originaldatei bleibt erhalten: ProxMenux kopiert sie, statt sie zu verschieben."
},
"howRuns": {
"heading": "Wie das Skript läuft",
"body": "Der Ablauf hat zwei Phasen. Phase 1 erfasst über Dialoge vorab alle Entscheidungen: VM, Speicher, Quellverzeichnis, Images und Optionen je Image. Phase 2 führt <code>qm importdisk</code> für jedes ausgewählte Image aus. Vor Beginn von Phase 2 wird weder etwas kopiert noch die VM-Konfiguration verändert."
},
"prereqs": {
"heading": "Voraussetzungen",
"items": [
"Mindestens eine VM ist auf dem Host definiert. Die Ziel-VM sollte <strong>ausgeschaltet</strong> sein.",
"Mindestens eine Disk-Image-Datei in einem unterstützten Format liegt im Quellverzeichnis. Unterstützt werden <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code> und <code>.raw</code>.",
"Genug freien Speicherplatz auf dem Ziel-Proxmox-Speicher, um jede importierte Festplatte zu halten.",
"ProxMenux sucht standardmäßig nach Images in <code>/var/lib/vz/template/iso</code>. Sie können es auf jedes andere Verzeichnis auf dem Host verweisen, wenn es gefragt wird."
]
},
"steps": {
"heading": "Schritt für Schritt",
"stepLabel": "Schritt",
"list": [
{
"title": "Ziel-VM auswählen",
"bodyRich": "ProxMenux liest <code>qm list</code> und zeigt jeden VM an. Wählen Sie diejenige aus, die die importierten Festplatten erhält."
},
{
"title": "Wählen Sie den Proxmox-Speicher",
"bodyRich": "Die Liste enthält jeden Speicher, für den der Inhaltstyp <code>images</code> aktiviert ist. Wenn es nur einen Kandidaten gibt, wird er automatisch ausgewählt und der Dialog wird übersprungen."
},
{
"title": "Wählen Sie das Quellverzeichnis",
"bodyRich": "Wählen Sie das Standardverzeichnis (<code>/var/lib/vz/template/iso</code>) oder geben Sie einen benutzerdefinierten Pfad ein - in der Regel, wo Sie das Image heruntergeladen / hochgeladen haben. Das Skript lehnt Pfade ab, die nicht existieren."
},
{
"title": "Wählen Sie ein oder mehrere Images",
"bodyRich": "Das Verzeichnis wird nach <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code> Dateien gescannt. Sie können mehrere gleichzeitig auswählen; jede wird im nächsten Schritt die Per-Bild-Optionen durchlaufen."
},
{
"title": "Per-Image Optionen",
"intro": "Für jedes ausgewählte Image fragt ProxMenux:",
"items": [
"<strong>Interface</strong> — <code>scsi</code> (Standard), <code>virtio</code>, <code>sata</code> oder <code>ide</code>. Passt dazu, wie der Gast die Festplatte sehen wird.",
"<strong>SSD-Emulation</strong>: nur für Nicht-VirtIO-Schnittstellen verfügbar. Fügt <code>ssd=1</code> hinzu, damit der Gast das Laufwerk als SSD erkennt. Discard/TRIM muss separat konfiguriert werden.",
"<strong>Bootfähig</strong>: Bei Ja nimmt ProxMenux das Laufwerk als primäres Startgerät in die Bootreihenfolge der VM auf."
]
},
{
"title": "Importieren und zuweisen",
"bodyRich": "ProxMenux führt <code>qm importdisk</code> für jedes Image aus (Konvertierung des Formats im laufenden Betrieb, wo dies erforderlich ist), fügt die resultierende Festplatte mit den von Ihnen gewählten Optionen an den nächsten freien Slot (<code>scsiN</code>, <code>sataN</code>, ...) an und aktualisiert - wenn Sie eine Festplatte als bootfähig markiert haben - die Boot-Order. Fortschritt zeigt sich im Terminal."
}
]
},
"manual": {
"heading": "Manuelles Äquivalent",
"body": "Ein einzelnes Image lässt sich mit drei <code>qm</code>-Befehlen importieren:",
"warnTitle": "Konvertierung des Disk-Image-Formats",
"warnBody": "Wenn der Zielspeicher das Quellformat nativ nicht halten kann (z. B. LVM-Speicher <code>.qcow2</code>), konvertiert <code>qm importdisk</code> das Image transparent. Dies kann mehrere Minuten für Multi-GB-Bilder dauern; planen Sie entsprechend und unterbrechen Sie das Skript nicht."
},
"troubleshoot": {
"heading": "Fehlerbehebung",
"noImagesTitle": "\"Keine kompatiblen Disk Images gefunden\"",
"noImagesBody": "Das Skript fand keine Datei mit <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code> oder <code>.raw</code>. Prüfen Sie die Erweiterung einschließlich Groß-/Kleinschreibung, ob die Datei direkt im gewählten Verzeichnis liegt (Unterverzeichnisse werden nicht durchsucht) und ob root sie lesen darf.",
"slowTitle": "Import ist langsam",
"slowBody": "Konvertierungen zwischen VMDK, QCOW2 und raw können durch CPU und E/A begrenzt sein. Die Importgeschwindigkeit hängt von Quelllesezugriffen, Zielschreibzugriffen und nötiger Dekomprimierung ab. Bevorzugen Sie nach Möglichkeit raw- oder qcow2-Quellen.",
"uefiTitle": "Importiertes Laufwerk startet in der UEFI-Shell",
"uefiBody": "Das Image wurde für Legacy (SeaBIOS) gebaut, aber der VM verwendet OVMF (oder umgekehrt). Wechseln Sie entweder den VM BIOS in Proxmox, um das Image abzugleichen, oder bauen Sie das Image vor dem Importieren im richtigen Modus neu auf."
},
"related": {
"heading": "Verwandte Themen",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Datenträger in VM importieren",
"tail": " — derselbe Ablauf für physische Laufwerke (Passthrough)."
},
{
"href": "/docs/utils/import-vm",
"label": "VM von OVA / OVF importieren",
"tail": "- wenn Sie ein vollständiges VM-Paket haben, nicht nur ein Festplattenimage."
},
{
"href": "/docs/utils/UUp-Dump-ISO-Creator",
"label": "UUP-Dump-ISO-Erstellung",
"tail": "- Generieren Sie eine Windows ISO, wenn Sie eine für eine neue Installation benötigen."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Speicher- und Festplattenbefehle",
"tail": " — Referenz für qm importdisk und qemu-img convert."
},
{
"href": "/docs/disk-manager",
"label": "Übersicht Disk Manager",
"tail": "."
}
]
}
}
@@ -0,0 +1,115 @@
{
"meta": {
"title": "Datenträger zu LXC importieren | ProxMenux Dokumentation",
"description": "Befestigen Sie eine physische Festplatte an einen vorhandenen LXC-Container auf Proxmox VE mit ProxMenux. Behandelt Dateisystemerkennung / -formatierung, Einhängepunkt, unprivilegierte → privilegierte Konvertierung und persistente Gerätepfade.",
"ogTitle": "Datenträger zu LXC importieren | ProxMenux Dokumentation",
"ogDescription": "Befestigen Sie eine physische Festplatte an einen vorhandenen LXC-Container. Behandelt Dateisystem, Mount Point und unprivilegierte → privilegierte Konvertierung."
},
"header": {
"title": "Datenträger in LXC importieren",
"description": "Fügen Sie eine physische Festplatte an einen vorhandenen LXC-Container auf dem Proxmox-Host an. ProxMenux erkennt freie Festplatten, formatiert sie optional mit einem unterstützten Dateisystem und verkabelt die Partition mit persistenten Gerätepfaden an einen Einhängepunkt im Container.",
"section": "Datenträgerverwaltung · LXC"
},
"intro": {
"title": "VM-Passthrough und LXC-Passthrough",
"body": "LXC-Passthrough stellt hier <strong>kein rohes Blockgerät</strong> bereit. Der Container erhält einen <em>Einhängepunkt</em>, also ein Verzeichnis auf der gewählten Host-Partition. Anders als bei einer VM nutzt der Gast den Host-Kernel; das Dateisystem (ext4/xfs/btrfs) wird daher vom Proxmox-Host gelesen, verwaltet und dem Container zugänglich gemacht."
},
"howRuns": {
"heading": "Wie das Skript läuft",
"body": "Der Fluss hat zwei Phasen mit klarer Trennung zwischen \"Sammeln von Informationen und Entscheidungen\" und \"tatsächliches Ändern der Containerkonfiguration\". Bis zur endgültigen Bestätigung wird nichts in den CT eingebaut.",
"summary": "ProxMenux blendet das Root-Laufwerk, eingehängte Laufwerke und bereits in VM-/LXC-Konfigurationen referenzierte Laufwerke aus. Aktive ZFS-/LVM-/RAID-Mitglieder werden ausgeblendet; alte Signaturen werden mit ⚠ markiert, damit Sie sie vor dem Formatieren löschen können."
},
"prereqs": {
"heading": "Voraussetzungen",
"items": [
"Mindestens ein LXC-Container, der auf dem Host definiert ist.",
"Der Container ist <strong>privilegiert</strong>, oder Sie nehmen das Konvertierungsangebot des Skripts an.",
"Mindestens eine physische Festplatte, die vom Host oder einem anderen Gast nicht verwendet wird."
],
"warnTitle": "Privilegierter Container erforderlich",
"warnBody": "Dieses Skript benötigt für die direkte Laufwerkszuweisung einen <strong>privilegierten</strong> Container. Bei <code>unprivileged: 1</code> bietet es an, <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code> direkt zu ändern. Das ändert das Sicherheitsmodell, ordnet vorhandene Dateieigentümer aber nicht neu zu. Sichern Sie den Container und prüfen Sie die Eigentümer vor der Zustimmung, oder erstellen Sie ihn privilegiert neu."
},
"steps": {
"heading": "Schritt für Schritt",
"stepLabel": "Schritt",
"list": [
{
"title": "Wählen Sie den Zielcontainer",
"img": "/disk/select-container.png",
"caption": "Auswahlmenü für Container",
"bodyRich": "ProxMenux listet jeden LXC-Container auf dem Host auf (<code>pct list</code>). Wählen Sie diejenige, die die Festplatte erhalten wird. Wenn der Container nicht privilegiert ist, wird Ihnen angeboten, ihn jetzt umzuwandeln."
},
{
"title": "Wählen Sie die physische Festplatte",
"img": "/disk/disk-selection-ct.png",
"caption": "Freie Festplatten auf dem Host erkannt (mit ⚠ Labels für veraltete Metadaten)",
"bodyRich": "Nur sichere Kandidaten werden angezeigt. Anders als bei VMs weist dieses Skript <strong>ein Laufwerk pro Durchlauf</strong> zu. Führen Sie es für jedes weitere Laufwerk erneut aus."
},
{
"title": "Formatieren oder wiederverwenden",
"intro": "Das Skript überprüft die Festplatte:",
"items": [
"Wenn es bereits ein unterstütztes Dateisystem (ext4 / xfs / btrfs) trägt, können Sie es so wiederverwenden, wie es ist (bestehende Dateien bleiben erhalten).",
"Wenn es kein unterstütztes Dateisystem hat, wird Ihnen angeboten, es zu formatieren. Wählen Sie ext4 / xfs / btrfs."
]
},
{
"title": "Wählen Sie den Mount Point",
"bodyRich": "Geben Sie den Pfad ein, unter dem der Container das Laufwerk sehen soll, etwa <code>/mnt/data</code> oder <code>/mnt/disk_passthrough</code>. Dies ist der Pfad <em>innerhalb</em> des Containers; der Host sieht die Partition bereits unter <code>/dev/disk/by-id/…</code>."
},
{
"title": "Zuweisen und prüfen",
"img": "/disk/assignment-ct.png",
"caption": "Zuordnung zu CT",
"bodyRich": "ProxMenux fügt der Containerkonfiguration einen neuen <code>mpN:</code>-Eintrag hinzu, überspringt belegte Indizes und liest die Konfiguration zur Bestätigung erneut. Bei laufendem Container wird die Einhängung sofort angewendet, andernfalls beim nächsten Start.",
"extraImg": "/disk/result-point.png",
"extraAlt": "Mount Point erfolgreich erstellt",
"extraCaption": "Einhängepunkt erstellt und geprüft"
}
]
},
"manual": {
"heading": "Manuelles Äquivalent",
"body": "Das Skript wickelt <code>pct set</code> ab. Ein direkter Aufruf für eine einzelne Festplatte sieht so aus:"
},
"important": {
"heading": "Wichtige Überlegungen",
"items": [
"<strong>Ein Laufwerk pro Durchlauf</strong>. Führen Sie das Skript für jedes weitere Laufwerk erneut aus.",
"Hängen Sie <strong>nicht</strong> dieselbe Partition an mehrere Container an, die sie gleichzeitig bereitstellen könnten – gleichzeitige Schreibvorgänge beschädigen das Dateisystem.",
"<strong>Alte Metadaten</strong> (RAID / ZFS / LVM-Signaturen) müssen manuell gelöscht werden, bevor Sie das Skript formatieren lassen, andernfalls weigert sich <code>mkfs</code> zu überschreiben. Verwenden Sie dafür das <wipeLink>Format / Wipe Physical Disk</wipeLink> Tool."
]
},
"troubleshoot": {
"heading": "Fehlerbehebung",
"unprivTitle": "\"Kann nicht mit einem unprivilegierten Container fortfahren\"",
"unprivBody": "Sie haben die Konvertierung abgelehnt; das Skript wurde daher ohne Änderungen beendet. Um fortzufahren, führen Sie es erneut aus und stimmen zu: Das Skript stoppt den Container, sichert seine Konfiguration in <code>/etc/pve/lxc/&lt;CTID&gt;.conf.bak</code> und ersetzt <code>unprivileged: 1</code> durch <code>unprivileged: 0</code>. Diese Änderung allein wandelt die UID-/GID-Eigentümer vorhandener Dateien nicht um; sichern Sie den Container daher vorher und passen Sie die Eigentümer an. Alternativ stellen Sie ihn privilegiert wieder her oder erstellen ihn neu.",
"permsTitle": "Berechtigungen im Container sind falsch",
"permsBody": "Beim Einhängen in einen privilegierten Container bleiben vorhandene Dateieigentümer erhalten; ein neues Dateisystem gehört häufig <code>root:root</code>. Läuft der Dienst unter einem anderen Benutzer, etwa <code>www-data</code> für Nextcloud, prüfen Sie dessen UID/GID und passen Sie die nötigen Dateien mit <code>chown</code>/<code>chmod</code> an. Dies verändert auch den zugrunde liegenden Datenträger."
},
"related": {
"heading": "Verwandte Themen",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Datenträger in VM importieren",
"tail": " — entsprechender Ablauf für VMs."
},
{
"href": "/docs/storage-share/lxc-mount-points",
"label": "LXC-Einhängepunkte (Host ↔ CT)",
"tail": "- Hostverzeichnisse mit einem CT teilen, anstatt eine ganze Festplatte anzuhängen."
},
{
"href": "/docs/help-info/vm-ct-commands",
"label": "VM und CT Verwaltungsbefehle",
"tail": "- pct config / push / pull Referenz."
},
{
"href": "/docs/disk-manager",
"label": "Übersicht Disk Manager",
"tail": "."
}
]
}
}
@@ -0,0 +1,113 @@
{
"meta": {
"title": "Datenträger zu VM importieren | ProxMenux Dokumentation",
"description": "Befestigen Sie eine physische Festplatte an eine vorhandene Proxmox VM mit ProxMenux. Sichere Festplattenerkennung (ausgenommen System, montiert, in Gebrauch, ZFS/RAID/LVM), persistente /dev/disk/by-id-Pfade und SATA / SCSI / VirtIO / IDE-Schnittstellen.",
"ogTitle": "Datenträger zu VM importieren | ProxMenux Dokumentation",
"ogDescription": "Befestigen Sie eine physische Festplatte an eine vorhandene Proxmox VM. Verwendet persistente /dev/disk/by-id-Pfade und unterstützt SATA / SCSI / VirtIO / IDE."
},
"header": {
"title": "Datenträger in VM importieren",
"description": "Weisen Sie einer vorhandenen VM ein physisches Laufwerk des Proxmox-Hosts zu. ProxMenux erkennt freie Laufwerke, lässt Sie Ziel-VM und Bustyp (SATA/SCSI/VirtIO/IDE) wählen und verwendet persistente /dev/disk/by-id-Pfade. So bleibt die Zuordnung bei Neustarts und geänderter Gerätereihenfolge bestehen.",
"section": "Datenträgerverwaltung · VM"
},
"intro": {
"title": "Was das macht",
"body": "Ein physisches Laufwerk wird als Backend einer virtuellen Laufwerksschnittstelle zugewiesen. Der Gast erhält nicht automatisch native SMART-Daten oder Funktionen des physischen Controllers; dafür ist Controller-PCI-Passthrough geeignet. Das Laufwerk wird, falls vorhanden, über seinen Pfad <code>/dev/disk/by-id/…</code> zugewiesen, sodass eine geänderte Gerätereihenfolge beim Start die Zuordnung nicht unterbricht; andernfalls wird <code>/dev/sdX</code> verwendet."
},
"howRuns": {
"heading": "Wie das Skript läuft",
"body": "Der Fluss hat zwei Phasen mit klarer Trennung zwischen \"Sammeln von Informationen und Entscheidungen\" und \"tatsächliches Anbringen von Festplatten am VM\". Bis zur endgültigen Bestätigung bleibt die VM-Konfiguration unberührt.",
"summary": "ProxMenux blendet unsichere Kandidaten aus: Root-Laufwerk, auf dem Host eingehängte Laufwerke, aktive ZFS-/LVM-/RAID-Mitglieder und bereits in VM-/LXC-Konfigurationen referenzierte Laufwerke. Laufwerke mit <em>alten</em>, nicht mehr verwendeten ZFS-/RAID-/LVM-Metadaten erscheinen mit ⚠, werden aber nicht gesperrt."
},
"prereqs": {
"heading": "Voraussetzungen",
"items": [
"Mindestens ein VM, der auf dem Host definiert ist (das Skript wird direkt an <code>qm list</code> gesendet).",
"Die <strong>Ziel-VM ist ausgeschaltet</strong>. Läuft sie, bricht das Skript mit einer Meldung ab; das Hinzufügen im laufenden Betrieb ist nicht Teil dieses Ablaufs.",
"Mindestens eine physische Festplatte auf dem Host, die nicht vom Host oder einem anderen Gast verwendet wird."
]
},
"steps": {
"heading": "Schritt für Schritt",
"stepLabel": "Schritt",
"list": [
{
"title": "Ziel-VM auswählen",
"bodyRich": "ProxMenux listet alle VMs auf dem Host über <code>qm list</code> auf. Wählen Sie die VM für das Laufwerk. Läuft sie, bricht das Skript ab und fordert Sie auf, sie zuerst herunterzufahren."
},
{
"title": "Wählen Sie die physische Festplatte(n) zum Anbringen",
"img": "/disk/disk-selection.png",
"caption": "Freie Festplatten auf dem Host erkannt (mit ⚠ Labels für veraltete Metadaten)",
"body": "Das Skript scannt jede Host-Disk und zeigt nur diejenigen an, die sicher angehängt werden können. Mit der Checkliste können Sie eine oder mehrere auf einmal auswählen. Disks mit alten ZFS / LVM / RAID-Signaturen werden immer noch angezeigt, gekennzeichnet mit ⚠, so dass Sie wissen, dass sie ein Wischen benötigen, bevor der Gast sie formatieren kann."
},
{
"title": "Wählen Sie die Bus-Schnittstelle",
"img": "/disk/disk-assigment.png",
"caption": "Auswahl der Busschnittstellen",
"intro": "Wählen Sie aus, wie der Gast die Festplatte sehen soll:",
"items": [
"<strong>SCSI</strong> – moderner Standard für Linux und Windows mit installierten VirtIO-SCSI-Treibern.",
"<strong>SATA</strong> — breite Kompatibilität, funktioniert out of the box auf praktisch jedem Gast.",
"<strong>VirtIO</strong>: effizientes paravirtualisiertes Blockgerät; benötigt Gasttreiber.",
"<strong>IDE</strong>: für ältere Gäste ohne einen der oben genannten Treiber."
]
},
{
"title": "Zuweisen und prüfen",
"bodyRich": "ProxMenux verbindet jede ausgewählte Festplatte mit dem besten <code>/dev/disk/by-id/</code>-Pfad, überspringt Slot-Indizes, die bereits in der VM-Konfiguration verwendet werden (<code>scsi0</code>, <code>sata0</code>, ...) und liest die Konfiguration erneut, um die Zuordnung zu bestätigen. Am Ende wird eine Zusammenfassung gedruckt."
}
]
},
"manual": {
"heading": "Manuelles Äquivalent",
"body": "Das Skript ist ein Wrapper um <code>qm set</code>. Der genaue Befehl für eine einzelne Festplatte sieht so aus:",
"migrationTitle": "Live Migration ist nicht möglich",
"migrationBody": "Eine VM mit einem direkt zugewiesenen physischen Laufwerk ist <strong>an den Host gebunden, der dieses bereitstellt</strong>. Ein anderer Knoten hat normalerweise weder denselben Pfad <code>/dev/disk/by-id/…</code> noch dessen Daten. Sichern und übertragen Sie diese separat oder verwenden Sie verwaltete virtuelle Laufwerke auf gemeinsamem oder unterstützt repliziertem Speicher. Gehen Sie nicht davon aus, dass Proxmox-Speicherreplikation dieses Gerät umfasst.",
"shareTitle": "Teilen Sie keine physische Festplatte zwischen VMs",
"shareBody": "Wenn Sie dieselbe physische Festplatte gleichzeitig an zwei VMs anbringen, werden die Daten beim nächsten Schreiben beschädigt. ProxMenux erkennt diese Situation und blockiert sie, aber wenn Sie das Skript umgehen (direktes <code>qm set</code>), stellen Sie sicher, dass nur ein Gast jemals die Festplatte mountet."
},
"troubleshoot": {
"heading": "Fehlerbehebung",
"noDisksTitle": "\"Für diesen VM sind keine Festplatten verfügbar\"",
"noDisksIntro": "Das Skript fand Festplatten, aber jeder Kandidat wurde herausgefiltert. Häufige Gründe:",
"noDisksItems": [
"Jede verbleibende Festplatte wird bereits in der Konfiguration des Ziels VM referenziert.",
"Jede verbleibende Festplatte wird auf dem Host montiert oder ist Teil eines aktiven ZFS / LVM / RAID.",
"Der Host hat nur die Root Disk installiert."
],
"noDisksOutro": "Führen Sie <code>lsblk -f</code> auf dem Host aus, um den Status jeder Festplatte zu überprüfen.",
"noVisibleTitle": "VM sieht die Festplatte nach dem Booten nicht",
"noVisibleBody": "Bei <strong>SCSI</strong> oder <strong>VirtIO</strong> benötigt der Gast den passenden Treiber. Linux bringt ihn im Kernel mit; unter Windows installieren Sie ihn von der VirtIO-ISO (siehe <winLink>VM erstellen: Windows</winLink>). SATA auf der Hardware-Registerkarte der VM ist ein schneller Test, ob das Laufwerk zugewiesen ist."
},
"related": {
"heading": "Verwandte Themen",
"items": [
{
"href": "/docs/disk-manager/import-disk-image-vm",
"label": "Disk-Image in VM importieren",
"tail": " — derselbe Ablauf für Disk-Image-Dateien (qcow2 / vmdk / raw / img)."
},
{
"href": "/docs/disk-manager/import-disk-lxc",
"label": "Datenträger in LXC importieren",
"tail": " — entsprechender Ablauf für LXC-Container."
},
{
"href": "/docs/disk-manager/add-controller-nvme-vm",
"label": "Controller oder NVMe zu VM hinzufügen",
"tail": "- wenn Sie einen vollständigen PCIe / NVMe-Durchgang anstelle eines Festplattenanschlusses benötigen."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Speicher- und Festplattenbefehle",
"tail": "qm importdisk und zugehörige Shell-Referenz."
},
{
"href": "/docs/disk-manager",
"label": "Übersicht Disk Manager",
"tail": "."
}
]
}
}
@@ -0,0 +1,135 @@
{
"meta": {
"title": "Proxmox-Datenträgerverwaltung: VM/LXC-Zuweisung, SMART-Tests, Löschen | ProxMenux",
"description": "Verwalten Sie physische Laufwerke auf einem Proxmox-VE-Host mit ProxMenux: Laufwerke VMs oder LXC zuweisen (qm set scsi/sata/virtio, pct mp), img-/qcow2-/vmdk-/raw-Images importieren, ganze HBAs oder NVMe-Controller durchreichen, Laufwerke mit Sicherheitsprüfungen löschen und SMART-Selbsttests ausführen.",
"ogTitle": "Proxmox-Datenträgerverwaltung: VM/LXC-Zuweisung, SMART-Tests, Löschen",
"ogDescription": "Laufwerke VMs/LXC zuweisen, Images importieren, Controller per PCI durchreichen, Laufwerke sicher bedienen und SMART-Tests auf Proxmox VE ausführen.",
"twitterTitle": "Proxmox-Datenträgerverwaltung | ProxMenux",
"twitterDescription": "Laufwerke VMs/LXC zuweisen, Images importieren, PCI-Passthrough, Löschen mit Sicherheitsprüfungen und SMART-Tests."
},
"header": {
"title": "Festplattenmanager",
"description": "Das Menü Datenträgerverwaltung bündelt ProxMenux-Werkzeuge für physische Laufwerke auf einem Proxmox-Host: Zuweisung an VMs und LXC, Import von Disk-Images, Passthrough ganzer Controller oder NVMe-Geräte, Löschen mit Sicherheitsprüfungen und SMART-Tests.",
"section": "Festplattenmanager"
},
"intro": {
"title": "Wofür dieses Menü ist",
"body": "Diese Werkzeuge arbeiten mit <strong>für den Proxmox-Host sichtbaren physischen Laufwerken und dort gespeicherten Image-Dateien</strong>. Es gibt drei Gruppen: <strong>VM</strong> (Laufwerke zuweisen oder Images importieren), <strong>LXC</strong> (Laufwerke an Container anbinden) und <strong>Dienstprogramme</strong> (Formatierung und SMART-Status). Zuweisung und Löschen blenden Systemlaufwerke und belegte Laufwerke aus oder sperren sie; SMART-Prüfungen können sie ohne Löschen untersuchen."
},
"opening": {
"heading": "Öffnen des Menüs",
"body": "Wählen Sie im Hauptmenü von ProxMenux <strong>Disk Manager</strong>. Sie werden sehen:",
"imageAlt": "Disk Manager Menü mit VM, LXC und Utilities Blöcken"
},
"groups": {
"heading": "Drei Werkzeuggruppen",
"intro": "Das Disk Manager-Menü ist in drei Gruppen unterteilt: <strong>VM</strong>, <strong>LXC</strong> und <strong>Utilities</strong>. Klicken Sie auf eine Karte, um direkt zu den Werkzeugen in dieser Gruppe zu springen.",
"vmTitle": "VM",
"vmBody": "Tools, die auf vorhandenen virtuellen Maschinen arbeiten. Der VM muss ausgeschaltet werden; ProxMenux validiert dies, bevor er die Konfiguration berührt.",
"vmItems": [
"Datenträger in VM importieren",
"Disk-Image in VM importieren",
"Controller oder NVMe zu VM hinzufügen"
],
"lxcTitle": "LXC",
"lxcBody": "Werkzeuge für bestehende LXC-Container. Dieses Skript benötigt einen privilegierten Container und bietet bei Bedarf die Änderung der Einstellung an. Lesen Sie zuerst die Hinweise zur Konvertierung und zu Dateieigentümern auf der Werkzeugseite.",
"lxcItems": [
"Datenträger in LXC importieren"
],
"utilitiesTitle": "Dienstprogramme",
"utilitiesBody": "Hostseitige Tools, die auf den Festplatten selbst arbeiten, unabhängig von VM oder Containern.",
"utilitiesItems": [
"Physischen Datenträger formatieren / löschen",
"SMART-Festplattenstatus und -test"
]
},
"vm": {
"heading": "VM",
"intro": "Tools, die auf vorhandenen virtuellen Maschinen arbeiten. Der VM muss ausgeschaltet werden; ProxMenux validiert dies, bevor er die Konfiguration berührt.",
"options": [
{
"icon": "HardDrive",
"href": "/docs/disk-manager/import-disk-vm",
"title": "Datenträger in VM importieren",
"description": "Befestigen Sie eine nicht zugewiesene physische Festplatte an eine vorhandene VM. Unterstützt SATA / SCSI / VirtIO / IDE, verwendet persistente /dev/disk/by-id-Pfade."
},
{
"icon": "FileDown",
"href": "/docs/disk-manager/import-disk-image-vm",
"title": "Disk-Image in VM importieren",
"description": "Importieren Sie Disk-Image-Dateien (.img / .qcow2 / .vmdk / .raw) in eine vorhandene VM. Zweiphasiger Ablauf mit qm importdisk im Hintergrund."
},
{
"icon": "Cpu",
"href": "/docs/disk-manager/add-controller-nvme-vm",
"title": "Controller oder NVMe zu VM hinzufügen",
"description": "PCI-Durchgang eines ganzen SATA / SAS HBA- oder NVMe-Geräts zu einem VM. Behandelt IOMMU Enablement und Konflikterkennung."
}
]
},
"lxc": {
"heading": "LXC",
"intro": "Werkzeuge für bestehende LXC-Container. Dieses Skript benötigt einen privilegierten Container und bietet bei Bedarf die Änderung der Einstellung an. Lesen Sie zuerst die Hinweise zur Konvertierung und zu Dateieigentümern auf der Werkzeugseite.",
"options": [
{
"icon": "Boxes",
"href": "/docs/disk-manager/import-disk-lxc",
"title": "Datenträger in LXC importieren",
"description": "Befestigen Sie eine nicht zugewiesene physische Festplatte an einem vorhandenen LXC-Container als Montagepunkt. Behandelt Dateisystemerkennung / Format und privilegierte Konvertierung."
}
]
},
"utilities": {
"heading": "Dienstprogramme",
"intro": "Hostseitige Tools, die auf den Festplatten selbst arbeiten, unabhängig von VM oder Containern.",
"options": [
{
"icon": "Eraser",
"href": "/docs/disk-manager/format-disk",
"title": "Physische Festplatte formatieren/löschen (sicher)",
"description": "Laufwerke mit strengen Sicherheitskontrollen löschen: Nur vollständig freie Laufwerke werden angezeigt, und eine doppelte Bestätigung ist immer erforderlich."
},
{
"icon": "Activity",
"href": "/docs/disk-manager/smart-disk-test",
"title": "SMART-Festplattenstatus und -test",
"description": "Führen Sie SMART Gesundheitschecks und kurze / lange Selbsttests auf SATA-, SAS- und NVMe-Laufwerken durch. Exportiert JSON für den Monitor."
}
]
},
"safety": {
"title": "Sicherheitsregeln für Laufwerkszuweisung und Löschen",
"intro": "Zuweisungs- und Löschvorgänge filtern Geräte aus, die den Host gefährden könnten:",
"items": [
"Das <strong>Systemlaufwerk</strong> sowie Root-Pool, Swap und aktive ZFS-/LVM-/RAID-Mitglieder bleiben ausgeblendet.",
"Auf dem Host <strong>eingehängte</strong> Laufwerke werden ausgeblendet oder bei der Ausführung gesperrt.",
"Datenträger <strong>, auf die mit einem laufenden VM oder LXC</strong> verwiesen wird, können nicht neu zugewiesen oder gelöscht werden.",
"Operationen, die den Host-Status ändern können (IOMMU enable, Wipe) erfordern eine explizite Bestätigung."
]
},
"related": {
"heading": "Verwandte Themen",
"items": [
{
"href": "/docs/storage-share",
"label": "Speicher- und Freigabemanager",
"tail": "- registrieren Sie den Speicher in Proxmox selbst (NFS / Samba / iSCSI / local) und teilen Sie Ordner zwischen Host und CTs."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Speicher- und Festplattenbefehle",
"tail": "— Blockgeräte, LVM, pvesm, SMART Referenz."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "ZFS Verwaltungsbefehle",
"tail": "— für ZFS-Pools und Datensätze."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "GPU zu VM hinzufügen (Passthrough)",
"tail": "- die gleichen IOMMU / VFIO-Konzepte für GPUs."
}
]
}
}
@@ -0,0 +1,146 @@
{
"meta": {
"title": "SMART-Laufwerksstatus und Tests | ProxMenux-Dokumentation",
"description": "Führen Sie SMART-Gesundheitsprüfungen und Festplattentests auf Proxmox VE mit ProxMenux aus. Unterstützt SATA / SAS (smartmontools) und NVMe (nvme-cli). Kurze und lange Selbsttests, JSON Export für ProxMenux Monitor Integration.",
"ogTitle": "SMART-Laufwerksstatus und Tests | ProxMenux-Dokumentation",
"ogDescription": "SMART Gesundheitschecks und Selbsttests für SATA / SAS und NVMe Laufwerke auf Proxmox. JSON Export für den Monitor."
},
"header": {
"title": "SMART-Festplattenstatus und -test",
"description": "Lesen Sie SMART-Daten und lösen Sie Selbsttests auf den physischen Festplatten aus, die an den Proxmox-Host angeschlossen sind. ProxMenux installiert automatisch Smartmontools für SATA / SAS und nvme-cli für NVMe, führt die Aktion innerhalb der Laufwerk-Firmware aus (lange Tests überleben Terminalschluss) und exportiert JSON-Ergebnisse für den ProxMenux Monitor.",
"section": "Disk Manager · Dienstprogramme"
},
"intro": {
"title": "Wofür das ist",
"body": "SMART (Self-Monitoring, Analysis and Reporting Technology) ermöglicht es dem Laufwerk selbst, seinen Zustand zu melden und Selbsttests durchzuführen. Dieses Tool stellt diese Daten frei, ohne dass Sie sich die richtige <code>smartctl</code>/<code>nvme</code>-Aufrufung merken müssen, und behält die Ausgabe als JSON, so dass der Monitor Trends im Laufe der Zeit zeichnen kann."
},
"howRuns": {
"heading": "Wie das Skript läuft",
"body": "Alle Aktionen hier sind zerstörungsfrei - SMART liest die Laufwerk-Firmware-Zähler, und Selbsttests werden innerhalb des Laufwerks selbst in die Warteschlange gestellt. Es ist keine Phasentrennung erforderlich. Der Ablauf ist: Abhängigkeitsprüfung → Festplattenauswahl → Aktionsauswahl → Werkzeugaufruf (smartctl oder nvme-cli abhängig vom Festplattenbus) → gedruckte Ausgabe plus JSON Export für den Monitor."
},
"deps": {
"heading": "Abhängigkeiten",
"body": "Das Tool installiert automatisch, was es beim ersten Durchlauf benötigt. SATA / SAS-Laufwerke verlassen sich auf <code>smartmontools</code>; NVMe-Laufwerke verlassen sich auf <code>nvme-cli</code>. Beide:"
},
"actions": {
"heading": "Verfügbare Maßnahmen",
"headerAction": "Aktion",
"headerWhat": "Was gelesen oder ausgeführt wird",
"headerDur": "Dauer",
"rows": [
{
"action": "Schneller Gesundheitszustand",
"whatRich": "Insgesamt PASSED/FAILED + Schlüsselattribute.<br /><code>smartctl -H</code> + <code>-A</code> (SATA/SAS) oder <code>nvme smart-log</code> (NVMe).",
"dur": "Sofort"
},
{
"action": "Vollständiger Bericht",
"whatRich": "Vollständige SMART-Daten, scrollbar. <code>smartctl -x</code> für SATA/SAS oder <code>nvme smart-log</code> + <code>id-ctrl</code> für NVMe.",
"dur": "Sofort"
},
{
"action": "Kurztest",
"what": "Grundlegende Oberfläche und elektrische Überprüfung, in der Warteschlange innerhalb der Firmware des Laufwerks.",
"dur": "~2 Minuten"
},
{
"action": "Lange Prüfung",
"what": "Vollständiger Scan der gesamten Oberfläche. Läuft auf der Laufwerk-Hardware - bleibt bestehen, auch wenn Sie das Terminal schließen.",
"dur": "Stunden (abhängig von der Laufwerksgröße)"
},
{
"action": "Testfortschritt prüfen",
"what": "Status des aktiven oder letzten Selbsttests.",
"dur": "Sofort"
}
],
"tipTitle": "Lange Tests laufen nach dem Schließen des Terminals weiter",
"tipBody": "Ein langer Test läuft <em>im Laufwerk</em> und benötigt keinen weiterlaufenden ProxMenux-Prozess. Schließen Sie das Terminal und verwenden Sie später <strong>Testfortschritt prüfen</strong>. Ein Host-Neustart, Controller-Reset oder Stromausfall kann den Test und die Ergebniserfassung unterbrechen; eine automatische Fortsetzung ist nicht garantiert."
},
"json": {
"heading": "JSON Export für den Monitor",
"intro": "Status-, Kurztest- und Fortschrittsaktionen schreiben eine JSON-Datei mit Zeitstempel nach <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code>; Langtestergebnisse werden im Hintergrund erfasst. Der vollständige Bericht wird nur angezeigt. Die Struktur ist:",
"outro": "ProxMenux Monitor liest diese Dateien zur Darstellung von Zustandstrends je Laufwerk. Beim Erreichen der Aufbewahrungsgrenze werden alte Dateien automatisch entfernt."
},
"steps": {
"heading": "Schritt für Schritt",
"stepLabel": "Schritt",
"list": [
{
"title": "Laufwerk auswählen",
"body": "ProxMenux listet jede physische Festplatte auf dem Host mit ihrem Modell und ihrer Größe auf. Im Gegensatz zum Format-Tool wird diese Liste nicht durch die Sicherheit gefiltert - das Lesen von SMART ist eine zerstörungsfreie Operation.",
"img": "/disk/smart/disk-selection.png",
"alt": "SMART Plattenauswahlmenü",
"caption": "SMART Plattenauswahlmenü"
},
{
"title": "Wählen Sie eine Aktion",
"body": "Wählen Sie schnellen Status, vollständigen Bericht, Kurztest, Langtest oder Testfortschritt. Das Menü bleibt nach jeder Aktion offen, sodass Sie mehrere Abfragen desselben Laufwerks ausführen können.",
"img": "/disk/smart/action-menu.png",
"alt": "SMART Aktionsmenü",
"caption": "SMART Aktionsmenü (5 Aktionen + Abbruch)"
},
{
"title": "(Nur langer Test) Hintergrundausführung bestätigen",
"body": "ProxMenux weist darauf hin, dass der Test nach dem Schließen des Terminals weiterläuft, und zeigt den Speicherort der JSON-Ergebnisse. Bestätigen Sie, um den Test zu starten.",
"img": "/disk/smart/long-test-warning.png",
"alt": "Dialog über lange Testbestätigung",
"caption": "Lange Testbestätigung – läuft im Hintergrund, Ergebnis wird in JSON gespeichert"
},
{
"title": "Prüfergebnisse",
"bodyRich": "Status-, Test- und Fortschrittsausgaben erscheinen im Terminal; <strong>Vollständiger Bericht</strong> öffnet sich in einem scrollbaren Dialog. JSON wird für die oben genannten Aktionen exportiert, nicht für den vollständigen Bericht. Verwenden Sie bei Langtests später <strong>Testfortschritt prüfen</strong> für dasselbe Laufwerk.",
"img": "/disk/smart/quick-status.png",
"alt": "Schnelle Ausgabe des Gesundheitszustands",
"caption": "Schnelle Ausgabe des Gesundheitszustands (SATA — smartctl -H + -A)"
}
]
},
"manual": {
"heading": "Manuelle Äquivalente",
"nvmeWarnTitle": "NVMe Selbsttests sind Laufwerk-Firmware abhängig",
"nvmeWarnBody": "Nicht jedes NVMe-Laufwerk unterstützt den kurzen / langen Selbsttestbefehl. Wenn ein Laufwerk den Test ablehnt, sind das SMART-Protokoll und die ID-Controllerdaten (<code>nvme smart-log</code> + <code>id-ctrl</code>) immer noch das zuverlässigste Gesundheitssignal."
},
"troubleshoot": {
"heading": "Fehlerbehebung",
"noSmartTitle": "\"Konnte SMART-Daten aus /dev/sdX nicht lesen\"",
"noSmartBody": "Die Festplatte befindet sich wahrscheinlich hinter einem RAID / SAS-Controller, der SMART nicht durchläuft. Versuchen Sie mit Megaraid-basierten Karten <code>smartctl -d megaraid,N /dev/sdX</code>. Für HBAs im IT-Modus funktioniert der direkte Aufruf.",
"longTitle": "Langer Test nie abgeschlossen",
"longBody": "Der Test läuft in der Laufwerksfirmware; hohe E/A-Last kann ihn verzögern. Nutzen Sie eine ruhige Zeit, etwa nachts. Bei SATA zeigt <code>smartctl -c</code> den verbleibenden Prozentsatz, bei SAS <code>smartctl -l selftest</code>; das Selbsttestprotokoll zeigt Abschlussstatus und gegebenenfalls fehlerhafte LBAs. Lesefehler müssen untersucht werden; langsamer Fortschritt allein beweist keinen defekten Sektor."
},
"related": {
"heading": "Verwandte Themen",
"items": [
{
"href": "/docs/disk-manager/format-disk",
"label": "Physischen Datenträger formatieren / löschen",
"tail": "Wiederverwendung einer Festplatte, nachdem bestätigt wurde, dass sie gesund ist."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Speicher- und Laufwerksbefehle → SMART-Laufwerksstatus",
"tail": "Referenz smartctl/nvme."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "ZFS Verwaltungsbefehle",
"tail": " — zpool scrub prüft ZFS-Datenprüfsummen und ergänzt SMART-Hardwaretests."
},
{
"href": "/docs/monitor/dashboard/storage",
"label": "ProxMenux Monitor — Speicherregister",
"tail": " — Laufwerksdetailansicht mit den hier exportierten JSON-Daten: vollständige SMART-Tabelle, Verlauf und PDF-Bericht."
},
{
"href": "/docs/monitor/dashboard/hardware",
"label": "ProxMenux Monitor — Register Hardware",
"tail": "Speicherzusammenfassung mit Modell, Kapazität und ausgehandelter Verbindungsgeschwindigkeit (aktuell vs. maximal auf NVMe)."
},
{
"href": "/docs/disk-manager",
"label": "Übersicht Disk Manager",
"tail": "."
}
]
}
}
@@ -20,7 +20,7 @@
},
"iommu": {
"heading": "IOMMU groups — why the whole card leaves at once",
"body": "PCI passthrough is done per <strong>IOMMU group</strong>, which is the smallest unit the CPU's IOMMU can isolate. Everything inside a group moves together. If your SATA controller shares its IOMMU group with the USB controller, passing the SATA card to a VM also takes the USB ports with it — often undesirable.",
"body": "The isolation boundary for PCI passthrough is the <strong>IOMMU group</strong>, the smallest unit the CPU’s IOMMU can isolate. Devices in the same group cannot be isolated from each other. If a SATA controller shares its group with a USB controller, passing through SATA may also require releasing USB from the host, or may prevent passthrough. It does not automatically assign every device in the group to the VM.",
"outro": "ProxMenux shows the IOMMU group next to each device and warns you when a group carries more than just the controller you want. You can still proceed if the extra devices in the group are acceptable (all disk controllers, for example), or back out if they are not."
},
"prereqs": {
@@ -97,7 +97,7 @@
"busyBody": "Another process still holds the PCI device. Most common causes: a previous VM that crashed without releasing it, or the host kernel reclaimed it on the last boot. Run <code>lspci -nnk -s &lt;addr&gt;</code> to see which driver is bound; it should be <code>vfio-pci</code>. A full host reboot usually clears this.",
"noDisksTitle": "Guest sees the controller but not the disks",
"noDisksBody": "The controller model lacks an in-guest driver. Linux almost never hits this; Windows does — install the vendor driver (e.g. LSI / Broadcom for older SAS HBAs) while the card is detached, then reboot with the card attached.",
"sharedTitle": "Shared IOMMU group also exports an unrelated device",
"sharedTitle": "The IOMMU group includes an unrelated device",
"sharedBody": "Options: (a) move the card to a different PCIe slot to change its group, (b) enable <em>ACS override</em> in the kernel to split groups (security trade-off — research before applying), or (c) pick a different card in a cleaner group."
},
"related": {
@@ -46,19 +46,19 @@
"mode": "1. Wipe all",
"part": "Destroyed",
"data": "Signatures wiped",
"useCase": "Starting fresh: everything on the disk goes, ready for a new layout."
"useCase": "Removes the partition table and the filesystem and RAID metadata, zeroes the first and last 16 MiB and, on drives that support discard, trims the whole disk. The rest of the data is not overwritten and may still be recoverable on HDDs; this is not a secure erase."
},
{
"mode": "2. Remove FS labels",
"part": "Preserved",
"data": "Preserved",
"useCase": "Clears stale ZFS / LVM / RAID signatures so the disk stops being auto-claimed, without touching the data."
"useCase": "Removes stale ZFS / LVM / RAID signatures so the disk is no longer auto-claimed. Bulk user data is not overwritten, but removing signatures can make it inaccessible."
},
{
"mode": "3. Zero all data",
"part": "Preserved",
"data": "Destroyed (zeroed)",
"useCase": "Sanitise before handing the disk over, keeping the existing partition layout."
"useCase": "Overwrite the existing partitions with zeros while keeping the partition table. Unallocated space and SSD spare areas are not covered; this is not a complete device sanitization guarantee."
},
{
"mode": "4. Full format",
@@ -52,7 +52,7 @@
"intro": "For every selected image ProxMenux asks:",
"items": [
"<strong>Interface</strong> — <code>scsi</code> (default), <code>virtio</code>, <code>sata</code> or <code>ide</code>. Matches how the guest will see the disk.",
"<strong>SSD emulation</strong> — only offered for non-VirtIO interfaces. Adds <code>ssd=1</code> so the guest advertises the disk as solid-state (useful for OS-level TRIM / alignment).",
"<strong>SSD emulation</strong> — only offered for non-VirtIO interfaces. Adds <code>ssd=1</code> so the guest recognizes a solid-state disk. Discard/TRIM support must be configured separately.",
"<strong>Bootable</strong> — if yes, ProxMenux adds the disk to the boot order so it becomes the primary boot device of the VM."
]
},
@@ -73,7 +73,7 @@
"noImagesTitle": "\"No compatible disk images found\"",
"noImagesBody": "The script scanned the directory but found no <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code> file. Check the extension (case matters), that the file sits directly in the selected directory (no sub-directories are searched) and that permissions allow root to read it.",
"slowTitle": "Import is slow",
"slowBody": "VMDK → QCOW2 → raw conversions are CPU- and I/O-bound. Import speed depends on the source read speed, the target storage write speed and CPU for decompression. Prefer raw or qcow2 sources when possible.",
"slowBody": "Conversions between VMDK, QCOW2 and raw can be limited by CPU and I/O. Import speed depends on source reads, target writes and any decompression work. Prefer raw or qcow2 sources when possible.",
"uefiTitle": "Imported disk boots into UEFI shell",
"uefiBody": "The image was built for legacy (SeaBIOS) but the VM uses OVMF (or vice versa). Either switch the VM's BIOS in Proxmox to match the image, or rebuild the image in the correct mode before importing."
},
@@ -27,7 +27,7 @@
"At least one physical disk not in use by the host or any other guest."
],
"warnTitle": "Privileged container required",
"warnBody": "Direct device passthrough to an LXC container only works if the container is <strong>privileged</strong>. If the script detects <code>unprivileged: 1</code> in the config it offers to convert it in place (edits <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code>). Cancel if you cannot accept the security trade-off of a privileged container."
"warnBody": "This script requires a <strong>privileged</strong> container for its direct disk attachment. If it detects <code>unprivileged: 1</code>, it offers to edit <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code> in place. This changes the security model and does not remap existing file ownership. Back up the container and verify ownership before accepting, or rebuild it as privileged."
},
"steps": {
"heading": "Step-by-step",
@@ -83,9 +83,9 @@
"troubleshoot": {
"heading": "Troubleshooting",
"unprivTitle": "\"Cannot continue with an unprivileged container\"",
"unprivBody": "You declined the conversion offer. Either re-run and accept the conversion, or convert the container manually by editing <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code> and replacing <code>unprivileged: 1</code> with <code>unprivileged: 0</code>. You can also rebuild the container as privileged if you prefer not to convert in place.",
"unprivBody": "You declined the conversion, so the script stopped without changing anything. To continue, run it again and accept: the script stops the container, backs up its configuration to <code>/etc/pve/lxc/&lt;CTID&gt;.conf.bak</code> and replaces <code>unprivileged: 1</code> with <code>unprivileged: 0</code>. That flag change alone does not convert the UID/GID ownership of existing files, so back up the container and fix the ownership first; alternatively, restore or rebuild the container as privileged.",
"permsTitle": "Permissions inside the container are wrong",
"permsBody": "Mounts from the host into a privileged container land as <code>root:root</code>. If the service inside the CT runs as a different user (e.g. <code>www-data</code> for Nextcloud), <code>chown</code>/<code>chmod</code> inside the container to match its UID/GID after the first mount."
"permsBody": "Existing file ownership is retained when a partition is mounted into a privileged container; a newly formatted filesystem is often owned by <code>root:root</code>. If the service runs as another user (e.g. <code>www-data</code> for Nextcloud), inspect its UID/GID and adjust the required files with <code>chown</code>/<code>chmod</code>. Changes also affect the underlying disk."
},
"related": {
"heading": "Related",
@@ -12,7 +12,7 @@
},
"intro": {
"title": "What this does",
"body": "This is a raw-disk passthrough: the guest OS sees the drive as a real block device (with its SMART data and native geometry). The disk is attached via its <code>/dev/disk/by-id/…</code> path — not <code>/dev/sdX</code> — so the assignment does not break if disk controllers enumerate devices in a different order on the next boot."
"body": "This attaches a raw physical disk as the backing device for a virtual disk interface. The guest does not automatically receive native SMART data or the physical controller’s features; use controller PCI passthrough when those are required. The disk is attached through its <code>/dev/disk/by-id/…</code> path when one exists, so a changed device enumeration order at boot does not break the assignment; otherwise <code>/dev/sdX</code> is used."
},
"howRuns": {
"heading": "How the script runs",
@@ -49,7 +49,7 @@
"items": [
"<strong>SCSI</strong> — modern default for Linux and Windows with VirtIO-SCSI drivers installed.",
"<strong>SATA</strong> — broad compatibility, works out of the box on virtually every guest.",
"<strong>VirtIO</strong> — paravirtualised block device, fastest but requires guest drivers.",
"<strong>VirtIO</strong> — efficient paravirtualised block device; requires guest drivers.",
"<strong>IDE</strong> — for legacy guests that lack any of the above drivers."
]
},
@@ -63,7 +63,7 @@
"heading": "Manual equivalent",
"body": "The script is a wrapper around <code>qm set</code>. The exact command for a single disk looks like this:",
"migrationTitle": "Live migration is not possible",
"migrationBody": "A VM with a passthrough disk is <strong>tied to the host that exposes that disk</strong>. Live migration to another Proxmox node will fail because the target node does not see the same <code>/dev/disk/by-id/…</code> path. Use replication or backup/restore instead, or pick virtual disks on shared storage if you need mobility.",
"migrationBody": "A VM with a physical passthrough disk is <strong>tied to the host that exposes that disk</strong>. Another node normally lacks the same <code>/dev/disk/by-id/…</code> path and disk data. Back up and transfer that data separately, or use managed virtual disks on shared or supported replicated storage for mobility; do not assume Proxmox storage replication covers this device.",
"shareTitle": "Do not share a physical disk between VMs",
"shareBody": "Attaching the same physical disk to two VMs at the same time will corrupt data on next write. ProxMenux detects this situation and blocks it, but if you bypass the script (direct <code>qm set</code>), make sure only one guest ever mounts the disk."
},
+6 -6
View File
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Proxmox Disk Manager — Attach Disks to VMs / LXC, SMART Tests, Wipe | ProxMenux",
"description": "Manage physical disks on a Proxmox VE host with ProxMenux: pass disks through to VMs or LXC containers (qm set scsi/sata/virtio, pct mp), import qcow2 / vmdk / vdi disk images, pass through whole HBAs or NVMe controllers, safely wipe disks and run SMART self-tests.",
"description": "Manage physical disks on a Proxmox VE host with ProxMenux: attach disks to VMs or LXC containers (qm set scsi/sata/virtio, pct mp), import img / qcow2 / vmdk / raw disk images, pass through whole HBAs or NVMe controllers, wipe disks with safety checks and run SMART self-tests.",
"ogTitle": "Proxmox Disk Manager — Attach Disks to VMs / LXC, SMART Tests, Wipe",
"ogDescription": "Attach disks to VMs / LXC, import disk images, PCI passthrough for controllers, safe wipe and SMART tests on Proxmox VE.",
"twitterTitle": "Proxmox Disk Manager | ProxMenux",
@@ -14,7 +14,7 @@
},
"intro": {
"title": "What this menu is for",
"body": "Every option here operates on <strong>physical disks already visible to the Proxmox host</strong>. The menu is split in three groups — <strong>VM</strong> (attach disks or import images into a virtual machine), <strong>LXC</strong> (attach disks to a container), and <strong>Utilities</strong> (safe format, SMART health). Safety checks apply everywhere: system disks and disks already in use are hidden or blocked."
"body": "These tools work with <strong>physical disks visible to the Proxmox host and image files stored on it</strong>. The menu has three groups: <strong>VM</strong> (attach disks or import images), <strong>LXC</strong> (attach disks to a container), and <strong>Utilities</strong> (formatting and SMART health). Attachment and wipe operations hide or block system disks and disks already in use; SMART checks can inspect those disks without wiping them."
},
"opening": {
"heading": "Opening the menu",
@@ -32,7 +32,7 @@
"Add Controller or NVMe to VM"
],
"lxcTitle": "LXC",
"lxcBody": "Tools that operate on existing containers. Direct device passthrough needs a privileged container; the script offers to convert it if necessary.",
"lxcBody": "Tools for existing LXC containers. This script requires a privileged container and offers to change the flag when needed. Read the conversion and file-ownership cautions on the tool page first.",
"lxcItems": [
"Import Disk to LXC"
],
@@ -69,7 +69,7 @@
},
"lxc": {
"heading": "LXC",
"intro": "Tools that operate on existing LXC containers. Direct device passthrough requires a privileged container; the script offers to convert the container if needed.",
"intro": "Tools for existing LXC containers. This script requires a privileged container and offers to change the flag when needed. Read the conversion and file-ownership cautions on the tool page first.",
"options": [
{
"icon": "Boxes",
@@ -98,8 +98,8 @@
]
},
"safety": {
"title": "Safety rules shared by every option",
"intro": "ProxMenux filters out anything that could harm the host:",
"title": "Safety rules for disk attachment and wiping",
"intro": "Attachment and wipe operations filter out devices that could harm the host:",
"items": [
"The <strong>system disk</strong> (root pool, swap, active ZFS / LVM / RAID members) is always hidden.",
"Disks <strong>mounted</strong> anywhere on the host are hidden or blocked at execution.",
@@ -55,11 +55,11 @@
}
],
"tipTitle": "Long tests survive terminal close",
"tipBody": "A long test is queued <em>inside the drive</em> — it does not depend on the ProxMenux process staying alive. You can close the terminal, reboot the Proxmox host (the test picks up where it left off on some drives) or just come back later and use <strong>Check test progress</strong> to see the result."
"tipBody": "A long test runs <em>inside the drive</em> and does not depend on the ProxMenux process staying alive. You can close the terminal and return later to <strong>Check test progress</strong>. A host reboot, controller reset or power loss may interrupt the test and its result collector; do not assume it will resume automatically."
},
"json": {
"heading": "JSON export for the Monitor",
"intro": "Every run writes a timestamped JSON file to <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code>. The structure is:",
"intro": "Status, short-test and progress actions write a timestamped JSON file to <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code>; long-test results are collected in the background. The full-report action only displays its report. The structure is:",
"outro": "The ProxMenux Monitor picks these up to render health trends per disk; old files are rotated out automatically once the retention limit is reached."
},
"steps": {
@@ -89,7 +89,7 @@
},
{
"title": "Review results",
"bodyRich": "Status and report are printed to the terminal and written to JSON. For long tests, return later and run <strong>Check test progress</strong> on the same disk to see the outcome.",
"bodyRich": "Status, test and progress output is shown in the terminal; <strong>Full report</strong> opens in a scrollable dialog. JSON is exported for the actions described above, not for Full report. For long tests, return later and run <strong>Check test progress</strong> on the same disk to see the outcome.",
"img": "/disk/smart/quick-status.png",
"alt": "Quick health status output",
"caption": "Quick health status output (SATA — smartctl -H + -A)"
@@ -106,7 +106,7 @@
"noSmartTitle": "\"Could not read SMART data from /dev/sdX\"",
"noSmartBody": "The disk is probably behind a RAID / SAS controller that does not pass SMART through. With megaraid-based cards, try <code>smartctl -d megaraid,N /dev/sdX</code>. For HBAs in IT mode the direct invocation works.",
"longTitle": "Long test never completes",
"longBody": "The test is queued on the drive firmware and pauses if the disk is under heavy load. Running it overnight on an idle system usually works. You can also check <code>smartctl -c</code> to see percentage remaining; if it is stuck at a fixed LBA, the disk is failing at that sector."
"longBody": "The drive runs the test in firmware, and heavy I/O can delay completion. Try an idle period such as overnight. For SATA, <code>smartctl -c</code> shows the remaining percentage, and for SAS, <code>smartctl -l selftest</code>; inspect the self-test log for completion status and any failing LBA. A reported read failure needs investigation; slow progress alone does not prove a bad sector."
},
"related": {
"heading": "Related",
@@ -124,7 +124,7 @@
{
"href": "/docs/help-info/zfs-commands",
"label": "ZFS Management commands",
"tail": " — zpool scrub for the storage-layer equivalent of SMART tests."
"tail": " — zpool scrub verifies ZFS data checksums and complements hardware SMART tests."
},
{
"href": "/docs/monitor/dashboard/storage",
@@ -1,14 +1,14 @@
{
"meta": {
"title": "Añadir controladora o NVMe a VM | ProxMenux Documentation",
"title": "Añadir controladora o NVMe a una VM | Documentación de ProxMenux",
"description": "PCI passthrough de una controladora de almacenamiento (HBA SATA / SAS) o un dispositivo NVMe a una VM Proxmox usando ProxMenux. Gestiona la habilitación de IOMMU, la detección de conflictos y el conexionado con qm set --hostpci.",
"ogTitle": "Añadir controladora o NVMe a VM | ProxMenux Documentation",
"ogTitle": "Añadir controladora o NVMe a una VM | Documentación de ProxMenux",
"ogDescription": "Pasa un HBA SATA / SAS entero o un dispositivo NVMe a una VM Proxmox. ProxMenux gestiona IOMMU, detección de conflictos y conexionado hostpci."
},
"header": {
"title": "Añadir controladora o NVMe a VM",
"description": "Pasa un host bus adapter (HBA) SATA / SAS entero o un dispositivo NVMe a una VM Proxmox mediante PCI passthrough. ProxMenux comprueba — y, con tu consentimiento, habilita — IOMMU, enumera los dispositivos elegibles para passthrough, filtra los conflictos y conecta la asignación con qm set --hostpci.",
"section": "Disk Manager · VM"
"section": "Administrador de discos · VM"
},
"intro": {
"title": "Qué hace (y qué no hace) esto",
@@ -20,7 +20,7 @@
},
"iommu": {
"heading": "Grupos IOMMU — por qué la tarjeta entera sale a la vez",
"body": "El PCI passthrough se hace por <strong>grupo IOMMU</strong>, que es la unidad más pequeña que el IOMMU de la CPU puede aislar. Todo lo que hay dentro de un grupo se mueve junto. Si tu controladora SATA comparte grupo IOMMU con la controladora USB, pasar la tarjeta SATA a una VM se lleva también los puertos USB — algo a menudo no deseado.",
"body": "El límite de aislamiento del passthrough PCI es el <strong>grupo IOMMU</strong>, la unidad más pequeña que puede aislar el IOMMU de la CPU. Los dispositivos del mismo grupo no pueden aislarse entre sí. Si una controladora SATA comparte grupo con una USB, pasar la SATA puede requerir liberar también la USB del host o impedir el passthrough. Esto no asigna automáticamente a la VM todos los dispositivos del grupo.",
"outro": "ProxMenux muestra el grupo IOMMU junto a cada dispositivo y te avisa cuando un grupo lleva algo más que la controladora que quieres. Aún así puedes continuar si los dispositivos extra del grupo son aceptables (todas controladoras de disco, por ejemplo), o echar atrás si no lo son."
},
"prereqs": {
@@ -54,8 +54,8 @@
],
"outro": "Es necesario reiniciar después de este cambio. El script te pide reiniciar ahora o más tarde; el passthrough no puede continuar hasta que la nueva cmdline del kernel esté activa.",
"img": "/disk/nvme-passthrough/iommu-warning.png",
"alt": "Diálogo IOMMU Required",
"caption": "IOMMU Required — propuesta de habilitar y reiniciar"
"alt": "Diálogo que indica que se requiere IOMMU",
"caption": "Se requiere IOMMU: propuesta de habilitarlo y reiniciar"
},
{
"title": "Enumeración de dispositivos",
@@ -97,7 +97,7 @@
"busyBody": "Otro proceso aún retiene el dispositivo PCI. Causas más comunes: una VM anterior que crasheó sin soltarlo, o el kernel del host lo recuperó en el último arranque. Ejecuta <code>lspci -nnk -s &lt;addr&gt;</code> para ver qué driver está vinculado; debería ser <code>vfio-pci</code>. Un reinicio completo del host suele resolverlo.",
"noDisksTitle": "El guest ve la controladora pero no los discos",
"noDisksBody": "El modelo de la controladora no tiene driver en el guest. Linux casi nunca tiene este problema; Windows sí — instala el driver del fabricante (p. ej. LSI / Broadcom para HBAs SAS antiguos) con la tarjeta desconectada y luego reinicia con la tarjeta adjuntada.",
"sharedTitle": "Grupo IOMMU compartido que exporta también un dispositivo no relacionado",
"sharedTitle": "El grupo IOMMU incluye un dispositivo no relacionado",
"sharedBody": "Opciones: (a) mover la tarjeta a un slot PCIe distinto para cambiar su grupo, (b) habilitar <em>ACS override</em> en el kernel para separar grupos (compromiso de seguridad — investiga antes de aplicarlo), o (c) elegir otra tarjeta en un grupo más limpio."
},
"related": {
@@ -1,8 +1,8 @@
{
"meta": {
"title": "Formatear / borrar disco físico | ProxMenux Documentation",
"title": "Formatear o borrar un disco físico | Documentación de ProxMenux",
"description": "Wipe seguro y formateo de disco físico en Proxmox VE usando ProxMenux. Cuatro modos de operación, filtros estrictos de seguridad (discos del sistema / montados / en uso bloqueados) y doble confirmación incluyendo tecleo de la ruta completa.",
"ogTitle": "Formatear / borrar disco físico | ProxMenux Documentation",
"ogTitle": "Formatear o borrar un disco físico | Documentación de ProxMenux",
"ogDescription": "Borra o formatea de forma segura un disco físico en Proxmox. Reglas de visibilidad seguras, 4 modos de operación, doble confirmación."
},
"header": {
@@ -43,31 +43,31 @@
"headerUseCase": "Caso de uso",
"rows": [
{
"mode": "1. Wipe all",
"mode": "1. Borrar todo",
"part": "Destruida",
"data": "Firmas borradas",
"useCase": "Empezar de cero: todo lo del disco se va, listo para una nueva distribución."
"useCase": "Elimina la tabla de particiones y los metadatos de sistemas de archivos y RAID, pone a cero los primeros y los últimos 16 MiB y, en unidades que admiten discard, aplica TRIM a todo el disco. El resto de los datos no se sobrescribe y en un HDD aún podría recuperarse; no es un borrado seguro."
},
{
"mode": "2. Remove FS labels",
"mode": "2. Borrar firmas FS",
"part": "Preservada",
"data": "Preservados",
"useCase": "Limpia firmas obsoletas de ZFS / LVM / RAID para que el disco deje de ser reclamado automáticamente, sin tocar los datos."
"useCase": "Elimina firmas antiguas de ZFS / LVM / RAID para evitar que el disco se reclame automáticamente. No sobrescribe los datos de usuario en bloque, pero borrar las firmas puede dejarlos inaccesibles."
},
{
"mode": "3. Zero all data",
"mode": "3. Poner a cero",
"part": "Preservada",
"data": "Destruidos (zerados)",
"useCase": "Sanear antes de entregar el disco, manteniendo la distribución de particiones existente."
"data": "Destruidos (sobrescritos con ceros)",
"useCase": "Sobrescribir con ceros las particiones existentes conservando la tabla de particiones. No cubre el espacio sin asignar ni las áreas de reserva de los SSD; no garantiza el saneamiento completo del dispositivo."
},
{
"mode": "4. Full format",
"mode": "4. Formato completo",
"part": "Nuevo GPT",
"data": "Destruidos",
"useCase": "Disco listo para usar con una única partición nueva y un filesystem fresco."
}
],
"fullFormatOutro": "<strong>Full format</strong> continúa con dos diálogos extra:",
"fullFormatOutro": "<strong>Formato completo</strong> continúa con dos diálogos más:",
"fullFormatItems": [
"<strong>Filesystem</strong> — <code>ext4</code>, <code>xfs</code>, <code>exfat</code> (portable) o <code>btrfs</code>. Si faltan herramientas (por ejemplo <code>mkfs.btrfs</code>) aborta con un mensaje claro.",
"<strong>Etiqueta</strong> — etiqueta opcional del filesystem para identificación."
@@ -83,10 +83,10 @@
},
{
"title": "Elige un modo de operación",
"bodyRich": "Elige entre <strong>Wipe all</strong>, <strong>Remove FS labels</strong>, <strong>Zero all data</strong> o <strong>Full format</strong> según la tabla de arriba."
"bodyRich": "Elige entre <strong>Borrar todo</strong>, <strong>Borrar firmas FS</strong>, <strong>Poner a cero</strong> o <strong>Formato completo</strong> según la tabla anterior."
},
{
"title": "(Solo Full format) Elige filesystem y etiqueta",
"title": "(Solo Formato completo) Elegir sistema de archivos y etiqueta",
"body": "ext4 / xfs / exfat / btrfs, más una etiqueta opcional."
},
{
@@ -1,14 +1,14 @@
{
"meta": {
"title": "Importar imagen de disco a VM | ProxMenux Documentation",
"title": "Importar imagen de disco a una VM | Documentación de ProxMenux",
"description": "Importa un archivo de imagen de disco (.img / .qcow2 / .vmdk / .raw) a una VM Proxmox existente usando ProxMenux. Interfaz por imagen, emulación SSD y flag bootable, con qm importdisk por debajo.",
"ogTitle": "Importar imagen de disco a VM | ProxMenux Documentation",
"ogTitle": "Importar imagen de disco a una VM | Documentación de ProxMenux",
"ogDescription": "Importa imágenes de disco .img / .qcow2 / .vmdk / .raw a una VM existente con ProxMenux. Usa qm importdisk por debajo."
},
"header": {
"title": "Importar imagen de disco a VM",
"description": "Importa un archivo de imagen de disco (.img, .qcow2, .vmdk o .raw) a una VM Proxmox existente. ProxMenux recopila todas las decisiones por adelantado — VM destino, almacenamiento Proxmox, directorio origen, interfaz, emulación SSD, orden de arranque — y luego ejecuta qm importdisk para cada imagen seleccionada.",
"section": "Disk Manager · VM"
"section": "Administrador de discos · VM"
},
"intro": {
"title": "Qué hace esto",
@@ -52,8 +52,8 @@
"intro": "Para cada imagen seleccionada ProxMenux pregunta:",
"items": [
"<strong>Interfaz</strong> — <code>scsi</code> (por defecto), <code>virtio</code>, <code>sata</code> o <code>ide</code>. Determina cómo verá el disco el guest.",
"<strong>Emulación SSD</strong> — solo se ofrece para interfaces no-VirtIO. Añade <code>ssd=1</code> para que el guest anuncie el disco como solid-state (útil para TRIM / alineación a nivel de SO).",
"<strong>Bootable</strong> — si es sí, ProxMenux añade el disco al orden de arranque para que se convierta en el dispositivo de arranque primario de la VM."
"<strong>Emulación SSD</strong>: solo se ofrece para interfaces que no sean VirtIO. Añade <code>ssd=1</code> para que el invitado reconozca un disco de estado sólido. La compatibilidad con discard/TRIM debe configurarse aparte.",
"<strong>Disco de arranque</strong>: si eliges sí, ProxMenux añade el disco al orden de arranque como dispositivo principal de la VM."
]
},
{
@@ -70,10 +70,10 @@
},
"troubleshoot": {
"heading": "Solución de problemas",
"noImagesTitle": "\"No compatible disk images found\"",
"noImagesTitle": "\"No se encontraron imágenes de disco compatibles\"",
"noImagesBody": "El script escaneó el directorio pero no encontró ningún archivo <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code>. Comprueba la extensión (las mayúsculas importan), que el archivo esté directamente en el directorio seleccionado (no se buscan subdirectorios) y que los permisos permitan a root leerlo.",
"slowTitle": "La importación va lenta",
"slowBody": "Las conversiones VMDK → QCOW2 → raw están limitadas por CPU y E/S. La velocidad de importación depende de la velocidad de lectura del origen, la velocidad de escritura del almacenamiento destino y la CPU para descompresión. Prefiere orígenes raw o qcow2 cuando sea posible.",
"slowBody": "Las conversiones entre VMDK, QCOW2 y raw pueden estar limitadas por CPU y E/S. La velocidad depende de la lectura del origen, la escritura del destino y la descompresión necesaria. Prefiere fuentes raw o qcow2 cuando sea posible.",
"uefiTitle": "El disco importado arranca en la UEFI shell",
"uefiBody": "La imagen se construyó para legacy (SeaBIOS) pero la VM usa OVMF (o al revés). O bien cambia la BIOS de la VM en Proxmox para que coincida con la imagen, o reconstruye la imagen en el modo correcto antes de importar."
},
@@ -92,7 +92,7 @@
},
{
"href": "/docs/utils/UUp-Dump-ISO-Creator",
"label": "UUP Dump ISO Creator",
"label": "Creador de ISO UUP Dump",
"tail": " — genera una ISO de Windows si necesitas una para una instalación nueva."
},
{
@@ -1,14 +1,14 @@
{
"meta": {
"title": "Importar disco a LXC | ProxMenux Documentation",
"title": "Importar disco a LXC | Documentación de ProxMenux",
"description": "Adjunta un disco físico a un contenedor LXC existente en Proxmox VE usando ProxMenux. Gestiona la detección / formateo del filesystem, el mount point, la conversión unprivileged → privilegiado y rutas de dispositivo persistentes.",
"ogTitle": "Importar disco a LXC | ProxMenux Documentation",
"ogTitle": "Importar disco a LXC | Documentación de ProxMenux",
"ogDescription": "Adjunta un disco físico a un contenedor LXC existente. Gestiona el filesystem, el mount point y la conversión unprivileged → privilegiado."
},
"header": {
"title": "Importar disco a LXC",
"description": "Adjunta un disco físico a un contenedor LXC existente en el host Proxmox. ProxMenux detecta los discos libres, opcionalmente los formatea con un filesystem soportado y conecta la partición a un mount point dentro del contenedor usando rutas de dispositivo persistentes.",
"section": "Disk Manager · LXC"
"section": "Administrador de discos · LXC"
},
"intro": {
"title": "Passthrough en VM vs passthrough en LXC",
@@ -27,7 +27,7 @@
"Al menos un disco físico que no esté en uso por el host ni por ningún otro guest."
],
"warnTitle": "Se requiere contenedor privilegiado",
"warnBody": "El passthrough directo de dispositivos a un contenedor LXC solo funciona si el contenedor es <strong>privilegiado</strong>. Si el script detecta <code>unprivileged: 1</code> en la config, se ofrece a convertirlo in situ (edita <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code>). Cancela si no puedes aceptar el compromiso de seguridad de un contenedor privilegiado."
"warnBody": "Este script requiere un contenedor <strong>privilegiado</strong> para conectar el disco directamente. Si detecta <code>unprivileged: 1</code>, ofrece editar <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code> in situ. Esto cambia el modelo de seguridad y no reasigna la propiedad de los archivos existentes. Haz una copia del contenedor y comprueba la propiedad antes de aceptar, o recréalo como privilegiado."
},
"steps": {
"heading": "Paso a paso",
@@ -82,10 +82,10 @@
},
"troubleshoot": {
"heading": "Solución de problemas",
"unprivTitle": "\"Cannot continue with an unprivileged container\"",
"unprivBody": "Rechazaste la oferta de conversión. O bien vuelves a ejecutar y aceptas la conversión, o conviertes el contenedor manualmente editando <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code> y reemplazando <code>unprivileged: 1</code> por <code>unprivileged: 0</code>. También puedes reconstruir el contenedor como privilegiado si prefieres no convertirlo in situ.",
"unprivTitle": "\"No se puede continuar con un contenedor no privilegiado\"",
"unprivBody": "Rechazaste la conversión, así que el script se detuvo sin cambiar nada. Para continuar, vuelve a ejecutarlo y acepta: el script detiene el contenedor, guarda una copia de su configuración en <code>/etc/pve/lxc/&lt;CTID&gt;.conf.bak</code> y sustituye <code>unprivileged: 1</code> por <code>unprivileged: 0</code>. Ese cambio por sí solo no convierte los UID/GID de los archivos existentes, así que haz antes un backup del contenedor y corrige los propietarios; como alternativa, restaura o recrea el contenedor como privilegiado.",
"permsTitle": "Los permisos dentro del contenedor están mal",
"permsBody": "Los mounts del host hacia un contenedor privilegiado entran como <code>root:root</code>. Si el servicio dentro del CT corre como otro usuario (p. ej. <code>www-data</code> para Nextcloud), haz <code>chown</code>/<code>chmod</code> dentro del contenedor para que coincida con su UID/GID después del primer mount."
"permsBody": "Al montar una partición en un contenedor privilegiado se conserva la propiedad existente; un sistema de archivos recién formateado suele pertenecer a <code>root:root</code>. Si el servicio usa otro usuario, por ejemplo <code>www-data</code> para Nextcloud, comprueba su UID/GID y ajusta los archivos necesarios con <code>chown</code>/<code>chmod</code>. Los cambios afectan también al disco subyacente."
},
"related": {
"heading": "Relacionado",
@@ -1,18 +1,18 @@
{
"meta": {
"title": "Importar disco a VM | ProxMenux Documentation",
"title": "Importar disco a una VM | Documentación de ProxMenux",
"description": "Adjunta un disco físico a una VM Proxmox existente con ProxMenux. Detección segura de discos (excluye sistema, montados, en uso, ZFS/RAID/LVM), rutas persistentes /dev/disk/by-id e interfaces SATA / SCSI / VirtIO / IDE.",
"ogTitle": "Importar disco a VM | ProxMenux Documentation",
"ogTitle": "Importar disco a una VM | Documentación de ProxMenux",
"ogDescription": "Adjunta un disco físico a una VM Proxmox existente. Usa rutas persistentes /dev/disk/by-id y soporta SATA / SCSI / VirtIO / IDE."
},
"header": {
"title": "Importar disco a VM",
"description": "Adjunta un disco físico ya existente en el host Proxmox a una máquina virtual existente. ProxMenux detecta los discos libres, te deja elegir la VM destino y el tipo de bus (SATA / SCSI / VirtIO / IDE), y lo adjunta todo usando rutas persistentes /dev/disk/by-id para que el mapeo sobreviva a reinicios y cambios en el orden de los dispositivos.",
"section": "Disk Manager · VM"
"section": "Administrador de discos · VM"
},
"intro": {
"title": "Qué hace esto",
"body": "Esto es un passthrough de disco crudo: el SO guest ve la unidad como un block device real (con sus datos SMART y geometría nativa). El disco se adjunta por su ruta <code>/dev/disk/by-id/…</code> — no <code>/dev/sdX</code> — para que la asignación no se rompa si las controladoras de disco enumeran los dispositivos en otro orden en el siguiente arranque."
"body": "Conecta un disco físico como dispositivo subyacente de una interfaz de disco virtual. El invitado no recibe automáticamente los datos SMART nativos ni las funciones de la controladora física; usa passthrough PCI de la controladora si los necesitas. Se conecta mediante su ruta <code>/dev/disk/by-id/…</code> cuando existe, para que un cambio en el orden de enumeración al arrancar no rompa la asignación; si no existe, se usa <code>/dev/sdX</code>."
},
"howRuns": {
"heading": "Cómo se ejecuta el script",
@@ -49,7 +49,7 @@
"items": [
"<strong>SCSI</strong> — opción por defecto moderna para Linux y Windows con drivers VirtIO-SCSI instalados.",
"<strong>SATA</strong> — amplia compatibilidad, funciona por defecto en prácticamente cualquier guest.",
"<strong>VirtIO</strong> — block device paravirtualizado, el más rápido pero requiere drivers en el guest.",
"<strong>VirtIO</strong>: dispositivo de bloques paravirtualizado eficiente; requiere controladores en el invitado.",
"<strong>IDE</strong> — para guests legacy que no tienen ninguno de los drivers anteriores."
]
},
@@ -63,13 +63,13 @@
"heading": "Equivalente manual",
"body": "El script es un wrapper alrededor de <code>qm set</code>. El comando exacto para un solo disco se ve así:",
"migrationTitle": "La migración en vivo no es posible",
"migrationBody": "Una VM con un disco en passthrough está <strong>atada al host que expone ese disco</strong>. La migración en vivo a otro nodo Proxmox fallará porque el nodo destino no ve la misma ruta <code>/dev/disk/by-id/…</code>. Usa replicación o backup/restore en su lugar, o elige discos virtuales en almacenamiento compartido si necesitas movilidad.",
"migrationBody": "Una VM con un disco físico conectado directamente está <strong>ligada al host que expone ese disco</strong>. Otro nodo normalmente no dispone de la misma ruta <code>/dev/disk/by-id/…</code> ni de sus datos. Copia y transfiere esos datos por separado, o usa discos virtuales gestionados en almacenamiento compartido o con replicación compatible para facilitar la movilidad. No presupongas que la replicación de almacenamiento de Proxmox cubre este dispositivo.",
"shareTitle": "No compartas un disco físico entre VMs",
"shareBody": "Adjuntar el mismo disco físico a dos VMs a la vez corromperá los datos en la siguiente escritura. ProxMenux detecta esta situación y la bloquea, pero si te saltas el script (un <code>qm set</code> directo), asegúrate de que solo un guest monte el disco."
},
"troubleshoot": {
"heading": "Solución de problemas",
"noDisksTitle": "\"No disks available for this VM\"",
"noDisksTitle": "\"No hay discos disponibles para esta máquina virtual\"",
"noDisksIntro": "El script encontró discos, pero todos los candidatos se filtraron. Razones comunes:",
"noDisksItems": [
"Cada disco restante ya está referenciado en la config de la VM destino.",
+9 -9
View File
@@ -1,20 +1,20 @@
{
"meta": {
"title": "Disk Manager de Proxmox — adjuntar discos a VMs / LXC, tests SMART, wipe | ProxMenux",
"description": "Gestiona discos físicos en un host Proxmox VE con ProxMenux: pasa discos a VMs o contenedores LXC (qm set scsi/sata/virtio, pct mp), importa imágenes de disco qcow2 / vmdk / vdi, pasa HBAs o controladoras NVMe enteras, borra discos de forma segura y ejecuta self-tests SMART.",
"description": "Gestiona discos físicos en un host Proxmox VE con ProxMenux: conecta discos a VM o contenedores LXC (qm set scsi/sata/virtio, pct mp), importa imágenes img / qcow2 / vmdk / raw, asigna HBA o controladoras NVMe completas, borra discos con controles de seguridad y ejecuta pruebas SMART.",
"ogTitle": "Disk Manager de Proxmox — adjuntar discos a VMs / LXC, tests SMART, wipe",
"ogDescription": "Adjuntar discos a VMs / LXC, importar imágenes de disco, PCI passthrough para controladoras, wipe seguro y tests SMART en Proxmox VE.",
"twitterTitle": "Disk Manager de Proxmox | ProxMenux",
"twitterDescription": "Adjuntar discos a VMs / LXC, importar imágenes, PCI passthrough, wipe seguro y tests SMART."
},
"header": {
"title": "Disk Manager",
"title": "Administrador de discos",
"description": "El menú Disk Manager agrupa las herramientas de ProxMenux para gestionar discos físicos en un host Proxmox: adjuntar discos a VMs y contenedores LXC, importar imágenes de disco, pasar una controladora entera o un dispositivo NVMe, borrar discos de forma segura y ejecutar tests de salud SMART.",
"section": "Disk Manager"
"section": "Administrador de discos"
},
"intro": {
"title": "Para qué sirve este menú",
"body": "Cada opción aquí opera sobre <strong>discos físicos ya visibles para el host Proxmox</strong>. El menú está dividido en tres grupos — <strong>VM</strong> (adjuntar discos o importar imágenes a una máquina virtual), <strong>LXC</strong> (adjuntar discos a un contenedor) y <strong>Utilidades</strong> (format seguro, salud SMART). Los chequeos de seguridad se aplican en todas partes: los discos del sistema y los discos ya en uso están ocultos o bloqueados."
"body": "Estas herramientas trabajan con <strong>discos físicos visibles para el host Proxmox y archivos de imagen guardados en él</strong>. Hay tres grupos: <strong>VM</strong> (conectar discos o importar imágenes), <strong>LXC</strong> (conectar discos a un contenedor) y <strong>Utilidades</strong> (formateo y salud SMART). Las operaciones de conexión y borrado ocultan o bloquean los discos del sistema y en uso; las comprobaciones SMART pueden examinarlos sin borrarlos."
},
"opening": {
"heading": "Abrir el menú",
@@ -32,7 +32,7 @@
"Añadir controladora o NVMe a VM"
],
"lxcTitle": "LXC",
"lxcBody": "Herramientas que operan sobre contenedores existentes. El passthrough directo de dispositivos necesita un contenedor privilegiado; el script se ofrece a convertirlo si hace falta.",
"lxcBody": "Herramientas para contenedores LXC existentes. Este script requiere un contenedor privilegiado y ofrece cambiar la opción cuando hace falta. Lee primero las precauciones sobre conversión y propiedad de archivos en la página de la herramienta.",
"lxcItems": [
"Importar disco a LXC"
],
@@ -69,7 +69,7 @@
},
"lxc": {
"heading": "LXC",
"intro": "Herramientas que operan sobre contenedores LXC existentes. El passthrough directo de dispositivos requiere un contenedor privilegiado; el script se ofrece a convertir el contenedor si hace falta.",
"intro": "Herramientas para contenedores LXC existentes. Este script requiere un contenedor privilegiado y ofrece cambiar la opción cuando hace falta. Lee primero las precauciones sobre conversión y propiedad de archivos en la página de la herramienta.",
"options": [
{
"icon": "Boxes",
@@ -98,8 +98,8 @@
]
},
"safety": {
"title": "Reglas de seguridad comunes a todas las opciones",
"intro": "ProxMenux filtra cualquier cosa que pueda dañar el host:",
"title": "Reglas de seguridad para conectar y borrar discos",
"intro": "Las operaciones de conexión y borrado excluyen los dispositivos que podrían dañar el host:",
"items": [
"El <strong>disco del sistema</strong> (root pool, swap, miembros activos de ZFS / LVM / RAID) está siempre oculto.",
"Los discos <strong>montados</strong> en cualquier punto del host se ocultan o se bloquean en ejecución.",
@@ -112,7 +112,7 @@
"items": [
{
"href": "/docs/storage-share",
"label": "Storage & Share Manager",
"label": "Gestor de almacenamiento y recursos compartidos",
"tail": " — registrar almacenamiento en el propio Proxmox (NFS / Samba / iSCSI / local) y compartir carpetas entre host y CTs."
},
{
@@ -1,8 +1,8 @@
{
"meta": {
"title": "Salud y test SMART de disco | ProxMenux Documentation",
"title": "Salud y pruebas SMART del disco | Documentación de ProxMenux",
"description": "Ejecuta chequeos de salud SMART y tests de disco en Proxmox VE con ProxMenux. Soporta SATA / SAS (smartmontools) y NVMe (nvme-cli). Self-tests cortos y largos, exportación JSON para integración con ProxMenux Monitor.",
"ogTitle": "Salud y test SMART de disco | ProxMenux Documentation",
"ogTitle": "Salud y pruebas SMART del disco | Documentación de ProxMenux",
"ogDescription": "Chequeos de salud SMART y self-tests para unidades SATA / SAS y NVMe en Proxmox. Exportación JSON para el Monitor."
},
"header": {
@@ -49,17 +49,17 @@
"dur": "Horas (depende del tamaño del disco)"
},
{
"action": "Comprobar el progreso del test",
"action": "Progreso de prueba",
"what": "Estado del self-test activo o más reciente.",
"dur": "Instantáneo"
}
],
"tipTitle": "Los tests largos sobreviven al cierre del terminal",
"tipBody": "Un test largo se encola <em>dentro de la unidad</em> — no depende de que el proceso de ProxMenux siga vivo. Puedes cerrar el terminal, reiniciar el host Proxmox (el test continúa donde lo dejó en algunas unidades) o simplemente volver más tarde y usar <strong>Comprobar el progreso del test</strong> para ver el resultado."
"tipBody": "Un test largo se ejecuta <em>dentro de la unidad</em> y no depende de que siga activo el proceso de ProxMenux. Puedes cerrar el terminal y volver después a <strong>Progreso de prueba</strong>. Un reinicio del host, de la controladora o una pérdida de alimentación puede interrumpir el test y su recopilador de resultados; no presupongas que se reanudará automáticamente."
},
"json": {
"heading": "Exportación JSON para el Monitor",
"intro": "Cada ejecución escribe un archivo JSON con marca de tiempo en <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code>. La estructura es:",
"intro": "Las acciones de estado, test corto y progreso guardan un JSON con fecha en <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code>; los resultados del test largo se recopilan en segundo plano. El informe completo solo se muestra. La estructura es:",
"outro": "El ProxMenux Monitor los recoge para renderizar tendencias de salud por disco; los archivos viejos se rotan automáticamente cuando se alcanza el límite de retención."
},
"steps": {
@@ -89,7 +89,7 @@
},
{
"title": "Revisa los resultados",
"bodyRich": "El estado y el informe se imprimen en el terminal y se escriben en JSON. Para los tests largos, vuelve más tarde y ejecuta <strong>Comprobar el progreso del test</strong> en el mismo disco para ver el resultado.",
"bodyRich": "La salida del estado, de las pruebas y del progreso se muestra en el terminal; <strong>Informe completo</strong> se abre en un diálogo desplazable. El JSON se exporta para las acciones indicadas arriba, no para Informe completo. Para las pruebas largas, vuelve después a <strong>Progreso de prueba</strong> en el mismo disco.",
"img": "/disk/smart/quick-status.png",
"alt": "Salida del estado de salud rápido",
"caption": "Salida del estado de salud rápido (SATA — smartctl -H + -A)"
@@ -103,10 +103,10 @@
},
"troubleshoot": {
"heading": "Solución de problemas",
"noSmartTitle": "\"Could not read SMART data from /dev/sdX\"",
"noSmartTitle": "\"No se pudieron leer los datos SMART de /dev/sdX\"",
"noSmartBody": "El disco está probablemente detrás de una controladora RAID / SAS que no pasa SMART. Con tarjetas basadas en megaraid, prueba <code>smartctl -d megaraid,N /dev/sdX</code>. Para HBAs en modo IT la invocación directa funciona.",
"longTitle": "El test largo no termina nunca",
"longBody": "El test se encola en el firmware de la unidad y pausa si el disco tiene carga pesada. Ejecutarlo de noche en un sistema en reposo suele funcionar. También puedes revisar <code>smartctl -c</code> para ver el porcentaje restante; si se queda atascado en un LBA fijo, el disco está fallando en ese sector."
"longBody": "La unidad ejecuta el test en su firmware y la carga de E/S puede retrasarlo. Prueba en un periodo de poca actividad, como de noche. En SATA, <code>smartctl -c</code> muestra el porcentaje restante, y en SAS, <code>smartctl -l selftest</code>; revisa el registro de tests para ver el resultado y posibles LBA con fallos. Un error de lectura requiere investigación; la lentitud por sí sola no demuestra un sector defectuoso."
},
"related": {
"heading": "Relacionado",
@@ -124,7 +124,7 @@
{
"href": "/docs/help-info/zfs-commands",
"label": "Comandos de gestión de ZFS",
"tail": " — zpool scrub como equivalente a los tests SMART a nivel de capa de almacenamiento."
"tail": " — zpool scrub comprueba las sumas de verificación de los datos ZFS y complementa los tests SMART del hardware."
},
{
"href": "/docs/monitor/dashboard/storage",
@@ -0,0 +1,128 @@
{
"meta": {
"title": "Ajouter un contrôleur ou un NVMe à une VM | Documentation ProxMenux",
"description": "Attribuez un contrôleur de stockage SATA/SAS HBA ou un périphérique NVMe à une VM Proxmox par passthrough PCI avec ProxMenux. L’outil gère l’activation d’IOMMU, la détection des conflits et l’affectation avec qm set --hostpci.",
"ogTitle": "Ajouter un contrôleur ou un NVMe à une VM | Documentation ProxMenux",
"ogDescription": "Attribuez un HBA SATA/SAS complet ou un périphérique NVMe à une VM Proxmox. ProxMenux gère IOMMU, la détection des conflits et l’affectation hostpci."
},
"header": {
"title": "Ajouter un contrôleur ou un NVMe à une VM",
"description": "Attribuez un adaptateur de bus SATA/SAS (HBA) complet ou un périphérique NVMe à une VM Proxmox par passthrough PCI. ProxMenux vérifie IOMMU et l’active avec votre accord, recense les périphériques compatibles, écarte les conflits et configure l’affectation avec qm set --hostpci.",
"section": "Gestionnaire de disque · VM"
},
"intro": {
"title": "Ce que cela fait (et ne fait pas)",
"body": "Il s’agit d’un <strong>passthrough au niveau du périphérique</strong> : la carte PCIe quitte le contrôle du noyau de l’hôte et est liée à <code>vfio-pci</code>. La VM voit le contrôleur lui-même, au lieu de disques transmis individuellement, et charge son propre pilote pour ce modèle précis. Tous les disques qui y sont raccordés suivent automatiquement, avec les données SMART natives, toutes les fonctions du firmware et aucune couche Proxmox intermédiaire."
},
"howRuns": {
"heading": "Comment fonctionne le script",
"body": "Le flux a deux phases avec une séparation claire entre \"collecter l'information, vérifier IOMMU et lister les candidats\" et \"en fait fixer l'appareil PCI\". Jusqu'à la confirmation finale rien n'est écrit à la config VM."
},
"iommu": {
"heading": "Les groupes IOMMU — pourquoi la carte entière part à la fois",
"body": "La limite d’isolation du passthrough PCI est le <strong>groupe IOMMU</strong>, la plus petite unité que l’IOMMU du CPU peut isoler. Les périphériques d’un même groupe ne peuvent pas être isolés les uns des autres. Si un contrôleur SATA partage son groupe avec un contrôleur USB, le passthrough SATA peut exiger de libérer aussi l’USB de l’hôte, ou être impossible. Il n’attribue pas automatiquement tous les périphériques du groupe à la VM.",
"outro": "ProxMenux montre le groupe IOMMU à côté de chaque appareil et vous avertit lorsqu'un groupe porte plus que le contrôleur que vous voulez. Vous pouvez toujours procéder si les périphériques supplémentaires du groupe sont acceptables (tous les contrôleurs de disque, par exemple), ou revenir en arrière s'ils ne le sont pas."
},
"prereqs": {
"heading": "Préalables",
"items": [
"<strong>Le CPU et la carte mère prennent en charge</strong> VT-d (Intel) ou AMD-Vi, et la fonction est activée dans le firmware (BIOS/UEFI). ProxMenux peut activer la partie noyau, mais ne peut pas modifier le réglage du firmware.",
"La VM cible est <strong>éteinte</strong> avant l’affectation de périphériques PCI.",
"Le contrôleur/NVMe <strong> n'est pas celui qui détient le système de fichiers racine Proxmox</strong>. Le script cache tout ce qui est utilisé par l'hôte.",
"Le système invité dispose des pilotes du contrôleur. Linux prend en charge presque tous les HBA sans ajout de pilote ; sous Windows, le pilote du fabricant doit être installé <em>avant</em> le démarrage avec le contrôleur affecté."
],
"warnTitle": "La migration à chaud est impossible",
"warnBody": "Un VM avec PCI passethrough est lié au noeud qui détient physiquement la carte. La migration en direct à travers les nœuds échouera. Planifiez les sauvegardes / réplication en conséquence."
},
"steps": {
"heading": "Étape par étape",
"stepLabel": "Étape",
"list": [
{
"title": "Choisir la VM cible",
"bodyRich": "ProxMenux lit <code>qm list</code> et affiche chaque VM. Choisissez celui qui recevra le contrôleur.",
"img": "/disk/nvme-passthrough/vm-selection.png",
"alt": "Boîte de dialogue de sélection VM",
"caption": "Boîte de dialogue de sélection VM"
},
{
"title": "Vérification IOMMU",
"bodyRich": "Si IOMMU n’est pas activé dans la ligne de commande du noyau, ProxMenux propose de l’activer. Il modifie <code>/etc/kernel/cmdline</code> pour systemd-boot ou <code>/etc/default/grub</code> pour GRUB et ajoute le paramètre adapté au CPU :",
"items": [
"<code>intel_iommu=on</code> pour les processeurs Intel.",
"<code>amd_iommu=on</code> pour processeurs AMD."
],
"outro": "Un redémarrage est nécessaire après cette modification. Le script propose de redémarrer maintenant ou plus tard ; le passthrough ne peut continuer que lorsque la nouvelle ligne de commande du noyau est active.",
"img": "/disk/nvme-passthrough/iommu-warning.png",
"alt": "Boîte de dialogue IOMMU requis",
"caption": "IOMMU requis : proposition d’activation et de redémarrage"
},
{
"title": "Énumération du périphérique",
"body": "ProxMenux liste tous les contrôleurs de stockage (SATA / SAS HBA) et tous les périphériques NVMe du bus PCI. Pour chaque appareil, il affiche :",
"items": [
"Adresse PCI (<code>00:17.0</code>, <code>01:00.0</code>, ...).",
"Description du fournisseur / de l'appareil.",
"Groupe IOMMU, avec un avertissement ⚠ s’il est partagé avec d’autres périphériques sans rapport.",
"Les disques actuellement derrière le contrôleur (pour que vous sachiez ce qui va le suivre au VM)."
],
"img": "/disk/nvme-passthrough/device-list.png",
"alt": "Liste des contrôleurs et périphériques NVMe",
"caption": "Liste des contrôleurs et périphériques NVMe avec les groupes IOMMU"
},
{
"title": "Détection des conflits",
"bodyRich": "Le script bloque les périphériques manifestement dangereux : ceux déjà attribués à une autre VM via <code>hostpci</code> dans sa configuration, ceux utilisés par l’hôte comme le contrôleur du disque racine, ou ceux d’un groupe IOMMU dont les autres membres ne peuvent pas être identifiés de façon sûre. Les périphériques admissibles sont proposés à la sélection.",
"img": "/disk/nvme-passthrough/conflict-warning.png",
"alt": "Avertissement de détection des conflits",
"caption": "Détection des conflits — dispositif bloqué avec raison"
},
{
"title": "Affecter et terminer",
"bodyRich": "Pour chaque appareil sélectionné ProxMenux exécute <code>qm set &lt;VMID&gt; --hostpciN &lt;pci-addr&gt;,pcie=1</code>, en choisissant la prochaine fente libre <code>hostpci</code>. Si IOMMU a été activé pendant cette session, on vous rappelle de redémarrer avant de démarrer le VM.",
"img": "/disk/nvme-passthrough/assignment.png",
"alt": "Résumé de l'attribution",
"caption": "Résumé de l’affectation : emplacements hostpciN et adresses PCI attribuées"
}
]
},
"manual": {
"heading": "Équivalent manuel"
},
"troubleshoot": {
"heading": "Dépannage",
"noGroupsTitle": "IOMMU activé, mais aucun groupe dans /sys/kernel/iommu_groups/",
"noGroupsBody": "Redémarrer est nécessaire pour que le noyau cmdline prenne effet. Si les groupes sont encore manquants après le redémarrage, VT-d / AMD-Vi est probablement désactivé dans le firmware — vérifiez la configuration BIOS/UEFI.",
"busyTitle": "La VM ne démarre pas : \"hostpciN: device busy\"",
"busyBody": "Un autre processus utilise encore le périphérique PCI. Les causes courantes sont une VM ayant planté sans le libérer ou le noyau de l’hôte l’ayant repris au dernier démarrage. Exécutez <code>lspci -nnk -s &lt;addr&gt;</code> pour identifier le pilote associé ; il devrait s’agir de <code>vfio-pci</code>. Un redémarrage complet de l’hôte résout généralement le problème.",
"noDisksTitle": "Invité voit le contrôleur mais pas les disques",
"noDisksBody": "Le système invité ne dispose pas du pilote de ce contrôleur. Ce cas est rare sous Linux, mais se présente sous Windows : installez le pilote du fabricant, par exemple LSI/Broadcom pour les anciens HBA SAS, lorsque la carte n’est pas affectée, puis redémarrez avec la carte affectée.",
"sharedTitle": "Le groupe IOMMU contient un périphérique sans rapport",
"sharedBody": "Options : (a) déplacer la carte vers un autre emplacement PCIe pour changer son groupe, (b) activer <em>ACS override</em> dans le noyau pour diviser les groupes (compromis de sécurité : se renseigner avant de l’appliquer), ou (c) choisir une autre carte dans un groupe mieux isolé."
},
"related": {
"heading": "Voir aussi",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importer le disque vers la VM",
"tail": "— modèle alternatif: attachez un disque physique via Proxmox sans passage PCIe complet."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "Ajouter GPU à VM (Passthrough)",
"tail": "— les mêmes concepts IOMMU/VFIO appliqués à un GPU."
},
{
"href": "/docs/help-info/gpu-commands",
"label": "commandes GPU Passthrough",
"tail": "— Les commandes de vérification IOMMU s'appliquent également au contrôleur / NVMe passant."
},
{
"href": "/docs/disk-manager",
"label": "Aperçu du gestionnaire de disque",
"tail": "."
}
]
}
}
@@ -0,0 +1,142 @@
{
"meta": {
"title": "Formater ou effacer un disque physique | Documentation ProxMenux",
"description": "Effacez et formatez les disques physiques sur Proxmox VE avec ProxMenux. Quatre modes, des filtres stricts excluant les disques système, montés ou utilisés, et une double confirmation avec saisie du chemin complet.",
"ogTitle": "Formater ou effacer un disque physique | Documentation ProxMenux",
"ogDescription": "Effacez ou formatez un disque physique sur Proxmox. Filtres de sécurité, quatre modes et double confirmation."
},
"header": {
"title": "Formater ou effacer un disque physique",
"description": "Effacez ou formatez un disque physique sur l’hôte Proxmox. ProxMenux ne montre que les disques entièrement libres : aucun usage par le système, aucune référence dans les invités et aucun montage. Il impose une double confirmation, oui/non puis saisie du chemin complet du disque, avant toute destruction de données.",
"section": "Gestionnaire de disques · Utilitaires"
},
"danger": {
"title": "Outil destructif",
"body": "Chaque opération ici écrit sur le disque. Il n'y a pas d'annulation. ProxMenux applique des filtres de sécurité stricts et des confirmations, mais la responsabilité de choisir le bon disque est à vous. Lisez le chemin du disque deux fois avant de le taper."
},
"howRuns": {
"heading": "Comment fonctionne le script",
"body": "Le processus comporte deux phases séparées par un filtre de sécurité à trois contrôles. La première recueille le choix du disque, le mode et les détails du système de fichiers. Aucune écriture n’a lieu avant la validation finale de la seconde phase, juste avant l’exécution."
},
"visibility": {
"heading": "Règles de visibilité",
"intro": "Avant même que le menu apparaisse, ProxMenux filtre la liste des disques. Seuls les candidats qui sont en sécurité sont présentés :",
"items": [
"<strong>Affichés</strong> : les disques <em>non</em> utilisés par l’hôte (pool racine, swap, montages, ZFS/LVM/RAID actifs) et <em>non</em> référencés dans une configuration VM/LXC, que l’invité soit démarré ou arrêté.",
"<strong>Masqués</strong> : disques de l’hôte et du système.",
"<strong>Masqués</strong> : disques référencés dans une configuration VM/LXC."
],
"safetyTitle": "Sécurité lors de la confirmation et de l'exécution",
"safetyItems": [
"Les disques contenant des métadonnées anciennes ou actives déclenchent des avertissements détaillés <em>avant</em> la confirmation.",
"Les disques utilisés par une VM <strong>en cours d’exécution</strong> sont <strong>strictement bloqués</strong> à la confirmation.",
"Les disques comportant des partitions montées sont <strong>strictement bloqués</strong> à l’exécution. Une nouvelle validation a lieu juste avant toute écriture.",
"Deux confirmations sont toujours nécessaires : un dialogue <em>oui/non</em> et la saisie exacte du chemin complet du disque."
]
},
"modes": {
"heading": "Modes de fonctionnement",
"intro": "Après avoir choisi un disque, vous choisissez l'un des quatre modes. Ils diffèrent dans ce qu'ils détruisent et ce qu'ils laissent derrière eux:",
"headerMode": "Mode",
"headerPart": "Table de partitions",
"headerData": "Données",
"headerUseCase": "Cas d'utilisation",
"rows": [
{
"mode": "1. Tout effacer",
"part": "Détruite",
"data": "Signatures effacées",
"useCase": "Supprime la table de partitions et les métadonnées de système de fichiers et RAID, met à zéro les 16 premiers et derniers Mio et, sur les disques qui prennent en charge discard, applique un TRIM à tout le disque. Le reste des données n’est pas écrasé et peut encore être récupérable sur un HDD ; ce n’est pas un effacement sécurisé."
},
{
"mode": "2. Supprimer les étiquettes FS",
"part": "Préservé",
"data": "Préservé",
"useCase": "Supprime les anciennes signatures ZFS / LVM / RAID pour empêcher la prise en charge automatique du disque. Les données utilisateur ne sont pas écrasées en bloc, mais la suppression des signatures peut les rendre inaccessibles."
},
{
"mode": "3. Écraser les données avec des zéros",
"part": "Préservé",
"data": "Détruites (écrasées par des zéros)",
"useCase": "Écraser les partitions existantes avec des zéros en conservant la table de partitions. Les espaces non alloués et les zones de réserve des SSD ne sont pas couverts ; cela ne garantit pas un assainissement complet du périphérique."
},
{
"mode": "4. Format complet",
"part": "Nouvelle GPT",
"data": "Détruite",
"useCase": "Disque prêt à utiliser avec une seule nouvelle partition et un nouveau système de fichiers."
}
],
"fullFormatOutro": "<strong>Format complet</strong> continue avec deux dialogues supplémentaires:",
"fullFormatItems": [
"<strong>Système de fichiers</strong> : <code>ext4</code>, <code>xfs</code>, <code>exfat</code> (portable) ou <code>btrfs</code>. Si un outil manque, par exemple <code>mkfs.btrfs</code>, l’opération s’arrête avec un message explicite.",
"<strong>Étiquette</strong> : nom facultatif du système de fichiers pour l’identifier."
]
},
"steps": {
"heading": "Étape par étape",
"stepLabel": "Étape",
"list": [
{
"title": "Choisir un disque libre",
"body": "ProxMenux liste les disques qui passent les filtres ci-dessus. Ceux marqués ⚠ contiennent d’anciennes métadonnées dont les détails sont affichés pour vous indiquer ce que vous allez écraser."
},
{
"title": "Choisir un mode d'opération",
"bodyRich": "Choisissez <strong>Tout effacer</strong>, <strong>Supprimer les étiquettes FS</strong>, <strong>Écraser les données avec des zéros</strong> ou <strong>Format complet</strong> selon le tableau ci-dessus."
},
{
"title": "(Format complet seulement) Choisir le système de fichiers et l'étiquette",
"body": "ext4 / xfs / exfat / btrfs, plus une étiquette en option."
},
{
"title": "Confirmer deux fois",
"bodyRich": "ProxMenux présente un résumé de ce qui va se passer. Vous acceptez avec une boîte de dialogue oui/non et <strong> tapez le chemin complet du disque</strong> exactement comme indiqué (par exemple <code>/dev/sdc</code>). Tout le reste avorte."
},
{
"title": "Revalidation et exécution",
"body": "Juste avant d'écrire, le script revérifie l'état du disque. Si une partition a été montée ou un VM a commencé dans l'intervalle, l'exécution est interrompue. Sinon, l'opération choisie tourne et un résumé est imprimé à la fin."
}
]
},
"manual": {
"heading": "Équivalents manuels",
"body": "Si vous préférez exécuter les commandes équivalentes à la main :"
},
"troubleshoot": {
"notListedTitle": "Disque non listé dans le menu",
"notListedBody": "Il a été filtré pour la sécurité. Raisons courantes : il est monté (même à <code>/mnt/tmp</code>), il est un membre actif ZFS / LVM / RAID, il est référencé par une config VM ou LXC, ou c'est votre disque racine Proxmox. Exécutez <code>lsblk -f</code> et <code>cat /proc/mdstat</code> sur l'hôte pour comprendre pourquoi.",
"busyTitle": "\"Disk may be busy\" / échec du démontage",
"busyBody": "Quelque chose tient toujours un fichier ouvert sur une partition de ce disque — le plus souvent un conteneur ou un shell dont cwd est à l'intérieur d'un point de montage. Identifiez-le avec <code>lsof | grep /dev/sdX</code> ou <code>fuser -vm /dev/sdX1</code>, arrêtez-le, puis lancez l'outil."
},
"related": {
"heading": "Voir aussi",
"items": [
{
"href": "/docs/disk-manager/smart-disk-test",
"label": "Santé et test du disque SMART",
"tail": "— vérifier un disque avant / après l'essuyage pour confirmer qu'il est sain."
},
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importer le disque vers la VM",
"tail": "— passer un disque fraîchement formaté à un VM."
},
{
"href": "/docs/storage-share/host-local-disk",
"label": "Ajouter le disque local comme stockage Proxmox",
"tail": " — enregistrer un disque essuyé comme stockage Proxmox pool."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Commandes de stockage et de disques",
"tail": " — référence de lsblk, blkid et parted."
},
{
"href": "/docs/disk-manager",
"label": "Aperçu du gestionnaire de disque",
"tail": "."
}
]
}
}
@@ -0,0 +1,110 @@
{
"meta": {
"title": "Importer une image disque dans une VM | Documentation ProxMenux",
"description": "Importez un fichier image disque (.img / .qcow2 / .vmdk / .raw) dans une VM Proxmox existante avec ProxMenux. Interface, émulation SSD et option de démarrage par image, avec qm importdisk en arrière-plan.",
"ogTitle": "Importer une image disque dans une VM | Documentation ProxMenux",
"ogDescription": "Importer des images disque .img / .qcow2 / .vmdk / .raw dans un VM existant avec ProxMenux. Utilise qm importdisk sous le capot."
},
"header": {
"title": "Importer l'image disque vers la VM",
"description": "Importer un fichier image disque (.img, .qcow2, .vmdk ou .raw) dans un Proxmox VM existant. ProxMenux recueille toutes les décisions dès le départ — cible VM, stockage Proxmox, répertoire source, interface, émulation SSD, ordre de démarrage — et exécute ensuite qm importdisk pour chaque image sélectionnée.",
"section": "Gestionnaire de disque · VM"
},
"intro": {
"title": "Ce que ça fait",
"body": "Contrairement à <em>Importer le disque vers la VM</em>, qui affecte un disque physique brut, ce processus utilise un <strong>fichier</strong> sur l’hôte, exporté d’un autre hyperviseur, téléchargé comme image cloud ou extrait d’une sauvegarde. Il le convertit en disque de VM Proxmox sur le stockage choisi. L’original est conservé : ProxMenux le copie sans le déplacer."
},
"howRuns": {
"heading": "Comment fonctionne le script",
"body": "Le flux a deux phases. La phase 1 recueille toutes les décisions (VM, stockage, répertoire source, images, options par image) directement via des dialogues. La phase 2 exécute <code>qm importdisk</code> pour chaque image sélectionnée. Jusqu'à ce que la phase 2 commence, rien n'est copié et la configuration VM n'est pas touchée."
},
"prereqs": {
"heading": "Préalables",
"items": [
"Au moins une VM est définie sur l’hôte. La VM cible doit être <strong>éteinte</strong>.",
"Au moins un fichier image d'un format pris en charge dans le répertoire source. Prise en charge: <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code>, <code>.raw</code>.",
"Assez d'espace libre sur le stockage Proxmox cible pour tenir chaque disque importé.",
"ProxMenux recherche des images dans <code>/var/lib/vz/template/iso</code> par défaut. Vous pouvez le pointer vers n'importe quel autre répertoire de l'hôte quand il le demande."
]
},
"steps": {
"heading": "Étape par étape",
"stepLabel": "Étape",
"list": [
{
"title": "Choisir la VM cible",
"bodyRich": "ProxMenux lit <code>qm list</code> et affiche chaque VM. Choisissez celui qui recevra le ou les disques importés."
},
{
"title": "Choisir le stockage Proxmox",
"bodyRich": "La liste contient chaque stockage qui a le type de contenu <code>images</code> activé. S'il n'y a qu'un seul candidat, il est sélectionné automatiquement et le dialogue est ignoré."
},
{
"title": "Choisir le répertoire source",
"bodyRich": "Choisissez le répertoire par défaut (<code>/var/lib/vz/template/iso</code>) ou saisissez un autre chemin, généralement celui où vous avez téléchargé ou envoyé l’image. Le script refuse les chemins inexistants."
},
{
"title": "Choisissez une ou plusieurs images",
"bodyRich": "Le répertoire est scanné pour les fichiers <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code>. Vous pouvez en sélectionner plusieurs à la fois; chacun d'eux passera par les options par image dans la prochaine étape."
},
{
"title": "Options par image",
"intro": "Pour chaque image sélectionnée ProxMenux demande:",
"items": [
"<strong>Interface</strong> — <code>scsi</code> (par défaut), <code>virtio</code>, <code>sata</code> ou <code>ide</code>. Correspond à la façon dont l'invité verra le disque.",
"<strong>Émulation SSD</strong> : proposée uniquement pour les interfaces autres que VirtIO. Ajoute <code>ssd=1</code> pour que l’invité reconnaisse un disque SSD. La prise en charge de discard/TRIM doit être configurée séparément.",
"<strong>Amorçable</strong> : si vous répondez oui, ProxMenux place le disque en tête de l’ordre de démarrage de la VM."
]
},
{
"title": "Importer et connecter",
"bodyRich": "ProxMenux exécute <code>qm importdisk</code> pour chaque image, en convertissant le format si nécessaire. Il connecte le disque au prochain emplacement libre (<code>scsiN</code>, <code>sataN</code>, …) avec les options choisies et met à jour l’ordre de démarrage si un disque a été marqué comme amorçable. La progression s’affiche dans le terminal."
}
]
},
"manual": {
"heading": "Équivalent manuel",
"body": "L’importation d’une seule image correspond à trois commandes <code>qm</code> :",
"warnTitle": "Conversion du format d'image",
"warnBody": "Lorsque le stockage cible ne peut pas contenir le format source nativement (par exemple, le stockage LVM ne peut pas contenir <code>.qcow2</code>), <code>qm importdisk</code> convertit l'image de manière transparente. Cela peut prendre plusieurs minutes pour les images multi-GB; planifier en conséquence et ne pas interrompre le script."
},
"troubleshoot": {
"heading": "Dépannage",
"noImagesTitle": "\"Aucune image disque compatible trouvée\"",
"noImagesBody": "Le script n’a trouvé aucun fichier <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code> ou <code>.raw</code>. Vérifiez la casse de l’extension, la présence du fichier directement dans le répertoire choisi (les sous-répertoires ne sont pas parcourus) et les droits de lecture de root.",
"slowTitle": "L'importation est lente",
"slowBody": "Les conversions entre VMDK, QCOW2 et raw peuvent être limitées par le CPU et les entrées-sorties. La vitesse dépend des lectures à la source, des écritures à destination et de la décompression éventuelle. Préférez des sources raw ou qcow2 si possible.",
"uefiTitle": "Le disque importé démarre dans le shell UEFI",
"uefiBody": "L’image a été créée pour le mode hérité (SeaBIOS), mais la VM utilise OVMF, ou inversement. Changez le BIOS de la VM dans Proxmox pour correspondre à l’image, ou recréez l’image dans le bon mode avant l’importation."
},
"related": {
"heading": "Voir aussi",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importer le disque vers la VM",
"tail": "— même flux mais pour les disques physiques bruts (passthrough)."
},
{
"href": "/docs/utils/import-vm",
"label": "Importer VM de OVA / OVF",
"tail": "— lorsque vous avez un paquet complet VM, pas seulement une image de disque."
},
{
"href": "/docs/utils/UUp-Dump-ISO-Creator",
"label": "Créateur d’ISO UUP Dump",
"tail": "— générer une ISO Windows si vous en avez besoin pour une nouvelle installation."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Commandes de stockage et de disques",
"tail": " — référence de qm importdisk et qemu-img convert."
},
{
"href": "/docs/disk-manager",
"label": "Aperçu du gestionnaire de disque",
"tail": "."
}
]
}
}
@@ -0,0 +1,115 @@
{
"meta": {
"title": "Importer le disque vers LXC | ProxMenux Documentation",
"description": "Joindre un disque physique à un conteneur LXC existant sur Proxmox VE en utilisant ProxMenux. Gestion de la détection de système de fichiers / formatage, point de montage, non privilégié → conversion privilégiée et chemins de périphériques persistants.",
"ogTitle": "Importer le disque vers LXC | ProxMenux Documentation",
"ogDescription": "Connectez un disque physique à un conteneur LXC existant. Gestion du système de fichiers, du point de montage et de la conversion de non privilégié à privilégié."
},
"header": {
"title": "Importer un disque vers LXC",
"description": "Connectez un disque physique à un conteneur LXC existant sur l’hôte Proxmox. ProxMenux détecte les disques libres, propose de les formater avec un système de fichiers pris en charge, puis relie la partition à un point de montage dans le conteneur à l’aide de chemins de périphériques persistants.",
"section": "Gestionnaire de disque · LXC"
},
"intro": {
"title": "Passthrough VM vs Passthrough LXC",
"body": "Ce passthrough LXC <strong>ne fournit pas un périphérique bloc brut</strong>. Le conteneur reçoit un <em>point de montage</em>, c’est-à-dire un répertoire reposant sur une partition choisie sur l’hôte. Contrairement à une VM, il utilise le noyau de l’hôte ; le système de fichiers (ext4/xfs/btrfs) est donc lu et géré par l’hôte Proxmox puis exposé au conteneur."
},
"howRuns": {
"heading": "Comment fonctionne le script",
"body": "Le processus comporte deux phases distinctes : collecte des informations et des choix, puis modification effective de la configuration du conteneur. Rien n’est monté dans le CT avant la confirmation finale.",
"summary": "ProxMenux exclut le disque racine, les disques montés et ceux référencés dans une configuration VM/LXC. Les membres actifs de ZFS/LVM/RAID sont masqués ; les anciennes signatures portent un symbole ⚠ pour pouvoir les effacer avant le formatage."
},
"prereqs": {
"heading": "Préalables",
"items": [
"Au moins un conteneur LXC défini sur l'hôte.",
"Le conteneur est <strong>privilégié</strong>, ou vous acceptez la conversion proposée par le script.",
"Au moins un disque physique non utilisé par l'hôte ou tout autre invité."
],
"warnTitle": "Conteneur privilégié requis",
"warnBody": "Ce script exige un conteneur <strong>privilégié</strong> pour connecter directement le disque. S’il détecte <code>unprivileged: 1</code>, il propose de modifier <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code> sur place. Cela change le modèle de sécurité sans remapper les propriétaires des fichiers existants. Sauvegardez le conteneur et vérifiez les propriétaires avant d’accepter, ou recréez-le en mode privilégié."
},
"steps": {
"heading": "Étape par étape",
"stepLabel": "Étape",
"list": [
{
"title": "Choisir le conteneur cible",
"img": "/disk/select-container.png",
"caption": "Menu de sélection des conteneurs",
"bodyRich": "ProxMenux liste tous les conteneurs LXC de l’hôte (<code>pct list</code>). Choisissez celui qui recevra le disque. S’il est non privilégié, le script propose de le convertir maintenant."
},
{
"title": "Choisir le disque physique",
"img": "/disk/disk-selection-ct.png",
"caption": "Disques libres détectés sur l’hôte, avec ⚠ pour les anciennes métadonnées",
"bodyRich": "Seuls les candidats sûrs sont affichés. Contrairement au processus pour VM, ce script connecte <strong>un disque par exécution</strong>. Relancez-le pour chaque disque supplémentaire."
},
{
"title": "Formater ou réutiliser",
"intro": "Le script inspecte le disque :",
"items": [
"S'il porte déjà un système de fichiers supporté (ext4 / xfs / btrfs), vous pouvez le réutiliser tel quel (les fichiers existants sont conservés).",
"S'il n'a pas de système de fichiers pris en charge, vous êtes offert pour le formater. Choisir ext4 / xfs / btrfs."
]
},
{
"title": "Choisir le point de montage",
"bodyRich": "Tapez le chemin où le conteneur doit voir le disque, par exemple. <code>/mnt/data</code> ou <code>/mnt/disk_passthrough</code>. C'est le chemin <em>dans le conteneur</em> ; l'hôte voit déjà la partition sous <code>/dev/disk/by-id/…</code>."
},
{
"title": "Connecter et vérifier",
"img": "/disk/assignment-ct.png",
"caption": "Attribution à CT",
"bodyRich": "ProxMenux ajoute une nouvelle entrée <code>mpN:</code> à la configuration du conteneur, saute les index déjà utilisés et relise la configuration pour la confirmer. Si le conteneur est en cours d'exécution, le montage est en direct; sinon, il prend effet au prochain départ.",
"extraImg": "/disk/result-point.png",
"extraAlt": "Point de montage créé avec succès",
"extraCaption": "Point de montage créé et vérifié"
}
]
},
"manual": {
"heading": "Équivalent manuel",
"body": "Le script enveloppe <code>pct set</code>. Une invocation directe pour un seul disque ressemble à :"
},
"important": {
"heading": "Considérations importantes",
"items": [
"<strong>Un disque par exécution</strong>. Relancez le script pour chaque disque supplémentaire.",
"Ne connectez <strong>pas</strong> la même partition à plusieurs conteneurs susceptibles de la monter simultanément : les écritures concurrentes corrompent le système de fichiers.",
"<strong>Les anciennes métadonnées</strong> (signature RAID / ZFS / LVM) doivent être effacées manuellement avant que le script ne vous laisse formater, sinon <code>mkfs</code> refuse d'écraser. Utilisez l'outil <wipeLink>Format / Wipe Physical Disk</wipeLink> pour cela."
]
},
"troubleshoot": {
"heading": "Dépannage",
"unprivTitle": "\"Ne peut pas continuer avec un conteneur non privilégié\"",
"unprivBody": "Vous avez refusé la conversion : le script s’est arrêté sans rien modifier. Pour continuer, relancez-le et acceptez : le script arrête le conteneur, sauvegarde sa configuration dans <code>/etc/pve/lxc/&lt;CTID&gt;.conf.bak</code> et remplace <code>unprivileged: 1</code> par <code>unprivileged: 0</code>. Ce changement ne convertit pas à lui seul les UID/GID des fichiers existants ; sauvegardez donc d’abord le conteneur et corrigez les propriétaires, ou restaurez ou recréez-le en mode privilégié.",
"permsTitle": "Les autorisations à l'intérieur du conteneur sont erronées",
"permsBody": "Le montage dans un conteneur privilégié conserve les propriétaires des fichiers existants ; un système de fichiers neuf appartient souvent à <code>root:root</code>. Si le service utilise un autre compte, par exemple <code>www-data</code> pour Nextcloud, vérifiez son UID/GID et ajustez les fichiers nécessaires avec <code>chown</code>/<code>chmod</code>. Ces changements affectent aussi le disque sous-jacent."
},
"related": {
"heading": "Voir aussi",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importer le disque vers la VM",
"tail": " — processus équivalent pour les VM."
},
{
"href": "/docs/storage-share/lxc-mount-points",
"label": "Points de montage LXC (hôte ↔ CT)",
"tail": "— partager les répertoires hôtes avec un CT au lieu de fixer un disque entier."
},
{
"href": "/docs/help-info/vm-ct-commands",
"label": "Commandes de gestion VM et CT",
"tail": "— pct config / push / pull reference."
},
{
"href": "/docs/disk-manager",
"label": "Aperçu du gestionnaire de disque",
"tail": "."
}
]
}
}
@@ -0,0 +1,113 @@
{
"meta": {
"title": "Importer le disque vers VM | ProxMenux Documentation",
"description": "Connectez un disque physique à une VM Proxmox existante avec ProxMenux. Détection excluant les disques système, montés, utilisés ou membres actifs ZFS/RAID/LVM, chemins persistants /dev/disk/by-id et interfaces SATA / SCSI / VirtIO / IDE.",
"ogTitle": "Importer le disque vers VM | ProxMenux Documentation",
"ogDescription": "Joindre un disque physique à un Proxmox VM existant. Utilise des chemins de /dev/disk/by-id persistants et prend en charge SATA / SCSI / VirtIO / IDE."
},
"header": {
"title": "Importer le disque vers la VM",
"description": "Joindre un disque physique qui existe déjà sur l'hôte Proxmox à une machine virtuelle existante. ProxMenux détecte les disques libres, vous permet de choisir la cible VM, le type de bus (SATA / SCSI / VirtIO / IDE) et fixe tout en utilisant des chemins de /dev/disk/by-id persistants afin que la cartographie survive aux reboots et aux changements d'ordre des appareils.",
"section": "Gestionnaire de disque · VM"
},
"intro": {
"title": "Ce que ça fait",
"body": "Cette méthode utilise un disque physique brut comme support d’une interface de disque virtuel. L’invité ne reçoit pas automatiquement les données SMART natives ni les fonctions du contrôleur physique ; utilisez le passthrough PCI du contrôleur si elles sont nécessaires. Le disque est connecté via son chemin <code>/dev/disk/by-id/…</code> lorsqu’il existe, pour préserver l’affectation si l’ordre des périphériques change au démarrage ; sinon, <code>/dev/sdX</code> est utilisé."
},
"howRuns": {
"heading": "Comment fonctionne le script",
"body": "Le processus comporte deux phases distinctes : collecte des informations et des choix, puis connexion des disques à la VM. La configuration reste inchangée jusqu’à la confirmation finale.",
"summary": "ProxMenux exclut les candidats non sûrs : disque racine, disques montés sur l’hôte, membres actifs ZFS/LVM/RAID et disques référencés dans une configuration VM/LXC. Ceux comportant d’<em>anciennes</em> métadonnées ZFS/RAID/LVM inutilisées sont marqués ⚠, sans être bloqués."
},
"prereqs": {
"heading": "Préalables",
"items": [
"Au moins un VM défini sur l'hôte (le script envoie directement à <code>qm list</code>).",
"La <strong>VM cible est éteinte</strong>. Si elle fonctionne, le script s’arrête avec un message ; l’ajout à chaud de disques n’est pas pris en charge par ce processus.",
"Au moins un disque physique sur l'hôte qui n'est pas utilisé par l'hôte ou tout autre invité."
]
},
"steps": {
"heading": "Étape par étape",
"stepLabel": "Étape",
"list": [
{
"title": "Choisir la VM cible",
"bodyRich": "ProxMenux liste toutes les VM de l’hôte avec <code>qm list</code>. Choisissez celle qui recevra le disque. Si elle fonctionne, le script s’arrête et demande de l’éteindre d’abord."
},
{
"title": "Choisissez le ou les disques physiques à attacher",
"img": "/disk/disk-selection.png",
"caption": "Disques libres détectés sur l’hôte, avec ⚠ pour les anciennes métadonnées",
"body": "Le script examine les disques de l’hôte et ne propose que ceux pouvant être connectés sans conflit. La liste permet d’en sélectionner plusieurs. Les disques avec d’anciennes signatures ZFS/LVM/RAID restent affichés avec ⚠ pour indiquer qu’il faut effacer ces signatures avant leur formatage par l’invité."
},
{
"title": "Choisissez l'interface du bus",
"img": "/disk/disk-assigment.png",
"caption": "Sélection de l'interface de bus",
"intro": "Choisissez comment l'invité devrait voir le disque:",
"items": [
"<strong>SCSI</strong> — par défaut moderne pour Linux et Windows avec les pilotes VirtIO-SCSI installés.",
"<strong>SATA</strong> — large compatibilité, fonctionne hors de la boîte sur presque tous les invités.",
"<strong>VirtIO</strong> : périphérique bloc paravirtualisé efficace ; nécessite des pilotes dans l’invité.",
"<strong>IDE</strong> — pour les anciens clients qui n'ont aucun des pilotes ci-dessus."
]
},
{
"title": "Connecter et vérifier",
"bodyRich": "ProxMenux attache chaque disque sélectionné avec son meilleur chemin <code>/dev/disk/by-id/</code>, saute les index des fentes qui sont déjà utilisés dans la config VM (<code>scsi0</code>, <code>sata0</code>, ...) et relis la config pour confirmer l'assignation. Un résumé est imprimé à la fin."
}
]
},
"manual": {
"heading": "Équivalent manuel",
"body": "Le script est un wrapper autour de <code>qm set</code>. La commande exacte pour un seul disque ressemble à ceci :",
"migrationTitle": "La migration à chaud est impossible",
"migrationBody": "Une VM avec un disque physique connecté directement est <strong>liée à l’hôte qui expose ce disque</strong>. Un autre nœud ne dispose généralement ni du même chemin <code>/dev/disk/by-id/…</code> ni des données. Sauvegardez et transférez ces données séparément, ou utilisez des disques virtuels gérés sur stockage partagé ou avec réplication prise en charge. Ne supposez pas que la réplication Proxmox couvre ce périphérique.",
"shareTitle": "Ne partagez pas de disque physique entre VMs",
"shareBody": "La fixation du même disque physique à deux VMs en même temps corrompra les données sur l'écriture suivante. ProxMenux détecte cette situation et la bloque, mais si vous contournez le script (direct <code>qm set</code>), assurez-vous qu'un seul invité monte le disque."
},
"troubleshoot": {
"heading": "Dépannage",
"noDisksTitle": "\"Aucun disque disponible pour ce VM\"",
"noDisksIntro": "Le script a trouvé des disques, mais chaque candidat a été filtré. Raisons communes:",
"noDisksItems": [
"Chaque disque restant est déjà référencé dans la configuration de la cible VM.",
"Chaque disque restant est monté sur l'hôte ou fait partie d'un ZFS / LVM / RAID actif.",
"L'hôte a seulement le disque racine installé."
],
"noDisksOutro": "Exécutez <code>lsblk -f</code> sur l'hôte pour examiner l'état de chaque disque.",
"noVisibleTitle": "VM ne voit pas le disque après le démarrage",
"noVisibleBody": "Si vous avez choisi <strong>SCSI</strong> ou <strong>VirtIO</strong>, l'invité a besoin du pilote correspondant. Sur Linux qui est natif du noyau; sur Windows vous avez besoin de l'ISO VirtIO et d'un pilote d'installation (voir la page <winLink>Créer VM: Système Windows</winLink>). Le passage à SATA dans l'onglet matériel du VM est une solution rapide pour confirmer que le disque est physiquement attaché."
},
"related": {
"heading": "Voir aussi",
"items": [
{
"href": "/docs/disk-manager/import-disk-image-vm",
"label": "Importer l'image disque vers la VM",
"tail": " — même processus pour les fichiers image (qcow2 / vmdk / raw / img)."
},
{
"href": "/docs/disk-manager/import-disk-lxc",
"label": "Importer un disque vers LXC",
"tail": " — processus équivalent pour les conteneurs LXC."
},
{
"href": "/docs/disk-manager/add-controller-nvme-vm",
"label": "Ajouter un contrôleur ou un NVMe à une VM",
"tail": "— lorsque vous avez besoin d'un PCIe complet / NVMe passthrough plutôt que le disque attaché."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Commandes de stockage et de disques",
"tail": " — référence de qm importdisk et des commandes shell associées."
},
{
"href": "/docs/disk-manager",
"label": "Aperçu du gestionnaire de disque",
"tail": "."
}
]
}
}
@@ -0,0 +1,135 @@
{
"meta": {
"title": "Gestionnaire de disques Proxmox : VM/LXC, tests SMART et effacement | ProxMenux",
"description": "Gérez les disques physiques d’un hôte Proxmox VE avec ProxMenux : connexion aux VM ou LXC (qm set scsi/sata/virtio, pct mp), import d’images img / qcow2 / vmdk / raw, passthrough de HBA ou contrôleurs NVMe complets, effacement avec contrôles de sécurité et autotests SMART.",
"ogTitle": "Gestionnaire de disques Proxmox : VM/LXC, tests SMART et effacement",
"ogDescription": "Connecter des disques aux VM/LXC, importer des images, utiliser le passthrough PCI des contrôleurs, effacer avec contrôles de sécurité et lancer des tests SMART sur Proxmox VE.",
"twitterTitle": "Gestionnaire de disques Proxmox | ProxMenux",
"twitterDescription": "Connexion de disques aux VM/LXC, import d’images, passthrough PCI, effacement avec contrôles de sécurité et tests SMART."
},
"header": {
"title": "Gestionnaire de disque",
"description": "Le menu Gestionnaire de disques regroupe les outils ProxMenux pour les disques physiques de l’hôte : connexion aux VM et LXC, import d’images, passthrough d’un contrôleur complet ou d’un périphérique NVMe, effacement avec contrôles de sécurité et tests SMART.",
"section": "Gestionnaire de disque"
},
"intro": {
"title": "Ce menu sert à",
"body": "Ces outils utilisent les <strong>disques physiques visibles par l’hôte Proxmox et les fichiers image qui y sont stockés</strong>. Le menu comporte trois groupes : <strong>VM</strong> (connexion de disques ou import d’images), <strong>LXC</strong> (connexion à un conteneur) et <strong>Utilitaires</strong> (formatage et état SMART). Les opérations de connexion et d’effacement masquent ou bloquent les disques système et utilisés ; SMART peut les examiner sans les effacer."
},
"opening": {
"heading": "Ouverture du menu",
"body": "Dans le menu principal de ProxMenux, sélectionnez <strong>Disk Manager</strong>. Vous verrez ceci :",
"imageAlt": "Menu Gestionnaire de disque avec blocs VM, LXC et Utilitaires"
},
"groups": {
"heading": "Trois groupes d'outils",
"intro": "Le menu est organisé en trois groupes : <strong>VM</strong>, <strong>LXC</strong> et <strong>Utilitaires</strong>. Cliquez sur une carte pour accéder directement aux outils du groupe.",
"vmTitle": "VM",
"vmBody": "Outils qui fonctionnent sur des machines virtuelles existantes. Le VM doit être éteint; ProxMenux le valide avant de toucher la configuration.",
"vmItems": [
"Importer le disque vers la VM",
"Importer l'image disque vers la VM",
"Ajouter un contrôleur ou un NVMe à une VM"
],
"lxcTitle": "LXC",
"lxcBody": "Outils pour conteneurs LXC existants. Ce script exige un conteneur privilégié et propose de changer le paramètre si nécessaire. Lisez d’abord les précautions sur la conversion et les propriétaires des fichiers sur la page de l’outil.",
"lxcItems": [
"Importer un disque vers LXC"
],
"utilitiesTitle": "Utilitaires",
"utilitiesBody": "Outils côté hôte qui fonctionnent sur les disques eux-mêmes, indépendamment de tout VM ou conteneur.",
"utilitiesItems": [
"Formater ou effacer un disque physique",
"Santé et test du disque SMART"
]
},
"vm": {
"heading": "VM",
"intro": "Outils qui fonctionnent sur des machines virtuelles existantes. Le VM doit être éteint; ProxMenux le valide avant de toucher la configuration.",
"options": [
{
"icon": "HardDrive",
"href": "/docs/disk-manager/import-disk-vm",
"title": "Importer le disque vers la VM",
"description": "Joindre un disque physique non assigné à un VM existant. Prend en charge SATA / SCSI / VirtIO / IDE, utilise des chemins de /dev/disk/by-id persistants."
},
{
"icon": "FileDown",
"href": "/docs/disk-manager/import-disk-image-vm",
"title": "Importer l'image disque vers la VM",
"description": "Importez des images disque (.img / .qcow2 / .vmdk / .raw) dans une VM existante. Processus en deux phases utilisant qm importdisk."
},
{
"icon": "Cpu",
"href": "/docs/disk-manager/add-controller-nvme-vm",
"title": "Ajouter un contrôleur ou un NVMe à une VM",
"description": "Passthrough PCI d’un HBA SATA/SAS complet ou d’un périphérique NVMe à une VM. Gestion de l’activation d’IOMMU et de la détection des conflits."
}
]
},
"lxc": {
"heading": "LXC",
"intro": "Outils pour conteneurs LXC existants. Ce script exige un conteneur privilégié et propose de changer le paramètre si nécessaire. Lisez d’abord les précautions sur la conversion et les propriétaires des fichiers sur la page de l’outil.",
"options": [
{
"icon": "Boxes",
"href": "/docs/disk-manager/import-disk-lxc",
"title": "Importer un disque vers LXC",
"description": "Joindre un disque physique non assigné à un conteneur LXC existant comme point de montage. Gérer la détection de système de fichiers / format et la conversion privilégiée."
}
]
},
"utilities": {
"heading": "Utilitaires",
"intro": "Outils côté hôte qui fonctionnent sur les disques eux-mêmes, indépendamment de tout VM ou conteneur.",
"options": [
{
"icon": "Eraser",
"href": "/docs/disk-manager/format-disk",
"title": "Formater/effacer le disque physique (sûr)",
"description": "Effacement de disques avec des contrôles stricts : seuls les disques entièrement libres sont affichés et une double confirmation est toujours requise."
},
{
"icon": "Activity",
"href": "/docs/disk-manager/smart-disk-test",
"title": "Santé et test du disque SMART",
"description": "Exécutez des contrôles de santé SMART et des auto-tests courts/longs sur les disques SATA, SAS et NVMe. Exporte JSON pour le moniteur."
}
]
},
"safety": {
"title": "Règles de sécurité pour la connexion et l’effacement des disques",
"intro": "Les opérations de connexion et d’effacement excluent les périphériques susceptibles de nuire à l’hôte :",
"items": [
"Le <strong>disque système</strong> et les membres actifs du pool racine, du swap et de ZFS/LVM/RAID sont toujours masqués.",
"Les disques <strong> montés</strong> n'importe où sur l'hôte sont cachés ou bloqués lors de l'exécution.",
"Les disques <strong> référencés par un VM ou LXC</strong> en cours d'exécution ne peuvent pas être réaffectés ou effacés.",
"Les opérations qui peuvent modifier l'état hôte (activer IOMMU, effacer) nécessitent une confirmation explicite."
]
},
"related": {
"heading": "Voir aussi",
"items": [
{
"href": "/docs/storage-share",
"label": "Gestionnaire de stockage et de partage",
"tail": "— enregistrer le stockage dans Proxmox lui-même (NFS / Samba / iSCSI / local) et partager les dossiers entre hôte et CT."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Commandes de stockage et de disques",
"tail": " — référence des périphériques bloc, LVM, pvesm et SMART."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "Commandes de gestion ZFS",
"tail": "— pour les pools et ensembles de données ZFS."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "Ajouter GPU à VM (Passthrough)",
"tail": "— les mêmes concepts IOMMU/VFIO appliqués aux GPU."
}
]
}
}
@@ -0,0 +1,146 @@
{
"meta": {
"title": "État et tests SMART des disques | Documentation ProxMenux",
"description": "Effectuez des contrôles SMART et des tests de disques sur Proxmox VE avec ProxMenux. Prise en charge de SATA/SAS avec smartmontools et de NVMe avec nvme-cli, autotests courts et longs et export JSON pour ProxMenux Monitor.",
"ogTitle": "État et tests SMART des disques | Documentation ProxMenux",
"ogDescription": "SMART contrôles de santé et auto-tests pour les disques SATA / SAS et NVMe sur Proxmox. Exportation de JSON pour le moniteur."
},
"header": {
"title": "Santé et test du disque SMART",
"description": "Lisez les données SMART et lancez des autotests sur les disques physiques de l’hôte Proxmox. ProxMenux installe automatiquement smartmontools pour SATA/SAS et nvme-cli pour NVMe, lance les tests dans le firmware du disque (les tests longs continuent après la fermeture du terminal) et exporte les résultats JSON pour ProxMenux Monitor.",
"section": "Gestionnaire de disques · Utilitaires"
},
"intro": {
"title": "C'est pour quoi ?",
"body": "SMART (Autosurveillance, analyse et technologie de rapport) permet au lecteur lui-même de signaler sa santé et de faire des auto-tests. Cet outil expose ces données sans que vous ayez besoin de vous souvenir de la bonne invocation <code>smartctl</code> / <code>nvme</code> et persiste la sortie en tant que JSON afin que le moniteur puisse grapher les tendances au fil du temps."
},
"howRuns": {
"heading": "Comment fonctionne le script",
"body": "Toutes les actions ici sont non destructives — SMART lit les compteurs de firmware de disque, et les auto-tests sont en attente dans le lecteur lui-même. Aucune séparation de phase n'est nécessaire. Le flux est: vérification de dépendance → sélection de disque → sélection d'action → invocation d'outil (smartctl ou nvme-cli selon le bus disque) → sortie imprimée plus l'exportation de JSON pour le moniteur."
},
"deps": {
"heading": "Dépendances",
"body": "L'outil installe automatiquement ce dont il a besoin à la première fois. Les lecteurs SATA / SAS dépendent de <code>smartmontools</code>; les lecteurs NVMe dépendent de <code>nvme-cli</code>. Les deux :"
},
"actions": {
"heading": "Actions disponibles",
"headerAction": "Action",
"headerWhat": "Ce qu'il lit / exécute",
"headerDur": "Durée",
"rows": [
{
"action": "État de santé rapide",
"whatRich": "État global PASSED/FAILED et attributs clés.<br /><code>smartctl -H</code> + <code>-A</code> (SATA/SAS) ou <code>nvme smart-log</code> (NVMe).",
"dur": "Instantané"
},
{
"action": "Rapport complet",
"whatRich": "Données complètes SMART, scrollable. <code>smartctl -x</code> pour SATA/SAS ou <code>nvme smart-log</code> + <code>id-ctrl</code> pour NVMe.",
"dur": "Instantané"
},
{
"action": "Essai court",
"what": "Contrôle élémentaire de la surface et des circuits, lancé dans le firmware du disque.",
"dur": "~2 minutes"
},
{
"action": "Essai long",
"what": "Analyse complète de la surface. Elle s’exécute sur le disque et continue même si vous fermez le terminal.",
"dur": "Heures (selon la taille du disque)"
},
{
"action": "Vérifier la progression du test",
"what": "Statut de l'auto-essai actif ou le plus récent.",
"dur": "Instantané"
}
],
"tipTitle": "Les longs essais survivent à la fermeture du terminal",
"tipBody": "Un test long s’exécute <em>dans le disque</em> sans dépendre du maintien du processus ProxMenux. Vous pouvez fermer le terminal et revenir à <strong>Vérifier la progression du test</strong>. Un redémarrage de l’hôte, une réinitialisation du contrôleur ou une coupure de courant peut interrompre le test et la collecte des résultats ; ne présumez pas d’une reprise automatique."
},
"json": {
"heading": "Exportation de JSON pour le moniteur",
"intro": "Les actions d’état, de test court et de progression écrivent un JSON horodaté dans <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code> ; les résultats des tests longs sont collectés en arrière-plan. Le rapport complet est uniquement affiché. Structure :",
"outro": "ProxMenux Monitor utilise ces fichiers pour afficher l’évolution de l’état de chaque disque. Les anciens fichiers sont supprimés automatiquement lorsque la limite de conservation est atteinte."
},
"steps": {
"heading": "Étape par étape",
"stepLabel": "Étape",
"list": [
{
"title": "Choisir un disque",
"body": "ProxMenux répertorie chaque disque physique de l'hôte avec son modèle et sa taille. Contrairement à l'outil Format, cette liste n'est pas filtrée par sécurité — lire SMART est une opération non destructive.",
"img": "/disk/smart/disk-selection.png",
"alt": "Menu de sélection de disque SMART",
"caption": "Menu de sélection de disque SMART"
},
{
"title": "Choisir une action",
"body": "Choisissez entre état de santé rapide, rapport complet, test court, test long ou vérifier les progrès. Le menu reste ouvert après chaque action afin que vous puissiez enchaîner plusieurs requêtes contre le même disque.",
"img": "/disk/smart/action-menu.png",
"alt": "Menu d'action SMART",
"caption": "Menu d'action SMART (actions 5 + annulation)"
},
{
"title": "(Test long seulement) Confirmer l'exécution de fond",
"body": "ProxMenux indique que le test continuera après la fermeture du terminal et montre où sera enregistré le résultat JSON. Confirmez pour lancer le test.",
"img": "/disk/smart/long-test-warning.png",
"alt": "Boîte de dialogue de confirmation de test longue",
"caption": "Confirmation de test longue — fonctionne en arrière-plan, résultat enregistré en JSON"
},
{
"title": "Examen des résultats",
"bodyRich": "L’état, les tests et la progression s’affichent dans le terminal ; <strong>Rapport complet</strong> s’ouvre dans une boîte de dialogue défilante. Le JSON est exporté pour les actions décrites plus haut, sauf Rapport complet. Pour les tests longs, revenez à <strong>Vérifier la progression du test</strong> sur le même disque.",
"img": "/disk/smart/quick-status.png",
"alt": "État de santé rapide",
"caption": "État de santé rapide (SATA — smartctl -H + -A)"
}
]
},
"manual": {
"heading": "Équivalents manuels",
"nvmeWarnTitle": "Les autotests NVMe dépendent du firmware du disque",
"nvmeWarnBody": "Chaque lecteur NVMe ne supporte pas la commande d'auto-test courte/long. Si un lecteur refuse le test, le journal SMART et les données du contrôleur ID (<code>nvme smart-log</code> + <code>id-ctrl</code>) sont toujours le signal de santé le plus fiable."
},
"troubleshoot": {
"heading": "Dépannage",
"noSmartTitle": "\"Ne pouvait pas lire les données SMART de /dev/sdX\"",
"noSmartBody": "Le disque est probablement derrière un contrôleur RAID / SAS qui ne passe pas SMART à travers. Avec des cartes à base de megaraid, essayez <code>smartctl -d megaraid,N /dev/sdX</code>. Pour les HBA en mode IT, l'invocation directe fonctionne.",
"longTitle": "Un long test ne se termine jamais",
"longBody": "Le disque exécute le test dans son firmware et une forte activité peut le retarder. Essayez pendant une période calme, par exemple la nuit. Pour SATA, <code>smartctl -c</code> indique le pourcentage restant, et pour SAS, <code>smartctl -l selftest</code> ; le journal des autotests contient l’état final et les éventuels LBA en erreur. Une erreur de lecture doit être examinée ; la lenteur seule ne prouve pas un secteur défectueux."
},
"related": {
"heading": "Voir aussi",
"items": [
{
"href": "/docs/disk-manager/format-disk",
"label": "Formater ou effacer un disque physique",
"tail": "— réutiliser un disque après avoir confirmé sa santé."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Commandes de stockage et de disques → État SMART",
"tail": "— référence smartctl / nvme."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "Commandes de gestion ZFS",
"tail": " — zpool scrub vérifie les sommes de contrôle des données ZFS et complète les tests matériels SMART."
},
{
"href": "/docs/monitor/dashboard/storage",
"label": "ProxMenux Monitor — onglet de stockage",
"tail": " — vue détaillée du disque utilisant le JSON exporté ici : table SMART complète, historique et rapport PDF."
},
{
"href": "/docs/monitor/dashboard/hardware",
"label": "ProxMenux Monitor — Onglet matériel",
"tail": "— Sommaire de stockage avec modèle, capacité et vitesse de liaison négociée (courant vs maximum sur NVMe)."
},
{
"href": "/docs/disk-manager",
"label": "Aperçu du gestionnaire de disque",
"tail": "."
}
]
}
}
@@ -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 &lt;VMID&gt; --hostpciN &lt;pci-addr&gt;,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 &lt;addr&gt;</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 la tabella delle partizioni e i metadati di file system e RAID, azzera i primi e gli ultimi 16 MiB e, sulle unità che supportano discard, esegue il TRIM dell’intero disco. Il resto dei dati non viene sovrascritto e su un HDD potrebbe essere ancora recuperabile; non è una cancellazione sicura."
},
{
"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/&lt;CTID&gt;.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, quindi lo script si è fermato senza modificare nulla. Per continuare, eseguilo di nuovo e accetta: lo script arresta il contenitore, salva la sua configurazione in <code>/etc/pve/lxc/&lt;CTID&gt;.conf.bak</code> e sostituisce <code>unprivileged: 1</code> con <code>unprivileged: 0</code>. Questa modifica da sola non converte la proprietà UID/GID dei file esistenti: esegui prima un backup del contenitore e correggi i proprietari, oppure 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 il suo percorso <code>/dev/disk/by-id/…</code> quando esiste, così un diverso ordine di enumerazione all’avvio non interrompe l’assegnazione; altrimenti si usa <code>/dev/sdX</code>."
},
"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/&lt;disk&gt;/</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, test e avanzamento compaiono nel terminale; <strong>Rapporto completo</strong> 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 <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, <code>smartctl -c</code> mostra la percentuale rimanente, su SAS <code>smartctl -l selftest</code>; 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": "."
}
]
}
}
@@ -0,0 +1,128 @@
{
"meta": {
"title": "Adicionar controlador ou NVMe a uma VM | Documentação ProxMenux",
"description": "Atribua um controlador de armazenamento SATA/SAS HBA ou dispositivo NVMe a uma VM Proxmox por passthrough PCI com o ProxMenux. A ferramenta trata da ativação do IOMMU, deteta conflitos e configura a atribuição com qm set --hostpci.",
"ogTitle": "Adicionar controlador ou NVMe a uma VM | Documentação ProxMenux",
"ogDescription": "Atribua um HBA SATA/SAS completo ou um dispositivo NVMe a uma VM Proxmox. O ProxMenux trata do IOMMU, da deteção de conflitos e da atribuição hostpci."
},
"header": {
"title": "Adicionar controlador ou NVMe a uma VM",
"description": "Atribua um adaptador de barramento SATA/SAS completo (HBA) ou dispositivo NVMe a uma VM Proxmox por passthrough PCI. O ProxMenux verifica o IOMMU e ativa-o com o seu consentimento, lista os dispositivos elegíveis, exclui conflitos e configura a atribuição com qm set --hostpci.",
"section": "Gerenciador de disco · VM"
},
"intro": {
"title": "O que isto faz (e não faz)",
"body": "Trata-se de <strong>passthrough ao nível do dispositivo</strong>: a placa PCIe deixa de estar sob controlo do kernel do host e é associada a <code>vfio-pci</code>. A VM vê o próprio controlador, em vez de discos atribuídos individualmente, e carrega o controlador de software para esse modelo. Todos os discos ligados seguem automaticamente, com dados SMART nativos, todas as funções do firmware e sem uma camada Proxmox intermédia."
},
"howRuns": {
"heading": "Como o script é executado",
"body": "O fluxo tem duas fases com separação clara entre \"coletar informações, verificar IOMMU e listar candidatos\" e \"realmente anexar o dispositivo PCI\". Até a confirmação final nada é escrito para a configuração VM."
},
"iommu": {
"heading": "Grupos IOMMU: por que é necessário considerar a placa inteira",
"body": "O limite de isolamento do passthrough PCI é o <strong>grupo IOMMU</strong>, a menor unidade que o IOMMU da CPU consegue isolar. Os dispositivos do mesmo grupo não podem ser isolados entre si. Se um controlador SATA partilhar o grupo com um controlador USB, o passthrough SATA pode exigir libertar também o USB do host ou ser impossível. Não atribui automaticamente à VM todos os dispositivos do grupo.",
"outro": "O ProxMenux mostra o grupo IOMMU ao lado de cada dispositivo e avisa quando um grupo carrega mais do que o controlador que deseja. Você ainda pode prosseguir se os dispositivos extras do grupo são aceitáveis (todos os controladores de disco, por exemplo), ou voltar se eles não forem."
},
"prereqs": {
"heading": "Pré-requisitos",
"items": [
"<strong>A CPU e a placa-mãe suportam</strong> VT-d (Intel) ou AMD-Vi, e a função está ativa no firmware (BIOS/UEFI). O ProxMenux pode ativar a parte do kernel, mas não alterar a definição do firmware.",
"A VM de destino está <strong>desligada</strong> antes de ligar dispositivos PCI.",
"O controlador/NVMe <strong> não é aquele que detém o sistema de arquivos raiz Proxmox</strong>. O script esconde qualquer coisa em uso pela máquina.",
"O sistema operativo convidado tem os controladores de software para o modelo do controlador. O Linux suporta praticamente todos os HBA de origem; o Windows precisa do controlador do fabricante instalado <em>antes</em> de arrancar com o dispositivo atribuído."
],
"warnTitle": "A migração ao vivo não é possível",
"warnBody": "Um VM com passagem PCI está ligado ao nó que detém fisicamente o cartão. A migração ao vivo nos nós irá falhar. Planeje backups/replicação em conformidade."
},
"steps": {
"heading": "Passo a passo",
"stepLabel": "Etapa",
"list": [
{
"title": "Escolher a VM de destino",
"bodyRich": "ProxMenux lê <code>qm list</code> e mostra cada VM. Escolha o que receberá o controlador.",
"img": "/disk/nvme-passthrough/vm-selection.png",
"alt": "Diálogo de seleção do VM",
"caption": "Diálogo de seleção do VM"
},
{
"title": "Verificação IOMMU",
"bodyRich": "Se o IOMMU não estiver habilitado na linha cmdline do kernel, o ProxMenux oferece para habilitá-lo. Ele edita <code>/etc/kernel/cmdline</code> (para systemd-boot) ou <code>/etc/default/grub</code> (para GRUB) e adiciona o parâmetro correto para o seu CPU:",
"items": [
"<code>intel_iommu=on</code> para CPUs Intel.",
"<code>amd_iommu=on</code> para CPUs AMD."
],
"outro": "Uma reinicialização é necessária após esta alteração. O script pede que você reinicie agora ou mais tarde; a passagem não pode continuar até que o novo kernel cmdline esteja ativo.",
"img": "/disk/nvme-passthrough/iommu-warning.png",
"alt": "Diálogo IOMMU necessário",
"caption": "IOMMU Necessário — oferta para ativar e reiniciar"
},
{
"title": "Enumeração do dispositivo",
"body": "ProxMenux lista cada controlador de armazenamento (SATA / SAS HBA) e cada dispositivo NVMe no barramento PCI. Para cada dispositivo, mostra:",
"items": [
"Endereço PCI (<code>00:17.0</code>, <code>01:00.0</code>, ...).",
"Descrição do fornecedor / dispositivo.",
"Grupo IOMMU, com um aviso ⚠ se for partilhado com outros dispositivos não relacionados.",
"Os discos atualmente por trás do controlador (então você sabe o que irá segui-lo para o VM)."
],
"img": "/disk/nvme-passthrough/device-list.png",
"alt": "Controlador / enumeração do dispositivo NVMe",
"caption": "Controlador / NVMe enumeração do dispositivo com informações do grupo IOMMU"
},
{
"title": "Detecção de conflitos",
"bodyRich": "O script bloqueia dispositivos claramente inseguros: já atribuídos a outra VM através de <code>hostpci</code> na respetiva configuração, utilizados pelo host como o controlador do disco raiz, ou num grupo IOMMU cujos outros membros não consegue identificar com segurança. Os dispositivos elegíveis ficam disponíveis para seleção.",
"img": "/disk/nvme-passthrough/conflict-warning.png",
"alt": "Aviso de detecção de conflitos",
"caption": "Detecção de conflitos — dispositivo bloqueado com razão"
},
{
"title": "Anexar e finalizar",
"bodyRich": "Para cada dispositivo selecionado ProxMenux roda <code>qm set &lt;VMID&gt; --hostpciN &lt;pci-addr&gt;,pcie=1</code>, escolhendo o próximo slot livre <code>hostpci</code>. Se IOMMU foi habilitado durante esta sessão você é lembrado para reiniciar antes de iniciar o VM.",
"img": "/disk/nvme-passthrough/assignment.png",
"alt": "Resumo da atribuição",
"caption": "Resumo da atribuição — slots hostpciN e endereços PCI anexados"
}
]
},
"manual": {
"heading": "Equivalente manual"
},
"troubleshoot": {
"heading": "Resolução de Problemas",
"noGroupsTitle": "IOMMU activado, mas sem grupos sob /sys/kernel/iommu_groups/",
"noGroupsBody": "É necessário reiniciar para que a linha cmdline do kernel faça efeito. Se os grupos ainda estiverem faltando após o reinício, o VT-d / AMD-Vi provavelmente estará desativado no firmware — verifique a configuração BIOS/UEFI.",
"busyTitle": "A VM não inicia: \"hostpciN: device busy\"",
"busyBody": "Outro processo mantém o dispositivo PCI ocupado. As causas mais comuns são uma VM que falhou sem o libertar ou o kernel do host que o recuperou no último arranque. Execute <code>lspci -nnk -s &lt;addr&gt;</code> para ver o controlador de software associado; deve ser <code>vfio-pci</code>. Um reinício completo do host costuma resolver o problema.",
"noDisksTitle": "Convidado vê o controlador, mas não os discos",
"noDisksBody": "Falta no sistema convidado o controlador de software para esse modelo. No Linux é raro, mas acontece no Windows: instale o controlador do fabricante, por exemplo LSI/Broadcom para HBA SAS antigos, com a placa não atribuída, e reinicie depois de a atribuir.",
"sharedTitle": "O grupo IOMMU inclui um dispositivo não relacionado",
"sharedBody": "Opções: (a) mover a placa para outra ranhura PCIe para alterar o grupo, (b) ativar <em>ACS override</em> no kernel para dividir grupos (compromisso de segurança: informe-se antes de aplicar), ou (c) escolher outra placa num grupo mais isolado."
},
"related": {
"heading": "Relacionado",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importar disco para VM",
"tail": " — modelo alternativo: anexar um disco físico via Proxmox sem passagem PCIe completa."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "Adicionar GPU a uma VM (passthrough)",
"tail": " — os mesmos conceitos IOMMU / VFIO aplicados a um GPU."
},
{
"href": "/docs/help-info/gpu-commands",
"label": "Comandos de passagem GPU",
"tail": " — Os comandos de verificação IOMMU também se aplicam à passagem do controlador / NVMe."
},
{
"href": "/docs/disk-manager",
"label": "Visão geral do Gerenciador de Discos",
"tail": "."
}
]
}
}
@@ -0,0 +1,142 @@
{
"meta": {
"title": "Formatar ou apagar um disco físico | Documentação ProxMenux",
"description": "Apague e formate discos físicos no Proxmox VE com o ProxMenux. Quatro modos, filtros rigorosos que bloqueiam discos de sistema, montados ou em uso e confirmação dupla com introdução do caminho completo.",
"ogTitle": "Formatar ou apagar um disco físico | Documentação ProxMenux",
"ogDescription": "Limpar ou formatar com segurança um disco físico no Proxmox. Regras de visibilidade seguras, modos de operação 4, dupla confirmação."
},
"header": {
"title": "Formatar ou apagar um disco físico",
"description": "Limpar ou formatar com segurança um disco físico no host Proxmox. ProxMenux só mostra discos totalmente livres (sem uso do sistema, sem referência de convidado, sem montagens) e força uma confirmação dupla — sim/não mais digitando o caminho do disco completo — antes de destruir quaisquer dados.",
"section": "Gerenciador de disco · Utilitários"
},
"danger": {
"title": "Ferramenta destrutiva",
"body": "Cada operação aqui escreve para o disco. Não há nada a desfazer. ProxMenux aplica rigorosos filtros de segurança e confirmações, mas a responsabilidade pela escolha do disco certo é sua. Leia o caminho do disco em voz alta duas vezes antes de digitá-lo."
},
"howRuns": {
"heading": "Como o script é executado",
"body": "O fluxo tem duas fases com um filtro de segurança de porta tripla no meio. A lista de discos, o modo de operação e os detalhes do sistema de arquivos são todos coletados na Fase 1; nada é escrito até que a Fase 2 passe uma revalidação final logo antes de executar."
},
"visibility": {
"heading": "Regras de visibilidade",
"intro": "Antes mesmo do menu aparecer, o ProxMenux filtra a lista de discos. Apenas os candidatos que são comprovadamente seguros são mostrados:",
"items": [
"<strong>Mostrados</strong>: discos <em>não</em> utilizados pelo host (pool raiz, swap, montagens, ZFS/LVM/RAID ativos) e <em>não</em> referenciados em configurações de VM/LXC, em execução ou paradas.",
"<strong>Ocultos</strong>: discos do host e do sistema.",
"<strong>Ocultos</strong>: discos referenciados numa configuração VM/LXC."
],
"safetyTitle": "Segurança na confirmação e execução",
"safetyItems": [
"Os discos com metadados antigos ou ativos mostram avisos detalhados <em>antes</em> da confirmação.",
"Os discos utilizados por uma VM <strong>em execução</strong> são <strong>bloqueados sem exceção</strong> na confirmação.",
"Os discos com partições montadas são <strong>bloqueados sem exceção</strong> na execução. Uma nova verificação é realizada imediatamente antes de qualquer escrita.",
"São sempre necessárias duas confirmações: um diálogo <em>sim/não</em> e a introdução exata do caminho completo do disco."
]
},
"modes": {
"heading": "Modos de operação",
"intro": "Depois de escolher um disco você escolhe um dos quatro modos. Divergem no que destroem e no que deixam para trás.",
"headerMode": "Modo",
"headerPart": "Tabela de partições",
"headerData": "Dados",
"headerUseCase": "Caso de uso",
"rows": [
{
"mode": "1. Limpar tudo",
"part": "Destruído",
"data": "Assinaturas apagadas",
"useCase": "Remove a tabela de partições e os metadados de sistemas de ficheiros e RAID, preenche com zeros os primeiros e os últimos 16 MiB e, nas unidades que suportam discard, aplica TRIM a todo o disco. O resto dos dados não é sobrescrito e ainda pode ser recuperável num HDD; não é um apagamento seguro."
},
{
"mode": "2. Remover rótulos FS",
"part": "Preservado",
"data": "Preservado",
"useCase": "Remove assinaturas antigas de ZFS / LVM / RAID para evitar a utilização automática do disco. Os dados do utilizador não são sobrescritos em bloco, mas a remoção das assinaturas pode torná-los inacessíveis."
},
{
"mode": "3. Sobrescrever os dados com zeros",
"part": "Preservado",
"data": "Destruídos (sobrescritos com zeros)",
"useCase": "Sobrescreve com zeros as partições existentes, mantendo a tabela de partições. Não abrange espaço não atribuído nem áreas de reserva dos SSD; não garante a sanitização completa do dispositivo."
},
{
"mode": "4. Formato completo",
"part": "Novo GPT",
"data": "Destruído",
"useCase": "Disco pronto a usar com uma nova partição e um novo sistema de ficheiros."
}
],
"fullFormatOutro": "<strong>Formato completo</strong> continua com duas janelas extras:",
"fullFormatItems": [
"<strong>Filesystem</strong> — <code>ext4</code>, <code>xfs</code>, <code>exfat</code> (portátil), ou <code>btrfs</code>. As ferramentas em falta (por exemplo, <code>mkfs.btrfs</code>) abortam com uma mensagem clara.",
"<strong>Etiqueta</strong>: nome opcional do sistema de ficheiros para identificação."
]
},
"steps": {
"heading": "Passo a passo",
"stepLabel": "Etapa",
"list": [
{
"title": "Escolha um disco livre",
"body": "O ProxMenux lista os discos que passam nos filtros acima. Os discos marcados com ⚠ contêm metadados antigos, apresentados em detalhe para saber o que vai sobrescrever."
},
{
"title": "Escolha um modo de operação",
"bodyRich": "Escolha <strong>Limpar tudo</strong>, <strong>Remover rótulos FS</strong>, <strong>Sobrescrever os dados com zeros</strong> ou <strong>Formato completo</strong> de acordo com a tabela acima."
},
{
"title": "(Apenas formato completo) Escolha o sistema de arquivos e a etiqueta",
"body": "ext4 / xfs / exfat / btrfs, além de uma etiqueta opcional."
},
{
"title": "Confirmar duas vezes",
"bodyRich": "O ProxMenux mostra um resumo da operação. Aceite no diálogo sim/não e <strong>introduza o caminho completo do disco</strong> exatamente como indicado, por exemplo <code>/dev/sdc</code>. Qualquer outra entrada cancela a operação."
},
{
"title": "Revalidação e execução",
"body": "Pouco antes de escrever, o script verifica novamente o estado do disco. Se uma partição tiver sido montada ou uma VM tiver sido iniciada, a execução será interrompida. Caso contrário, a operação escolhida é executada e um resumo é impresso no final."
}
]
},
"manual": {
"heading": "Equivalentes manuais",
"body": "Se preferir executar os comandos equivalentes à mão:"
},
"troubleshoot": {
"notListedTitle": "Disco não listado no menu",
"notListedBody": "Foi filtrado por segurança. Razões comuns: é montado (mesmo em <code>/mnt/tmp</code>), é um ZFS / LVM / RAID membro, é referenciado por um VM ou LXC config, ou é seu disco raiz Proxmox. Execute <code>lsblk -f</code> e <code>cat /proc/mdstat</code> no host para entender o porquê.",
"busyTitle": "\"Disk may be busy\" / falha ao desmontar",
"busyBody": "Algo ainda está segurando um arquivo aberto em uma partição desse disco — na maioria das vezes um recipiente ou uma shell cujo cwd está dentro de um ponto de montagem. Identifique-o com <code>lsof | grep /dev/sdX</code> ou <code>fuser -vm /dev/sdX1</code>, pare-o e, em seguida, execute novamente a ferramenta."
},
"related": {
"heading": "Relacionado",
"items": [
{
"href": "/docs/disk-manager/smart-disk-test",
"label": "Integridade e teste do disco SMART",
"tail": " — verificar um disco antes / após limpar para confirmar que é saudável."
},
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importar disco para VM",
"tail": " — passar um disco recém-formatado para um VM."
},
{
"href": "/docs/storage-share/host-local-disk",
"label": "Adicionar o disco local como armazenamento Proxmox",
"tail": " — registar um disco apagado como conjunto de armazenamento Proxmox."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Comandos de armazenamento e discos",
"tail": " — referência de lsblk, blkid e parted."
},
{
"href": "/docs/disk-manager",
"label": "Visão geral do Gerenciador de Discos",
"tail": "."
}
]
}
}
@@ -0,0 +1,110 @@
{
"meta": {
"title": "Importar imagem de disco para uma VM | Documentação ProxMenux",
"description": "Importar um arquivo de imagem de disco (.img / .qcow2 / .vmdk / .raw) para um Proxmox VM existente usando ProxMenux. Interface por imagem, emulação SSD e bandeira inicializável, com qm importdisk sob o capô.",
"ogTitle": "Importar imagem de disco para uma VM | Documentação ProxMenux",
"ogDescription": "Importar imagens de disco .img / .qcow2 / .vmdk / .raw para um VM existente com ProxMenux. Usa o 'qm importdisk' sob o capô."
},
"header": {
"title": "Importar imagem de disco para VM",
"description": "Importar um arquivo de imagem de disco (.img, .qcow2, .vmdk ou .raw) para um Proxmox VM existente. ProxMenux coleta cada decisão inicial — destino VM, armazenamento Proxmox, diretório fonte, interface, emulação SSD, ordem de inicialização — e então executa qm importdisk para cada imagem selecionada.",
"section": "Gerenciador de disco · VM"
},
"intro": {
"title": "O que isto faz",
"body": "Ao contrário de <em>Importar disco para VM</em>, que atribui um disco físico diretamente, este processo utiliza um <strong>ficheiro</strong> no host, exportado de outro hipervisor, transferido como imagem cloud ou extraído de uma cópia de segurança. Converte-o num disco de VM Proxmox no armazenamento escolhido. O original é preservado: o ProxMenux copia-o, não o move."
},
"howRuns": {
"heading": "Como o script é executado",
"body": "O fluxo tem duas fases. A fase 1 recolhe todas as decisões (VM, armazenamento, directório de origem, imagens, opções de imagem) à frente através de diálogos. Fase 2 executa <code>qm importdisk</code> para cada imagem selecionada. Até o início da Fase 2, nada é copiado e a configuração VM não é tocada."
},
"prereqs": {
"heading": "Pré-requisitos",
"items": [
"Pelo menos uma VM definida no host. A VM de destino deve estar <strong>desligada</strong>.",
"Pelo menos um arquivo de imagem de um formato suportado no diretório fonte. Suportado: <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code>, <code>.raw</code>.",
"Espaço livre suficiente no armazenamento Proxmox alvo para segurar cada disco importado.",
"ProxMenux procura imagens em <code>/var/lib/vz/template/iso</code> por padrão. Você pode apontá-lo para qualquer outro diretório no host quando ele perguntar."
]
},
"steps": {
"heading": "Passo a passo",
"stepLabel": "Etapa",
"list": [
{
"title": "Escolher a VM de destino",
"bodyRich": "ProxMenux lê <code>qm list</code> e mostra cada VM. Escolha o que receberá o(s) disco(s) importado(s)."
},
{
"title": "Escolha o armazenamento do Proxmox",
"bodyRich": "A lista contém cada armazenamento que tem o tipo de conteúdo <code>images</code> habilitado. Se houver apenas um candidato, ele é selecionado automaticamente e a janela é ignorada."
},
{
"title": "Escolha o diretório de origem",
"bodyRich": "Escolha o diretório padrão (<code>/var/lib/vz/template/iso</code>) ou digite um caminho personalizado — normalmente onde você baixou / enviou a imagem. O script rejeita caminhos que não existem."
},
{
"title": "Escolha uma ou várias imagens",
"bodyRich": "O diretório é escaneado para arquivos <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code>. Você pode selecionar vários de uma vez; cada um irá passar pelas opções por imagem no próximo passo."
},
{
"title": "Opções por imagem",
"intro": "Para cada imagem selecionada, o ProxMenux pergunta:",
"items": [
"<strong>Interface</strong> — <code>scsi</code> (padrão), <code>virtio</code>, <code>sata</code> ou <code>ide</code>. Corresponde à forma como o hóspede vai ver o disco.",
"<strong>Emulação SSD</strong>: apenas para interfaces que não sejam VirtIO. Adiciona <code>ssd=1</code> para o sistema convidado reconhecer um disco de estado sólido. O suporte de discard/TRIM tem de ser configurado separadamente.",
"<strong>De arranque</strong>: se responder sim, o ProxMenux adiciona o disco à ordem de arranque como dispositivo principal da VM."
]
},
{
"title": "Importar e anexar",
"bodyRich": "O ProxMenux executa o <code>qm importdisk</code> para cada imagem (formato de conversão na hora, onde necessário), liga o disco resultante ao próximo slot livre (<code>scsiN</code>, <code>sataN</code>, ...) com as opções escolhidas e — se você marcou qualquer disco como inicializável — atualiza a ordem de inicialização. O progresso mostra-se no terminal."
}
]
},
"manual": {
"heading": "Equivalente manual",
"body": "A importação de uma única imagem corresponde a três comandos <code>qm</code>:",
"warnTitle": "Conversão do formato da imagem",
"warnBody": "Quando o armazenamento de destino não pode conter o formato de origem nativamente (por exemplo, o armazenamento LVM não pode conter <code>.qcow2</code>), <code>qm importdisk</code> converte a imagem de forma transparente. Isso pode levar vários minutos para imagens multi-GB; planejar de acordo com isso e não interromper o script."
},
"troubleshoot": {
"heading": "Resolução de Problemas",
"noImagesTitle": "\"Nenhuma imagem de disco compatível encontrada\"",
"noImagesBody": "O script não encontrou ficheiros <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code> ou <code>.raw</code>. Verifique a extensão, distinguindo maiúsculas e minúsculas, se o ficheiro está diretamente no diretório escolhido (os subdiretórios não são pesquisados) e se root o pode ler.",
"slowTitle": "A importação é lenta",
"slowBody": "As conversões entre VMDK, QCOW2 e raw podem ser limitadas pela CPU e E/S. A velocidade depende das leituras na origem, das escritas no destino e da eventual descompressão. Prefira fontes raw ou qcow2 quando possível.",
"uefiTitle": "O disco importado arranca na shell UEFI",
"uefiBody": "A imagem foi construída para legado (SeaBIOS), mas o VM usa OVMF (ou vice-versa). Alternar o VM do BIOS no Proxmox para corresponder à imagem, ou reconstruir a imagem no modo correto antes de importar."
},
"related": {
"heading": "Relacionado",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importar disco para VM",
"tail": " — mesmo fluxo, mas para discos físicos brutos (passagem)."
},
{
"href": "/docs/utils/import-vm",
"label": "Importar VM de OVA / OVF",
"tail": " — quando você tem um pacote completo VM, não apenas uma imagem de disco."
},
{
"href": "/docs/utils/UUp-Dump-ISO-Creator",
"label": "Criador de ISO do UUP Dump",
"tail": " — gerar uma ISO do Windows se necessitar de uma nova instalação."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Comandos de armazenamento e discos",
"tail": " — referência de qm importdisk e qemu-img convert."
},
{
"href": "/docs/disk-manager",
"label": "Visão geral do Gerenciador de Discos",
"tail": "."
}
]
}
}
@@ -0,0 +1,115 @@
{
"meta": {
"title": "Importar o Disco para LXC | ProxMenux Documentação",
"description": "Anexar um disco físico a um recipiente LXC existente em Proxmox VE usando ProxMenux. Lida com detecção / formatação do sistema de arquivos, ponto de montagem, sem privilégios → conversões privilegiadas e caminhos persistentes do dispositivo.",
"ogTitle": "Importar o Disco para LXC | ProxMenux Documentação",
"ogDescription": "Anexar um disco físico a um recipiente LXC existente. Lida com sistema de arquivos, ponto de montagem e sem privilégios → conversão privilegiada."
},
"header": {
"title": "Importar disco para LXC",
"description": "Ligue um disco físico a um contentor LXC existente no host Proxmox. O ProxMenux deteta discos livres, permite formatá-los com um sistema de ficheiros suportado e liga a partição a um ponto de montagem dentro do contentor através de caminhos persistentes do dispositivo.",
"section": "Gerenciador de disco · LXC"
},
"intro": {
"title": "Passthrough em VM e em LXC",
"body": "Este passthrough LXC <strong>não fornece um dispositivo de bloco bruto</strong>. O contentor recebe um <em>ponto de montagem</em>, ou seja, um diretório numa partição escolhida no host. Ao contrário de uma VM, utiliza o kernel do host: o sistema de ficheiros (ext4/xfs/btrfs) é lido e gerido pelo host Proxmox e depois disponibilizado ao contentor."
},
"howRuns": {
"heading": "Como o script é executado",
"body": "O fluxo tem duas fases com separação clara entre \"coletar informações e decisões\" e \"na verdade mudar a configuração do recipiente\". Até à confirmação final, nada é montado no CT.",
"summary": "O ProxMenux exclui o disco raiz, os discos montados e os referenciados em configurações VM/LXC. Os membros ativos de ZFS/LVM/RAID são ocultos; as assinaturas antigas aparecem com ⚠ para poderem ser apagadas antes da formatação."
},
"prereqs": {
"heading": "Pré-requisitos",
"items": [
"Pelo menos um recipiente LXC definido no hospedeiro.",
"O contentor é <strong>privilegiado</strong> ou aceita a conversão proposta pelo script.",
"Pelo menos um disco físico que não está em uso pelo host ou por qualquer outro convidado."
],
"warnTitle": "Recipiente privilegiado necessário",
"warnBody": "Este script exige um contentor <strong>privilegiado</strong> para ligar diretamente o disco. Se detetar <code>unprivileged: 1</code>, oferece editar <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code> no local. Isso altera o modelo de segurança sem remapear os proprietários dos ficheiros existentes. Faça uma cópia de segurança e verifique os proprietários antes de aceitar, ou recrie o contentor como privilegiado."
},
"steps": {
"heading": "Passo a passo",
"stepLabel": "Etapa",
"list": [
{
"title": "Escolher o contentor de destino",
"img": "/disk/select-container.png",
"caption": "Menu de seleção do contentor",
"bodyRich": "ProxMenux lista cada recipiente LXC no host (<code>pct list</code>). Escolha o que vai receber o disco. Se o recipiente não tiver privilégios, é-lhe oferecido converter agora."
},
{
"title": "Escolha o disco físico",
"img": "/disk/disk-selection-ct.png",
"caption": "Discos livres detetados no host, com ⚠ para metadados antigos",
"bodyRich": "Só são mostrados candidatos seguros. Ao contrário do processo para VM, este script liga <strong>um disco por execução</strong>. Execute-o novamente para cada disco adicional."
},
{
"title": "Formatar ou reutilizar",
"intro": "O script inspeciona o disco:",
"items": [
"Se ele já carrega um sistema de arquivos suportado (ext4 / xfs / btrfs) você pode reutilizá-lo como está (os arquivos existentes são preservados).",
"Se não tiver nenhum sistema de arquivos suportado, você é oferecido para formatá-lo. Escolha ext4 / xfs / btrfs."
]
},
{
"title": "Escolha o ponto de montagem",
"bodyRich": "Introduza o caminho onde o contentor verá o disco, por exemplo <code>/mnt/data</code> ou <code>/mnt/disk_passthrough</code>. É o caminho <em>dentro</em> do contentor; o host já vê a partição em <code>/dev/disk/by-id/…</code>."
},
{
"title": "Anexar e verificar",
"img": "/disk/assignment-ct.png",
"caption": "Atribuição a CT",
"bodyRich": "O ProxMenux adiciona uma entrada <code>mpN:</code> nova à configuração do recipiente, ignorando índices já em uso e re-leia a configuração para confirmar. Se o recipiente estiver rodando, a montagem será executada ao vivo; caso contrário, fará efeito no próximo início.",
"extraImg": "/disk/result-point.png",
"extraAlt": "Ponto de montagem criado com sucesso",
"extraCaption": "Ponto de montagem criado e verificado"
}
]
},
"manual": {
"heading": "Equivalente manual",
"body": "O script envolve <code>pct set</code>. Uma invocação direta para um único disco parece:"
},
"important": {
"heading": "Considerações importantes",
"items": [
"<strong>Um disco por execução</strong>. Repita o script para cada disco adicional.",
"<strong>Não</strong> ligue a mesma partição a vários contentores que a possam montar simultaneamente: escritas concorrentes corrompem o sistema de ficheiros.",
"<strong>Os metadados antigos</strong> (assinaturas RAID/ZFS/LVM) têm de ser apagados manualmente antes de o script permitir a formatação; caso contrário, <code>mkfs</code> recusa sobrescrever. Utilize <wipeLink>Formatar ou apagar um disco físico</wipeLink>."
]
},
"troubleshoot": {
"heading": "Resolução de Problemas",
"unprivTitle": "\"Não posso continuar com um contentor sem privilégios\"",
"unprivBody": "Recusou a conversão, por isso o script terminou sem alterar nada. Para continuar, execute-o novamente e aceite: o script para o contentor, guarda uma cópia da configuração em <code>/etc/pve/lxc/&lt;CTID&gt;.conf.bak</code> e substitui <code>unprivileged: 1</code> por <code>unprivileged: 0</code>. Essa alteração, por si só, não converte os UID/GID dos ficheiros existentes; faça antes uma cópia de segurança do contentor e corrija os proprietários, ou restaure ou recrie o contentor como privilegiado.",
"permsTitle": "Permissões dentro do recipiente estão erradas",
"permsBody": "Montar uma partição num contentor privilegiado mantém os proprietários existentes; um sistema de ficheiros novo pertence frequentemente a <code>root:root</code>. Se o serviço usar outro utilizador, por exemplo <code>www-data</code> para Nextcloud, verifique o UID/GID e ajuste os ficheiros necessários com <code>chown</code>/<code>chmod</code>. As alterações também afetam o disco subjacente."
},
"related": {
"heading": "Relacionado",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importar disco para VM",
"tail": " — fluxo equivalente para VMs."
},
{
"href": "/docs/storage-share/lxc-mount-points",
"label": "Pontos de montagem LXC (Host ↔ CT)",
"tail": " — compartilhar diretórios de host com um CT em vez de anexar um disco inteiro."
},
{
"href": "/docs/help-info/vm-ct-commands",
"label": "Comandos de gestão VM e CT",
"tail": " — pct config / push / pull referência."
},
{
"href": "/docs/disk-manager",
"label": "Visão geral do Gerenciador de Discos",
"tail": "."
}
]
}
}
@@ -0,0 +1,113 @@
{
"meta": {
"title": "Importar o Disco para VM | ProxMenux Documentação",
"description": "Anexar um disco físico a um Proxmox VM existente com ProxMenux. Detecção segura de disco (exclui sistema, montado, em uso, ZFS/RAID/LVM), caminhos /dev/disk/by-id persistentes e interfaces SATA / SCSI / VirtIO / IDE.",
"ogTitle": "Importar o Disco para VM | ProxMenux Documentação",
"ogDescription": "Anexar um disco físico a um Proxmox VM existente. Usa caminhos /dev/disk/by-id persistentes e suporta SATA / SCSI / VirtIO / IDE."
},
"header": {
"title": "Importar disco para VM",
"description": "Anexar um disco físico que já existe na máquina Proxmox a uma máquina virtual existente. ProxMenux detecta discos livres, permite que você escolha o alvo VM, o tipo de barramento (SATA / SCSI / VirtIO / IDE) e liga tudo usando caminhos /dev/disk/by-id persistentes para que o mapeamento sobreviva a reinicialização e alterações de ordem do dispositivo.",
"section": "Gerenciador de disco · VM"
},
"intro": {
"title": "O que isto faz",
"body": "Liga um disco físico bruto como dispositivo subjacente de uma interface de disco virtual. O sistema convidado não recebe automaticamente os dados SMART nativos nem as funções do controlador físico; utilize passthrough PCI do controlador se forem necessários. O disco é ligado pelo seu caminho <code>/dev/disk/by-id/…</code> quando existe, para manter a atribuição se a ordem dos dispositivos mudar no arranque; caso contrário, é usado <code>/dev/sdX</code>."
},
"howRuns": {
"heading": "Como o script é executado",
"body": "O fluxo tem duas fases com separação clara entre \"coletar informações e decisões\" e \"realmente anexar discos ao VM\". Até a confirmação final, a configuração VM não é tocada.",
"summary": "O ProxMenux exclui candidatos inseguros: disco raiz, discos montados no host, membros ativos ZFS/LVM/RAID e discos referenciados em configurações VM/LXC. Os discos com metadados <em>antigos</em>, ou seja, assinaturas ZFS/RAID/LVM já não utilizadas, aparecem com ⚠ mas não são bloqueados."
},
"prereqs": {
"heading": "Pré-requisitos",
"items": [
"Pelo menos um VM definido no host (o script envia diretamente para <code>qm list</code>).",
"A <strong>VM de destino está desligada</strong>. Se estiver em execução, o script para com uma mensagem; a adição de discos em funcionamento não faz parte deste processo.",
"Pelo menos um disco físico no host que não está em uso pelo host ou qualquer outro hóspede."
]
},
"steps": {
"heading": "Passo a passo",
"stepLabel": "Etapa",
"list": [
{
"title": "Escolher a VM de destino",
"bodyRich": "O ProxMenux lista todas as VM do host com <code>qm list</code>. Escolha a que receberá o disco. Se estiver em execução, o script para e pede que a desligue primeiro."
},
{
"title": "Escolha o( s) disco( s) físico( s) a anexar",
"img": "/disk/disk-selection.png",
"caption": "Discos livres detetados no host, com ⚠ para metadados antigos",
"body": "O script examina os discos do host e mostra apenas os que podem ser ligados sem conflitos. Pode selecionar vários. Os discos com assinaturas antigas ZFS/LVM/RAID continuam visíveis com ⚠ para indicar que as assinaturas devem ser apagadas antes de o sistema convidado os formatar."
},
{
"title": "Escolha a interface de barramento",
"img": "/disk/disk-assigment.png",
"caption": "Seleção da interface de barramento",
"intro": "Escolha como o hóspede deve ver o disco:",
"items": [
"<strong>SCSI</strong> — padrão moderno para Linux e Windows com drivers VirtIO-SCSI instalados.",
"<strong>SATA</strong> — ampla compatibilidade, funciona fora da caixa em praticamente todos os hóspedes.",
"<strong>VirtIO</strong>: dispositivo de bloco paravirtualizado eficiente; exige controladores de software no sistema convidado.",
"<strong>IDE</strong> — para os hóspedes legados que não possuem nenhum dos drivers acima."
]
},
{
"title": "Anexar e verificar",
"bodyRich": "ProxMenux liga cada disco selecionado com seu melhor caminho <code>/dev/disk/by-id/</code>, salta os índices de slot que já estão em uso na configuração VM (<code>scsi0</code>, <code>sata0</code>, ...) e re-ler a configuração para confirmar a atribuição. Um resumo é impresso no final."
}
]
},
"manual": {
"heading": "Equivalente manual",
"body": "O script é uma embalagem em torno de <code>qm set</code>. O comando exato para um único disco se parece com este:",
"migrationTitle": "A migração ao vivo não é possível",
"migrationBody": "Uma VM com um disco físico ligado diretamente fica <strong>dependente do host que disponibiliza esse disco</strong>. Outro nó normalmente não tem o mesmo caminho <code>/dev/disk/by-id/…</code> nem os dados. Faça cópias de segurança e transfira os dados separadamente, ou utilize discos virtuais geridos em armazenamento partilhado ou com replicação suportada. Não pressuponha que a replicação do Proxmox abrange este dispositivo.",
"shareTitle": "Não compartilhar um disco físico entre VMs",
"shareBody": "Anexar o mesmo disco físico a duas VMs ao mesmo tempo irá corromper os dados na próxima gravação. ProxMenux detecta esta situação e bloqueia-a, mas se você ignorar o script (direto <code>qm set</code>), certifique-se de que apenas um convidado monta o disco."
},
"troubleshoot": {
"heading": "Resolução de Problemas",
"noDisksTitle": "\"Nenhum disco disponível para este VM\"",
"noDisksIntro": "O script encontrou discos, mas todos os candidatos foram filtrados. Razões comuns:",
"noDisksItems": [
"Cada disco restante já está referenciado na configuração do VM.",
"Cada disco restante é montado na máquina ou faz parte de um ZFS / LVM / RAID ativo.",
"A máquina só tem o disco raiz instalado."
],
"noDisksOutro": "Execute <code>lsblk -f</code> no host para rever o estado de cada disco.",
"noVisibleTitle": "O VM não vê o disco após o arranque",
"noVisibleBody": "Se você escolheu <strong>SCSI</strong> ou <strong>VirtIO</strong>, o hóspede precisa do driver correspondente. No Linux que é nativo do kernel; no Windows você precisa da ISO VirtIO e de uma instalação de driver (veja a página <winLink>Criar VM: Sistema Windows</winLink>). Mudar para SATA na guia de hardware do VM é uma solução rápida para confirmar que o disco está fisicamente ligado."
},
"related": {
"heading": "Relacionado",
"items": [
{
"href": "/docs/disk-manager/import-disk-image-vm",
"label": "Importar imagem de disco para VM",
"tail": " — mesmo fluxo mas para arquivos de imagem (qcow2 / vmdk / raw / img)."
},
{
"href": "/docs/disk-manager/import-disk-lxc",
"label": "Importar disco para LXC",
"tail": " — processo equivalente para contentores LXC."
},
{
"href": "/docs/disk-manager/add-controller-nvme-vm",
"label": "Adicionar controlador ou NVMe a uma VM",
"tail": " — quando necessitar de uma passagem completa PCIe / NVMe em vez de anexar o disco."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Comandos de armazenamento e discos",
"tail": " — qm importdisk e referência de shell correspondente."
},
{
"href": "/docs/disk-manager",
"label": "Visão geral do Gerenciador de Discos",
"tail": "."
}
]
}
}
@@ -0,0 +1,135 @@
{
"meta": {
"title": "Gestor de discos Proxmox: VM/LXC, testes SMART e eliminação | ProxMenux",
"description": "Faça a gestão de discos físicos num host Proxmox VE com o ProxMenux: ligue discos a VM ou LXC (qm set scsi/sata/virtio, pct mp), importe imagens img / qcow2 / vmdk / raw, atribua HBA ou controladores NVMe completos, apague discos com verificações de segurança e execute autotestes SMART.",
"ogTitle": "Gerenciador de disco Proxmox — Anexar discos a VMs / LXC, testes SMART, limpa",
"ogDescription": "Anexar discos a VMs / LXC, importar imagens de disco, passagem PCI para controladores, limpeza segura e testes SMART em Proxmox VE.",
"twitterTitle": "Gestor de discos Proxmox | ProxMenux",
"twitterDescription": "Anexar discos a VMs / LXC, imagens de importação, passagem PCI, limpeza segura e testes SMART."
},
"header": {
"title": "Gerenciador de disco",
"description": "O menu Gerenciador de disco agrupa as ferramentas ProxMenux para lidar com discos físicos em um host Proxmox: anexar discos em recipientes VMs e LXC, importar imagens de disco, passar por um controlador inteiro ou dispositivo NVMe, limpar discos com segurança e executar testes de saúde SMART.",
"section": "Gerenciador de disco"
},
"intro": {
"title": "Para que serve este menu",
"body": "Estas ferramentas trabalham com <strong>discos físicos visíveis ao host Proxmox e ficheiros de imagem nele guardados</strong>. Há três grupos: <strong>VM</strong> (ligar discos ou importar imagens), <strong>LXC</strong> (ligar discos a um contentor) e <strong>Utilitários</strong> (formatação e estado SMART). As operações de ligação e eliminação ocultam ou bloqueiam discos de sistema e em uso; as verificações SMART podem examiná-los sem os apagar."
},
"opening": {
"heading": "Abrir o menu",
"body": "No menu principal do ProxMenux, selecione <strong>Disk Manager</strong>. Você verá isto:",
"imageAlt": "Menu Gerenciador de disco com blocos VM, LXC e Utilitários"
},
"groups": {
"heading": "Três grupos de ferramentas",
"intro": "O menu está organizado em três grupos: <strong>VM</strong>, <strong>LXC</strong> e <strong>Utilitários</strong>. Clique num cartão para ir diretamente às ferramentas desse grupo.",
"vmTitle": "VM",
"vmBody": "Ferramentas que operam em máquinas virtuais existentes. O VM deve ser desligado; o ProxMenux valida isto antes de tocar na configuração.",
"vmItems": [
"Importar disco para VM",
"Importar imagem de disco para VM",
"Adicionar controlador ou NVMe a uma VM"
],
"lxcTitle": "LXC",
"lxcBody": "Ferramentas para contentores LXC existentes. Este script exige um contentor privilegiado e oferece alterar a opção quando necessário. Leia primeiro os cuidados sobre conversão e propriedade dos ficheiros na página da ferramenta.",
"lxcItems": [
"Importar disco para LXC"
],
"utilitiesTitle": "Utilitários",
"utilitiesBody": "Ferramentas do lado do hospedeiro que operam nos próprios discos, independentemente de qualquer VM ou recipiente.",
"utilitiesItems": [
"Formatar ou apagar um disco físico",
"Integridade e teste do disco SMART"
]
},
"vm": {
"heading": "VM",
"intro": "Ferramentas que operam em máquinas virtuais existentes. O VM deve ser desligado; o ProxMenux valida isto antes de tocar na configuração.",
"options": [
{
"icon": "HardDrive",
"href": "/docs/disk-manager/import-disk-vm",
"title": "Importar disco para VM",
"description": "Anexar um disco físico não atribuído a um VM existente. Suporta SATA / SCSI / VirtIO / IDE, usa caminhos /dev/disk/by-id persistentes."
},
{
"icon": "FileDown",
"href": "/docs/disk-manager/import-disk-image-vm",
"title": "Importar imagem de disco para VM",
"description": "Importar arquivos de imagem de disco (.img / .qcow2 / .vmdk / .raw) para um VM existente. Fluxo bifásico, qm importdisk sob o capô."
},
{
"icon": "Cpu",
"href": "/docs/disk-manager/add-controller-nvme-vm",
"title": "Adicionar controlador ou NVMe a uma VM",
"description": "Passagem PCI de um dispositivo inteiro SATA / SAS HBA ou NVMe para um VM. Lida com habilitação IOMMU e detecção de conflitos."
}
]
},
"lxc": {
"heading": "LXC",
"intro": "Ferramentas para contentores LXC existentes. Este script exige um contentor privilegiado e oferece alterar a opção quando necessário. Leia primeiro os cuidados sobre conversão e propriedade dos ficheiros na página da ferramenta.",
"options": [
{
"icon": "Boxes",
"href": "/docs/disk-manager/import-disk-lxc",
"title": "Importar disco para LXC",
"description": "Anexar um disco físico não atribuído a um recipiente LXC existente como ponto de montagem. Lida com detecção / formato do sistema de arquivos e conversão privilegiada."
}
]
},
"utilities": {
"heading": "Utilitários",
"intro": "Ferramentas do lado do hospedeiro que operam nos próprios discos, independentemente de qualquer VM ou recipiente.",
"options": [
{
"icon": "Eraser",
"href": "/docs/disk-manager/format-disk",
"title": "Formatar/limpar disco físico (seguro)",
"description": "Limpar o disco seguro com controles de segurança rigorosos: apenas discos totalmente livres são mostrados e uma confirmação dupla é sempre necessária."
},
{
"icon": "Activity",
"href": "/docs/disk-manager/smart-disk-test",
"title": "Integridade e teste do disco SMART",
"description": "Execute verificações de saúde SMART e auto-testes curtos / longos em unidades SATA, SAS e NVMe. Exporta JSON para o Monitor."
}
]
},
"safety": {
"title": "Regras de segurança para ligação e eliminação de discos",
"intro": "As operações de ligação e eliminação excluem dispositivos que possam prejudicar o host:",
"items": [
"O <strong>disco de sistema</strong>, o pool raiz, o swap e os membros ativos de ZFS/LVM/RAID ficam sempre ocultos.",
"Os discos <strong>montados</strong> em qualquer ponto do host são ocultos ou bloqueados na execução.",
"Os discos <strong> referenciados por um VM ou LXC</strong> em execução não podem ser reatribuídos ou apagados.",
"Operações que podem alterar o estado host (IOMMU habilitar, limpar) requerem confirmação explícita."
]
},
"related": {
"heading": "Relacionado",
"items": [
{
"href": "/docs/storage-share",
"label": "Gerenciador de armazenamento e compartilhamento",
"tail": " — registro de armazenamento no próprio Proxmox (NFS / Samba / iSCSI / local) e compartilhar pastas entre host e CTs."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Comandos de armazenamento e discos",
"tail": " — referência de dispositivos de bloco, LVM, pvesm e SMART."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "Comandos de gerenciamento ZFS",
"tail": " — para conjuntos e conjuntos de dados ZFS."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "Adicionar GPU a uma VM (passthrough)",
"tail": " — os mesmos conceitos IOMMU / VFIO aplicados às GPU."
}
]
}
}
@@ -0,0 +1,146 @@
{
"meta": {
"title": "Estado e testes SMART do disco | Documentação ProxMenux",
"description": "Executar SMART controlos de saúde e testes de disco em Proxmox VE com ProxMenux. Suporta SATA / SAS (smartmontools) e NVMe (nvme-cli). Auto-testes curtos e longos, JSON exportação para ProxMenux Monitor integração.",
"ogTitle": "Estado e testes SMART do disco | Documentação ProxMenux",
"ogDescription": "Verificações de saúde e auto-testes de SMART para unidades SATA / SAS e NVMe em Proxmox. Exportação JSON para o Monitor."
},
"header": {
"title": "Integridade e teste do disco SMART",
"description": "Leia dados do SMART e ative auto-testes nos discos físicos ligados ao host Proxmox. ProxMenux auto-instala smartmontools para SATA / SAS e nvme-cli para NVMe, executa a ação dentro do firmware da unidade (os testes longos sobrevivem ao encerramento do terminal) e exporta os resultados JSON para o ProxMenux Monitor.",
"section": "Gerenciador de disco · Utilitários"
},
"intro": {
"title": "Para que serve isto?",
"body": "SMART (Auto-Monitoramento, Análise e Tecnologia de Relatórios) permite que a própria unidade relate sua saúde e execute auto-testes. Esta ferramenta expõe que os dados sem que você precise se lembrar da invocação correta <code>smartctl</code> / <code>nvme</code>, e persiste a saída como JSON, para que o Monitor possa grafar tendências ao longo do tempo."
},
"howRuns": {
"heading": "Como o script é executado",
"body": "Todas as ações aqui são não destrutivas — SMART lê os contadores de firmware da unidade, e os auto-testes estão em fila dentro da própria unidade. Nenhuma separação de fases é necessária. O fluxo é: verificação de dependência → seleção de disco → seleção de ação → invocação de ferramenta (smartctl ou nvme-cli dependendo do barramento de disco) → saída impressa mais exportação de JSON para o Monitor."
},
"deps": {
"heading": "Dependências",
"body": "A ferramenta auto-instala o que precisa na primeira execução. As unidades SATA / SAS dependem do <code>smartmontools</code>; as unidades NVMe dependem do <code>nvme-cli</code>. Ambos:"
},
"actions": {
"heading": "Acções disponíveis",
"headerAction": "Ação",
"headerWhat": "O que lê / roda",
"headerDur": "Duração",
"rows": [
{
"action": "Estado de saúde rápido",
"whatRich": "Total PASSED/FAILED + atributos-chave.<br /><code>smartctl -H</code> + <code>-A</code> (SATA/SAS) ou <code>nvme smart-log</code> (NVMe).",
"dur": "Instantânea"
},
{
"action": "Relatório completo",
"whatRich": "Dados SMART completos, com deslocamento. <code>smartctl -x</code> para SATA/SAS ou <code>nvme smart-log</code> + <code>id-ctrl</code> para NVMe.",
"dur": "Instantânea"
},
{
"action": "Teste curto",
"what": "Verificação básica de superfície e elétrica, em fila dentro do firmware da unidade.",
"dur": "~2 minutos"
},
{
"action": "Ensaio longo",
"what": "Varredura completa de toda a superfície. Funciona no hardware da unidade — persiste mesmo se você fechar o terminal.",
"dur": "Horas (dependentes do tamanho do disco)"
},
{
"action": "Verificar o progresso do teste",
"what": "Estado do auto-teste ativo ou mais recente.",
"dur": "Instantânea"
}
],
"tipTitle": "Longos testes sobrevivem ao encerramento do terminal",
"tipBody": "Um teste longo corre <em>dentro do disco</em> e não depende do processo ProxMenux continuar ativo. Pode fechar o terminal e voltar a <strong>Verificar o progresso do teste</strong>. Um reinício do host, uma reposição do controlador ou uma falha de energia pode interromper o teste e a recolha de resultados; não pressuponha que retoma automaticamente."
},
"json": {
"heading": "Exportação de JSON para o Monitor",
"intro": "As ações de estado, teste curto e progresso guardam um JSON com data e hora em <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code>; os resultados dos testes longos são recolhidos em segundo plano. O relatório completo é apenas apresentado. A estrutura é:",
"outro": "O ProxMenux Monitor utiliza estes ficheiros para mostrar a evolução do estado de cada disco. Os ficheiros antigos são eliminados automaticamente ao atingir o limite de retenção."
},
"steps": {
"heading": "Passo a passo",
"stepLabel": "Etapa",
"list": [
{
"title": "Escolha um disco",
"body": "ProxMenux lista cada disco físico no host com seu modelo e tamanho. Ao contrário da ferramenta Format, esta lista não é filtrada pela segurança — ler SMART é uma operação não destrutiva.",
"img": "/disk/smart/disk-selection.png",
"alt": "Menu de seleção de disco SMART",
"caption": "Menu de seleção de disco SMART"
},
{
"title": "Escolha uma ação",
"body": "Escolha entre estado de saúde rápido, relatório completo, teste curto, teste longo ou check progress. O menu fica aberto após cada ação para que você possa encadear várias consultas contra o mesmo disco.",
"img": "/disk/smart/action-menu.png",
"alt": "Menu de ação SMART",
"caption": "Menu de ação SMART (ações 5 + cancelamento)"
},
{
"title": "(Apenas teste longo) Confirmar execução em segundo plano",
"body": "O ProxMenux informa que o teste continuará após fechar o terminal e mostra onde será guardado o resultado JSON. Aceite para iniciar o teste.",
"img": "/disk/smart/long-test-warning.png",
"alt": "Diálogo de confirmação de teste longo",
"caption": "Confirmação de teste longa — roda em segundo plano, resultado salvo em JSON"
},
{
"title": "Rever os resultados",
"bodyRich": "O estado, os testes e o progresso são apresentados no terminal; <strong>Relatório completo</strong> abre numa caixa de diálogo com deslocamento. O JSON é exportado para as ações descritas acima, exceto Relatório completo. Para testes longos, volte a <strong>Verificar o progresso do teste</strong> no mesmo disco.",
"img": "/disk/smart/quick-status.png",
"alt": "Saída rápida do estado de saúde",
"caption": "Saída rápida do estado de saúde (SATA — smartctl -H + -A)"
}
]
},
"manual": {
"heading": "Equivalentes manuais",
"nvmeWarnTitle": "Os autotestes NVMe dependem do firmware do disco",
"nvmeWarnBody": "Nem toda unidade NVMe suporta o comando de auto-teste curto/longo. Se uma unidade recusar o teste, o log SMART e os dados do controlador de ID (<code>nvme smart-log</code> + <code>id-ctrl</code>) ainda são o sinal de saúde mais confiável."
},
"troubleshoot": {
"heading": "Resolução de Problemas",
"noSmartTitle": "\"Não foi possível ler dados SMART de /dev/sdX\"",
"noSmartBody": "O disco pode estar ligado a um controlador RAID/SAS que não transmite SMART. Com placas megaraid, tente <code>smartctl -d megaraid,N /dev/sdX</code>. Com HBA em modo IT, a chamada direta funciona.",
"longTitle": "O teste longo nunca termina",
"longBody": "O teste corre no firmware e uma carga elevada de E/S pode atrasá-lo. Tente num período calmo, como durante a noite. Em SATA, <code>smartctl -c</code> mostra a percentagem restante e, em SAS, <code>smartctl -l selftest</code>; o registo de autotestes indica o resultado e eventuais LBA com erros. Uma falha de leitura exige investigação; a lentidão, por si só, não prova um setor danificado."
},
"related": {
"heading": "Relacionado",
"items": [
{
"href": "/docs/disk-manager/format-disk",
"label": "Formatar ou apagar um disco físico",
"tail": " — reutilizar um disco após confirmar que é saudável."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Comandos de armazenamento e discos → Estado SMART",
"tail": " — referência smartctl / nvme."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "Comandos de gerenciamento ZFS",
"tail": " — zpool scrub verifica as somas de controlo dos dados ZFS e complementa os testes SMART do hardware."
},
{
"href": "/docs/monitor/dashboard/storage",
"label": "ProxMenux Monitor — Página de armazenamento",
"tail": " — vista detalhada do disco que utiliza o JSON aqui exportado: tabela SMART completa, histórico e relatório PDF."
},
{
"href": "/docs/monitor/dashboard/hardware",
"label": "ProxMenux Monitor — Página de hardware",
"tail": " — Resumo de armazenamento com modelo, capacidade e velocidade de ligação negociada (atual vs máximo em NVMe)."
},
{
"href": "/docs/disk-manager",
"label": "Visão geral do Gerenciador de Discos",
"tail": "."
}
]
}
}
@@ -0,0 +1,128 @@
{
"meta": {
"title": "Pridať radič alebo NVMe do VM | Dokumentácia ProxMenux",
"description": "Sprístupnenie radiča úložiska SATA/SAS HBA alebo zariadenia NVMe virtuálnemu stroju Proxmox cez PCI passthrough pomocou ProxMenuxu. Nástroj zabezpečuje aktiváciu IOMMU, rozpoznanie konfliktov a priradenie cez qm set --hostpci.",
"ogTitle": "Pridať radič alebo NVMe do VM | Dokumentácia ProxMenux",
"ogDescription": "Priraďte celý HBA SATA/SAS alebo zariadenie NVMe virtuálnemu stroju Proxmox. ProxMenux zabezpečí IOMMU, rozpoznanie konfliktov a priradenie hostpci."
},
"header": {
"title": "Pridať radič alebo NVMe do VM",
"description": "Priraďte celý adaptér SATA/SAS HBA alebo zariadenie NVMe virtuálnemu stroju Proxmox cez PCI passthrough. ProxMenux skontroluje IOMMU a s vaším súhlasom ho aktivuje, vyhľadá vhodné zariadenia, vylúči konflikty a zapíše priradenie pomocou qm set --hostpci.",
"section": "Správca disku · VM"
},
"intro": {
"title": "Čo to robí (a nerobí)",
"body": "Toto je <strong>priechod na úrovni zariadenia</strong>: karta PCIe opustí pohľad hostiteľského jadra a je viazaná na <code>vfio-pci</code>. VM vidí samotný radič – nie jednotlivé disky za ním – a načíta svoj vlastný ovládač pre tento presný model. Každý disk pripojený k tomuto radiču ho nasleduje automaticky, s natívnymi SMART údajmi, úplnými funkciami firmvéru a bez vrstvy Proxmox medzi nimi."
},
"howRuns": {
"heading": "Ako beží skript",
"body": "Postup má dve oddelené fázy: zhromaždenie informácií, kontrolu IOMMU a výpis vhodných zariadení; potom samotné pripojenie zariadenia PCI. Až do záverečného potvrdenia sa do konfigurácie VM nič nezapisuje."
},
"iommu": {
"heading": "Skupiny IOMMU: prečo treba posudzovať celú kartu",
"body": "Hranicou izolácie PCI passthrough je <strong>skupina IOMMU</strong>, najmenšia jednotka, ktorú IOMMU procesora dokáže izolovať. Zariadenia v rovnakej skupine nemožno izolovať navzájom. Ak radič SATA zdieľa skupinu s radičom USB, passthrough SATA môže vyžadovať aj uvoľnenie USB z hostiteľa alebo nemusí byť možný. Automaticky nepriradí VM všetky zariadenia skupiny.",
"outro": "ProxMenux zobrazuje skupinu IOMMU pri každom zariadení a upozorní, ak skupina obsahuje aj iné zariadenia než požadovaný radič. Môžete pokračovať, ak sú tieto ďalšie zariadenia prijateľné, napríklad ak sú všetky radičmi diskov, alebo sa vrátiť späť."
},
"prereqs": {
"heading": "Predpoklady",
"items": [
"<strong>CPU a základná doska podporujú</strong> VT-d (Intel) alebo AMD-Vi a funkcia je povolená vo firmvéri (BIOS/UEFI). ProxMenux môže upraviť nastavenie jadra, ale nemôže prepnúť nastavenie firmvéru.",
"Cieľová VM je pred pripojením zariadení PCI <strong>vypnutá</strong>.",
"Radič/NVMe <strong>nie je ten, na ktorom sa nachádza koreňový súborový systém Proxmox</strong>. Skript skryje všetko, čo hostiteľ používa.",
"Hosťujúci OS má ovládače pre model radiča. Linux pokrýva prakticky každý HBA hneď po vybalení; Windows potrebuje nainštalovaný ovládač od dodávateľa <em>pred</em> spustením s pripojeným radičom."
],
"warnTitle": "Živá migrácia nie je možná",
"warnBody": "VM s PCI passthrough je viazaná na uzol, v ktorom je karta fyzicky osadená. Živá migrácia medzi uzlami zlyhá. Prispôsobte tomu zálohovanie a replikáciu."
},
"steps": {
"heading": "Krok za krokom",
"stepLabel": "Krok",
"list": [
{
"title": "Vyberte cieľovú VM",
"bodyRich": "ProxMenux načíta <code>qm list</code> a zobrazí všetky VM. Vyberte tú, ktorej chcete priradiť radič.",
"img": "/disk/nvme-passthrough/vm-selection.png",
"alt": "dialóg výberu VM",
"caption": "dialóg výberu VM"
},
{
"title": "Kontrola IOMMU",
"bodyRich": "Ak IOMMU nie je povolené v príkazovom riadku jadra, ProxMenux ponúkne jeho aktiváciu. Upraví <code>/etc/kernel/cmdline</code> pre systemd-boot alebo <code>/etc/default/grub</code> pre GRUB a pridá správny parameter pre váš CPU:",
"items": [
"<code>intel_iommu=on</code> pre procesory Intel.",
"<code>amd_iommu=on</code> pre CPU AMD."
],
"outro": "Po tejto zmene je potrebný reštart. Skript ponúkne reštart teraz alebo neskôr; passthrough nemôže pokračovať, kým nie je aktívny nový príkazový riadok jadra.",
"img": "/disk/nvme-passthrough/iommu-warning.png",
"alt": "Dialóg IOMMU je vyžadované",
"caption": "IOMMU je vyžadované: ponuka aktivácie a reštartu"
},
{
"title": "Výpis zariadení",
"body": "ProxMenux vypíše všetky radiče úložiska (HBA SATA/SAS) a všetky zariadenia NVMe na zbernici PCI. Pri každom zariadení zobrazí:",
"items": [
"Adresa PCI (<code>00:17.0</code>, <code>01:00.0</code>, ...).",
"Dodávateľ / popis zariadenia.",
"Skupina IOMMU a upozornenie ⚠, ak ju zdieľajú ďalšie nesúvisiace zariadenia.",
"Disky aktuálne pripojené k radiču, aby ste vedeli, ktoré s ním prejdú do VM."
],
"img": "/disk/nvme-passthrough/device-list.png",
"alt": "Výpis radičov a zariadení NVMe",
"caption": "Výpis radičov a zariadení NVMe s informáciami o skupine IOMMU"
},
{
"title": "Odhalenie konfliktov",
"bodyRich": "Skript zablokuje jednoznačne nebezpečné zariadenia: už priradené inej VM cez <code>hostpci</code> v jej konfigurácii, používané hostiteľom, napríklad radič koreňového disku, alebo zaradené v skupine IOMMU, ktorej ostatných členov nedokáže bezpečne identifikovať. Vhodné zariadenia sú dostupné na výber.",
"img": "/disk/nvme-passthrough/conflict-warning.png",
"alt": "Upozornenie na zistený konflikt",
"caption": "Rozpoznanie konfliktu: zariadenie zablokované s uvedením dôvodu"
},
{
"title": "Pripojiť a dokončiť",
"bodyRich": "Pre každé vybrané zariadenie ProxMenux spustí <code>qm set &lt;VMID&gt; --hostpciN &lt;pci-addr&gt;,pcie=1</code> a vyberie ďalší voľný slot <code>hostpci</code>. Ak sa počas tejto relácie aktivovalo IOMMU, pripomenie potrebu reštartu pred spustením VM.",
"img": "/disk/nvme-passthrough/assignment.png",
"alt": "Prehľad priradenia",
"caption": "Prehľad priradenia: sloty hostpciN a pripojené adresy PCI"
}
]
},
"manual": {
"heading": "Ručný ekvivalent"
},
"troubleshoot": {
"heading": "Riešenie problémov",
"noGroupsTitle": "IOMMU povolené, ale žiadne skupiny pod /sys/kernel/iommu_groups/",
"noGroupsBody": "Na uplatnenie príkazového riadka jadra je potrebný reštart. Ak skupiny chýbajú aj po reštarte, VT-d/AMD-Vi je pravdepodobne vypnuté vo firmvéri: skontrolujte nastavenia BIOS/UEFI.",
"busyTitle": "VM sa nespustí: \"hostpciN: device busy\"",
"busyBody": "Iný proces stále drží PCI zariadenie. Najčastejšie príčiny: predchádzajúci VM, ktorý zlyhal bez jeho uvoľnenia, alebo ho hostiteľské jadro získalo späť pri poslednom spustení. Spustite <code>lspci -nnk -s &lt;addr&gt;</code> a zistite, ktorý ovládač je viazaný; malo by to byť <code>vfio-pci</code>. Úplný reštart hostiteľa to zvyčajne vymaže.",
"noDisksTitle": "Hosť vidí radič, ale nie disky",
"noDisksBody": "V hosťovi chýba ovládač pre daný model radiča. V Linuxe je to zriedkavé, vo Windowse sa to stáva: nainštalujte ovládač výrobcu, napríklad LSI/Broadcom pre staršie HBA SAS, keď karta nie je priradená, a potom reštartujte s priradenou kartou.",
"sharedTitle": "Skupina IOMMU obsahuje nesúvisiace zariadenie",
"sharedBody": "Možnosti: (a) presunúť kartu do iného slotu PCIe a zmeniť tak jej skupinu, (b) zapnúť <em>ACS override</em> v jadre na rozdelenie skupín (bezpečnostný kompromis, pred použitím si ho preštudujte), alebo (c) vybrať inú kartu v lepšie izolovanej skupine."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importovať disk do VM",
"tail": " — alternatíva: pripojiť fyzický disk cez Proxmox bez úplného PCIe passthrough."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "Pridať GPU do VM (passthrough)",
"tail": " — Rovnaké IOMMU / VFIO koncepty použité na GPU."
},
{
"href": "/docs/help-info/gpu-commands",
"label": "Príkazy pre GPU passthrough",
"tail": " — príkazy na overenie IOMMU platia aj pre passthrough radiča alebo NVMe."
},
{
"href": "/docs/disk-manager",
"label": "Prehľad správcu diskov",
"tail": "."
}
]
}
}
@@ -0,0 +1,142 @@
{
"meta": {
"title": "Formátovať alebo vymazať fyzický disk | Dokumentácia ProxMenux",
"description": "Mazanie a formátovanie fyzických diskov v Proxmox VE pomocou ProxMenux. Štyri režimy, prísne filtre blokujúce systémové, pripojené a používané disky a dvojité potvrdenie vrátane zadania celej cesty.",
"ogTitle": "Formátovať alebo vymazať fyzický disk | Dokumentácia ProxMenux",
"ogDescription": "Vymažte alebo naformátujte fyzický disk v Proxmox. Bezpečnostné filtre, štyri režimy a dvojité potvrdenie."
},
"header": {
"title": "Formátovať / vymazať fyzický disk",
"description": "Vymažte alebo naformátujte fyzický disk na hostiteľovi Proxmox. ProxMenux zobrazí iba úplne voľné disky, ktoré nepoužíva systém, nie sú uvedené v konfigurácii hosťa a nemajú pripojené súborové systémy. Pred zničením dát vyžaduje dvojité potvrdenie: áno/nie a presné zadanie celej cesty k disku.",
"section": "Správca diskov · Nástroje"
},
"danger": {
"title": "Deštrukčný nástroj",
"body": "Každá operácia zapisuje na disk. Nedá sa vrátiť späť. ProxMenux používa prísne bezpečnostné filtre a potvrdenia, no za výber správneho disku zodpovedáte vy. Pred zadaním si cestu k disku dvakrát prečítajte nahlas."
},
"howRuns": {
"heading": "Ako beží skript",
"body": "Postup má dve fázy s trojitou bezpečnostnou kontrolou medzi nimi. V prvej fáze sa zhromaždí výber disku, režim operácie a údaje súborového systému. Nič sa nezapíše, kým druhá fáza neprejde záverečným opätovným overením tesne pred vykonaním."
},
"visibility": {
"heading": "Pravidlá viditeľnosti",
"intro": "Pred tým, ako sa zobrazí menu, ProxMenux filtruje zoznam diskov. Zobrazujú sa iba kandidáti, ktorí sú preukázateľne v bezpečí:",
"items": [
"<strong>Zobrazené</strong>: disky, ktoré <em>nepoužíva</em> hostiteľ (koreňový pool, swap, pripojené systémy, aktívne ZFS/LVM/RAID) a <em>nie sú</em> uvedené v konfigurácii žiadnej VM/LXC, spustenej ani zastavenej.",
"<strong>Skryté</strong>: disky hostiteľa a systému.",
"<strong>Skryté</strong>: disky uvedené v konfigurácii VM/LXC."
],
"safetyTitle": "Bezpečnosť pri potvrdení a vykonávaní",
"safetyItems": [
"Disky so zastaranými alebo aktívnymi metadátami zobrazia podrobné upozornenia <em>pred</em> potvrdením.",
"Disky používané <strong>spustenou</strong> VM sa pri potvrdení <strong>bez výnimky zablokujú</strong>.",
"Disky s pripojenými oddielmi sú <strong>pevne zablokované</strong> pri spustení (tesne predtým, ako sa čokoľvek zapíše, sa spustí nové overenie).",
"Vždy sa vyžadujú dve potvrdenia: <em>áno/nie</em> dialógové okno + presné napísanie celej cesty k disku."
]
},
"modes": {
"heading": "Režimy prevádzky",
"intro": "Po vybratí disku si vyberiete jeden zo štyroch režimov. Odlišujú sa v tom, čo ničia a čo za sebou zanechávajú:",
"headerMode": "Režim",
"headerPart": "Tabuľka oddielov",
"headerData": "Údaje",
"headerUseCase": "Prípad použitia",
"rows": [
{
"mode": "1. Vymazať všetko",
"part": "Zničené",
"data": "Vymazané podpisy",
"useCase": "Odstráni tabuľku oddielov a metadáta súborových systémov a RAID, vynuluje prvých a posledných 16 MiB a na diskoch s podporou discard vykoná TRIM celého disku. Ostatné dáta sa neprepíšu a na HDD môžu byť stále obnoviteľné; nejde o bezpečné vymazanie."
},
{
"mode": "2. Odstrániť značky FS",
"part": "Zachované",
"data": "Zachované",
"useCase": "Odstráni staré podpisy ZFS / LVM / RAID, aby sa disk automaticky nepreberal. Používateľské dáta sa plošne neprepisujú, no odstránenie podpisov ich môže zneprístupniť."
},
{
"mode": "3. Prepísať dáta nulami",
"part": "Zachované",
"data": "Zničené (prepísané nulami)",
"useCase": "Prepíše existujúce oddiely nulami a zachová tabuľku oddielov. Nezahŕňa nepridelené miesto ani rezervné oblasti SSD; nezaručuje úplné bezpečné vymazanie zariadenia."
},
{
"mode": "4. Úplné formátovanie",
"part": "Nová GPT",
"data": "Zničené",
"useCase": "Disk pripravený na použitie s jednou novou partíciou a novým súborovým systémom."
}
],
"fullFormatOutro": "<strong>Úplné formátovanie</strong> pokračuje dvoma ďalšími dialógmi:",
"fullFormatItems": [
"<strong>Súborový systém</strong>: <code>ext4</code>, <code>xfs</code>, <code>exfat</code> (prenosný) alebo <code>btrfs</code>. Ak chýbajú nástroje, napríklad <code>mkfs.btrfs</code>, operácia sa preruší s jasnou správou.",
"<strong>Menovka</strong>: voliteľná menovka súborového systému na jeho identifikáciu."
]
},
"steps": {
"heading": "Krok za krokom",
"stepLabel": "Krok",
"list": [
{
"title": "Vyberte si voľný disk",
"body": "ProxMenux uvádza zoznam všetkých diskov, ktoré vyhovujú vyššie uvedeným filtrom viditeľnosti. Disky so značkami ⚠ nesú neaktuálne metadáta a zobrazujú sa s podrobnosťami, aby ste vedeli, čo sa chystáte prepísať."
},
{
"title": "Vybrať operačný režim",
"bodyRich": "Podľa tabuľky vyberte <strong>Vymazať všetko</strong>, <strong>Odstrániť značky FS</strong>, <strong>Prepísať dáta nulami</strong> alebo <strong>Úplné formátovanie</strong>."
},
{
"title": "(iba celý formát) Vyberte súborový systém a popis",
"body": "ext4 / xfs / exfat / btrfs, plus voliteľný štítok."
},
{
"title": "Potvrdiť dvakrát",
"bodyRich": "ProxMenux zobrazí prehľad plánovanej operácie. Potvrdíte dialóg áno/nie a <strong>zadáte celú cestu k disku</strong> presne podľa zobrazenia, napríklad <code>/dev/sdc</code>. Iný vstup operáciu zruší."
},
{
"title": "Opätovné overenie a vykonanie",
"body": "Tesne pred zápisom skript znova overí stav disku. Ak sa medzitým pripojil oddiel alebo spustila VM, vykonávanie sa preruší. Inak prebehne zvolená operácia a na konci sa zobrazí prehľad."
}
]
},
"manual": {
"heading": "Ručné ekvivalenty",
"body": "Ak chcete spustiť rovnocenné príkazy ručne:"
},
"troubleshoot": {
"notListedTitle": "Disk nie je uvedený v menu",
"notListedBody": "Disk bol z bezpečnostných dôvodov skrytý. Časté dôvody: je pripojený, aj pod <code>/mnt/tmp</code>, je aktívnym členom ZFS/LVM/RAID, je uvedený v konfigurácii VM/LXC alebo ide o koreňový disk Proxmox. Na hostiteľovi spustite <code>lsblk -f</code> a <code>cat /proc/mdstat</code> na zistenie dôvodu.",
"busyTitle": "\"Disk may be busy\" / odpojenie zlyhalo",
"busyBody": "Niektorý proces stále drží otvorený súbor na oddiele tohto disku, najčastejšie kontajner alebo shell s pracovným adresárom v bode pripojenia. Zistite ho pomocou <code>lsof | grep /dev/sdX</code> alebo <code>fuser -vm /dev/sdX1</code>, zastavte ho a znova spustite nástroj."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"href": "/docs/disk-manager/smart-disk-test",
"label": "SMART Zdravie a test disku",
"tail": " — skontrolovať stav disku pred vymazaním alebo po ňom."
},
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importovať disk do VM",
"tail": " — priradiť čerstvo naformátovaný disk VM."
},
{
"href": "/docs/storage-share/host-local-disk",
"label": "Pridať lokálny disk ako Proxmox úložisko",
"tail": "— zaregistrujte vymazaný disk ako úložisko Proxmox pool."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Príkazy pre úložiská a disky",
"tail": " — prehľad príkazov lsblk, blkid a parted."
},
{
"href": "/docs/disk-manager",
"label": "Prehľad správcu diskov",
"tail": "."
}
]
}
}
@@ -0,0 +1,110 @@
{
"meta": {
"title": "Importovať obraz disku do VM | Dokumentácia ProxMenux",
"description": "Import súboru obrazu disku (.img / .qcow2 / .vmdk / .raw) do existujúcej VM Proxmox pomocou ProxMenux. Rozhranie, emulácia SSD a príznak spúšťacieho disku sa nastavujú pre každý obraz; na pozadí sa používa qm importdisk.",
"ogTitle": "Importovať obraz disku do VM | Dokumentácia ProxMenux",
"ogDescription": "Importovať .img / .qcow2 / .vmdk / .raw diskové snímky do existujúceho VM s ProxMenux. Používa qm importdisk pod kapotou."
},
"header": {
"title": "Importovať obraz disku do VM",
"description": "Importujte súbor obrazu disku (.img, .qcow2, .vmdk alebo .raw) do existujúcej VM Proxmox. ProxMenux najprv zhromaždí všetky voľby: cieľovú VM, úložisko Proxmox, zdrojový adresár, rozhranie, emuláciu SSD a poradie spúšťania. Potom spustí qm importdisk pre každý vybraný obraz.",
"section": "Správca disku · VM"
},
"intro": {
"title": "Čo to robí?",
"body": "Na rozdiel od <em>Importovať disk do VM</em>, ktorý pripája fyzický disk priamo, tento postup používa <strong>súbor</strong> na hostiteľovi: exportovaný z iného hypervízora, stiahnutý ako cloudový obraz alebo extrahovaný zo zálohy. Prevedie ho na disk VM Proxmox na zvolenom úložisku. Pôvodný súbor zostáva zachovaný; ProxMenux ho skopíruje, nepresunie."
},
"howRuns": {
"heading": "Ako beží skript",
"body": "Postup má dve fázy. Prvá zhromaždí cez dialógy všetky voľby: VM, úložisko, zdrojový adresár, obrazy a možnosti pre každý obraz. Druhá spustí <code>qm importdisk</code> pre každý vybraný obraz. Kým sa druhá fáza nezačne, nič sa nekopíruje a konfigurácia VM sa nemení."
},
"prereqs": {
"heading": "Predpoklady",
"items": [
"Na hostiteľovi je definovaná aspoň jedna VM. Cieľová VM by mala byť <strong>vypnutá</strong>.",
"V zdrojovom adresári je aspoň jeden súbor obrazu v podporovanom formáte: <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code>, <code>.raw</code>.",
"Na cieľovom úložisku Proxmox je dosť voľného miesta pre všetky importované disky.",
"ProxMenux štandardne hľadá obrazy v <code>/var/lib/vz/template/iso</code>. Po výzve môžete zadať aj iný adresár na hostiteľovi."
]
},
"steps": {
"heading": "Krok za krokom",
"stepLabel": "Krok",
"list": [
{
"title": "Vyberte cieľovú VM",
"bodyRich": "ProxMenux načíta <code>qm list</code> a zobrazí všetky VM. Vyberte tú, ktorá dostane importované disky."
},
{
"title": "Vyberte Proxmox úložisko",
"bodyRich": "Zoznam obsahuje všetky úložiská s povoleným typom obsahu <code>images</code>. Ak je dostupné iba jedno, vyberie sa automaticky a dialóg sa preskočí."
},
{
"title": "Vyberte zdrojový adresár",
"bodyRich": "Vyberte predvolený adresár (<code>/var/lib/vz/template/iso</code>) alebo zadajte vlastnú cestu, zvyčajne tam, kde ste obraz stiahli alebo nahrali. Skript odmietne neexistujúce cesty."
},
{
"title": "Vybrať jeden alebo viac obrazov",
"bodyRich": "V adresári sa vyhľadajú súbory <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code>. Možno ich vybrať viac naraz; v ďalšom kroku sa pre každý obraz nastavia samostatné voľby."
},
{
"title": "Možnosti pre jednotlivé obrazy",
"intro": "Pre každý vybraný obraz sa ProxMenux opýta:",
"items": [
"<strong>Rozhranie</strong> — <code>scsi</code> (predvolené), <code>virtio</code>, <code>sata</code> alebo <code>ide</code>. Zhoduje sa s tým, ako hosť uvidí disk.",
"<strong>Emulácia SSD</strong>: ponúka sa iba pre rozhrania iné než VirtIO. Pridá <code>ssd=1</code>, aby hosť rozpoznal disk SSD. Podporu discard/TRIM treba nastaviť samostatne.",
"<strong>Spúšťací</strong>: pri voľbe áno ProxMenux pridá disk do poradia spúšťania ako hlavné spúšťacie zariadenie VM."
]
},
{
"title": "Importovať a pripojiť",
"bodyRich": "ProxMenux spustí <code>qm importdisk</code> pre každý obraz a podľa potreby skonvertuje formát. Výsledný disk pripojí na ďalší voľný slot (<code>scsiN</code>, <code>sataN</code>, …) so zvolenými možnosťami. Ak ste označili niektorý disk ako spúšťací, aktualizuje poradie spúšťania. Priebeh sa zobrazuje v termináli."
}
]
},
"manual": {
"heading": "Ručný ekvivalent",
"body": "Import jedného obrazu zodpovedá trom príkazom <code>qm</code>:",
"warnTitle": "Konverzia formátu obrazu",
"warnBody": "Ak cieľové úložisko nemôže držať zdrojový formát natívne (napríklad LVM úložisko nemôže držať <code>.qcow2</code>), <code>qm importdisk</code> konvertuje obraz transparentne. To môže trvať niekoľko minút pre viac-GB snímky; podľa toho plán a neprerušujte skript."
},
"troubleshoot": {
"heading": "Riešenie problémov",
"noImagesTitle": "\"Nenájdené žiadne kompatibilné obrazy disku\"",
"noImagesBody": "Skript prehľadal adresár, ale nenašiel žiadny súbor <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code>. Skontrolujte príponu (rozlišujú sa veľké a malé písmená), či je súbor priamo vo vybranom adresári (podadresáre sa neprehľadávajú) a či ho root môže čítať.",
"slowTitle": "Import je pomalý",
"slowBody": "Konverzie medzi VMDK, QCOW2 a raw môžu byť obmedzené CPU a vstupom/výstupom. Rýchlosť závisí od čítania zdroja, zápisu na cieľ a prípadnej dekompresie. Ak je to možné, uprednostnite zdroje raw alebo qcow2.",
"uefiTitle": "Importovaný disk sa spustí do UEFI shellu",
"uefiBody": "Obraz bol vytvorený pre starší režim (SeaBIOS), ale VM používa OVMF alebo naopak. Prepnite BIOS VM v Proxmox podľa obrazu alebo obraz pred importom znova vytvorte v správnom režime."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importovať disk do VM",
"tail": " — rovnaký postup pre fyzické disky (passthrough)."
},
{
"href": "/docs/utils/import-vm",
"label": "Importovať VM z OVA / OVF",
"tail": " — keď máte kompletný balík VM, nielen obraz disku."
},
{
"href": "/docs/utils/UUp-Dump-ISO-Creator",
"label": "Tvorba ISO cez UUP Dump",
"tail": " — vytvoriť ISO Windows pre novú inštaláciu."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Príkazy pre úložiská a disky",
"tail": " — prehľad príkazov qm importdisk a qemu-img convert."
},
{
"href": "/docs/disk-manager",
"label": "Prehľad správcu diskov",
"tail": "."
}
]
}
}
@@ -0,0 +1,115 @@
{
"meta": {
"title": "Importovať disk do LXC | ProxMenux Dokumentácia",
"description": "Pripojte fyzický disk k existujúcemu kontajneru LXC v Proxmox VE pomocou ProxMenux. Zabezpečí rozpoznanie a formátovanie súborového systému, bod pripojenia, konverziu z neprivilegovaného na privilegovaný kontajner a trvalé cesty zariadení.",
"ogTitle": "Importovať disk do LXC | ProxMenux Dokumentácia",
"ogDescription": "Pripojte fyzický disk k existujúcemu kontajneru LXC. Zabezpečí súborový systém, bod pripojenia a konverziu z neprivilegovaného na privilegovaný kontajner."
},
"header": {
"title": "Importovať disk do LXC",
"description": "Pripojte fyzický disk k existujúcemu LXC kontajneru na Proxmox hostiteľa. ProxMenux detekuje voľné disky, voliteľne ich formátuje podporovaným súborovým systémom a prepojí partíciu na bod pripojenia vo vnútri kontajnera pomocou trvalých trás zariadenia.",
"section": "Správca disku · LXC"
},
"intro": {
"title": "Passthrough vo VM a v LXC",
"body": "Tento passthrough LXC <strong>neposkytuje priamo blokové zariadenie</strong>. Kontajner dostane <em>bod pripojenia</em>, teda adresár na vybranom oddiele hostiteľa. Na rozdiel od VM používa jadro hostiteľa, preto súborový systém (ext4/xfs/btrfs) číta a spravuje hostiteľ Proxmox a následne ho sprístupní kontajneru."
},
"howRuns": {
"heading": "Ako beží skript",
"body": "Postup má dve oddelené fázy: zhromaždenie informácií a volieb, potom samotnú zmenu konfigurácie kontajnera. Až do záverečného potvrdenia sa v CT nič nepripája.",
"summary": "ProxMenux skryje koreňový disk, pripojené disky a disky uvedené v konfiguráciách VM/LXC. Aktívni členovia ZFS/LVM/RAID sú skrytí; staré podpisy sú označené ⚠, aby ste ich mohli pred formátovaním vymazať."
},
"prereqs": {
"heading": "Predpoklady",
"items": [
"Aspoň jeden kontajner LXC definovaný na hostiteľovi.",
"Kontajner je <strong>privilegovaný</strong>, alebo akceptujete ponuku skriptu na jeho konverziu.",
"Aspoň jeden fyzický disk nepoužívaný hostiteľom alebo iným hosťom."
],
"warnTitle": "Požadovaný privilegovaný kontajner",
"warnBody": "Tento skript vyžaduje na priame pripojenie disku <strong>privilegovaný</strong> kontajner. Ak nájde <code>unprivileged: 1</code>, ponúkne priamu úpravu <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code>. Zmení sa bezpečnostný model, ale vlastníctvo existujúcich súborov sa nepremapuje. Pred prijatím kontajner zálohujte a overte vlastníctvo alebo ho znova vytvorte ako privilegovaný."
},
"steps": {
"heading": "Krok za krokom",
"stepLabel": "Krok",
"list": [
{
"title": "Vybrať cieľový kontajner",
"img": "/disk/select-container.png",
"caption": "Výberové menu kontajnera",
"bodyRich": "ProxMenux uvádza každý LXC kontajner na hostiteľa (<code>pct list</code>). Vyberte ten, ktorý dostane disk. Ak je kontajner neprivilegovaný, ponúka sa mu konvertovať teraz."
},
{
"title": "Vyberte fyzický disk",
"img": "/disk/disk-selection-ct.png",
"caption": "Voľné disky na hostiteľovi, s označením ⚠ pre staré metadáta",
"bodyRich": "Zobrazia sa iba bezpeční kandidáti. Na rozdiel od postupu pre VM tento skript pripojí <strong>jeden disk na spustenie</strong>. Pre každý ďalší disk ho spustite znova."
},
{
"title": "Formátovať alebo znova použiť",
"intro": "Skript kontroluje disk:",
"items": [
"Ak už obsahuje podporovaný súborový systém (ext4/xfs/btrfs), možno ho použiť bez zmeny; existujúce súbory sa zachovajú.",
"Ak disk nemá podporovaný súborový systém, ponúkne sa formátovanie. Vyberte ext4/xfs/btrfs."
]
},
{
"title": "Vyberte bod pripojenia",
"bodyRich": "Zadajte cestu, kde má kontajner vidieť disk, napríklad <code>/mnt/data</code> alebo <code>/mnt/disk_passthrough</code>. Ide o cestu <em>vnútri</em> kontajnera; hostiteľ už vidí oddiel pod <code>/dev/disk/by-id/…</code>."
},
{
"title": "Pripojiť a overiť",
"img": "/disk/assignment-ct.png",
"caption": "Priradenie ku CT",
"bodyRich": "ProxMenux pridá do konfigurácie kontajnera nový záznam <code>mpN:</code>, pričom preskočí už použité indexy. Potom konfiguráciu znovu načíta a overí. Ak kontajner beží, pripojenie sa vykoná za behu; inak sa uplatní pri ďalšom spustení.",
"extraImg": "/disk/result-point.png",
"extraAlt": "Bod pripojenia vytvorený úspešne",
"extraCaption": "Bod pripojenia vytvorený a overený"
}
]
},
"manual": {
"heading": "Ručný ekvivalent",
"body": "Skript používa <code>pct set</code>. Priamy príkaz pre jeden disk vyzerá takto:"
},
"important": {
"heading": "Dôležité úvahy",
"items": [
"<strong>Jeden disk na spustenie</strong>. Znova spustite skript pre každý ďalší disk.",
"<strong>Nepripájajte</strong> rovnaký oddiel k viacerým kontajnerom, ktoré by ho mohli pripojiť súčasne; súbežné zápisy poškodia súborový systém.",
"<strong>Staré metadáta</strong> (podpisy RAID / ZFS / LVM) sa musia manuálne vymazať skôr, ako vám skript umožní formátovanie, inak <code>mkfs</code> odmietne prepísať. Použite na to nástroj <wipeLink>Formátovanie / vymazanie fyzického disku</wipeLink>."
]
},
"troubleshoot": {
"heading": "Riešenie problémov",
"unprivTitle": "\"Nemôže pokračovať s neprivilegovaným kontajnerom\"",
"unprivBody": "Odmietli ste konverziu, takže skript skončil bez akejkoľvek zmeny. Ak chcete pokračovať, spustite ho znova a súhlaste: skript zastaví kontajner, zálohuje jeho konfiguráciu do <code>/etc/pve/lxc/&lt;CTID&gt;.conf.bak</code> a nahradí <code>unprivileged: 1</code> hodnotou <code>unprivileged: 0</code>. Samotná zmena neprevedie vlastníctvo UID/GID existujúcich súborov; preto kontajner najprv zálohujte a upravte vlastníkov, prípadne ho obnovte alebo znova vytvorte ako privilegovaný.",
"permsTitle": "Práva vnútri kontajnera sú nesprávne",
"permsBody": "Pri pripojení oddielu do privilegovaného kontajnera sa zachová existujúce vlastníctvo súborov; nový súborový systém často patrí <code>root:root</code>. Ak služba beží pod iným používateľom, napríklad <code>www-data</code> pri Nextcloude, overte UID/GID a upravte potrebné súbory pomocou <code>chown</code>/<code>chmod</code>. Zmeny ovplyvnia aj podkladový disk."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importovať disk do VM",
"tail": " — rovnaký postup pre VM."
},
{
"href": "/docs/storage-share/lxc-mount-points",
"label": "LXC mount pointy (Host ↔ CT)",
"tail": " Zdieľať adresáre hostiteľa s CT namiesto pripojenia celého disku."
},
{
"href": "/docs/help-info/vm-ct-commands",
"label": "Príkazy na správu VM a CT",
"tail": " — prehľad príkazov pct config / push / pull."
},
{
"href": "/docs/disk-manager",
"label": "Prehľad správcu diskov",
"tail": "."
}
]
}
}
@@ -0,0 +1,113 @@
{
"meta": {
"title": "Importovať disk do VM | ProxMenux Dokumentácia",
"description": "Pripojte fyzický disk na existujúci Proxmox VM s ProxMenux. Bezpečná detekcia disku (okrem systému, namontovaných, používaných, ZFS/RAID/LVM), perzistentných ciest /dev/disk/by-id a SATA / SCSI / VirtIO / IDE rozhraní.",
"ogTitle": "Importovať disk do VM | ProxMenux Dokumentácia",
"ogDescription": "Pripojte fyzický disk na existujúci Proxmox VM. Používa perzistentné cesty /dev/disk/by-id a podporuje SATA / SCSI / VirtIO / IDE."
},
"header": {
"title": "Importovať disk do VM",
"description": "Pripojte fyzický disk, ktorý už existuje na Proxmox hostiteľa k existujúcemu virtuálnemu stroju. ProxMenux detekuje voľné disky, umožňuje vám vybrať cieľovú VM, typ zbernice (SATA / SCSI / VirtIO / IDE) a pripojí všetko pomocou perzistentných ciest /dev/disk/by-id, takže mapovanie prežije reštarty a zmeny v poradí zariadenia.",
"section": "Správca disku · VM"
},
"intro": {
"title": "Čo to robí?",
"body": "Fyzický disk sa pripojí ako podkladové zariadenie rozhrania virtuálneho disku. Hosť automaticky nedostane natívne SMART dáta ani funkcie fyzického radiča; ak ich potrebujete, použite PCI passthrough radiča. Disk sa pripája cez svoju cestu <code>/dev/disk/by-id/…</code>, ak existuje, takže zmena poradia zariadení pri štarte nenaruší priradenie; inak sa použije <code>/dev/sdX</code>."
},
"howRuns": {
"heading": "Ako beží skript",
"body": "Postup má dve oddelené fázy: zhromaždenie informácií a volieb, potom samotné pripojenie diskov k VM. Až do záverečného potvrdenia sa konfigurácia VM nemení.",
"summary": "ProxMenux filtruje všetko, čo nemôže bezpečne prejsť: koreňový disk, disky pripojené k hostiteľovi, členovia aktívneho ZFS/LVM/RAID pool a disky, na ktoré už odkazujú VM/LXC konfigurácia. Disky s <em>zastaranými</em> metadátami (staré ZFS / RAID / LVM podpisy, ktoré sa už nepoužívajú) sú zobrazené s označením ⚠, ale nie sú blokované."
},
"prereqs": {
"heading": "Predpoklady",
"items": [
"Aspoň jeden VM definovaný na hostiteľovi (skript odosiela priamo do <code>qm list</code>).",
"<strong>Cieľová VM je vypnutá</strong>. Ak beží, skript sa preruší so správou; pridávanie diskov za behu nie je súčasťou tohto postupu.",
"Aspoň jeden fyzický disk na hostiteľa, ktorý nie je v prevádzke hostiteľom alebo iným hosťom."
]
},
"steps": {
"heading": "Krok za krokom",
"stepLabel": "Krok",
"list": [
{
"title": "Vyberte cieľovú VM",
"bodyRich": "ProxMenux vypíše všetky VM hostiteľa cez <code>qm list</code>. Vyberte tú, ktorej chcete pripojiť disk. Ak beží, skript sa preruší a vyžiada si jej vypnutie."
},
{
"title": "Vybrať fyzické disky na pripojenie",
"img": "/disk/disk-selection.png",
"caption": "Voľné disky na hostiteľovi, s označením ⚠ pre staré metadáta",
"body": "Skript prehľadá každý hostiteľský disk a zobrazí len tie, ktoré je možné bezpečne pripojiť. Kontrolný zoznam vám umožňuje vybrať jeden alebo niekoľko naraz. Disky so starými ZFS / LVM / RAID signatúrami sa stále zobrazujú a sú označené ⚠, takže viete, že je potrebné ich vymazať, aby ich hosť mohol naformátovať."
},
{
"title": "Vyberte rozhranie zbernice",
"img": "/disk/disk-assigment.png",
"caption": "Výber rozhrania zbernice",
"intro": "Vyberte si, ako by mal hosť vidieť disk:",
"items": [
"<strong>SCSI</strong>: moderná predvolená voľba pre Linux a Windows s nainštalovanými ovládačmi VirtIO-SCSI.",
"<strong>SATA</strong>: široká kompatibilita, funguje bez ďalších ovládačov takmer v každom hosťovi.",
"<strong>VirtIO</strong>: efektívne paravirtualizované blokové zariadenie; vyžaduje ovládače v hosťovi.",
"<strong>IDE</strong>: pre staršie hosťovské systémy, ktorým chýbajú uvedené ovládače."
]
},
{
"title": "Pripojiť a overiť",
"bodyRich": "ProxMenux pripojí každý vybraný disk cez najvhodnejšiu cestu <code>/dev/disk/by-id/</code>, preskočí už obsadené sloty konfigurácie VM (<code>scsi0</code>, <code>sata0</code>, …) a znova načíta konfiguráciu na overenie priradenia. Na konci zobrazí prehľad."
}
]
},
"manual": {
"heading": "Ručný ekvivalent",
"body": "Scenár je obal okolo <code>qm set</code>. Presný príkaz pre jeden disk vyzerá takto:",
"migrationTitle": "Živá migrácia nie je možná",
"migrationBody": "VM s priamo pripojeným fyzickým diskom je <strong>viazaná na hostiteľa, ktorý disk sprístupňuje</strong>. Iný uzol zvyčajne nemá rovnakú cestu <code>/dev/disk/by-id/…</code> ani dáta disku. Zálohujte a preneste dáta samostatne alebo použite spravované virtuálne disky na zdieľanom či podporovanom replikovanom úložisku. Nepredpokladajte, že replikácia Proxmox zahŕňa toto zariadenie.",
"shareTitle": "Nezdieľať fyzický disk medzi VM",
"shareBody": "Pripojenie rovnakého fyzického disku k dvom VM súčasne skazí dáta pri ďalšom zápise. ProxMenux detekuje túto situáciu a blokuje ju, ale ak obídete skript (direct <code>qm set</code>), uistite sa, že len jeden hosť niekedy pripojí disk."
},
"troubleshoot": {
"heading": "Riešenie problémov",
"noDisksTitle": "\"Nie sú k dispozícii disky pre tento VM\"",
"noDisksIntro": "Skript našiel disky, ale každý kandidát bol odfiltrovaný. Časté dôvody:",
"noDisksItems": [
"Každý zostávajúci disk je už uvedený v cieľovom VM konfigurácii.",
"Každý zostávajúci disk je namontovaný na hostiteľa alebo je súčasťou aktívneho ZFS / LVM / RAID.",
"Hostiteľ má nainštalovaný iba koreňový disk."
],
"noDisksOutro": "Spustite <code>lsblk -f</code> na hostiteľa skontrolovať stav každého disku.",
"noVisibleTitle": "VM nevidí disk po štarte",
"noVisibleBody": "Pri <strong>SCSI</strong> alebo <strong>VirtIO</strong> hosť potrebuje príslušný ovládač. Linux ho má v jadre; vo Windowse ho nainštalujte z VirtIO ISO (pozrite <winLink>Vytvoriť VM: Windows</winLink>). Prepnutie na SATA na karte Hardvér VM je rýchly test priradenia disku."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"href": "/docs/disk-manager/import-disk-image-vm",
"label": "Importovať obraz disku do VM",
"tail": " — rovnaký postup pre súbory obrazov (qcow2 / vmdk / raw / img)."
},
{
"href": "/docs/disk-manager/import-disk-lxc",
"label": "Importovať disk do LXC",
"tail": " — rovnaký postup pre kontajnery LXC."
},
{
"href": "/docs/disk-manager/add-controller-nvme-vm",
"label": "Pridať radič alebo NVMe do VM",
"tail": " — ak potrebujete úplný PCIe/NVMe passthrough namiesto pripojenia disku."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Príkazy pre úložiská a disky",
"tail": " — prehľad qm importdisk a súvisiacich príkazov shellu."
},
{
"href": "/docs/disk-manager",
"label": "Prehľad správcu diskov",
"tail": "."
}
]
}
}
@@ -0,0 +1,135 @@
{
"meta": {
"title": "Správca diskov Proxmox: VM/LXC, testy SMART a mazanie | ProxMenux",
"description": "Spravujte fyzické disky hostiteľa Proxmox VE pomocou ProxMenux: pripájajte disky k VM alebo LXC (qm set scsi/sata/virtio, pct mp), importujte obrazy img / qcow2 / vmdk / raw, priraďujte celé HBA alebo radiče NVMe, mažte disky s bezpečnostnými kontrolami a spúšťajte testy SMART.",
"ogTitle": "Správca diskov Proxmox: VM/LXC, testy SMART a mazanie",
"ogDescription": "Pripájajte disky k VM/LXC, importujte obrazy, priraďujte radiče cez PCI passthrough, mažte s bezpečnostnými kontrolami a spúšťajte testy SMART v Proxmox VE.",
"twitterTitle": "Správca diskov Proxmox | ProxMenux",
"twitterDescription": "Pripojenie diskov k VM/LXC, import obrazov, PCI passthrough, mazanie s bezpečnostnými kontrolami a testy SMART."
},
"header": {
"title": "Správca diskov",
"description": "Ponuka Správca diskov združuje nástroje ProxMenux na správu fyzických diskov hostiteľa: pripojenie k VM a LXC, import obrazov diskov, passthrough celého radiča alebo zariadenia NVMe, mazanie s bezpečnostnými kontrolami a testy SMART.",
"section": "Správca diskov"
},
"intro": {
"title": "Na čo je toto menu",
"body": "Nástroje pracujú s <strong>fyzickými diskami viditeľnými pre hostiteľa Proxmox a súbormi obrazov uloženými na ňom</strong>. Sú rozdelené do troch skupín: <strong>VM</strong> (pripojenie diskov alebo import obrazov), <strong>LXC</strong> (pripojenie diskov ku kontajneru) a <strong>Nástroje</strong> (formátovanie a stav SMART). Pripájanie a mazanie skryje alebo zablokuje systémové a používané disky; SMART ich môže kontrolovať bez vymazania."
},
"opening": {
"heading": "Otvorenie menu",
"body": "V hlavnej ponuke ProxMenux vyberte <strong>Správca diskov</strong>. Zobrazí sa:",
"imageAlt": "Menu správcu diskov s VM, LXC a blokmi utilít"
},
"groups": {
"heading": "Tri skupiny nástrojov",
"intro": "Ponuka Disk Manager je organizovaná v troch skupinách <strong>VM</strong>, <strong>LXC</strong> a <strong>Nástroje</strong>. Kliknite na kartu pre skok priamo na nástroje v tejto skupine.",
"vmTitle": "VM",
"vmBody": "Nástroje pre existujúce virtuálne stroje. VM musí byť vypnutá; ProxMenux to overí pred zmenou konfigurácie.",
"vmItems": [
"Importovať disk do VM",
"Importovať obraz disku do VM",
"Pridať radič alebo NVMe do VM"
],
"lxcTitle": "LXC",
"lxcBody": "Nástroje pre existujúce kontajnery LXC. Tento skript vyžaduje privilegovaný kontajner a podľa potreby ponúkne zmenu príznaku. Najprv si na stránke nástroja prečítajte upozornenia ku konverzii a vlastníctvu súborov.",
"lxcItems": [
"Importovať disk do LXC"
],
"utilitiesTitle": "Nástroje",
"utilitiesBody": "Nástroje na strane hostiteľa, ktoré fungujú na samotných diskoch, nezávisle od akéhokoľvek VM alebo kontajnera.",
"utilitiesItems": [
"Formátovať / vymazať fyzický disk",
"SMART Zdravie a test disku"
]
},
"vm": {
"heading": "VM",
"intro": "Nástroje pre existujúce virtuálne stroje. VM musí byť vypnutá; ProxMenux to overí pred zmenou konfigurácie.",
"options": [
{
"icon": "HardDrive",
"href": "/docs/disk-manager/import-disk-vm",
"title": "Importovať disk do VM",
"description": "Pripojte nepridelený fyzický disk na existujúci VM. Podporuje SATA / SCSI / VirtIO / IDE, používa trvalé cesty /dev/disk/by-id."
},
{
"icon": "FileDown",
"href": "/docs/disk-manager/import-disk-image-vm",
"title": "Importovať obraz disku do VM",
"description": "Import súborov obrazov disku (.img / .qcow2 / .vmdk / .raw) do existujúcej VM. Dvojfázový postup s qm importdisk na pozadí."
},
{
"icon": "Cpu",
"href": "/docs/disk-manager/add-controller-nvme-vm",
"title": "Pridať radič alebo NVMe do VM",
"description": "PCI priechod celého zariadenia SATA / SAS HBA alebo NVMe do zariadenia VM. Ovláda IOMMU a umožňuje odhaľovanie konfliktov."
}
]
},
"lxc": {
"heading": "LXC",
"intro": "Nástroje pre existujúce kontajnery LXC. Tento skript vyžaduje privilegovaný kontajner a podľa potreby ponúkne zmenu príznaku. Najprv si na stránke nástroja prečítajte upozornenia ku konverzii a vlastníctvu súborov.",
"options": [
{
"icon": "Boxes",
"href": "/docs/disk-manager/import-disk-lxc",
"title": "Importovať disk do LXC",
"description": "Pripojí nepriradený fyzický disk k existujúcemu kontajneru LXC ako bod pripojenia. Zabezpečí rozpoznanie a formátovanie súborového systému aj zmenu na privilegovaný režim."
}
]
},
"utilities": {
"heading": "Nástroje",
"intro": "Nástroje na strane hostiteľa, ktoré fungujú na samotných diskoch, nezávisle od akéhokoľvek VM alebo kontajnera.",
"options": [
{
"icon": "Eraser",
"href": "/docs/disk-manager/format-disk",
"title": "Formátovať / vymazať fyzický disk (bezpečne)",
"description": "Mazanie diskov s prísnymi bezpečnostnými kontrolami: zobrazia sa iba úplne voľné disky a vždy sa vyžaduje dvojité potvrdenie."
},
{
"icon": "Activity",
"href": "/docs/disk-manager/smart-disk-test",
"title": "SMART Zdravie a test disku",
"description": "Spustite SMART zdravotné kontroly a krátke / dlhé vlastné testy na SATA, SAS a NVMe disky. Exportuje JSON pre monitor."
}
]
},
"safety": {
"title": "Bezpečnostné pravidlá pripájania a mazania diskov",
"intro": "Pripájanie a mazanie vylučuje zariadenia, ktoré by mohli poškodiť hostiteľa:",
"items": [
"<strong>systémový disk</strong> (koreňový pool, swap, aktívny ZFS / LVM členovia RAID) je vždy skrytý.",
"Disky <strong>pripojené</strong> kdekoľvek na hostiteľovi sa nezobrazia alebo sa ich použitie pri vykonávaní zablokuje.",
"Disky, na ktoré <strong>odkazuje spustená VM alebo LXC</strong>, nemožno priradiť inému hosťovi ani vymazať.",
"Operácie, ktoré môžu zmeniť hostiteľský stav (IOMMU povoliť, vymazať) vyžadujú explicitné potvrdenie."
]
},
"related": {
"heading": "Súvisiace",
"items": [
{
"href": "/docs/storage-share",
"label": "Správca úložísk a zdieľania",
"tail": " Registrácia úložiska v Proxmoxe (NFS / Samba / iSCSI / miestne) a zdieľať priečinky medzi hostiteľom a CTs."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Príkazy pre úložiská a disky",
"tail": " — prehľad blokových zariadení, LVM, pvesm a SMART."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "Príkazy na správu ZFS",
"tail": " — pre pooly a datasety ZFS."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "Pridať GPU do VM (passthrough)",
"tail": " — rovnaké princípy IOMMU/VFIO použité pre GPU."
}
]
}
}
@@ -0,0 +1,146 @@
{
"meta": {
"title": "Stav a testy diskov SMART | Dokumentácia ProxMenux",
"description": "Kontroly stavu SMART a testy diskov v Proxmox VE pomocou ProxMenux. Podporuje SATA/SAS cez smartmontools a NVMe cez nvme-cli, krátke aj dlhé testy a export JSON pre ProxMenux Monitor.",
"ogTitle": "Stav a testy diskov SMART | Dokumentácia ProxMenux",
"ogDescription": "Kontroly stavu SMART a testy diskov SATA/SAS a NVMe v Proxmox. Export JSON pre Monitor."
},
"header": {
"title": "SMART Zdravie a test disku",
"description": "Čítajte dáta SMART a spúšťajte testy fyzických diskov hostiteľa Proxmox. ProxMenux automaticky nainštaluje smartmontools pre SATA/SAS a nvme-cli pre NVMe, spustí test vo firmvéri disku (dlhé testy pokračujú aj po zatvorení terminálu) a exportuje výsledky JSON pre ProxMenux Monitor.",
"section": "Správca diskov · Nástroje"
},
"intro": {
"title": "Načo to je?",
"body": "SMART (Self-Monitoring, Analysis and Reporting Technology) umožňuje disku hlásiť svoj stav a vykonávať vlastné testy. Nástroj zobrazí tieto dáta bez potreby pamätať si správne volanie <code>smartctl</code> alebo <code>nvme</code> a uloží výstup ako JSON, aby Monitor mohol zobrazovať vývoj v čase."
},
"howRuns": {
"heading": "Ako beží skript",
"body": "Všetky akcie sú nedeštruktívne: SMART číta počítadlá firmvéru disku a testy prebiehajú v samotnom disku. Nie je potrebné oddeľovať fázy. Postup: kontrola závislostí → výber disku → výber akcie → volanie nástroja smartctl alebo nvme-cli podľa typu disku → zobrazenie výstupu a export JSON pre Monitor."
},
"deps": {
"heading": "Závislosti",
"body": "Nástroj pri prvom spustení automaticky nainštaluje potrebné závislosti. Disky SATA / SAS používajú <code>smartmontools</code>, disky NVMe používajú <code>nvme-cli</code>. Oba balíky:"
},
"actions": {
"heading": "Dostupné opatrenia",
"headerAction": "Akcia",
"headerWhat": "Čo číta alebo spúšťa",
"headerDur": "Trvanie",
"rows": [
{
"action": "Rýchly zdravotný stav",
"whatRich": "Celkový stav PASSED/FAILED a kľúčové atribúty.<br /><code>smartctl -H</code> + <code>-A</code> (SATA/SAS) alebo <code>nvme smart-log</code> (NVMe).",
"dur": "Okamžite"
},
{
"action": "Úplná správa",
"whatRich": "Kompletné dáta SMART, posuvné. <code>smartctl -x</code> pre SATA/SAS alebo <code>nvme smart-log</code> + <code>id-ctrl</code> pre NVMe.",
"dur": "Okamžite"
},
{
"action": "Krátky test",
"what": "Základná kontrola povrchu a elektroniky vo firmvéri disku.",
"dur": "~2 minút"
},
{
"action": "Dlhá skúška",
"what": "Úplná kontrola povrchu. Beží na hardvéri disku a pokračuje aj po zatvorení terminálu.",
"dur": "Hodiny (od veľkosti disku závisí)"
},
{
"action": "Skontrolovať priebeh testu",
"what": "Stav aktívneho alebo posledného samotestu.",
"dur": "Okamžite"
}
],
"tipTitle": "Dlhé testy pokračujú po zatvorení terminálu",
"tipBody": "Dlhý test beží <em>vnútri disku</em> a nezávisí od bežiaceho procesu ProxMenux. Terminál môžete zavrieť a neskôr použiť <strong>Skontrolovať priebeh testu</strong>. Reštart hostiteľa, reset radiča alebo výpadok napájania môže prerušiť test aj zber výsledkov; nepredpokladajte automatické pokračovanie."
},
"json": {
"heading": "Export JSON pre monitor",
"intro": "Akcie stavu, krátkeho testu a priebehu zapisujú JSON s časovou pečiatkou do <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code>; výsledky dlhého testu sa zbierajú na pozadí. Úplná správa sa iba zobrazí. Štruktúra je:",
"outro": "ProxMenux Monitor používa tieto súbory na zobrazenie vývoja stavu diskov. Staré súbory sa po dosiahnutí limitu uchovávania automaticky odstránia."
},
"steps": {
"heading": "Krok za krokom",
"stepLabel": "Krok",
"list": [
{
"title": "Vybrať disk",
"body": "ProxMenux vypíše všetky fyzické disky hostiteľa s modelom a veľkosťou. Na rozdiel od nástroja formátovania sa tu bezpečnostné filtre nepoužívajú, pretože čítanie SMART je nedeštruktívne.",
"img": "/disk/smart/disk-selection.png",
"alt": "Menu výberu disku SMART",
"caption": "Menu výberu disku SMART"
},
{
"title": "Vybrať akciu",
"body": "Vyberte rýchly stav, úplnú správu, krátky test, dlhý test alebo kontrolu priebehu. Ponuka zostane po každej akcii otvorená, aby ste mohli vykonať viac kontrol toho istého disku.",
"img": "/disk/smart/action-menu.png",
"alt": "Akčné menu SMART",
"caption": "Akčné menu SMART (5 akcie + zrušiť)"
},
{
"title": "(Iba dlhý test) Potvrdiť vykonávanie na pozadí",
"body": "ProxMenux upozorní, že test bude pokračovať po zatvorení terminálu, a zobrazí miesto uloženia výsledku JSON. Potvrdením spustíte test.",
"img": "/disk/smart/long-test-warning.png",
"alt": "Dialóg potvrdenia dlhého testu",
"caption": "Potvrdenie dlhého testu: beží na pozadí a výsledok sa uloží do JSON"
},
{
"title": "Skontrolovať výsledky",
"bodyRich": "Stav, testy a priebeh sa zobrazia v termináli; <strong>Úplná správa</strong> sa otvorí v posúvateľnom dialógu. JSON sa exportuje pri vyššie opísaných akciách, nie pri úplnej správe. Pri dlhých testoch neskôr použite <strong>Skontrolovať priebeh testu</strong> na rovnakom disku.",
"img": "/disk/smart/quick-status.png",
"alt": "Výstup rýchlej kontroly stavu",
"caption": "Rýchly prehľad stavu disku (SATA — smartctl -H + -A)"
}
]
},
"manual": {
"heading": "Ručné ekvivalenty",
"nvmeWarnTitle": "Testy NVMe závisia od firmvéru disku",
"nvmeWarnBody": "Nie každý NVMe disk podporuje krátky/dlhý samotestový príkaz. Ak pohon odmietne test, log SMART a dáta ovládača ID (<code>nvme smart-log</code> + <code>id-ctrl</code>) sú stále najspoľahlivejším zdravotným signálom."
},
"troubleshoot": {
"heading": "Riešenie problémov",
"noSmartTitle": "\"Nepodarilo sa prečítať dáta SMART z /dev/sdX\"",
"noSmartBody": "Disk je pravdepodobne za radičom RAID/SAS, ktorý nesprístupňuje SMART. Pri kartách megaraid skúste <code>smartctl -d megaraid,N /dev/sdX</code>. Pri HBA v režime IT funguje priame volanie.",
"longTitle": "Dlhý test sa nikdy nedokončil",
"longBody": "Test beží vo firmvéri disku a vysoká záťaž ho môže spomaliť. Skúste pokojné obdobie, napríklad noc. Pri SATA zobrazí <code>smartctl -c</code> zostávajúce percento, pri SAS <code>smartctl -l selftest</code>; výsledok a prípadné chybné LBA nájdete v zázname testov. Chybu čítania treba preskúmať; pomalý priebeh sám osebe nedokazuje chybný sektor."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"href": "/docs/disk-manager/format-disk",
"label": "Formátovať / vymazať fyzický disk",
"tail": " — znova použiť disk po overení jeho stavu."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Príkazy pre úložiská a disky → Stav SMART",
"tail": " — prehľad smartctl/nvme s príkazmi na skopírovanie."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "Príkazy na správu ZFS",
"tail": " — zpool scrub overuje kontrolné súčty dát ZFS a dopĺňa hardvérové testy SMART."
},
{
"href": "/docs/monitor/dashboard/storage",
"label": "ProxMenux Monitor — karta Úložisko",
"tail": " — podrobný pohľad na disk využívajúci exportovaný JSON: úplná tabuľka SMART, história a správa PDF."
},
{
"href": "/docs/monitor/dashboard/hardware",
"label": "ProxMenux Monitor — karta Hardvér",
"tail": " — prehľad úložiska s modelom, kapacitou a dohodnutou rýchlosťou spojenia (aktuálna a maximálna pri NVMe)."
},
{
"href": "/docs/disk-manager",
"label": "Prehľad správcu diskov",
"tail": "."
}
]
}
}
@@ -0,0 +1,128 @@
{
"meta": {
"title": "Lägg till styrenhet eller NVMe i en VM | ProxMenux-dokumentation",
"description": "PCI-passthrough av en lagringsstyrenhet (SATA/SAS-HBA) eller NVMe-enhet till en Proxmox-VM med ProxMenux. Hanterar aktivering av IOMMU, konfliktkontroll och tilldelning med qm set --hostpci.",
"ogTitle": "Lägg till styrenhet eller NVMe i en VM | ProxMenux-dokumentation",
"ogDescription": "Tilldela en hel SATA/SAS-HBA eller NVMe-enhet till en Proxmox-VM. ProxMenux hanterar IOMMU, konfliktkontroll och hostpci-tilldelningen."
},
"header": {
"title": "Lägg till styrenhet eller NVMe i en VM",
"description": "Tilldela en hel SATA/SAS-värdbussadapter (HBA) eller NVMe-enhet till en Proxmox-VM via PCI-passthrough. ProxMenux kontrollerar IOMMU och aktiverar det med ditt samtycke, listar lämpliga enheter, filtrerar bort konflikter och konfigurerar tilldelningen med qm set --hostpci.",
"section": "Diskhanterare · VM"
},
"intro": {
"title": "Vad detta gör (och inte) gör",
"body": "Detta är <strong>passthrough på enhetsnivå</strong>: PCIe-kortet lämnar värdkärnans kontroll och binds till <code>vfio-pci</code>. VM:n ser själva styrenheten i stället för enskilt vidarebefordrade diskar och laddar sin egen drivrutin för modellen. Alla anslutna diskar följer automatiskt med, med inbyggda SMART-data, fullständiga firmwarefunktioner och utan ett Proxmox-lager emellan."
},
"howRuns": {
"heading": "Så körs skriptet",
"body": "Flödet har två faser med tydlig separation mellan \"samla information, kontrollera IOMMU och lista kandidater\" och \"faktiskt fästa PCI-enheten\". Fram till den slutliga bekräftelsen skrivs ingenting till VM-konfig."
},
"iommu": {
"heading": "IOMMU-grupper – varför hela kortet lämnar samtidigt",
"body": "Isoleringsgränsen för PCI-passthrough är <strong>IOMMU-gruppen</strong>, den minsta enhet som processorns IOMMU kan isolera. Enheter i samma grupp kan inte isoleras från varandra. Om en SATA-styrenhet delar grupp med en USB-styrenhet kan SATA-passthrough kräva att även USB frigörs från värden, eller hindra passthrough. Alla enheter i gruppen tilldelas inte automatiskt till VM:n.",
"outro": "ProxMenux visar IOMMU-gruppen bredvid varje enhet och varnar dig när en grupp bär mer än bara den kontroller du vill ha. Du kan fortfarande fortsätta om de extra enheterna i gruppen är acceptabla (alla diskkontroller, till exempel), eller backa ut om de inte är det."
},
"prereqs": {
"heading": "Förutsättningar",
"items": [
"<strong>Processor och moderkort stöder</strong> VT-d (Intel) eller AMD-Vi, och funktionen är aktiverad i firmware (BIOS/UEFI). ProxMenux kan aktivera kärnans inställning men inte ändra firmwareinställningen.",
"Mål-VM:n är <strong>avstängd</strong> innan PCI-enheter ansluts.",
"Controller/NVMe <strong> är inte den som innehar Proxmox root-filsystem</strong>. Skriptet döljer allt som används av värden.",
"Gästoperativsystemet har drivrutiner för styrenhetens modell. Linux stöder praktiskt taget alla HBA:er direkt; Windows behöver tillverkarens drivrutin installerad <em>innan</em> du startar med styrenheten ansluten."
],
"warnTitle": "Live migration är inte möjligt",
"warnBody": "En VM med PCI-passthrough är knuten till noden där kortet sitter fysiskt. Livemigrering mellan noder misslyckas. Planera säkerhetskopiering och replikering därefter."
},
"steps": {
"heading": "Steg-för-steg",
"stepLabel": "Steg",
"list": [
{
"title": "Välj mål-VM",
"bodyRich": "ProxMenux läser <code>qm list</code> och visar alla VM:ar. Välj den som ska få styrenheten.",
"img": "/disk/nvme-passthrough/vm-selection.png",
"alt": "VM urvalsdialog",
"caption": "VM urvalsdialog"
},
{
"title": "IOMMU-kontroll",
"bodyRich": "Om IOMMU inte är aktiverat i kärnans kommandorad erbjuder ProxMenux att aktivera det. Skriptet redigerar <code>/etc/kernel/cmdline</code> för systemd-boot eller <code>/etc/default/grub</code> för GRUB och lägger till rätt parameter för din processor:",
"items": [
"<code>intel_iommu=on</code> för Intel CPU.",
"<code>amd_iommu=on</code> för AMD CPU."
],
"outro": "En omstart krävs efter ändringen. Skriptet erbjuder omstart nu eller senare; passthrough kan inte fortsätta förrän kärnans nya kommandorad är aktiv.",
"img": "/disk/nvme-passthrough/iommu-warning.png",
"alt": "Dialogrutan IOMMU krävs",
"caption": "IOMMU krävs: erbjudande om aktivering och omstart"
},
{
"title": "Enhetsuppräkning",
"body": "ProxMenux listar varje lagringskontroll (SATA / SAS HBA) och varje NVMe-enhet på PCI-bussen. För varje enhet den visar:",
"items": [
"PCI-adress (<code>00:17.0</code>, <code>01:00.0</code>, ...).",
"Leverantör / enhetsbeskrivning.",
"IOMMU-grupp, med en ⚠-varning om gruppen delas med andra orelaterade enheter.",
"Diskarna som är anslutna till styrenheten, så att du vet vilka som följer med till VM:n."
],
"img": "/disk/nvme-passthrough/device-list.png",
"alt": "Lista över styrenheter och NVMe-enheter",
"caption": "Lista över styrenheter och NVMe-enheter med information om IOMMU-grupper"
},
{
"title": "Konfliktdetektering",
"bodyRich": "Skriptet blockerar tydligt osäkra enheter: sådana som redan tilldelats en annan VM via <code>hostpci</code> i dess konfiguration, används av värden som styrenheten för rotdisken, eller ingår i en IOMMU-grupp vars övriga medlemmar inte kan identifieras säkert. Lämpliga enheter går att välja.",
"img": "/disk/nvme-passthrough/conflict-warning.png",
"alt": "Varning om upptäckt konflikt",
"caption": "Konfliktdetektering - enhet blockerad med anledning"
},
{
"title": "Anslut och slutför",
"bodyRich": "För varje vald enhet kör ProxMenux <code>qm set &lt;VMID&gt; --hostpciN &lt;pci-addr&gt;,pcie=1</code> och väljer nästa lediga <code>hostpci</code>-plats. Om IOMMU aktiverades under sessionen påminns du om att starta om värden innan VM:n startas.",
"img": "/disk/nvme-passthrough/assignment.png",
"alt": "Tilldelningssammanfattning",
"caption": "Tilldelningsöversikt: hostpciN-platser och anslutna PCI-adresser"
}
]
},
"manual": {
"heading": "Manuell motsvarighet"
},
"troubleshoot": {
"heading": "Felsökning",
"noGroupsTitle": "IOMMU aktiverade men inga grupper under /sys/kernel/iommu_groups/",
"noGroupsBody": "En omstart krävs för att kärnans kommandorad ska börja gälla. Om grupperna fortfarande saknas efter omstart är VT-d/AMD-Vi troligen inaktiverat i firmware. Kontrollera BIOS/UEFI-inställningarna.",
"busyTitle": "VM:n startar inte: \"hostpciN: device busy\"",
"busyBody": "En annan process håller fortfarande PCI-enheten upptagen. Vanliga orsaker är en VM som kraschat utan att frigöra den eller att värdkärnan tog tillbaka den vid senaste starten. Kör <code>lspci -nnk -s &lt;addr&gt;</code> för att se den bundna drivrutinen; den bör vara <code>vfio-pci</code>. En fullständig omstart av värden brukar lösa problemet.",
"noDisksTitle": "Gästen ser styrenheten men inte diskarna",
"noDisksBody": "Gästen saknar drivrutin för styrenhetens modell. Det är ovanligt i Linux men förekommer i Windows: installera tillverkarens drivrutin, exempelvis LSI/Broadcom för äldre SAS-HBA:er, när kortet inte är tilldelat och starta sedan om med kortet tilldelat.",
"sharedTitle": "IOMMU-gruppen innehåller en orelaterad enhet",
"sharedBody": "Alternativ: (a) flytta kortet till en annan PCIe slot för att ändra sin grupp, (b) aktivera <em>ACS override</em> i kärnan för att dela grupper (säkerhet avvägning - forskning innan applicering), eller (c) välja ett annat kort i en renare grupp."
},
"related": {
"heading": "Relaterat",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importera disk till VM",
"tail": " — alternativ: anslut en fysisk disk via Proxmox utan fullständig PCIe-passthrough."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "Lägg till GPU till VM (Passthrough)",
"tail": " - samma IOMMU / VFIO-koncept som tillämpas på en GPU."
},
{
"href": "/docs/help-info/gpu-commands",
"label": "GPU Passthrough kommandon",
"tail": " - IOMMU-verifieringskommandon gäller också för styrenhet / NVMe-genomgång."
},
{
"href": "/docs/disk-manager",
"label": "Disk Manager översikt",
"tail": "."
}
]
}
}
@@ -0,0 +1,142 @@
{
"meta": {
"title": "Formatera eller radera en fysisk disk | ProxMenux-dokumentation",
"description": "Radera och formatera fysiska diskar på Proxmox VE med ProxMenux. Fyra driftlägen, strikta filter som blockerar systemdiskar, monterade eller använda diskar och dubbel bekräftelse med inmatning av hela sökvägen.",
"ogTitle": "Formatera eller radera en fysisk disk | ProxMenux-dokumentation",
"ogDescription": "Radera eller formatera en fysisk disk på Proxmox. Säkerhetsfilter, fyra driftlägen och dubbel bekräftelse."
},
"header": {
"title": "Formatera / radera fysisk disk",
"description": "Radera eller formatera en fysisk disk på Proxmox-värden. ProxMenux visar bara helt lediga diskar som inte används av systemet, inte refereras av gäster och inte har några monteringar. Innan data förstörs krävs dubbel bekräftelse: ja/nej och inmatning av hela disksökvägen.",
"section": "Diskhanterare · Verktyg"
},
"danger": {
"title": "Destruktivt verktyg",
"body": "Varje operation här skriver till disken. Det finns ingen undo. ProxMenux tillämpar strikta säkerhetsfilter och bekräftelser, men ansvaret för att välja rätt disk är din. Läs diskvägen högt två gånger innan du skriver den."
},
"howRuns": {
"heading": "Så körs skriptet",
"body": "Flödet har två faser med tre säkerhetskontroller emellan. I fas 1 samlas diskval, driftläge och filsystemsuppgifter in. Ingenting skrivs förrän fas 2 klarar en sista förnyad kontroll direkt före körningen."
},
"visibility": {
"heading": "Synlighetsregler",
"intro": "Innan menyn ens visas filtrerar ProxMenux disklistan. Endast kandidater som är bevisligen säkra visas:",
"items": [
"<strong>Visas</strong>: diskar som <em>inte</em> används av värden (rotpool, swap, monteringar, aktiv ZFS/LVM/RAID) och <em>inte</em> refereras i någon VM/LXC-konfiguration, oavsett om gästen körs eller är stoppad.",
"<strong>Döljs</strong>: värd- och systemdiskar.",
"<strong>Döljs</strong>: diskar som refereras i en VM/LXC-konfiguration."
],
"safetyTitle": "Säkerhet vid bekräftelse och utförande",
"safetyItems": [
"Diskar med gamla eller aktiva metadata visar detaljerade varningar <em>innan</em> du bekräftar.",
"Diskar som används av en <strong>körande</strong> VM <strong>blockeras helt</strong> vid bekräftelsen.",
"Diskar med monterade partitioner <strong>blockeras helt</strong> vid körningen. En ny kontroll görs direkt innan något skrivs.",
"Två bekräftelser krävs alltid: en <em>ja/nej</em>-dialog och exakt inmatning av hela disksökvägen."
]
},
"modes": {
"heading": "Operationslägen",
"intro": "Efter att ha valt en disk väljer du en av fyra lägen. De skiljer sig åt i vad de förstör och vad de lämnar efter sig:",
"headerMode": "Läge",
"headerPart": "Partitionstabell",
"headerData": "Data",
"headerUseCase": "Användningsfall",
"rows": [
{
"mode": "1. Radera allt",
"part": "Förstörd",
"data": "Signaturer raderade",
"useCase": "Tar bort partitionstabellen och metadata för filsystem och RAID, nollställer de första och sista 16 MiB och kör TRIM på hela disken om enheten stöder discard. Övriga data skrivs inte över och kan fortfarande gå att återställa på en HDD; detta är ingen säker radering."
},
{
"mode": "2. Ta bort FS-etiketter",
"part": "Bevarad",
"data": "Bevarad",
"useCase": "Tar bort gamla ZFS/LVM/RAID-signaturer så att disken inte tas i bruk automatiskt. Användardata skrivs inte över i sin helhet, men borttagna signaturer kan göra dem oåtkomliga."
},
{
"mode": "3. Nollställ alla data",
"part": "Bevarad",
"data": "Förstörda (överskrivna med nollor)",
"useCase": "Skriv över befintliga partitioner med nollor och behåll partitionstabellen. Oallokerat utrymme och SSD-reservområden omfattas inte; detta garanterar inte fullständig datasanering av enheten."
},
{
"mode": "4. Fullständigt format",
"part": "Ny GPT",
"data": "Förstörd",
"useCase": "Redo att använda disk med en enda ny partition och ett nytt filsystem."
}
],
"fullFormatOutro": "<strong>Fullständig formatering</strong> fortsätter med två ytterligare dialogrutor:",
"fullFormatItems": [
"<strong>Filsystem</strong>: <code>ext4</code>, <code>xfs</code>, <code>exfat</code> (portabelt) eller <code>btrfs</code>. Om verktyg som <code>mkfs.btrfs</code> saknas avbryts åtgärden med ett tydligt meddelande.",
"<strong>Etikett</strong>: valfri filsystemetikett för identifiering."
]
},
"steps": {
"heading": "Steg-för-steg",
"stepLabel": "Steg",
"list": [
{
"title": "Välj en ledig disk",
"body": "ProxMenux listar de diskar som klarar filtren ovan. Diskar märkta med ⚠ har gamla metadata som visas i detalj så att du vet vad du är på väg att skriva över."
},
{
"title": "Välj ett operationsläge",
"bodyRich": "Välj <strong>Radera allt</strong>, <strong>Ta bort FS-etiketter</strong>, <strong>Nollställ alla data</strong> eller <strong>Fullständig formatering</strong> enligt tabellen ovan."
},
{
"title": "(Endast fullständig formatering) Välj filsystem och etikett",
"body": "ext4 / xfs / exfat / btrfs, plus en valfri etikett."
},
{
"title": "Bekräfta två gånger",
"bodyRich": "ProxMenux visar en sammanfattning av åtgärden. Bekräfta i ja/nej-dialogen och <strong>skriv hela disksökvägen</strong> exakt som den visas, exempelvis <code>/dev/sdc</code>. All annan inmatning avbryter."
},
{
"title": "Re-validering och utförande",
"body": "Direkt före skrivningen kontrollerar skriptet diskens tillstånd igen. Om en partition har monterats eller en VM startats under tiden avbryts körningen. Annars utförs den valda åtgärden och en sammanfattning visas efteråt."
}
]
},
"manual": {
"heading": "Manuella motsvarigheter",
"body": "Om du föredrar att köra motsvarande kommandon för hand:"
},
"troubleshoot": {
"notListedTitle": "Disk som inte anges i menyn",
"notListedBody": "Det filtrerades för säkerhet. Vanliga skäl: det är monterat (även på <code>/mnt/tmp</code>), det är en aktiv ZFS / LVM / RAID-medlem, det refereras av en VM eller LXC config, eller det är din Proxmox root disk. Kör <code>lsblk -f</code> och <code>cat /proc/mdstat</code> på värden för att förstå varför.",
"busyTitle": "\"Disk may be busy\" / avmontering misslyckades",
"busyBody": "Något håller fortfarande en öppen fil på en partition av den disken - oftast en container eller ett skal vars cwd är inuti en monteringspunkt. Identifiera det med <code>lsof | grep /dev/sdX</code> eller <code>fuser -vm /dev/sdX1</code>, stoppa det och sedan köra verktyget igen."
},
"related": {
"heading": "Relaterat",
"items": [
{
"href": "/docs/disk-manager/smart-disk-test",
"label": "SMART-status och disktest",
"tail": " — Kontrollera en disk före / efter att ha torkat för att bekräfta att den är frisk."
},
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importera disk till VM",
"tail": " — passera en nyformaterad disk till en VM."
},
{
"href": "/docs/storage-share/host-local-disk",
"label": "Lägg till lokal disk som Proxmox lagring",
"tail": " - registrera en torkad disk som en Proxmox lagringspool."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Kommandon för lagring och diskar",
"tail": " — referens för lsblk, blkid och parted."
},
{
"href": "/docs/disk-manager",
"label": "Disk Manager översikt",
"tail": "."
}
]
}
}
@@ -0,0 +1,110 @@
{
"meta": {
"title": "Importera diskbild till VM | ProxMenux Dokumentation",
"description": "Importera en disk bildfil (.img / .qcow2 / .vmdk / .raw) till en befintlig Proxmox VM med ProxMenux. Per-image gränssnitt, SSD emulering och startbar flagga, med qm importdisk under huven.",
"ogTitle": "Importera diskbild till VM | ProxMenux Dokumentation",
"ogDescription": "Importera .img / .qcow2 / .vmdk / .raw-diskavbildningar till en befintlig VM med ProxMenux. Använder qm importdisk i bakgrunden."
},
"header": {
"title": "Importera diskavbildning till virtuell dator",
"description": "Importera en diskbildfil (.img, .qcow2, .vmdk eller .raw) till en befintlig Proxmox VM. ProxMenux samlar varje beslut up-front - mål VM, Proxmox lagring, källkatalog, gränssnitt, SSD emulering, startorder - och sedan kör qm importdisk för varje vald avbildning.",
"section": "Diskhanterare · VM"
},
"intro": {
"title": "Vad detta gör",
"body": "Till skillnad från <em>Importera disk till VM</em>, som ansluter en fysisk disk direkt, använder detta flöde en <strong>fil</strong> på värden: exporterad från en annan hypervisor, nedladdad som molnavbildning eller extraherad ur en säkerhetskopia. Den omvandlas till en Proxmox-VM-disk på vald lagring. Originalfilen bevaras; ProxMenux kopierar den utan att flytta den."
},
"howRuns": {
"heading": "Så körs skriptet",
"body": "Flödet har två faser. Fas 1 samlar alla val via dialogrutor: VM, lagring, källkatalog, avbildningar och alternativ för varje avbildning. Fas 2 kör <code>qm importdisk</code> för varje vald avbildning. Innan fas 2 börjar kopieras ingenting och VM-konfigurationen ändras inte."
},
"prereqs": {
"heading": "Förutsättningar",
"items": [
"Minst en VM är definierad på värden. Mål-VM:n bör vara <strong>avstängd</strong>.",
"Minst en diskavbildningsfil i ett format som stöds finns i källkatalogen: <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code>, <code>.raw</code>.",
"Tillräckligt med ledigt utrymme på målet Proxmox lagring för att hålla varje importerad disk.",
"ProxMenux letar efter avbildningar i <code>/var/lib/vz/template/iso</code> som standard. Du kan peka det på någon annan katalog på värden när den frågar."
]
},
"steps": {
"heading": "Steg-för-steg",
"stepLabel": "Steg",
"list": [
{
"title": "Välj mål-VM",
"bodyRich": "ProxMenux läser <code>qm list</code> och visar alla VM:ar. Välj den som ska få de importerade diskarna."
},
{
"title": "Välj Proxmox lagring",
"bodyRich": "Listan innehåller varje lagring som har <code>images</code>-innehållstyp aktiverad. Om det bara finns en kandidat är det automatiskt valt och dialogen hoppas över."
},
{
"title": "Välj källkatalogen",
"bodyRich": "Välj standardkatalogen (<code>/var/lib/vz/template/iso</code>) eller skriv en anpassad väg - vanligtvis där du laddade ner / laddade upp avbildningen. Skriptet avvisar vägar som inte existerar."
},
{
"title": "Välj en eller flera avbildningar",
"bodyRich": "Katalogen skannas för <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code> filer. Du kan välja flera samtidigt; var och en kommer att gå igenom alternativen per avbildning i nästa steg."
},
{
"title": "Alternativ per avbildning",
"intro": "För varje vald avbildning frågar ProxMenux:",
"items": [
"<strong>Interface</strong> - <code>scsi</code> (standard), <code>virtio</code>, <code>sata</code> eller <code>ide</code>. Matchar hur gästen kommer att se skivan.",
"<strong>SSD-emulering</strong>: erbjuds bara för andra gränssnitt än VirtIO. Lägger till <code>ssd=1</code> så att gästen känner igen en SSD. Stöd för discard/TRIM måste konfigureras separat.",
"<strong>Startbar</strong>: om du väljer ja lägger ProxMenux disken först i VM:ns startordning."
]
},
{
"title": "Importera och anslut",
"bodyRich": "ProxMenux kör <code>qm importdisk</code> för varje avbildning och konverterar formatet vid behov. Disken ansluts till nästa lediga plats (<code>scsiN</code>, <code>sataN</code>, …) med valda alternativ. Om någon disk markerats som startbar uppdateras startordningen. Förloppet visas i terminalen."
}
]
},
"manual": {
"heading": "Manuell motsvarighet",
"body": "Import av en enda avbildning motsvarar tre <code>qm</code>-kommandon:",
"warnTitle": "Konvertering av avbildningsformat",
"warnBody": "När mållagringen inte kan hålla källformatet inbyggt (till exempel kan LVM-lagring inte hålla <code>.qcow2</code>), konverterar <code>qm importdisk</code> avbildningen transparent. Detta kan ta flera minuter för multi-GB avbildningar; planera därefter och inte avbryta manuset."
},
"troubleshoot": {
"heading": "Felsökning",
"noImagesTitle": "\"Inga kompatibla diskbilder hittades\"",
"noImagesBody": "Skriptet hittade ingen <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code> eller <code>.raw</code>-fil. Kontrollera filändelsens stora och små bokstäver, att filen ligger direkt i vald katalog (underkataloger genomsöks inte) och att root får läsa den.",
"slowTitle": "Importen är långsam",
"slowBody": "Konverteringar mellan VMDK, QCOW2 och raw kan begränsas av CPU och in-/utmatning. Hastigheten beror på läsning från källan, skrivning till målet och eventuell dekomprimering. Välj helst raw- eller qcow2-källor när det går.",
"uefiTitle": "Den importerade disken startar i UEFI-skalet",
"uefiBody": "Avbildningen skapades för äldre BIOS-läge (SeaBIOS) men VM:n använder OVMF, eller tvärtom. Ändra VM:ns BIOS i Proxmox så att det matchar avbildningen, eller bygg om avbildningen i rätt läge före importen."
},
"related": {
"heading": "Relaterat",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importera disk till VM",
"tail": " — samma flöde för fysiska diskar (passthrough)."
},
{
"href": "/docs/utils/import-vm",
"label": "Importera VM från OVA / OVF",
"tail": " — När du har ett komplett VM-paket, inte bara en skivbild."
},
{
"href": "/docs/utils/UUp-Dump-ISO-Creator",
"label": "UUP Dump ISO-skapare",
"tail": " — generera en Windows ISO om du behöver en för en ny installation."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Kommandon för lagring och diskar",
"tail": " — referens för qm importdisk och qemu-img convert."
},
{
"href": "/docs/disk-manager",
"label": "Disk Manager översikt",
"tail": "."
}
]
}
}
@@ -0,0 +1,115 @@
{
"meta": {
"title": "Importera disk till LXC | ProxMenux Dokumentation",
"description": "Bifoga en fysisk disk till en befintlig LXC-behållare på Proxmox VE med ProxMenux. Hantera filsystemdetektering / formatering, monteringspunkt, oprivilegierade → privilegierad omvandling och ihållande enhetsvägar.",
"ogTitle": "Importera disk till LXC | ProxMenux Dokumentation",
"ogDescription": "Bifoga en fysisk disk till en befintlig LXC-behållare. Hantera filsystem, monteringspunkt och oprivilegierad → privilegierad omvandling."
},
"header": {
"title": "Importera disk till LXC",
"description": "Anslut en fysisk disk till en befintlig LXC-container på Proxmox-värden. ProxMenux hittar lediga diskar, erbjuder formatering med ett filsystem som stöds och ansluter partitionen till en monteringspunkt i containern via beständiga enhetssökvägar.",
"section": "Diskhanterare · LXC"
},
"intro": {
"title": "VM passthrough vs LXC genomgång",
"body": "Den här LXC-passthroughen ger <strong>ingen rå blockenhet</strong>. Containern får en <em>monteringspunkt</em>, alltså en katalog på den partition du väljer på värden. Till skillnad från en VM använder gästen värdens kärna, så filsystemet (ext4/xfs/btrfs) läses och hanteras av Proxmox-värden och görs sedan tillgängligt i containern."
},
"howRuns": {
"heading": "Så körs skriptet",
"body": "Flödet har två faser med tydlig åtskillnad mellan \"samla information och beslut\" och \"faktiskt ändra containerkonfig\". Fram till den slutliga bekräftelsen monteras ingenting i CT.",
"summary": "ProxMenux filtrerar bort rotdisken, monterade diskar och diskar som refereras i VM/LXC-konfigurationer. Aktiva ZFS/LVM/RAID-medlemmar döljs; gamla signaturer märks med ⚠ så att de kan raderas före formatering."
},
"prereqs": {
"heading": "Förutsättningar",
"items": [
"Minst en LXC-container definierad på värden.",
"Containern är <strong>privilegierad</strong>, eller så accepterar du skriptets erbjudande att konvertera den.",
"Minst en fysisk disk som inte används av värden eller någon annan gäst."
],
"warnTitle": "Privilegierad container krävs",
"warnBody": "Det här skriptet kräver en <strong>privilegierad</strong> container för direkt diskanslutning. Om det hittar <code>unprivileged: 1</code> erbjuds ändring av <code>/etc/pve/lxc/&lt;CTID&gt;.conf</code> på plats. Det ändrar säkerhetsmodellen men mappar inte om befintliga filägare. Säkerhetskopiera containern och kontrollera ägarskapet innan du accepterar, eller återskapa den som privilegierad."
},
"steps": {
"heading": "Steg-för-steg",
"stepLabel": "Steg",
"list": [
{
"title": "Välj målcontainer",
"img": "/disk/select-container.png",
"caption": "Meny för containerval",
"bodyRich": "ProxMenux listar varje LXC-container på värden (<code>pct list</code>). Välj den som får disken. Om containern är oprivilegierad erbjuds du att konvertera den nu."
},
{
"title": "Välj den fysiska disken",
"img": "/disk/disk-selection-ct.png",
"caption": "Lediga diskar på värden, med ⚠ för gamla metadata",
"bodyRich": "Bara säkra kandidater visas. Till skillnad från VM-flödet ansluter skriptet <strong>en disk per körning</strong>. Kör det igen för varje ytterligare disk."
},
{
"title": "Formatera eller återanvänd",
"intro": "Skriptet inspekterar disken:",
"items": [
"Om disken redan har ett filsystem som stöds (ext4/xfs/btrfs) kan det återanvändas som det är; befintliga filer bevaras.",
"Om disken saknar ett filsystem som stöds erbjuds formatering. Välj ext4/xfs/btrfs."
]
},
{
"title": "Välj monteringspunkten",
"bodyRich": "Ange sökvägen där containern ska se disken, exempelvis <code>/mnt/data</code> eller <code>/mnt/disk_passthrough</code>. Det är sökvägen <em>inne i</em> containern; värden ser redan partitionen under <code>/dev/disk/by-id/…</code>."
},
{
"title": "Anslut och verifiera",
"img": "/disk/assignment-ct.png",
"caption": "Tilldelning till CT",
"bodyRich": "ProxMenux lägger till en ny <code>mpN:</code>-post i containerkonfigurationen, hoppar över upptagna index och läser konfigurationen igen för att bekräfta. Om containern körs tillämpas monteringen direkt; annars vid nästa start.",
"extraImg": "/disk/result-point.png",
"extraAlt": "Monteringspunkten skapades",
"extraCaption": "Monteringspunkt skapad och verifierad"
}
]
},
"manual": {
"heading": "Manuell motsvarighet",
"body": "Skriptet använder <code>pct set</code>. Ett direkt anrop för en enda disk ser ut så här:"
},
"important": {
"heading": "Viktiga överväganden",
"items": [
"<strong>En disk per körning</strong>. Kör skriptet igen för varje ytterligare disk.",
"Anslut <strong>inte</strong> samma partition till flera containrar som kan montera den samtidigt; samtidiga skrivningar skadar filsystemet.",
"<strong>Gamla metadata</strong> (RAID/ZFS/LVM-signaturer) måste rensas manuellt innan skriptet tillåter formatering, annars vägrar <code>mkfs</code> att skriva över. Använd <wipeLink>Formatera eller radera fysisk disk</wipeLink>."
]
},
"troubleshoot": {
"heading": "Felsökning",
"unprivTitle": "\"Kan inte fortsätta med en oprivilegierad container\"",
"unprivBody": "Du avböjde konverteringen, så skriptet avslutades utan att ändra något. Kör det igen och godkänn för att fortsätta: skriptet stoppar containern, säkerhetskopierar konfigurationen till <code>/etc/pve/lxc/&lt;CTID&gt;.conf.bak</code> och ersätter <code>unprivileged: 1</code> med <code>unprivileged: 0</code>. Den ändringen omvandlar inte i sig UID/GID-ägarskapet för befintliga filer, så säkerhetskopiera containern och rätta ägarskapet först, eller återställ eller återskapa containern som privilegierad.",
"permsTitle": "Behörigheter inne i containern är fel",
"permsBody": "Befintliga filägare behålls när en partition monteras i en privilegierad container; ett nyformaterat filsystem ägs ofta av <code>root:root</code>. Om tjänsten körs som en annan användare, exempelvis <code>www-data</code> för Nextcloud, kontrollera UID/GID och justera berörda filer med <code>chown</code>/<code>chmod</code>. Ändringarna påverkar även den underliggande disken."
},
"related": {
"heading": "Relaterat",
"items": [
{
"href": "/docs/disk-manager/import-disk-vm",
"label": "Importera disk till VM",
"tail": " - motsvarande flöde för VM."
},
{
"href": "/docs/storage-share/lxc-mount-points",
"label": "LXC-monteringspunkter (värd ↔ CT)",
"tail": " - dela värdkataloger med en CT istället för att fästa en hel disk."
},
{
"href": "/docs/help-info/vm-ct-commands",
"label": "Kommandon för VM- och CT-hantering",
"tail": " — pct config / push / pull referens."
},
{
"href": "/docs/disk-manager",
"label": "Disk Manager översikt",
"tail": "."
}
]
}
}
@@ -0,0 +1,113 @@
{
"meta": {
"title": "Importera disk till VM | ProxMenux Dokumentation",
"description": "Bifoga en fysisk disk till en befintlig Proxmox VM med ProxMenux. Säker diskdetektering (exkluderar system, monterad, in-use, ZFS / RAID / LVM), ihållande /dev/disk/by-id vägar och SATA / SCSI / VirtIO / IDE gränssnitt.",
"ogTitle": "Importera disk till VM | ProxMenux Dokumentation",
"ogDescription": "Bifoga en fysisk disk till en befintlig Proxmox VM. Använder ihållande /dev/disk/by-id vägar och stöder SATA / SCSI / VirtIO / IDE."
},
"header": {
"title": "Importera disk till VM",
"description": "Anslut en fysisk disk på Proxmox-värden till en befintlig virtuell maskin. ProxMenux hittar lediga diskar, låter dig välja mål-VM och busstyp (SATA/SCSI/VirtIO/IDE) och använder beständiga /dev/disk/by-id-sökvägar. Tilldelningen består då efter omstarter och ändrad enhetsordning.",
"section": "Diskhanterare · VM"
},
"intro": {
"title": "Vad detta gör",
"body": "En fysisk disk ansluts som underlag för ett virtuellt diskgränssnitt. Gästen får inte automatiskt inbyggda SMART-data eller den fysiska styrenhetens funktioner; använd PCI-passthrough av styrenheten om dessa behövs. Disken ansluts via sin sökväg <code>/dev/disk/by-id/…</code> när en sådan finns, så ändrad enhetsordning vid start bryter inte tilldelningen; annars används <code>/dev/sdX</code>."
},
"howRuns": {
"heading": "Så körs skriptet",
"body": "Flödet har två faser med tydlig åtskillnad mellan \"samla information och beslut\" och \"faktiskt fästa diskar till VM\". Fram till den slutliga bekräftelsen är VM-konfig orörd.",
"summary": "ProxMenux filtrerar bort osäkra kandidater: rotdisken, diskar monterade på värden, aktiva ZFS/LVM/RAID-medlemmar och diskar som refereras i VM/LXC-konfigurationer. Diskar med <em>gamla</em>, oanvända ZFS/RAID/LVM-signaturer märks med ⚠ men blockeras inte."
},
"prereqs": {
"heading": "Förutsättningar",
"items": [
"Minst en VM definierad på värden (skriptet skickar direkt till <code>qm list</code>).",
"<strong>Mål-VM:n är avstängd</strong>. Om den körs avbryts skriptet med ett meddelande; tillägg av diskar under drift ingår inte i det här flödet.",
"Minst en fysisk disk på värden som inte används av värden eller någon annan gäst."
]
},
"steps": {
"heading": "Steg-för-steg",
"stepLabel": "Steg",
"list": [
{
"title": "Välj mål-VM",
"bodyRich": "ProxMenux listar alla VM:ar på värden via <code>qm list</code>. Välj den som ska få disken. Om den körs avbryts skriptet och ber dig stänga av den först."
},
{
"title": "Välj fysiska diskar att ansluta",
"img": "/disk/disk-selection.png",
"caption": "Lediga diskar på värden, med ⚠ för gamla metadata",
"body": "Skriptet granskar värdens diskar och visar bara sådana som kan anslutas utan konflikt. Du kan välja flera samtidigt. Diskar med gamla ZFS/LVM/RAID-signaturer visas fortfarande med ⚠ för att ange att signaturerna behöver raderas innan gästen formaterar dem."
},
{
"title": "Välj bussgränssnittet",
"img": "/disk/disk-assigment.png",
"caption": "Val av bussgränssnitt",
"intro": "Välj hur gästen ska se skivan:",
"items": [
"<strong>SCSI</strong> moderna standard för Linux och Windows med VirtIOSCSI-drivrutiner installerade.",
"<strong>SATA</strong> bred kompatibilitet, fungerar ur lådan på praktiskt taget alla gäster.",
"<strong>VirtIO</strong>: effektiv paravirtualiserad blockenhet; kräver drivrutiner i gästen.",
"<strong>IDE</strong>: för äldre gäster som saknar ovanstående drivrutiner."
]
},
{
"title": "Anslut och verifiera",
"bodyRich": "ProxMenux fäster varje vald disk med sin bästa <code>/dev/disk/by-id/</code>-väg, hoppar över slotindex som redan används i VM-konfig (<code>scsi0</code>, <code>sata0</code>, ...) och läser om konfigen för att bekräfta uppdraget. En sammanfattning trycks i slutet."
}
]
},
"manual": {
"heading": "Manuell motsvarighet",
"body": "Manuset är en wrapper runt <code>qm set</code>. Det exakta kommandot för en enda disk ser ut så här:",
"migrationTitle": "Live migration är inte möjligt",
"migrationBody": "En VM med en direktansluten fysisk disk är <strong>knuten till värden som tillhandahåller disken</strong>. En annan nod saknar normalt både samma <code>/dev/disk/by-id/…</code>-sökväg och diskdata. Säkerhetskopiera och överför data separat, eller använd hanterade virtuella diskar på delad lagring eller med replikering som stöds. Utgå inte från att Proxmox lagringsreplikering omfattar enheten.",
"shareTitle": "Dela inte en fysisk disk mellan VM",
"shareBody": "Att fästa samma fysiska disk till två VM samtidigt kommer att korrumpera data på nästa skriv. ProxMenux upptäcker denna situation och blockerar den, men om du kringgår manuset (direkt <code>qm set</code>), se till att endast en gäst någonsin monterar disken."
},
"troubleshoot": {
"heading": "Felsökning",
"noDisksTitle": "Inga diskar tillgängliga för denna VM",
"noDisksIntro": "Manuset hittade skivor, men varje kandidat filtrerades ut. Vanliga skäl:",
"noDisksItems": [
"Varje återstående disk refereras redan i målet VM-konfig.",
"Varje återstående disk monteras på värden eller är en del av en aktiv ZFS / LVM / RAID.",
"Värden har bara rotskivan installerad."
],
"noDisksOutro": "Kör <code>lsblk -f</code> på värden för att granska tillståndet för varje disk.",
"noVisibleTitle": "VM ser inte disken efter start",
"noVisibleBody": "Med <strong>SCSI</strong> eller <strong>VirtIO</strong> behöver gästen rätt drivrutin. Linux har den i kärnan; i Windows installerar du den från VirtIO-ISO:n (se <winLink>Skapa VM: Windows</winLink>). Att byta till SATA på VM:ns maskinvaruflik är ett snabbt test av diskens tilldelning."
},
"related": {
"heading": "Relaterat",
"items": [
{
"href": "/docs/disk-manager/import-disk-image-vm",
"label": "Importera diskavbildning till virtuell dator",
"tail": " — samma flöde för diskavbildningsfiler (qcow2 / vmdk / raw / img)."
},
{
"href": "/docs/disk-manager/import-disk-lxc",
"label": "Importera disk till LXC",
"tail": " - motsvarande flöde för LXC containrar."
},
{
"href": "/docs/disk-manager/add-controller-nvme-vm",
"label": "Lägg till styrenhet eller NVMe i en VM",
"tail": " — när du behöver fullständig PCIe/NVMe-passthrough i stället för diskanslutning."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Kommandon för lagring och diskar",
"tail": " — referens för qm importdisk och relaterade skalkommandon."
},
{
"href": "/docs/disk-manager",
"label": "Disk Manager översikt",
"tail": "."
}
]
}
}
@@ -0,0 +1,135 @@
{
"meta": {
"title": "Proxmox diskhanterare: VM/LXC, SMART-test och radering | ProxMenux",
"description": "Hantera fysiska diskar på en Proxmox VE-värd med ProxMenux: anslut diskar till VM eller LXC (qm set scsi/sata/virtio, pct mp), importera img/qcow2/vmdk/raw-avbildningar, tilldela hela HBA:er eller NVMe-styrenheter, radera med säkerhetskontroller och kör SMART-självtester.",
"ogTitle": "Proxmox diskhanterare: VM/LXC, SMART-test och radering",
"ogDescription": "Anslut diskar till VM/LXC, importera avbildningar, använd PCI-passthrough för styrenheter, radera med säkerhetskontroller och kör SMART-test på Proxmox VE.",
"twitterTitle": "Proxmox diskhanterare | ProxMenux",
"twitterDescription": "Anslut diskar till VM/LXC, importera avbildningar, PCI-passthrough, radering med säkerhetskontroller och SMART-test."
},
"header": {
"title": "Diskhanteraren",
"description": "Menyn Diskhanterare samlar ProxMenux-verktyg för värdens fysiska diskar: anslutning till VM och LXC, import av diskavbildningar, passthrough av en hel styrenhet eller NVMe-enhet, radering med säkerhetskontroller och SMART-test.",
"section": "Diskhanteraren"
},
"intro": {
"title": "Vad denna meny är för",
"body": "Verktygen arbetar med <strong>fysiska diskar som värden ser och avbildningsfiler lagrade på den</strong>. Menyn har tre grupper: <strong>VM</strong> (anslut diskar eller importera avbildningar), <strong>LXC</strong> (anslut diskar till containrar) och <strong>Verktyg</strong> (formatering och SMART-status). Anslutning och radering döljer eller blockerar systemdiskar och använda diskar; SMART-kontroller kan granska dem utan att radera dem."
},
"opening": {
"heading": "Öppna menyn",
"body": "Från ProxMenux huvudmenyn väljer du <strong>Disk Manager</strong>. Du kommer att se detta:",
"imageAlt": "Disk Manager-menyn med VM, LXC och Utilities block"
},
"groups": {
"heading": "Tre verktygsgrupper",
"intro": "Disk Manager-menyn är organiserad i tre grupper - <strong>VM</strong>, <strong>LXC</strong> och <strong>Utilities</strong>. Klicka på ett kort för att hoppa direkt till verktygen i den gruppen.",
"vmTitle": "VM",
"vmBody": "Verktyg för befintliga virtuella maskiner. VM:n måste vara avstängd; ProxMenux kontrollerar detta innan konfigurationen ändras.",
"vmItems": [
"Importera disk till VM",
"Importera diskavbildning till virtuell dator",
"Lägg till styrenhet eller NVMe i en VM"
],
"lxcTitle": "LXC",
"lxcBody": "Verktyg för befintliga LXC-containrar. Skriptet kräver en privilegierad container och erbjuder att ändra flaggan vid behov. Läs först informationen om konvertering och filägarskap på verktygets sida.",
"lxcItems": [
"Importera disk till LXC"
],
"utilitiesTitle": "Verktyg",
"utilitiesBody": "Värdsida verktyg som fungerar på diskarna själva, oberoende av någon VM eller container.",
"utilitiesItems": [
"Formatera / radera fysisk disk",
"SMART-status och disktest"
]
},
"vm": {
"heading": "VM",
"intro": "Verktyg för befintliga virtuella maskiner. VM:n måste vara avstängd; ProxMenux kontrollerar detta innan konfigurationen ändras.",
"options": [
{
"icon": "HardDrive",
"href": "/docs/disk-manager/import-disk-vm",
"title": "Importera disk till VM",
"description": "Bifoga en otilldelad fysisk disk till en befintlig VM. Stöder SATA / SCSI / VirtIO / IDE, använder ihållande /dev/disk/by-id vägar."
},
{
"icon": "FileDown",
"href": "/docs/disk-manager/import-disk-image-vm",
"title": "Importera diskavbildning till virtuell dator",
"description": "Importera diskavbildningar (.img / .qcow2 / .vmdk / .raw) till en befintlig VM. Två faser med qm importdisk i bakgrunden."
},
{
"icon": "Cpu",
"href": "/docs/disk-manager/add-controller-nvme-vm",
"title": "Lägg till styrenhet eller NVMe i en VM",
"description": "PCI-passthrough av en hel SATA/SAS-HBA eller NVMe-enhet till en VM. Hanterar aktivering av IOMMU och konfliktkontroll."
}
]
},
"lxc": {
"heading": "LXC",
"intro": "Verktyg för befintliga LXC-containrar. Skriptet kräver en privilegierad container och erbjuder att ändra flaggan vid behov. Läs först informationen om konvertering och filägarskap på verktygets sida.",
"options": [
{
"icon": "Boxes",
"href": "/docs/disk-manager/import-disk-lxc",
"title": "Importera disk till LXC",
"description": "Bifoga en otilldelad fysisk disk till en befintlig LXC-behållare som fästpunkt. Hantera filsystemdetektering / format och privilegierad omvandling."
}
]
},
"utilities": {
"heading": "Verktyg",
"intro": "Värdsida verktyg som fungerar på diskarna själva, oberoende av någon VM eller container.",
"options": [
{
"icon": "Eraser",
"href": "/docs/disk-manager/format-disk",
"title": "Formatera eller radera fysisk disk (med säkerhetskontroller)",
"description": "Radera diskar med strikta säkerhetskontroller: bara helt lediga diskar visas och dubbel bekräftelse krävs alltid."
},
{
"icon": "Activity",
"href": "/docs/disk-manager/smart-disk-test",
"title": "SMART-status och disktest",
"description": "Kör SMART hälsokontroller och kort / långa självtester på SATA, SAS och NVMe-enheter. Exporterar JSON för monitorn."
}
]
},
"safety": {
"title": "Säkerhetsregler för diskanslutning och radering",
"intro": "Anslutning och radering filtrerar bort enheter som kan skada värden:",
"items": [
"<strong>Systemdisken</strong>, rotpoolen, swap och aktiva ZFS/LVM/RAID-medlemmar döljs alltid.",
"Diskar som är <strong>monterade</strong> någonstans på värden döljs eller blockeras vid körningen.",
"Diskar som <strong>refereras av en körande VM eller LXC</strong> kan inte tilldelas om eller raderas.",
"Åtgärder som ändrar värdens tillstånd, exempelvis aktivering av IOMMU eller radering, kräver uttrycklig bekräftelse."
]
},
"related": {
"heading": "Relaterat",
"items": [
{
"href": "/docs/storage-share",
"label": "Lagrings- och delningshanterare",
"tail": " - registrera lagring i Proxmox själv (NFS / Samba / iSCSI / lokal) och dela mappar mellan värd och CT."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Kommandon för lagring och diskar",
"tail": " - blockenheter, LVM, pvesm, SMART referens."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "Kommandon för ZFS-hantering",
"tail": " — för ZFS pooler och datamängder."
},
{
"href": "/docs/hardware/gpu-vm-passthrough",
"label": "Lägg till GPU till VM (Passthrough)",
"tail": " - samma IOMMU / VFIO-koncept som tillämpas på GPU."
}
]
}
}
@@ -0,0 +1,146 @@
{
"meta": {
"title": "SMART-status och disktest | ProxMenux-dokumentation",
"description": "Kör SMART hälsokontroller och disktester på Proxmox VE med ProxMenux. Stöder SATA / SAS (smartmontools) och NVMe (nvme-cli). Korta och långa självtester, JSON export för ProxMenux Monitor integration.",
"ogTitle": "SMART-status och disktest | ProxMenux-dokumentation",
"ogDescription": "SMART hälsokontroller och självtest för SATA / SAS och NVMe-enheter på Proxmox. JSON export för Monitor."
},
"header": {
"title": "SMART-status och disktest",
"description": "Läs SMART-data och starta självtester på värdens fysiska diskar. ProxMenux installerar smartmontools för SATA/SAS och nvme-cli för NVMe, startar testet i diskens firmware (långa tester fortsätter när terminalen stängs) och exporterar JSON-resultat för ProxMenux Monitor.",
"section": "Diskhanterare · Verktyg"
},
"intro": {
"title": "Vad detta är för",
"body": "SMART (Self-Monitoring, Analysis and Reporting Technology) låter disken rapportera sitt tillstånd och köra självtester. Verktyget visar data utan att du behöver minnas rätt <code>smartctl</code>- eller <code>nvme</code>-anrop och sparar utdata som JSON så att Monitor kan visa trender över tid."
},
"howRuns": {
"heading": "Så körs skriptet",
"body": "Alla åtgärder är icke-destruktiva: SMART läser firmware-räknare och självtester körs inne i disken. Ingen fasindelning behövs. Flödet är: beroendekontroll → diskval → åtgärdsval → anrop av smartctl eller nvme-cli beroende på disktyp → visad utdata och JSON-export för Monitor."
},
"deps": {
"heading": "Beroenden",
"body": "Verktyget installerar automatiskt vad det behöver på första körningen. SATA / SAS-enheter är beroende av <code>smartmontools</code>; NVMe-enheter är beroende av <code>nvme-cli</code>. Båda:"
},
"actions": {
"heading": "Tillgängliga åtgärder",
"headerAction": "Handling",
"headerWhat": "Vad som läses eller körs",
"headerDur": "Varaktighet",
"rows": [
{
"action": "Snabb hälsostatus",
"whatRich": "Totalt PASSED/FAILED + nyckelattribut.<br /><code>smartctl -H</code> + <code>-A</code> (SATA/SAS) eller <code>nvme smart-log</code> (NVMe).",
"dur": "Omedelbart"
},
{
"action": "Fullständig rapport",
"whatRich": "Komplett SMART data, rullbar. <code>smartctl -x</code> för SATA/SAS eller <code>nvme smart-log</code> + <code>id-ctrl</code> för NVMe.",
"dur": "Omedelbart"
},
{
"action": "Kort test",
"what": "Grundläggande kontroll av lagringsytan och elektroniken i diskens firmware.",
"dur": "~2 minuter"
},
{
"action": "Långt test",
"what": "Full skanning av hela ytan. Körs på hårdvaran - kvarstår även om du stänger terminalen.",
"dur": "Timmar (diskstorlek beroende)"
},
{
"action": "Kontrollera testförlopp",
"what": "Status för det aktiva eller senaste självtestet.",
"dur": "Omedelbart"
}
],
"tipTitle": "Långa tester fortsätter när terminalen stängs",
"tipBody": "Ett långt test körs <em>inne i disken</em> och kräver inte att ProxMenux-processen fortsätter. Du kan stänga terminalen och återkomma till <strong>Kontrollera testförlopp</strong>. Omstart av värden, återställning av styrenheten eller strömavbrott kan avbryta testet och resultatinsamlingen; utgå inte från att de återupptas automatiskt."
},
"json": {
"heading": "JSON export för Monitor",
"intro": "Status-, korttest- och förloppsåtgärder skriver en tidsstämplad JSON-fil till <code>/usr/local/share/proxmenux/smart/&lt;disk&gt;/</code>; långa testers resultat samlas i bakgrunden. Den fullständiga rapporten visas bara. Strukturen är:",
"outro": "ProxMenux Monitor plockar upp dessa för att göra hälsotrender per disk; gamla filer roteras automatiskt när lagringsgränsen nås."
},
"steps": {
"heading": "Steg-för-steg",
"stepLabel": "Steg",
"list": [
{
"title": "Välj en disk",
"body": "ProxMenux listar varje fysisk disk på värden med sin modell och storlek. Till skillnad från Format-verktyget filtreras inte den här listan av säkerhet - läs SMART är en icke-destruktiv operation.",
"img": "/disk/smart/disk-selection.png",
"alt": "SMART diskval meny",
"caption": "SMART diskval meny"
},
{
"title": "Välj en åtgärd",
"body": "Välj snabb status, fullständig rapport, kort test, långt test eller kontroll av testförlopp. Menyn hålls öppen efter varje åtgärd så att du kan göra flera förfrågningar mot samma disk.",
"img": "/disk/smart/action-menu.png",
"alt": "SMART åtgärdsmenyn",
"caption": "SMART åtgärdsmenyn (5 åtgärder + avbryta)"
},
{
"title": "(Endast långt test) Bekräfta bakgrundskörning",
"body": "ProxMenux informerar om att testet fortsätter när terminalen stängs och visar var JSON-resultatet sparas. Bekräfta för att starta testet.",
"img": "/disk/smart/long-test-warning.png",
"alt": "Lång testbekräftelsedialog",
"caption": "Lång testbekräftelse - körs i bakgrunden, vilket sparas till JSON"
},
{
"title": "Granska resultat",
"bodyRich": "Status, tester och förlopp visas i terminalen; <strong>Fullständig rapport</strong> öppnas i en rullbar dialog. JSON exporteras för åtgärderna ovan, inte för Fullständig rapport. För långa tester återkommer du till <strong>Kontrollera testförlopp</strong> på samma disk.",
"img": "/disk/smart/quick-status.png",
"alt": "Utdata från snabb statuskontroll",
"caption": "Snabb hälsostatusutgång (SATA - smartctl -H + -A)"
}
]
},
"manual": {
"heading": "Manuella motsvarigheter",
"nvmeWarnTitle": "NVMe-självtester beror på diskens firmware",
"nvmeWarnBody": "Inte varje NVMe-enhet stöder det korta / långa självtestkommandot. Om en enhet vägrar testet är SMART-loggen och ID-kontrolldata (<code>nvme smart-log</code> + <code>id-ctrl</code>) fortfarande den mest tillförlitliga hälsosignalen."
},
"troubleshoot": {
"heading": "Felsökning",
"noSmartTitle": "\"Kan inte läsa SMART data från /dev/sdX\"",
"noSmartBody": "Disken sitter troligen bakom en RAID/SAS-styrenhet som inte vidarebefordrar SMART. För megaraid-kort kan du prova <code>smartctl -d megaraid,N /dev/sdX</code>. För HBA:er i IT-läge fungerar det direkta anropet.",
"longTitle": "Långt test slutför aldrig",
"longBody": "Testet körs i diskens firmware och hög I/O-belastning kan fördröja det. Prova en lugn period, exempelvis över natten. För SATA visar <code>smartctl -c</code> återstående procent, för SAS <code>smartctl -l selftest</code>; självtestloggen visar slutstatus och eventuella felaktiga LBA:er. Läsfel behöver undersökas; långsamt förlopp bevisar inte i sig en dålig sektor."
},
"related": {
"heading": "Relaterat",
"items": [
{
"href": "/docs/disk-manager/format-disk",
"label": "Formatera / radera fysisk disk",
"tail": " — Återanvänd en disk efter att ha bekräftat att den är frisk."
},
{
"href": "/docs/help-info/storage-commands",
"label": "Kommandon för lagring och diskar → SMART-status",
"tail": " — referens för smartctl/nvme med kommandon att kopiera."
},
{
"href": "/docs/help-info/zfs-commands",
"label": "Kommandon för ZFS-hantering",
"tail": " — zpool scrub verifierar ZFS-datas kontrollsummor och kompletterar hårdvarans SMART-test."
},
{
"href": "/docs/monitor/dashboard/storage",
"label": "ProxMenux Monitor - Lagringsflik",
"tail": " — detaljerad diskvy som använder exporterad JSON: fullständig SMART-tabell, historik och PDF-rapport."
},
{
"href": "/docs/monitor/dashboard/hardware",
"label": "ProxMenux Monitor — maskinvarufliken",
"tail": " - Lagring Sammanfattning med modell, kapacitet och förhandlad länkhastighet (nuvarande vs maximum på NVMe)."
},
{
"href": "/docs/disk-manager",
"label": "Disk Manager översikt",
"tail": "."
}
]
}
}