"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 <code>vfio-pci</code> je GPU vyhradený pre VM. S natívnym ovládačom <em>(i915 / amdgpu / nvidia)</em> ho môžu zdieľať hostiteľ a LXC. <strong>Zmeniť režim GPU</strong> spravuje <code>vfio.conf</code>, 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 <strong>už priradený</strong> 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 <vmLink>Pridať GPU do VM</vmLink>"
},
{
"situation":"GPU je voľný a nebol priradený: chcem ho použiť v LXC.",
"useRich":"Nie — použite <lxcLink>Pridať GPU do LXC</lxcLink>"
},
{
"situationRich":"GPU je priradený VM cez <code>vfio-pci</code>, ale chcem ho používať v LXC.",
"useRich":"<strong>Áno – táto stránka.</strong>"
},
{
"situation":"GPU je zdieľaný s LXC, chcem ho venovať VM.",
"useRich":"<strong>Áno – táto stránka.</strong>"
},
{
"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."
"iommu":"<strong>IOMMU musí byť aktívne na hostiteľovi</strong> pri prechode <em>do</em> režimu VM. Záleží na nastaveniach firmvéru aj na podpore jadra. Ak v bežiacom jadre chýba <code>intel_iommu=on</code> alebo <code>amd_iommu=on</code>, skript ho pridá s <code>iommu=pt</code> do <code>/etc/kernel/cmdline</code> (značka koreňa ZFS) alebo <code>/etc/default/grub</code> a potom spustí <code>proxmox-boot-tool refresh</code> alebo <code>update-grub</code>. Skontrolujte prípadné varovania a podľa výzvy reštartujte.",
"iommuCheck":"dmesg | grep -i 'IOMMU enabled' | head -1",
"reboot":"<strong>Počítajte s reštartom.</strong> Trvalé zmeny ovládača a zavádzania môžu vyžadovať obnovu initramfs a reštart. Skript na to vyzve na konci.",
"knowList":"<strong>Zistite, ktoré VM a LXC používajú GPU.</strong> 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í <code>8086:5a84</code> a <code>8086:5a85</code>. 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 <em>do</em> režimu LXC; ďalšie kontroly môžu naďalej platiť."
"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í <code>/sys/bus/pci/devices/*/driver</code>. 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 <em>rovnakom</em> 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":[
"<strong>VM → LXC:</strong> odstráni väzbu na <code>vfio-pci</code>, aby GPU mohol používať natívny ovládač (<code>nvidia</code>, <code>amdgpu</code>, <code>i915</code>). Pre NVIDIA odstráni príslušné položky BDF z <code>/etc/udev/rules.d/10-proxmenux-vfio-bind.rules</code> pre ďalší štart.",
"<strong>LXC → VM:</strong> pripraví priradenie k <code>vfio-pci</code>. AMD / Intel blokujú natívny ovládač a používajú <code>options vfio-pci ids=…</code>. Pre NVIDIA sa <code>nvidia</code> globálne blokuje iba vtedy, keď je každá NVIDIA GPU hostiteľa vo VFIO; inak pravidlá podľa BDF nastavia <code>driver_override=vfio-pci</code> zariadeniam dotknutých skupín IOMMU a NVIDIA GPU mimo týchto skupín si ponechajú <code>nvidia</code>. Pred prepnutím skontrolujte každého člena skupiny."
"body":"Kontroluje <code>/etc/pve/lxc/*.conf</code> podľa rodiny ovládača GPU a <code>/etc/pve/qemu-server/*.conf</code> 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":"<code>pct set CTID -onboot 0</code> alebo <code>qm set VMID -onboot 0</code>. 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 <code>hostpci</code> / <code>dev</code> 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 <code>.1</code> rovnakého slotu; priradené môžu byť aj ďalšie zvukové zariadenia. Po odstránení GPU môžu zostať neplatné zvukové položky <code>hostpci</code>. Overte, ktoré priradenia ponechať.",
"body2":"Identifikuje zvukové adresy BDF a zobrazí zoznam priradení na odstránenie. Ich ID vendor:device odstráni aj z <code>/etc/modprobe.d/vfio.conf</code>, iba ak ich nepoužíva iná VM."
},
"apply":{
"title":"Použitie zmien hostiteľa a hostí",
"body":"Po potvrdení zapíše zmeny hostiteľa: <code>vfio.conf</code>, blokovanie ovládačov, moduly a pre NVIDIA pravidlo BDF <code>/etc/udev/rules.d/10-proxmenux-vfio-bind.rules</code> so stavom v <code>/etc/proxmenux/vfio-bind.bdfs</code>. Použije aj zvolený postup pre každého hosťa. Pri zmene konfigurácie hostiteľa spustí <code>update-initramfs -u -k all</code> a potom <code>proxmox-boot-tool refresh</code>; 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 <strong>VM → LXC</strong> overte ovládač a pravidlá BDF. Príklad NVIDIA používa <code>10de:2204</code>; prispôsobte ho karte. Príkazy čítajú stav; skript spravuje aj hostí a členov skupiny IOMMU.",
"lxcToVm":"Pred <strong>LXC → VM</strong> 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 <code>hostpci</code> 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 <code>update-initramfs</code> a reštart. <code>lsmod | grep vfio</code> iba vypíše moduly. Pre AMD / Intel pozrite <code>vfio.conf</code>; pre NVIDIA <code>/etc/proxmenux/vfio-bind.bdfs</code> a <code>/etc/udev/rules.d/10-proxmenux-vfio-bind.rules</code>. Opravte staré pravidlá pred <code>update-initramfs -u -k all</code> a reštartom.",
"vmFailTitle":"VM sa nespustí po prepnutí GPU do LXC",
"vmFailBody":"Overte neplatné odkazy <code>hostpci</code>. Voľba <em>Odstrániť GPU z konfigurácie</em> 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 <code>modprobe -r nvidia</code> a <code>modprobe nvidia</code> 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 <code>/tmp/proxmenux_gpu_switch_mode.log</code> 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."
