ProxMenux/web/messages/sk/docs/utils/import-vm.json

{
  "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": [
      "<code>/var/lib/vz/dump</code> — predvolený adresár záloh vzdump v Proxmox.",
      "<code>/var/lib/vz/template/iso</code> — 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 <code>.ova</code> a <code>.ovf</code> 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 <strong>gawk</strong> načíta deskriptor OVF a metadáta VM. Používa <code>match()</code> s tromi argumentmi, čo je rozšírenie gawk, ktoré mawk, predvolený <code>awk</code> v Debiane / Proxmoxe, nepodporuje. Ak gawk chýba, skript ho pri prvom importe nainštaluje cez <code>ensure_repositories</code> + <code>install_single_package</code>. Ď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": "<Name> (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 <strong>MiB</strong>, vrátane bajtov, KiB, MiB, GiB a podporovaných textových označení. Chýbajúce alebo neznáme jednotky sa <em>považujú za MiB</em>. Po importe porovnajte <code>qm config $VMID | grep memory</code> so zdokumentovanou RAM zdrojovej VM a podľa potreby ju opravte pomocou <code>qm set $VMID --memory &lt;MiB&gt;</code>."
  },
  "dialog": {
    "heading": "Postup dialógov importu",
    "items": [
      "<strong>VMID</strong> — predvolene ďalší voľný identifikátor (<code>pvesh get /cluster/nextid</code>).",
      "<strong>Názov VM</strong> — predvolene názov načítaný z OVF; môžete ho zmeniť.",
      "<strong>Cieľové úložisko</strong> — zoznam úložísk s obsahom <code>images</code> z <code>pvesm status -content images</code>.",
      "<strong>Sieťový most</strong> — zoznam mostov z <code>ip link show type bridge</code>. Jediný most sa vyberie automaticky; predvolený je <code>vmbr0</code>.",
      "<strong>Potvrdenie</strong> — 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í <code>lsi</code> (LSI Logic) pre kompatibilitu VMDK. NIC predvolené <code>e1000</code> (univerzálna kompatibilita) na zvolenom moste."
  },
  "diskLoop": {
    "heading": "Cyklus importu diskov",
    "intro": "Pre každý odkaz na disk v OVF:",
    "items": [
      "<code>qm importdisk $VMID $disk_path $STORAGE</code> — importuje disk vo formáte podporovanom cieľovým úložiskom a vytvorí položku <code>unusedN:</code> v konfigurácii VM.",
      "Skript pomocou grep vyhľadá v konfigurácii práve vytvorený odkaz <code>unusedN</code>.",
      "<code>qm set $VMID --scsiN $unused_disk</code> Prikladá disk ako <code>scsi0</code>, <code>scsi1</code>, …",
      "<code>qm set $VMID --delete unusedN</code> — odstráni už nepotrebnú značku unused."
    ],
    "outro": "Boot je nastavená na prvý SCSI disk: <code>qm set $VMID --boot c --bootdisk scsi0</code>."
  },
  "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ť <code>qemu-guest-agent</code> 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 <em>FirmwareType / firmware</em> v OVF alebo v nastaveniach pôvodnej VM a nastavte rovnakú voľbu v Proxmoxe: <code>qm set $VMID --bios ovmf</code> pre UEFI; predvolená hodnota BIOS je <code>seabios</code>."
  },
  "notImported": {
    "heading": "Čo sa NEIMPORTUJE",
    "items": [
      "<strong>Konkrétne sieťové mosty</strong> — zachová sa iba počet kariet. Všetky sa pripoja k mostu vybranému pri importe.",
      "<strong>Model NIC</strong> – predvolená hodnota je e1000.",
      "<strong>Typ firmvéru BIOS / UEFI</strong> — použije sa predvolený BIOS Proxmox.",
      "<strong>Konfigurácia priameho priradenia PCI</strong>.",
      "<strong>TPM</strong> (vTPM).",
      "<strong>Cloud-init</strong> disky.",
      "<strong>Snímky</strong> — iba aktuálny stav.",
      "<strong>USB / sériové / paralelné zariadenia</strong> deklarované v OVF.",
      "<strong>VM možnosti tagov / poznámok / štart-on-boot</strong>."
    ]
  },
  "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 <em>pred</em> exportom z VMware alebo ponechajte predvolený radič <code>lsi</code>. 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 <code>&lt;File ovf:href=\"...vmdk\" ...&gt;</code>. Ak je disk skutočne VMDK, ale má nezvyčajnú príponu ako <code>.dat</code>, premenujte ho na <code>.vmdk</code> 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: <code>match()</code> s tromi argumentmi. Tú mawk, predvolený <code>awk</code> v Debiane / Proxmoxe, nepodporuje. Novšie verzie skriptu nainštalujú gawk pri prvom použití cez <code>ensure_repositories</code> + <code>install_single_package</code>. 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 <code>ip a</code>: 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/<node>/qemu-server/<vmid>.conf  # created by qm create\n<storage>/<vmid>/<vmid>-disk-<n>.<fmt>        # 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."
      }
    ]
  }
}