{ "meta": { "title": "Import VM z OVA / OVF | Dokumentácia ProxMenux", "description": "Importujte VMware ESXi / Workstation / Fusion / VirtualBox / ProxMenux VM do Proxmox VE. Automaticky extrahuje OVA, analyzuje metadáta OVF, vytvorí VM a importuje každý disk ako natívny formát úložiska (qcow2 / raw).", "ogTitle": "Import VM z OVA / OVF | Dokumentácia ProxMenux", "ogDescription": "Importujte do Proxmoxu VM exportované z VMware, VirtualBox alebo ProxMenux. Disky sa automaticky konvertujú do natívneho formátu úložiska." }, "header": { "title": "Importovať VM z OVA / OVF", "description": "Importuje balík OVA / OVF do Proxmox VE: rozbalí archívy OVA, z deskriptora OVF načíta vCPU, pamäť, počet sieťových kariet a odkazy na disky, potom vytvorí VM a pomocou qm importdisk importuje každý disk do vybraného úložiska. Kompatibilné s exportmi z VMware (ESXi / Workstation / Fusion), VirtualBox aj ProxMenux.", "section": "Nástroje" }, "intro": { "title": "Čo to robí?", "body": "Vytvorí kompletnú VM v Proxmoxe z prenosného balíka. Po importe je pripravená na spustenie; pre výkon a kompatibilitu sa odporúča skontrolovať model sieťovej karty, firmvér a typ operačného systému." }, "picker": { "heading": "Vyberač súborov", "intro": "Pri štarte skript ponúka dva prednastavené adresáre alebo manuálnu cestu:", "items": [ "/var/lib/vz/dump — predvolený adresár záloh vzdump v Proxmox.", "/var/lib/vz/template/iso — užitočné, ak ste sem preniesli OVA cez sftp.", "Manuálna cesta pre OVA / OVF súbory kdekoľvek inde na hostiteľovi." ], "outro": "To potom uvádza každý súbor .ova a .ovf vo vybranom adresári.", "imageAlt": "Dialóg výberu súboru VM na import" }, "flow": { "heading": "Ako funguje import", "nodes": [ { "label": "Vstup OVA / OVF", "detail": ".ova → tar xf do\n /tmp/.proxmenux-import-*\n.ovf → použiť na mieste", "variant": "source" }, { "label": "Spracovať + dialógy", "detail": "AWK načíta OVF\n(názov, vCPU, RAM, NIC,\ndisky). Výber\nVMID / úložiska / mosta", "variant": "bridge" }, { "label": "qm create + importdisk", "detail": "qm create $VMID\nqm importdisk\n(VMDK → formát úložiska)\nqm set --scsiN", "variant": "target" } ] }, "ovf": { "heading": "OVF spracovanie", "intro": "Parser gawk načíta deskriptor OVF a metadáta VM. Používa match() s tromi argumentmi, čo je rozšírenie gawk, ktoré mawk, predvolený awk v Debiane / Proxmoxe, nepodporuje. Ak gawk chýba, skript ho pri prvom importe nainštaluje cez ensure_repositories + install_single_package. Ďalšie importy tento krok nepotrebujú. Načítané polia:", "headerField": "Pole", "headerSource": "Zdroj v OVF", "headerDefault": "Štandardne, ak chýba", "rows": [ { "field": "Názov VM", "source": " (prvá zhoda)", "default": "imported-vm" }, { "field": "Počet vCPU", "source": "RASD ResourceType 3 → VirtualQuantity", "default": "1" }, { "field": "Pamäť (MiB)", "source": "RASD ResourceType 4 → VirtualQuantity", "default": "1024" }, { "field": "Počet NIC", "source": "počet ResourceType 10", "default": "1" }, { "field": "Typ OS", "source": "/Linux/ alebo /Windows/ v popise", "default": "other" }, { "field": "Odkazy na disk", "source": "href atribúty končiace v .vmdk / .qcow2 / .img / .raw", "default": "Žiadne (import sa zruší)" } ] }, "memWarn": { "title": "Nejasnosť pamäťovej jednotky", "body": "Parser prevedie rozpoznané jednotky pamäte na MiB, vrátane bajtov, KiB, MiB, GiB a podporovaných textových označení. Chýbajúce alebo neznáme jednotky sa považujú za MiB. Po importe porovnajte qm config $VMID | grep memory so zdokumentovanou RAM zdrojovej VM a podľa potreby ju opravte pomocou qm set $VMID --memory <MiB>." }, "dialog": { "heading": "Postup dialógov importu", "items": [ "VMID — predvolene ďalší voľný identifikátor (pvesh get /cluster/nextid).", "Názov VM — predvolene názov načítaný z OVF; môžete ho zmeniť.", "Cieľové úložisko — zoznam úložísk s obsahom images z pvesm status -content images.", "Sieťový most — zoznam mostov z ip link show type bridge. Jediný most sa vyberie automaticky; predvolený je vmbr0.", "Potvrdenie — súhrn s VMID, názvom, vCPU, pamäťou, sieťovými kartami, úložiskom, mostom a zoznamom diskov na import. Pri zrušení sa nič nemení." ] }, "create": { "heading": "Vytvorenie VM", "intro": "Po potvrdení skript spustí:", "code": "qm create $VMID \\\n --name \"$NAME\" \\\n --memory $MEMORY \\\n --cores $VCPU \\\n --ostype $OSTYPE \\\n --scsihw lsi \\\n --net0 e1000,bridge=$BRIDGE\n\n# For each additional NIC:\nqm set $VMID --netN e1000,bridge=$BRIDGE", "outro": "SCSI radič predvolí lsi (LSI Logic) pre kompatibilitu VMDK. NIC predvolené e1000 (univerzálna kompatibilita) na zvolenom moste." }, "diskLoop": { "heading": "Cyklus importu diskov", "intro": "Pre každý odkaz na disk v OVF:", "items": [ "qm importdisk $VMID $disk_path $STORAGE — importuje disk vo formáte podporovanom cieľovým úložiskom a vytvorí položku unusedN: v konfigurácii VM.", "Skript pomocou grep vyhľadá v konfigurácii práve vytvorený odkaz unusedN.", "qm set $VMID --scsiN $unused_disk Prikladá disk ako scsi0, scsi1, …", "qm set $VMID --delete unusedN — odstráni už nepotrebnú značku unused." ], "outro": "Boot je nastavená na prvý SCSI disk: qm set $VMID --boot c --bootdisk scsi0." }, "postImport": { "heading": "Odporúčané úpravy po importe", "intro": "Import používa široko kompatibilné nastavenia, aby sa VM podľa možnosti spustila na prvý pokus. Po overení štartu môžete v rozhraní Proxmox alebo cez CLI vybrať výkonnejšie nastavenia:", "headerSetting": "Nastavenie", "headerDefault": "Štandardné po importe", "headerRecommended": "Odporúčané (ak hosť podporuje)", "rows": [ { "setting": "Model sieťovej karty", "default": "e1000", "recommended": "VirtIO (oveľa rýchlejšie, potrebuje ovládač v hosťovskom systéme)" }, { "setting": "SCSI radič", "default": "LSI", "recommended": "VirtIO SCSI single (novší Linux alebo Windows s ovládačmi VirtIO)" }, { "setting": "Firmvér (BIOS / UEFI)", "default": "Proxmox predvolený (BIOS)", "recommended": "Použite firmvér zdrojovej VM; nesúlad zabráni štartu" }, { "setting": "QEMU hosťujúci agent", "default": "Vypnuté", "recommendedRich": "Zapnúť a nainštalovať qemu-guest-agent v hosťovskom systéme (lepšie zálohy a hlásenie IP adries)" }, { "setting": "Typ OS", "default": "l26 / win10 / other (heuristika)", "recommended": "Overte podľa skutočného hosťovského operačného systému" }, { "setting": "Zobrazenie", "default": "Štandardné", "recommended": "VirtIO-GPU alebo SPICE (lepší výkon konzol)" } ] }, "fwWarn": { "title": "Nesúlad firmvéru zabráni štartu", "body": "Ak zdrojová VM používala UEFI, ale Proxmox ju vytvorí s BIOS, alebo naopak, hosťovský systém nenájde zavádzací disk. Overte FirmwareType / firmware v OVF alebo v nastaveniach pôvodnej VM a nastavte rovnakú voľbu v Proxmoxe: qm set $VMID --bios ovmf pre UEFI; predvolená hodnota BIOS je seabios." }, "notImported": { "heading": "Čo sa NEIMPORTUJE", "items": [ "Konkrétne sieťové mosty — zachová sa iba počet kariet. Všetky sa pripoja k mostu vybranému pri importe.", "Model NIC – predvolená hodnota je e1000.", "Typ firmvéru BIOS / UEFI — použije sa predvolený BIOS Proxmox.", "Konfigurácia priameho priradenia PCI.", "TPM (vTPM).", "Cloud-init disky.", "Snímky — iba aktuálny stav.", "USB / sériové / paralelné zariadenia deklarované v OVF.", "VM možnosti tagov / poznámok / štart-on-boot." ] }, "troubleshoot": { "heading": "Riešenie problémov", "orphanTitle": "VM sa vytvorila, ale import diskov zlyhal: zostala čiastočná VM", "orphanIntro": "Pri zlyhaní importu skript ponúkne odstránenie čiastočnej VM aj importovaných diskov. Ak ste odmietli alebo automatické odstránenie zlyhalo, skontrolujte VM a odstráňte ju ručne pomocou:", "orphanCode": "qm destroy $VMID --destroy-unreferenced-disks 1", "orphanOutro": "Potom opravte príčinu, pravdepodobne nedostatok miesta v cieľovom úložisku, a import zopakujte.", "memTitle": "Importovaná VM má 8 MB RAM alebo 8 TB", "memIntro": "Parser prevedie rozpoznané AllocationUnits na MiB. Chýbajúce alebo neznáme jednotky považuje za MiB. Skontrolujte OVF a porovnajte importovanú pamäť so zdrojovou VM. Podľa potreby ju opravte:", "memCode": "qm set $VMID --memory 8192 # 8 GiB", "bootTitle": "Importovaná VM sa nespustí: \"No bootable device\"", "bootIntro": "Najčastejšia príčina: BIOS / UEFI nesúlad. VM bol UEFI, ale Proxmox ho vytvoril ako BIOS. Nastavte zodpovedajúci firmvér:", "bootCode": "qm set $VMID --bios ovmf # UEFI\n# also add an EFI disk for the EFI vars:\nqm set $VMID --efidisk0 $STORAGE:1,format=qcow2,efitype=4m,pre-enrolled-keys=1", "bootOutro": "Ďalšia častá príčina: poradie štartu ukazuje na scsi0, ale operačný systém je na scsi1. Upravte poradie na karte Možnosti VM.", "bsodTitle": "VM so systémom Windows exportovaná z VMware zobrazí pri prvom štarte modrú obrazovku", "bsodBody": "Windows je citlivý na zmenu radiča disku. Nainštalujte ovládače VirtIO pred exportom z VMware alebo ponechajte predvolený radič lsi. Na VirtIO SCSI prejdite až po spustení hosťovského systému a inštalácii ovládačov VirtIO vo Windows.", "zeroTitle": "Parser OVF hlási 0 diskov", "zeroBody": "OVF môže používať odkazy na disky, ktoré parser nerozpozná. Otvorte ho a pre každý disk nájdite položku <File ovf:href=\"...vmdk\" ...>. Ak je disk skutočne VMDK, ale má nezvyčajnú príponu ako .dat, premenujte ho na .vmdk a aktualizujte odkaz v OVF. Premenovanie nekonvertuje formát disku.", "awkTitle": "awk: syntax error at or near , — parser zlyhá pri každom OVA / OVF", "awkIntro": "Parser OVF používa syntax gawk: match() s tromi argumentmi. Tú mawk, predvolený awk v Debiane / Proxmoxe, nepodporuje. Novšie verzie skriptu nainštalujú gawk pri prvom použití cez ensure_repositories + install_single_package. Pri staršej kópii ho nainštalujte ručne:", "awkCode": "apt-get install -y gawk", "awkOutro": "Potom znovu spustite import.", "netTitle": "Sieť nefunguje po prvom spustení", "netBody": "Hosťovský systém nemusí mať ovládače pre model sieťovej karty e1000 alebo môže byť vybraný nesprávny most. Na karte Hardware VM zmeňte Network Device → Model. V hosťovskom systéme skontrolujte aj ip a: rozhranie môže mať nový názov, napríklad ens18 namiesto eth0, zatiaľ čo sieťové nastavenie stále používa starý názov." }, "files": { "heading": "Príslušné súbory", "code": "scripts/utilities/import_vm_ova_ovf.sh # this script\n/tmp/.proxmenux-import-*/ # temp extraction dir for OVA\n/etc/pve/nodes//qemu-server/.conf # created by qm create\n//-disk-. # disk images, format depends on storage" }, "related": { "heading": "Súvisiace", "items": [ { "href": "/docs/utils/export-vm", "label": "Exportovať VM do OVA / OVF", "tail": " — doplnkový nástroj na export VM." }, { "href": "/docs/utils", "label": "Prehľad pomocných nástrojov", "tail": " — Späť na prehľad sekcie." } ] } }