{ "meta": { "title": "Zmeniť režim GPU (VM ↔ LXC) | Dokumentácia ProxMenux", "description": "Prepnite GPU medzi VFIO pre VM a natívnym ovládačom pre LXC. ProxMenux zistí ovládač, ponúkne riešenie konfliktov hostí, odstráni súvisiace zvukové priradenia a pri zmene konfigurácie hostiteľa obnoví initramfs." }, "header": { "title": "Zmeniť režim GPU (VM ↔ LXC)", "description": "Prepnite priradený GPU medzi priamym prístupom VM a zdieľaním LXC. ProxMenux spravuje ovládač, VFIO, moduly a initramfs a pýta sa na dotknutých hostí. Skontrolujte voľby a po reštarte overte výslednú konfiguráciu.", "section": "Hardvér: grafické karty a Coral TPU" }, "intro": { "title": "Čo robí", "body": "S vfio-pci je GPU vyhradený pre VM. S natívnym ovládačom (i915 / amdgpu / nvidia) ho môžu zdieľať hostiteľ a LXC. Zmeniť režim GPU spravuje vfio.conf, blokovanie modulov a odkazy hostí a upozorní na zostávajúce priradenia." }, "graphics": { "lxcTitle": "Pripravené pre LXC kontajnery", "lxcDesc": "Aktívny natívny ovládač", "vmTitle": "Pripravené pre VM passthrough", "vmDesc": "Aktívny VFIO-PCI ovládač" }, "when": { "heading": "Kedy to mám použiť?", "intro": "Použite, ak je GPU už priradený a chcete zmeniť jeho použitie:", "headerSituation": "Situácia", "headerUse": "Použiť túto stránku?", "rows": [ { "situation": "GPU je voľný a nebol priradený: chcem ho použiť vo VM.", "useRich": "Nie — použite Pridať GPU do VM" }, { "situation": "GPU je voľný a nebol priradený: chcem ho použiť v LXC.", "useRich": "Nie — použite Pridať GPU do LXC" }, { "situationRich": "GPU je priradený VM cez vfio-pci, ale chcem ho používať v LXC.", "useRich": "Áno – táto stránka." }, { "situation": "GPU je zdieľaný s LXC, chcem ho venovať VM.", "useRich": "Áno – táto stránka." }, { "situation": "Chcem odstrániť všetky priradenia tohto GPU.", "use": "Režim LXC vráti GPU ovládaču hostiteľa; postup pri konflikte pre VM môže odstrániť položky hostpci, položky zariadení LXC však treba odstrániť samostatne. GPU zostane pripojený k ovládaču." } ] }, "prereqs": { "title": "Skôr ako začnete", "assigned": "Už priradený GPU do VM cez VFIO alebo do LXC. Pri prvom priradení použite Pridať GPU do VM / LXC.", "iommu": "IOMMU musí byť aktívne na hostiteľovi pri prechode do režimu VM. Záleží na nastaveniach firmvéru aj na podpore jadra. Ak v bežiacom jadre chýba intel_iommu=on alebo amd_iommu=on, skript ho pridá s iommu=pt do /etc/kernel/cmdline (značka koreňa ZFS) alebo /etc/default/grub a potom spustí proxmox-boot-tool refresh alebo update-grub. Skontrolujte prípadné varovania a podľa výzvy reštartujte.", "iommuCheck": "dmesg | grep -i 'IOMMU enabled' | head -1", "reboot": "Počítajte s reštartom. Trvalé zmeny ovládača a zavádzania môžu vyžadovať obnovu initramfs a reštart. Skript na to vyzve na konci.", "knowList": "Zistite, ktoré VM a LXC používajú GPU. Skript vyhľadá odkazy a spýta sa na každého hosťa; známy zoznam uľahčí kontrolu." }, "blocklist": { "title": "Nie všetky GPU sú bezpečné prejsť na VM", "body": "Skript podľa svojich pravidiel kompatibility blokuje režim VM pre ID zariadení 8086:5a84 a 8086:5a85. Ak vybraná GPU zodpovedá, zastaví prechod do režimu VM a vráti sa na výber GPU, alebo skončí, ak je to jediná GPU. Tento zoznam blokovaných nebráni prechodu do režimu LXC; ďalšie kontroly môžu naďalej platiť." }, "running": { "heading": "Spustenie skriptu", "body": "V ProxMenuxe otvorte Hardvér: GPU a Coral-TPU → Zmeniť režim GPU (VM ↔ LXC).", "imageAlt": "Voľba Zmeniť režim GPU (VM ↔ LXC) v ponuke hardvéru" }, "howRuns": { "heading": "Ako skript funguje", "body": "Výber GPU a smer sa kontrolujú pred hlavným prepnutím. Samostatné čistenie starých záznamov VFIO môže žiadať potvrdenie skôr; hostia majú vlastné dialógy konfliktov. Čítajte každé potvrdenie: jedno záverečné potvrdenie nepokrýva všetky zmeny." }, "walkthrough": { "heading": "Postup krok za krokom", "detect": { "title": "Zistenie GPU a aktuálneho ovládača", "body": "Prehľadá radiče VGA, 3D a Display hostiteľa a overí /sys/bus/pci/devices/*/driver. Zobrazí názov, adresu PCI a aktuálny ovládač každého GPU na určenie režimu.", "imageAlt": "Zoznam GPU s aktuálnym ovládačom (vfio-pci / nvidia / amdgpu / i915) a adresou PCI" }, "pickGpu": { "title": "Výber GPU na prepnutie", "body": "Jediný GPU sa vyberie automaticky. Pri viacerých možno označiť viac GPU, ale musia byť v rovnakom režime. Pri zmiešaných režimoch treba výber zúžiť.", "tipTitle": "Prepínanie viacerých GPU naraz", "tipBody": "Príklad: prepnúť tri NVIDIA do režimu VM a potom vrátiť iGPU do LXC. Dve spustenia, každé so spoločným cieľom, namiesto samostatného prepínania kariet." }, "direction": { "title": "Preskúmanie navrhovaného smerovania", "intro": "Na základe aktuálneho režimu, skript navrhuje opak ako cieľ:", "items": [ "VM → LXC: odstráni väzbu na vfio-pci, aby GPU mohol používať natívny ovládač (nvidia, amdgpu, i915). Pre NVIDIA odstráni príslušné položky BDF z /etc/udev/rules.d/10-proxmenux-vfio-bind.rules pre ďalší štart.", "LXC → VM: pripraví priradenie k vfio-pci. AMD / Intel blokujú natívny ovládač a používajú options vfio-pci ids=…. Pre NVIDIA sa nvidia globálne blokuje iba vtedy, keď je každá NVIDIA GPU hostiteľa vo VFIO; inak pravidlá podľa BDF nastavia driver_override=vfio-pci zariadeniam dotknutých skupín IOMMU a NVIDIA GPU mimo týchto skupín si ponechajú nvidia. Pred prepnutím skontrolujte každého člena skupiny." ], "outro": "Potvrdiť smer alebo zrušiť." }, "conflict": { "title": "Postup pre každú dotknutú VM alebo LXC", "body": "Kontroluje /etc/pve/lxc/*.conf podľa rodiny ovládača GPU a /etc/pve/qemu-server/*.conf podľa PCI priradení. Detekcia LXC nie je presnou zhodou BDF každej karty. Skontrolujte zistených hostí a vyberte postup pre každého:", "headerPolicy": "Politika", "headerEffect": "Účinok", "headerWhen": "Kedy vybrať", "keepPolicy": "Ponechať konfiguráciu a vypnúť automatický štart", "keepEffect": "pct set CTID -onboot 0 alebo qm set VMID -onboot 0. Položky GPU zostanú zachované.", "keepWhen": "Ak chcete hosťa znova používať po návrate GPU do pôvodného režimu. Opatrná predvolená voľba.", "removePolicy": "Odstrániť GPU z konfigurácie", "removeEffect": "Odstráni zistené položky hostpci / dev a podporované staršie odkazy.", "removeWhen": "Ak má hosť fungovať bez GPU. Najprv overte aplikáciu: náhrada cez CPU závisí od nej a odstránenie zariadenia ju automaticky nenastaví.", "imageAlt": "Dialóg výberu postupu pre dotknuté VM alebo LXC" }, "audio": { "title": "Odstránenie súvisiacich zvukových priradení pri opustení VM", "body1": "Mnohé samostatné GPU NVIDIA / AMD poskytujú HDMI zvuk cez funkciu .1 rovnakého slotu; priradené môžu byť aj ďalšie zvukové zariadenia. Po odstránení GPU môžu zostať neplatné zvukové položky hostpci. Overte, ktoré priradenia ponechať.", "body2": "Identifikuje zvukové adresy BDF a zobrazí zoznam priradení na odstránenie. Ich ID vendor:device odstráni aj z /etc/modprobe.d/vfio.conf, iba ak ich nepoužíva iná VM." }, "apply": { "title": "Použitie zmien hostiteľa a hostí", "body": "Po potvrdení zapíše zmeny hostiteľa: vfio.conf, blokovanie ovládačov, moduly a pre NVIDIA pravidlo BDF /etc/udev/rules.d/10-proxmenux-vfio-bind.rules so stavom v /etc/proxmenux/vfio-bind.bdfs. Použije aj zvolený postup pre každého hosťa. Pri zmene konfigurácie hostiteľa spustí update-initramfs -u -k all a potom proxmox-boot-tool refresh; inak oba kroky preskočí." }, "reboot": { "title": "Reštartovať", "body": "Reštartujte hostiteľa na použitie novej trvalej väzby. Reštart možno odložiť, ale pred spustením cieľového hosťa overte aktívny ovládač: dovtedy môže byť aktívny pôvodný.", "imageAlt": "Súhrnný dialóg so zmenami a následnou výzvou na reštart" } }, "manual": { "heading": "Ručná kontrola", "intro": "Pred VM → LXC overte ovládač a pravidlá BDF. Príklad NVIDIA používa 10de:2204; prispôsobte ho karte. Príkazy čítajú stav; skript spravuje aj hostí a členov skupiny IOMMU.", "lxcToVm": "Pred LXC → VM overte adresu PCI a skupinu IOMMU. Nahraďte vzorovú adresu a pred priradením skontrolujte všetkých členov skupiny.", "oneVmTitle": "Fyzický GPU priradený cez VFIO môže naraz používať iba jedna VM", "oneVmBody": "Dve VM môžu mať položky hostpci pre rovnakú adresu PCI, ale GPU môže súčasne používať iba jedna; spustenie druhej zlyhá. Výber postupu pri konflikte pomáha tomu predísť." }, "verification": { "heading": "Overenie po reštarte" }, "troubleshoot": { "heading": "Riešenie problémov", "stillVfioTitle": "GPU stále ukazuje vfio-pci po prepnutí do režimu LXC", "stillVfioBody": "Načítaný modul VFIO neurčuje, ktorý ovládač používa tento GPU. Overte väzbu karty, dokončenie update-initramfs a reštart. lsmod | grep vfio iba vypíše moduly. Pre AMD / Intel pozrite vfio.conf; pre NVIDIA /etc/proxmenux/vfio-bind.bdfs a /etc/udev/rules.d/10-proxmenux-vfio-bind.rules. Opravte staré pravidlá pred update-initramfs -u -k all a reštartom.", "vmFailTitle": "VM sa nespustí po prepnutí GPU do LXC", "vmFailBody": "Overte neplatné odkazy hostpci. Voľba Odstrániť GPU z konfigurácie ich môže odstrániť počas plánovaného prepnutia. Pred opakovaním skriptu overte smer, aby ste režim neobrátili omylom. Priradenie môžete odstrániť aj v Proxmoxe pri zastavenej VM.", "smiFailTitle": "nvidia-smi hlási „Driver/library version mismatch“ po návrate do LXC", "smiFailBody": "Porovnajte načítaný modul NVIDIA s nainštalovanými knižnicami aj v LXC. Najprv zjednoťte verzie: reštart načíta nainštalovaný modul, neopraví však nekompatibilné balíky. Obnovenie cez modprobe -r nvidia a modprobe nvidia vyžaduje zastavených GPU klientov a môže zlyhať pri používaných závislých moduloch.", "logTitle": "Protokol vykonávania", "logBody": "Každé spustenie zapisuje do /tmp/proxmenux_gpu_switch_mode.log na hostiteľovi. Priložte protokol k žiadosti o pomoc na GitHube." }, "related": { "heading": "Súvisiace", "items": [ { "label": "Pridať GPU do VM (passthrough)", "href": "/docs/hardware/gpu-vm-passthrough", "tail": " — prvotné nastavenie režimu VM." }, { "label": "Pridať GPU do LXC", "href": "/docs/hardware/igpu-acceleration-lxc", "tail": " — prvotné nastavenie režimu LXC." }, { "label": "Nainštalovať ovládače NVIDIA (host)", "href": "/docs/hardware/nvidia-host", "tail": " — Vyžadované pre LXC režim na NVIDIA GPU." }, { "label": "ProxMenux Monitor — karta Hardvér", "href": "/docs/monitor/dashboard/hardware", "tail": " — časť Grafické karty s aktuálnym režimom a ovládaním prepnutia." }, { "label": "Príkazy priameho priradenia GPU", "href": "/docs/help-info/gpu-commands", "tail": " — stručný prehľad príkazov." } ] } }