mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
docs: review utility documentation in all seven translations
This commit is contained in:
Jonatan
@@ -0,0 +1,145 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Export VM do OVA / OVF | Dokumentácia ProxMenux",
|
||||
"description": "Exportujte VM Proxmox do prenosného archívu OVA alebo adresára OVF pomocou štandardnej schémy DMTF. Disky VMDK vo formáte streamOptimized a manifest SHA1. Import je možný vo VMware ESXi / Workstation / Fusion, VirtualBox aj späť v Proxmoxe.",
|
||||
"ogTitle": "Export VM do OVA / OVF | Dokumentácia ProxMenux",
|
||||
"ogDescription": "Preveďte VM Proxmox na prenosný balík OVA / OVF kompatibilný s VMware a VirtualBox."
|
||||
},
|
||||
"header": {
|
||||
"title": "Exportovať VM do OVA / OVF",
|
||||
"description": "Prevedie VM Proxmox na prenosný balík OVA (jeden archív TAR) alebo OVF (deskriptor a súbory VMDK) pomocou štandardnej schémy DMTF OVF. Disky sa pomocou qemu-img konvertujú na VMDK vo formáte streamOptimized. Výsledok možno importovať vo VMware (ESXi / Workstation / Fusion), VirtualBox aj späť v Proxmoxe pomocou nástroja na import.",
|
||||
"section": "Nástroje"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo to robí?",
|
||||
"body": "Načíta konfiguráciu zastavenej VM, prevedie každý disk na VMDK vo formáte streamOptimized, vytvorí deskriptor OVF a manifest SHA1 a všetko zabalí do jedného súboru <code>.ova</code> alebo adresára <code>-ovf</code>. Zdrojová VM sa nikdy nemení."
|
||||
},
|
||||
"picker": {
|
||||
"heading": "Výber VM",
|
||||
"body": "Po spustení skript zobrazí všetky VM z <code>qm list</code> s VMID, názvom a stavom. Vyberte VM na export:",
|
||||
"imgAlt": "Dialóg výberu VM na export so zoznamom všetkých VM"
|
||||
},
|
||||
"stopped": {
|
||||
"heading": "VM musí byť zastavená",
|
||||
"intro": "Konzistentný obraz disku vyžaduje zastavenú VM. Ak vybraná VM beží, ProxMenux ponúkne jej vypnutie:",
|
||||
"items": [
|
||||
"Riadne vypnutie cez <code>qm shutdown $VMID --timeout 120</code> (čaká 2 minúty na vypnutie hosťovského systému cez ACPI).",
|
||||
"Po uplynutí času ponúkne vynútené zastavenie: <code>qm stop $VMID</code> (zodpovedá odpojeniu napájania).",
|
||||
"Ak odmietnete obe možnosti, export sa zruší a žiadne údaje sa nezmenia."
|
||||
],
|
||||
"warnTitle": "Vynútené zastavenie zodpovedá odpojeniu napájania",
|
||||
"warnBody": "<code>qm stop</code> zodpovedá vytiahnutiu napájacieho kábla. Pri ďalšom štarte môže hosťovský systém potrebovať opravu súborového systému. Ak je to možné, použite riadne vypnutie a vynútené zastavenie si nechajte pre hosťovské systémy, ktoré nereagujú."
|
||||
},
|
||||
"format": {
|
||||
"heading": "Volič formátu: OVA vs OVF",
|
||||
"headerFormat": "Formát",
|
||||
"headerOutput": "Výstup",
|
||||
"headerPros": "Výhody",
|
||||
"headerCons": "Nevýhody",
|
||||
"rows": [
|
||||
{
|
||||
"format": "OVA",
|
||||
"output": "name-vmid-ts.ova",
|
||||
"pros": "Jeden samostatný súbor, ktorý sa ľahko presúva, prenáša cez sftp alebo pripája k požiadavke podpory.",
|
||||
"cons": "Vyžaduje ~220% virtuálnej veľkosti disku (dodatočný priestor pre archív TAR počas vytvárania)."
|
||||
},
|
||||
{
|
||||
"format": "OVF",
|
||||
"output": "name-vmid-ts-ovf/",
|
||||
"pros": "~120% virtuálnej veľkosti disku. Jednoduchšia kontrola, pretože deskriptor je textový XML. Pred importom ho možno upraviť.",
|
||||
"cons": "Viac súborov, ktoré sa musia preniesť spoločne."
|
||||
}
|
||||
]
|
||||
},
|
||||
"destination": {
|
||||
"heading": "Cieľový priečinok",
|
||||
"body": "Vyberte prednastavenú cestu (<code>/var/lib/vz/dump</code>, <code>/var/lib/vz/template/iso</code>) alebo zadajte vlastnú. Skript pred začiatkom overí možnosť zápisu do adresára a upozorní na nedostatok voľného miesta.",
|
||||
"calloutTitle": "Orientačný odhad voľného miesta",
|
||||
"calloutBody": "Pri exporte VM s celkovou virtuálnou veľkosťou diskov 100 GB do OVF počítajte s ~120 GB voľného miesta; pri OVA s ~220 GB. Takmer prázdne disky môžu v skutočnosti zaberať menej. Archív OVA sa vytvára pomocou nekomprimovaného TAR, kým dočasné súbory VMDK ešte existujú, preto treba miesto pre oboje. Ak sa miesto minie počas exportu, obsluha EXIT vyčistí dočasný adresár a musíte začať odznova."
|
||||
},
|
||||
"package": {
|
||||
"heading": "Čo balík obsahuje",
|
||||
"intro": "Pre OVA / OVF s názvom <code>myvm-100-2026-04-26_18-30-15</code>:",
|
||||
"code": "# OVA mode (single .ova file is a TAR of):\nmyvm-100-2026-04-26_18-30-15.ovf # XML descriptor (DMTF OVF 1.0 + RASD + VSSD)\nmyvm-100-2026-04-26_18-30-15.mf # SHA1 manifest\nmyvm-100-2026-04-26_18-30-15-disk0.vmdk\nmyvm-100-2026-04-26_18-30-15-disk1.vmdk\n...\n\n# OVF mode (a directory):\nmyvm-100-2026-04-26_18-30-15-ovf/\n├── myvm-100-2026-04-26_18-30-15.ovf\n├── myvm-100-2026-04-26_18-30-15.mf\n├── myvm-100-2026-04-26_18-30-15-disk0.vmdk\n└── myvm-100-2026-04-26_18-30-15-disk1.vmdk"
|
||||
},
|
||||
"exported": {
|
||||
"heading": "Čo sa exportuje",
|
||||
"items": [
|
||||
"<strong>Disky:</strong> všetky položky <code>scsi*</code>, <code>sata*</code>, <code>virtio*</code> a <code>ide*</code> v konfigurácii VM, prevedené na VMDK vo formáte streamOptimized.",
|
||||
"<strong>Počet vCPU</strong> (RASD ResourceType 3) a <strong>pamäť</strong> v MiB (ResourceType 4).",
|
||||
"<strong>Počet sieťových kariet</strong> (ResourceType 10: iba počet, nie most ani model).",
|
||||
"<strong>Názov VM</strong> a údaj o type operačného systému."
|
||||
],
|
||||
"notTitle": "Čo sa NEEXPORTUJE",
|
||||
"notItems": [
|
||||
"Pripojené CD-ROM / ISO (zámerne vylúčené).",
|
||||
"Jednotky cloud-init (zámerne vylúčené).",
|
||||
"Konkrétny most a model sieťovej karty (zachová sa iba počet).",
|
||||
"Voľba BIOS / UEFI, ktorú treba pri importe znova nastaviť.",
|
||||
"Konfigurácia priameho priradenia PCI.",
|
||||
"Snímky: zachytí sa iba aktuálny stav.",
|
||||
"Možnosti na úrovni VM (NUMA, hugepages, hotplug, …)."
|
||||
]
|
||||
},
|
||||
"conversion": {
|
||||
"heading": "Konverzia disku",
|
||||
"intro": "Každý disk je konvertovaný s:",
|
||||
"code": "qemu-img convert -p -O vmdk -o subformat=streamOptimized \\\n \"$source_path\" \\\n \"$work_dir/<base_name>-disk<N>.vmdk\"",
|
||||
"outro": "<code>streamOptimized</code> je formát VMware čitateľný jedným priechodom. Podporujú ho ESXi 6.7+, VMware Workstation, VirtualBox aj samotný Proxmox. Je to najširšie kompatibilný podformát VMDK a vhodná voľba na prenos. Nevýhodou je, že neumožňuje náhodný prístup, takže ho nemožno priamo pripojiť bez konverzie."
|
||||
},
|
||||
"manifest": {
|
||||
"heading": "Manifest SHA1",
|
||||
"intro": "Každý balík obsahuje súbor <code>.mf</code> s hashmi SHA1 deskriptora OVF a každého súboru VMDK:",
|
||||
"code": "SHA1(myvm-100-2026-04-26_18-30-15.ovf)= 3a7bd3e2360a3d29eea436fcfb7e44c735d117c9\nSHA1(myvm-100-2026-04-26_18-30-15-disk0.vmdk)= b7e23ec29af22b0b4e41da31e868d57226121c84\nSHA1(myvm-100-2026-04-26_18-30-15-disk1.vmdk)= a87ff679a2f3e71d9181a67b7542122c",
|
||||
"outro": "V špecifikácii OVF je manifest voliteľný a mnohé programy ho ignorujú. Pomáha však overiť, či sa balík preniesol neporušený. Overte ho ručne pomocou <code>sha1sum -c file.mf</code>."
|
||||
},
|
||||
"import": {
|
||||
"heading": "Importovanie výsledku",
|
||||
"intro": "Exportovaný balík možno importovať do:",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/import-vm",
|
||||
"preRich": "<strong>Proxmox</strong> — použite príslušný nástroj ",
|
||||
"linkLabel": "Importovať VM z OVA / OVF",
|
||||
"tailRich": "."
|
||||
},
|
||||
{
|
||||
"tailRich": "<strong>VMware ESXi</strong> — Datacenter → Deploy OVF Template; vyberte súbor .ova alebo .ovf."
|
||||
},
|
||||
{
|
||||
"tailRich": "<strong>VMware Workstation / Fusion</strong> — File → Open; vyberte súbor .ova alebo .ovf."
|
||||
},
|
||||
{
|
||||
"tailRich": "<strong>VirtualBox</strong> — File → Import Appliance; vyberte súbor .ova alebo .ovf."
|
||||
}
|
||||
]
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"noSpaceTitle": "qemu-img convert zlyhá počas konverzie s chybou \"No space left on device\"",
|
||||
"noSpaceBody": "V cieli sa minulo voľné miesto. Obsluha EXIT automaticky vyčistí dočasný adresár. Vyberte cieľ s väčším voľným miestom podľa odhadu vyššie a export spustite znova.",
|
||||
"unsupportedHwTitle": "Export sa dokončí, ale VMware odmietne import: \"Unsupported hardware family\"",
|
||||
"unsupportedHwBody": "Niektoré verzie ESXi odmietajú deskriptory OVF, ktoré deklarujú neznámu rodinu hardvéru. Otvorte .ovf v textovom editore alebo najprv rozbaľte .ova. Nájdite <code><vssd:VirtualSystemType></code> a zmeňte hodnotu na takú, ktorú ESXi prijme, napríklad <code>vmx-13</code> pre ESXi 6.5+. Ako rýchle obídenie problému skúste VirtualBox, ktorý je menej prísny.",
|
||||
"nicTitle": "Importovaná VM používa inú sieťovú kartu alebo radič SCSI",
|
||||
"nicBody": "OVF zachováva počet sieťových kariet, nie ich pôvodný model. Skontrolujte sieťové nastavenia importovanej VM v cieľovom hypervízore. Export deklaruje radič SCSI lsilogic pre kompatibilitu s VMware. Pri spätnom importe do Proxmoxu môžete vybrať <code>VirtIO SCSI</code>, ak má hosťovský systém vhodné ovládače.",
|
||||
"runningTitle": "VM bežala a odmietol som jej vypnutie: export sa zrušil",
|
||||
"runningBody": "Skript nemôže vytvoriť konzistentný obraz, keď sa na disky zapisuje. Nabudúce potvrďte vypnutie alebo najprv vypnite VM ručne (<code>qm shutdown $VMID</code>) a export spustite znova.",
|
||||
"slowTitle": "Konverzia disku je pomalá",
|
||||
"slowBody": "<code>qemu-img convert</code> používa jedno vlákno a číta zdroj plnou rýchlosťou. Pri 100 GB disku na mechanickom pevnom disku počítajte s 15–30 minútami. Prenos z NVMe na NVMe je 5–10-krát rýchlejší. Disky VM sa konvertujú postupne a čas rastie lineárne s celkovou virtuálnou veľkosťou."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/import-vm",
|
||||
"label": "Importovať VM z OVA / OVF",
|
||||
"tail": " — doplnkový nástroj na spätný import."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils",
|
||||
"label": "Prehľad pomocných nástrojov",
|
||||
"tail": " — Späť na prehľad sekcie."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,218 @@
|
||||
{
|
||||
"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 <MiB></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><File ovf:href=\"...vmdk\" ...></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."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,115 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Nástroje Proxmox — UUP Dump, aktualizácia PVE 8 na 9, export/import OVA | ProxMenux",
|
||||
"description": "Každodenné nástroje pre Proxmox VE: vytváranie obrazov ISO systému Windows cez UUP Dump, inštalácia vybraných nástrojov CLI, bezpečná aktualizácia systému Proxmox, prechod z PVE 8 na PVE 9, export VM do OVA / OVF a import VM vo formáte OVA / OVF z VMware alebo VirtualBox.",
|
||||
"ogTitle": "Nástroje Proxmox — UUP Dump, aktualizácia PVE 8 na 9, export/import OVA",
|
||||
"ogDescription": "Vytvárajte obrazy ISO systému Windows, inštalujte nástroje CLI, bezpečne aktualizujte systém, prejdite z PVE 8 na PVE 9 a exportujte alebo importujte VM vo formáte OVA / OVF.",
|
||||
"twitterTitle": "Nástroje Proxmox | ProxMenux",
|
||||
"twitterDescription": "Tvorba ISO, nástroje CLI, aktualizácia Proxmoxu, prechod PVE 8→9 a prenosnosť VM vo formáte OVA / OVF."
|
||||
},
|
||||
"header": {
|
||||
"title": "Pomocné nástroje",
|
||||
"description": "Šesť nástrojov dopĺňa každodennú prácu s Proxmox VE: tvorbu ISO, údržbu systému a prenos VM. Každá možnosť je nezávislá. Vyberte si tú, ktorú potrebujete; nič sa nenainštaluje, kým o to nepožiadate.",
|
||||
"section": "Nástroje"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Na čo je toto menu",
|
||||
"body": "Tri skupiny nezávislých, ale často potrebných nástrojov: <strong>vytvorenie ISO systému Windows</strong> cez UUP Dump, <strong>údržba hostiteľa Proxmox</strong> (nástroje CLI, aktualizácie a prechod na novú hlavnú verziu) a <strong>import a export VM</strong> v Proxmoxe pomocou štandardného formátu OVA / OVF."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie menu",
|
||||
"body": "V hlavnom menu ProxMenux vyberte <strong>Utilities</strong>. Zobrazí sa toto:",
|
||||
"imageAlt": "Menu pomocných nástrojov s UUP Dump, systémovými nástrojmi, aktualizáciou, prechodom na novú verziu, exportom a importom"
|
||||
},
|
||||
"groups": {
|
||||
"heading": "Tri skupiny nástrojov",
|
||||
"intro": "Šesť nástrojov patrí do troch nezávislých skupín. Kliknite na kartu nižšie pre skok do zodpovedajúcej časti.",
|
||||
"iso": {
|
||||
"title": "Tvorba ISO",
|
||||
"body": "Vytvorte oficiálne obrazy ISO systému Windows cez UUP Dump priamo na hostiteľovi Proxmox.",
|
||||
"bullets": [
|
||||
"Zdieľaný odkaz UUP Dump → zavádzací obraz ISO",
|
||||
"Závislosti nainštalované automaticky",
|
||||
"Výsledok sa uloží do adresára šablón ISO v Proxmoxe"
|
||||
]
|
||||
},
|
||||
"maintenance": {
|
||||
"title": "Údržba systému",
|
||||
"body": "Udržiavajte hostiteľa v dobrom stave pomocou nástrojov CLI, pravidelných aktualizácií a prechodu na novú hlavnú verziu, keď príde čas.",
|
||||
"bullets": [
|
||||
"Inštalátor systémových nástrojov (25 nástrojov CLI)",
|
||||
"Aktualizácia systému Proxmox (apt + dist-upgrade)",
|
||||
"Prechod z PVE 8 na PVE 9"
|
||||
]
|
||||
},
|
||||
"portability": {
|
||||
"title": "Prenosnosť VM",
|
||||
"body": "Importujte a exportujte VM v Proxmoxe pomocou štandardného formátu OVA / OVF.",
|
||||
"bullets": [
|
||||
"Exportovať Proxmox VM → OVA / OVF",
|
||||
"Importovať OVA / OVF → Proxmox VM",
|
||||
"Kompatibilný s VMware a VirtualBox"
|
||||
]
|
||||
}
|
||||
},
|
||||
"upgradeWarn": {
|
||||
"title": "Prechod PVE 8 → 9 je deštruktívny a nie je vratný",
|
||||
"body": "Aktualizácia hlavnej verzie prepíše základ Debianu (Bookworm → Trixie) aj súčasti Proxmox priamo na mieste. Nie je k dispozícii automatický návrat: pred začiatkom potrebujete <strong>overené zálohy</strong> každej VM a CT a <strong>prístup ku konzole / IPMI / iKVM</strong>. Preto sa aktualizačný nástroj odmietne spustiť vo webovom termináli Proxmox."
|
||||
},
|
||||
"isoSection": {
|
||||
"heading": "Tvorba ISO",
|
||||
"body": "Vytvorte nový, aktuálny inštalačný obraz ISO systému Windows priamo na hostiteľovi Proxmox. Skript automatizuje celý postup UUP Dump: inštaláciu závislostí (aria2c, cabextract, wimlib-imagex, …), paralelné sťahovanie aktualizačných súborov cez aria2 a konverziu na jeden zavádzací obraz ISO. Ten sa uloží do <code>/var/lib/vz/template/iso</code> a je pripravený na pripojenie k VM.",
|
||||
"options": [
|
||||
{
|
||||
"title": "Tvorba ISO cez UUP Dump",
|
||||
"description": "Vytvorte aktuálny inštalačný obraz ISO systému Windows zo zdieľaného odkazu UUP Dump. Závislosti, sťahovanie aj konverzia sú plne automatizované. Výsledný obraz ISO sa uloží do /var/lib/vz/template/iso a je pripravený na vytvorenie VM.",
|
||||
"href": "/docs/utils/UUp-Dump-ISO-Creator"
|
||||
}
|
||||
]
|
||||
},
|
||||
"maintenanceSection": {
|
||||
"heading": "Údržba systému",
|
||||
"body": "Tri nástroje pokrývajú každodenné aj príležitostné úlohy na hostiteľovi. <strong>Inštalátor systémových nástrojov</strong> nastaví nástroje CLI, ktoré využijete po novej inštalácii. <strong>Aktualizácia systému Proxmox</strong> slúži na týždennú alebo mesačnú údržbu. <strong>Prechod z PVE 8 na PVE 9</strong> je veľká zmena pri každej novej hlavnej verzii a zahŕňa dodatočné bezpečnostné kontroly, pretože nie je vratná.",
|
||||
"options": [
|
||||
{
|
||||
"title": "Inštalátor systémových nástrojov",
|
||||
"description": "Výber 25 osvedčených nástrojov CLI (htop, btop, iperf3, jq, tmux, ncdu, ...) s vlastným výberom alebo preddefinovanými skupinami (základné, vývoj, kompresia, multiplexery, analýza, sieť). Používa štandardný postup s repozitárom a overovacím príkazom.",
|
||||
"href": "/docs/utils/system-utils"
|
||||
},
|
||||
{
|
||||
"title": "Aktualizácia systému Proxmox",
|
||||
"description": "Kontrola repozitárov + apt update + apt dist-upgrade s potvrdením pred reštartom. Rozpozná hlavnú verziu PVE (8 alebo 9), zachová nakonfigurované repozitáre a pred prepnutím hostiteľa bez predplatného na repozitár no-subscription požiada o potvrdenie. Potom spustí autoremove.",
|
||||
"href": "/docs/utils/system-update"
|
||||
},
|
||||
{
|
||||
"title": "Prechod z PVE 8 na PVE 9",
|
||||
"description": "Prechod na novú hlavnú verziu (Debian Bookworm → Trixie + PVE 8 → 9). Kontroly pred začiatkom, migrácia repozitárov, automatizovaný alebo interaktívny režim, následné overenie a reštart. Odmietne spustenie z webového terminálu.",
|
||||
"href": "/docs/utils/upgrade-pve8-pve9"
|
||||
}
|
||||
]
|
||||
},
|
||||
"portabilitySection": {
|
||||
"heading": "Prenosnosť VM (OVA / OVF)",
|
||||
"body": "OVA a OVF sú formáty balíkov na prenos medzi hypervízormi podľa štandardu DMTF. Podporujú ich VMware, VirtualBox a Proxmox. Oba nástroje umožňujú export aj spätný import: VM exportovanú z Proxmoxu možno znova importovať a naopak. Použite ich na migráciu pracovných záťaží z ESXi, vytvorenie prenosnej zálohy VM alebo zdieľanie pripravenej VM s používateľom VirtualBox.",
|
||||
"options": [
|
||||
{
|
||||
"title": "Exportovať VM do OVA / OVF",
|
||||
"description": "Preveďte VM Proxmox na prenosný archív OVA alebo adresár OVF. Štandardná schéma DMTF, manifest SHA1 a disky VMDK vo formáte streamOptimized. Import je možný vo VMware (ESXi / Workstation / Fusion), VirtualBox aj späť v Proxmoxe.",
|
||||
"href": "/docs/utils/export-vm"
|
||||
},
|
||||
{
|
||||
"title": "Importovať VM z OVA / OVF",
|
||||
"description": "Preneste export VMware / VirtualBox / ProxMenux späť do Proxmoxu. Automaticky extrahuje OVA, analyzuje metadáta OVF, vytvorí VM a importuje každý disk ako natívny formát úložiska.",
|
||||
"href": "/docs/utils/import-vm"
|
||||
}
|
||||
]
|
||||
},
|
||||
"diskSpaceCallout": {
|
||||
"title": "Poznámka k priestoru na disku pri exporte / importe",
|
||||
"body": "Oba nástroje konvertujú formáty diskov: export používa <code>qemu-img convert -O vmdk -o subformat=streamOptimized</code>; import používa <code>qm importdisk</code> na spätnú konverziu do natívneho formátu úložiska (qcow2 / raw). Pri exporte počítajte s <strong>~120% virtuálnej veľkosti disku</strong> pre OVF a <strong>~220%</strong> pre OVA. Archív OVA používa nekomprimovaný TAR a vytvára sa, kým dočasné súbory VMDK ešte existujú. Pred začiatkom overte, či je v cieľovom adresári dostatok voľného miesta."
|
||||
},
|
||||
"fitsTogether": {
|
||||
"heading": "Ako je menu usporiadané",
|
||||
"body": "Každý nástroj má vlastný skript v <code>scripts/utilities/</code>. Aktualizácia systému Proxmox volá jediný bezpečný skript v <code>scripts/global/</code>, update-pve-safe.sh, ktorý rozpozná hlavnú verziu a obsluhuje PVE 8 aj PVE 9. Prechod PVE 8 → 9 ponúka vo vlastnom menu dve ďalšie akcie: samostatnú <em>Kontrolu pred aktualizáciou</em> (spustí <code>pve8to9 --full</code>) a <em>Príručku na manuálnu aktualizáciu</em> iba na čítanie (postup so 17 krokmi), pre používateľov, ktorí chcú proces skontrolovať alebo vykonať ručne."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,168 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Aktualizácia systému Proxmox | Dokumentácia ProxMenux",
|
||||
"description": "Aktualizuje balíky v rámci aktuálnej hlavnej verzie Proxmox pomocou apt-get update a apt full-upgrade -y. Kontroluje miesto na disku a repozitáre, skúša obnoviť kľúče GPG, kontroluje a opravuje staré hlavičky PV v LVM, podľa potreby znovu zostaví spravované ovládače DKMS, spustí autoremove/autoclean a ponúkne potrebný reštart.",
|
||||
"ogTitle": "Aktualizácia systému Proxmox | Dokumentácia ProxMenux",
|
||||
"ogDescription": "apt full-upgrade s kontrolou repozitárov, autoremove/autoclean a výzvou na reštart podľa potreby."
|
||||
},
|
||||
"header": {
|
||||
"title": "Aktualizácia systému Proxmox",
|
||||
"description": "Volá jediný pracovný skript (<code>update-pve-safe.sh</code>), ktorý rozpozná hlavnú verziu Proxmox. Nakonfigurované repozitáre načíta cez API Proxmox a zachová ich. Hostiteľ bez predplatného, ktorý používa iba Enterprise, musí potvrdiť prechod na no-subscription. Skript aktualizuje balíky a znovu zostaví ovládače DKMS spravované ProxMenux pre jadro pripravené na ďalší štart. Hlavný skript ponúkne reštart, ak existuje systémová značka alebo sa najnovšie nainštalované jadro líši od spusteného. Pri čakajúcich aktualizáciách možno postup spustiť aj cez <em>Update Now</em> v hlavičke ProxMenux Monitor.",
|
||||
"section": "Nástroje"
|
||||
},
|
||||
"calloutWhat": {
|
||||
"title": "Čo to robí?",
|
||||
"body": "Aktualizuje hostiteľa na najnovšiu úroveň opráv jeho aktuálnej hlavnej verzie. <strong>Neprechádza</strong> na inú hlavnú verziu; pre PVE 8 → PVE 9 pozrite <link>Prechod z PVE 8 na PVE 9</link>."
|
||||
},
|
||||
"official": {
|
||||
"heading": "Oficiálne odporúčanie pre Proxmox",
|
||||
"intro": "Proxmox pri aktualizácii bežiaceho hostiteľa v rámci rovnakej hlavnej verzie odporúča spustiť:",
|
||||
"code": "apt update && apt full-upgrade -y",
|
||||
"outro": "Tento riadok je oficiálnym príkazom pre aktuálne vydania Proxmox. Treba tiež overiť správnosť repozitárov, zapnutie vhodných zdrojov a dobrý stav hostiteľa po aktualizácii."
|
||||
},
|
||||
"onTop": {
|
||||
"heading": "Čo ProxMenux pridáva: overené v skripte",
|
||||
"intro": "Používa <strong>rovnakú operáciu apt full-upgrade</strong> s kontrolou repozitárov, opätovným zostavením DKMS a následným čistením. Nasledujúce kroky zodpovedajú <code>scripts/utilities/proxmox_update.sh</code> a jeho jedinému pracovnému skriptu <code>scripts/global/update-pve-safe.sh</code>:",
|
||||
"items": [
|
||||
"<strong>Rozpozná hlavnú verziu PVE</strong> v pracovnom skripte (<code>pveversion | grep -oP ''pve-manager/\\K[0-9]+''</code>). Jeden skript obsluhuje PVE 8 aj PVE 9. Repozitáre sa zachovajú, ak hostiteľ bez predplatného nepotvrdí ponúknutú zmenu.",
|
||||
"<strong>Zachová nakonfigurované repozitáre.</strong> <code>ensure_repositories</code> cez API Proxmox načíta repozitáre a stav predplatného. Pri aktívnom predplatnom alebo už používanom repozitári no-subscription či test nič nemení. Hostiteľ bez aktívneho predplatného s jediným repozitárom Enterprise musí potvrdiť prechod na no-subscription. Pri odmietnutí sa aktualizácia skončí bez zmeny zdrojov.",
|
||||
"<strong>Spustí aktualizáciu neinteraktívne</strong> s <code>DEBIAN_FRONTEND=noninteractive</code> a <code>--force-confdef --force-confold</code>. Pri rozhodovaní o konfiguračných súboroch dpkg prijme predvolenú akciu, ak existuje; inak zachová aktuálny súbor.",
|
||||
"<strong>Nevynucuje voliteľné nástroje.</strong> Bezpečný skript nevnucuje hostiteľovi <code>zfsutils-linux</code>, <code>chrony</code>, <code>ifupdown2</code> ani podobné balíky. Ak sa inštalácia Proxmox rozhodla niektorý z nich nepoužiť, táto voľba sa zachová. Chýbajúce balíky oznamujú nadradené inštalačné postupy, nie aktualizačný postup.",
|
||||
"<strong>Kontrola a oprava metadát LVM.</strong> Rozpozná staré hlavičky PV a pre dotknuté skupiny zväzkov spustí vgck --updatemetadata a vgchange -ay. Môže zmeniť metadáta LVM; nejde iba o kontrolu s upozorneniami.",
|
||||
"<strong>Potom vyčistí:</strong> <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>.",
|
||||
"<strong>Opätovné zostavenie DKMS pred výzvou na reštart.</strong> Pracovný skript volá <code>pmx_rebuild_dkms_after_kernel</code>, keď je pripravené novšie nainštalované jadro. Hlavný skript kontroluje <code>/var/run/reboot-required</code> a pomocou <code>dpkg-query</code> porovná jadro uvedené v <code>uname -r</code> s najnovšie nainštalovaným balíkom <code>proxmox-kernel-*-pve-signed</code> / <code>pve-kernel-*-pve</code>. Na hostiteľoch bez <code>needrestart</code> môže značka chýbať; porovnanie jadier funguje aj vtedy."
|
||||
]
|
||||
},
|
||||
"calloutOneSentence": {
|
||||
"title": "V jednej vete",
|
||||
"body": "Aktualizuje balíky hostiteľa, zachová repozitáre bez potvrdenej zmeny, skontroluje metadáta LVM, znovu zostaví spravované ovládače DKMS, vyčistí systém cez autoremove/autoclean a podľa potreby ponúkne reštart."
|
||||
},
|
||||
"confirm": {
|
||||
"heading": "Potvrdzovací dialóg",
|
||||
"intro": "Výber možnosti otvorí súhrn plánovaných krokov a vyžaduje výslovné potvrdenie:",
|
||||
"imageAlt": "Potvrdzovací dialóg aktualizácie Proxmox s kontrolou repozitárov, aktualizáciou balíkov a čistením"
|
||||
},
|
||||
"routes": {
|
||||
"heading": "Ako hlavný skript odovzdáva prácu",
|
||||
"nodes": {
|
||||
"source": {
|
||||
"label": "proxmox_update.sh",
|
||||
"detail": "pveversion |\ngrep -oP ''pve-manager/\\K[0-9]+''"
|
||||
},
|
||||
"bridge": {
|
||||
"label": "Jediný pracovný skript",
|
||||
"detail": "update-pve-safe.sh\n(rozpozná PVE 8 / 9\ninterne)"
|
||||
},
|
||||
"target": {
|
||||
"label": "Po aktualizácii",
|
||||
"detail": "apt-get autoremove\napt-get autoclean\nVýzva na reštart podľa potreby"
|
||||
}
|
||||
}
|
||||
},
|
||||
"worker": {
|
||||
"heading": "Čo robí pracovný skript",
|
||||
"intro": "Jeden pracovný skript (<code>scripts/global/update-pve-safe.sh</code>) obsluhuje PVE 8 (<code>bookworm</code>) aj PVE 9 (<code>trixie</code>). Interne rozpozná hlavnú verziu a kontroluje existujúce repozitáre bez prepísania základných zdrojov Debianu. Kroky sú:",
|
||||
"items": [
|
||||
"<strong>Kontroly pred začiatkom.</strong> Overí aspoň ~1 GB voľného miesta v <code>/var/cache/apt/archives</code>. Pri nedostatku miesta sa včas zastaví s jasnou správou, aby nezlyhal uprostred operácie apt.",
|
||||
"<strong>Kontrola repozitárov.</strong> <code>ensure_repositories</code> načíta repozitáre a stav predplatného. Pri použiteľnom repozitári Proxmox nič nemení. Hostiteľ bez aktívneho predplatného s jediným repozitárom Enterprise musí potvrdiť prechod na no-subscription; pri odmietnutí sa aktualizácia skončí.",
|
||||
"<strong>apt update s automatickou obnovou GPG.</strong> Pri <code>NO_PUBKEY</code> pre ľubovoľný repozitár vrátane zdroja tretej strany skript importuje chýbajúci kľúč a automaticky zopakuje pokus pred ohlásením chyby.",
|
||||
"<strong>Čakajúce a bezpečnostné aktualizácie.</strong> Uvedie počet menených balíkov a počet balíkov z bezpečnostnej vetvy, aby potvrdzovací dialóg zobrazoval konkrétne čísla.",
|
||||
"<strong>Potvrdzovací dialóg.</strong> Po obnovení zoznamov balíkov pracovný skript vyžaduje výslovné áno pred aktualizáciou balíkov.",
|
||||
"<strong>apt full-upgrade.</strong> Používa <code>DEBIAN_FRONTEND=noninteractive</code> a <code>--force-confdef --force-confold</code>. Dpkg pri rozhodovaní o konfiguračných súboroch použije predvolenú akciu, ak existuje; inak zachová aktuálny súbor.",
|
||||
"<strong>Kontrola LVM.</strong> <code>lvm_repair_check</code> obnoví metadáta skupín zväzkov, keď sa disky priamo priradené hosťovským VM (DSM, TrueNAS alebo úložné zariadenia) vrátia so starými hlavičkami PV.",
|
||||
"<strong>Opätovné zostavenie ovládačov DKMS spravovaných ProxMenux.</strong> Keď je pripravené nové jadro, <code>pmx_rebuild_dkms_after_kernel</code> načíta ovládače nainštalované ProxMenux zo súboru <code>components_status.json</code> (aktuálne <code>nvidia_driver</code> → modul <code>nvidia</code> a <code>coral_driver</code> → modul <code>gasket</code>), nainštaluje príslušné hlavičky jadra (<code>proxmox-headers-<newkver></code>, ak sú dostupné, inak <code>pve-headers-<newkver></code>) a spustí <code>dkms autoinstall -k <newkver></code>. Ak <code>dkms status</code> nezobrazuje moduly zostavené pre nové jadro, znovu spustí jednotlivé inštalátory s <code>--auto-reinstall</code>. Chyby sa zaznamenajú, ale aktualizáciu nezrušia; postup sa dostane k výzve na reštart.",
|
||||
"<strong>Záverečné čistenie.</strong> <code>apt-get autoremove</code> + <code>apt-get autoclean</code> pred odovzdaním riadenia hlavnému skriptu."
|
||||
]
|
||||
},
|
||||
"post": {
|
||||
"heading": "Čistenie a reštart po aktualizácii",
|
||||
"intro": "Po dokončení pracovného skriptu hlavný skript spustí:",
|
||||
"code": "apt-get autoremove -y # drop unused dependencies pulled in by old packages\napt-get autoclean # drop downloaded .deb files no longer in the index",
|
||||
"afterCode": "Hlavný skript tiež kontroluje potrebu reštartu. Ktorýkoľvek z týchto signálov vyvolá výzvu:",
|
||||
"items": [
|
||||
"Existuje <code>/var/run/reboot-required</code>: balík alebo systémový nástroj označil potrebu reštartovať hostiteľa.",
|
||||
"Najnovšie nainštalovaný balík jadra Proxmox sa líši od spusteného jadra podľa <code>dpkg-query</code> a uname -r."
|
||||
],
|
||||
"outro": "Ak platí niektorá podmienka, dialóg whiptail sa opýta <em>„Niektoré zmeny vyžadujú reštart. Chcete reštartovať teraz?“</em>. Odmietnutím môžete pokračovať s aktuálnym jadrom až do ručného reštartu, napríklad v plánovanom okne údržby."
|
||||
},
|
||||
"end": {
|
||||
"heading": "Čo vidíte na konci",
|
||||
"intro": "Po dokončení pracovného skriptu terminál zobrazí výsledok čistenia a podľa potreby aj výzvu na reštart:",
|
||||
"imageAlt": "Záverečný súhrn aktualizácie Proxmox s výsledkom čistenia a výzvou na reštart"
|
||||
},
|
||||
"calloutDeclineReboot": {
|
||||
"title": "Reštart odložte iba z konkrétneho dôvodu",
|
||||
"body": "Inštalácia nového balíka <code>proxmox-kernel-*</code> nahradí spustené jadro až po reštarte. Nové jadro a zodpovedajúce moduly sa aktivujú pri ďalšom štarte. Naplánujte vhodné okno údržby a predtým skontrolujte upozornenia na chyby zostavenia DKMS."
|
||||
},
|
||||
"noSub": {
|
||||
"heading": "Ako pracovný skript zaobchádza s repozitárom Enterprise",
|
||||
"intro": "Proxmox predvolene zapína repozitár Enterprise. Bez aktívneho predplatného vráti pri <code>apt-get update</code> chybu 401. Pracovný skript mení repozitáre iba v tomto prípade a po potvrdení, cez API Proxmox používané v <em>Node → Updates → Repositories</em>. Jednotlivé prípady:",
|
||||
"items": [
|
||||
"Pri <strong>aktívnom predplatnom</strong> sa repozitáre nemenia a aktualizácie poskytuje Enterprise.",
|
||||
"Ak je <strong>repozitár no-subscription alebo test už zapnutý</strong>, repozitáre sa nemenia bez ohľadu na ďalšie nakonfigurované zdroje.",
|
||||
"Pri <strong>chýbajúcom aktívnom predplatnom a jedinom repozitári Enterprise</strong> dialóg ponúkne zmenu. Potvrdenie vypne zdroj Enterprise, zapne no-subscription a obnoví zoznamy balíkov. Zmena sa zaznamená v zobrazení <em>Changes</em> v Audit & Report. Odmietnutie ukončí aktualizáciu bez zmeny zdrojov.",
|
||||
"Prítomné <strong>zdroje Ceph Enterprise</strong> sa vypnú pri rovnakej zmene bez výberu iného kanála Ceph. Hostiteľ používajúci Ceph si jeho kanál nastavuje samostatne.",
|
||||
"Ak <strong>nie je dostupný terminál na potvrdenie</strong>, žiadny zdroj sa nezmení a aktualizácia sa skončí správou s odkazom na <em>Node → Updates → Repositories</em>."
|
||||
],
|
||||
"outro": "Zdroje Debianu ani ostatné súbory repozitárov tento postup nikdy neupravuje. Položku kombinujúcu Enterprise s inými komponentmi neprepne: aktualizácia sa zastaví a požiada o rozdelenie položky v zobrazení repozitárov Proxmox."
|
||||
},
|
||||
"cluster": {
|
||||
"heading": "Čo zohľadniť v klastri",
|
||||
"calloutTitle": "V klastri aktualizujte vždy iba jeden uzol",
|
||||
"calloutBody": "V klastri Proxmox spúšťajte túto možnosť vždy na <strong>jednom uzle</strong> a pred prechodom na ďalší počkajte na dokončenie reštartu. Najprv migrujte hosťovské systémy z uzla, aby nevznikol výpadok služieb celého klastra. Rôzne vedľajšie verzie, napríklad 8.4.1 a 8.4.5, môžu dočasne fungovať spolu niekoľko hodín; rôzne spustené jadrá môžu spôsobiť neočakávané správanie hosťovských systémov spravovaných HA."
|
||||
},
|
||||
"doesnt": {
|
||||
"heading": "Čo to nerobí",
|
||||
"items": [
|
||||
"<strong>Prechod na novú hlavnú verziu.</strong> 8 → 9 je samostatná operácia; pozrite <link>Prechod z PVE 8 na PVE 9</link>.",
|
||||
"<strong>Zálohovanie.</strong> Žiadne snímky ani návrat späť. Operácie apt nie sú transakčné. Zachovajte bežný postup zálohovania (PBS, vzdump, snímky ZFS).",
|
||||
"<strong>Aktualizácie kontajnerov / VM.</strong> Aktualizuje sa iba hostiteľ; hosťovské systémy sa nemenia.",
|
||||
"<strong>Samostatné nahrávanie firmvéru.</strong> Toto nie je nástroj na nahrávanie BIOS alebo firmvéru zariadení. Už nainštalované balíky firmvéru alebo mikrokódu CPU môžu byť aktualizované cez apt."
|
||||
]
|
||||
},
|
||||
"troubleshooting": {
|
||||
"heading": "Riešenie problémov",
|
||||
"items": [
|
||||
{
|
||||
"title": "apt update zlyhá s chybou 401 Unauthorized",
|
||||
"body": "Repozitár Enterprise je zapnutý, ale hostiteľ nemá aktívne predplatné. Pred <code>apt-get update</code> skript ponúkne prechod na no-subscription. Ak ste ho odmietli, spustite aktualizáciu znova a potvrďte ho, alebo vypnite Enterprise v <em>Node → Updates → Repositories</em> a zapnite no-subscription."
|
||||
},
|
||||
{
|
||||
"title": "dist-upgrade sa zastaví pri \"Configuring grub-pc\"",
|
||||
"body": "Ak sa zobrazuje interaktívna otázka GRUB, žiada zariadenia na inštaláciu zavádzača. Voľba <code>--force-confold</code> platí pre konfiguračné súbory, nie pre tento výber zariadení. Pomocou <kbd>Tab</kbd> + <kbd>Space</kbd> vyberte príslušné zavádzacie disky a potom OK. Výber možno nastaviť vopred pomocou <code>dpkg-reconfigure grub-pc</code>."
|
||||
},
|
||||
{
|
||||
"title": "Jadro sa aktualizovalo, ale chýbajú nové moduly externého ovládača",
|
||||
"body": "Pre spravované ovládače (<code>nvidia_driver</code> a <code>coral_driver</code>) funkcia spustí <code>dkms autoinstall -k <newkver></code> a môže zopakovať ich inštalátory s <code>--auto-reinstall</code>. Výsledok skontrolujte cez <code>dkms status</code>. Príkaz autoinstall môže znovu zostaviť aj iné registrované moduly DKMS; náhradné spustenie inštalátorov je obmedzené na spravované položky v <code>components_status.json</code>. Skontrolujte chýbajúce moduly tretích strán a podľa potreby ich zostavte pomocou <code>dkms autoinstall</code>."
|
||||
},
|
||||
{
|
||||
"title": "Výzva na reštart sa nezobrazila, hoci sa nainštalovalo nové jadro",
|
||||
"body": "Signály sú alternatívy: <code>/var/run/reboot-required</code> alebo rozdiel medzi spusteným a najnovšie nainštalovaným jadrom Proxmox. Hlavný skript neanalyzuje položky linux-image v zázname apt. Spustenú verziu overte cez <code>uname -r</code> a nainštalované balíky jadra cez <code>dpkg-query</code>. Potrebný reštart naplánujte alebo vo vhodnom čase spustite <code>shutdown -r now</code>."
|
||||
}
|
||||
]
|
||||
},
|
||||
"files": {
|
||||
"heading": "Príslušné súbory",
|
||||
"code": "scripts/utilities/proxmox_update.sh # this script (wrapper)\nscripts/global/update-pve-safe.sh # single safe worker (PVE 8 + PVE 9)\nscripts/global/repository-functions.sh # ensure_repositories\nscripts/global/repository_policy.py # reads and switches repositories through the Proxmox API\nscripts/global/utils-install-functions.sh # pmx_rebuild_dkms_after_kernel\n/usr/local/share/proxmenux/components_status.json # ProxMenux-managed DKMS driver registry\n/etc/apt/sources.list.d/proxmox.sources # no-subscription source, written by Proxmox when the switch is accepted\n/var/run/reboot-required # read to decide on reboot prompt\n# Reboot fallback when needrestart isn't installed:\n# dpkg-query -W 'proxmox-kernel-*-pve-signed' 'pve-kernel-*-pve' vs. uname -r"
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/upgrade-pve8-pve9",
|
||||
"label": "Prechod z PVE 8 na PVE 9",
|
||||
"tail": " — pre prechod na novú hlavnú verziu s iným nástrojom a bezpečnostným postupom."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils/system-utils",
|
||||
"label": "Inštalátor systémových nástrojov",
|
||||
"tail": " — na inštaláciu užitočných nástrojov CLI pre aktualizácie (htop / btop / ncdu)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils",
|
||||
"label": "Prehľad pomocných nástrojov",
|
||||
"tail": " — Späť na prehľad sekcie."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,252 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Inštalátor systémových nástrojov | Dokumentácia ProxMenux",
|
||||
"description": "Inštalátor nástrojov CLI pre Proxmox VE s 25 balíkmi v hlavnom zozname (htop, btop, iperf3, tmux, ...). Vlastný výber, inštalácia všetkého a preddefinované skupiny (základné, vývoj, kompresia, multiplexery, analýza, sieť). Skupiny môžu obsahovať ďalšie balíky. Používa ensure_repositories + install_single_package.",
|
||||
"ogTitle": "Inštalátor systémových nástrojov | Dokumentácia ProxMenux",
|
||||
"ogDescription": "Nainštalujte vybrané nástroje CLI v Proxmox VE jedným kliknutím alebo vlastným výberom."
|
||||
},
|
||||
"header": {
|
||||
"title": "Inštalátor systémových nástrojov",
|
||||
"description": "Výber 25 nástrojov CLI z hlavného zoznamu PROXMENUX_UTILS. Ponúka vlastný výber, inštaláciu všetkého, šesť preddefinovaných skupín a overenie inštalácií. Skupiny môžu obsahovať nástroje mimo hlavného zoznamu. Používa spoločné funkcie ensure_repositories() + install_single_package() na jednotnú správu repozitárov a správy o jednotlivých balíkoch.",
|
||||
"section": "Nástroje"
|
||||
},
|
||||
"info": {
|
||||
"title": "Čo to robí?",
|
||||
"body": "Inštaluje nástroje CLI zo zoznamu 25 balíkov. Každá inštalácia používa rovnaký postup: <code>ensure_repositories</code> overí použiteľný repozitár Proxmox pre spustenú hlavnú verziu PVE; potom <code>install_single_package</code> nainštaluje balík a overí dostupnosť príkazu v PATH."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie inštalátora",
|
||||
"intro": "Z menu Utilities vyberte <strong>System Utilities Installer</strong>. Hlavné menu ponúka deväť možností:",
|
||||
"imageAlt": "Menu inštalátora systémových nástrojov s vlastným výberom, ALL, preddefinovanými skupinami a overením"
|
||||
},
|
||||
"actions": {
|
||||
"heading": "9 akcií menu",
|
||||
"headerOption": "Možnosť",
|
||||
"headerBehaviour": "Správanie",
|
||||
"rows": [
|
||||
{
|
||||
"option": "1. Vlastný výber",
|
||||
"behaviourRich": "Výberový zoznam všetkých 25 balíkov. SPACE prepína označenie a ENTER potvrdzuje; nainštalujú sa iba vybrané balíky."
|
||||
},
|
||||
{
|
||||
"option": "2. Nainštalovať všetky nástroje",
|
||||
"behaviourRich": "Nainštaluje všetky balíky z <code>PROXMENUX_UTILS</code> naraz. Použite po novej inštalácii Proxmox."
|
||||
},
|
||||
{
|
||||
"option": "3. Základné",
|
||||
"behaviourRich": "<code>grc</code>, <code>htop</code>, <code>tree</code>, <code>curl</code>, <code>wget</code>"
|
||||
},
|
||||
{
|
||||
"option": "4. Vývoj",
|
||||
"behaviourRich": "<code>git</code>, <code>vim</code>, <code>nano</code>"
|
||||
},
|
||||
{
|
||||
"option": "5. Kompresia",
|
||||
"behaviourRich": "<code>zip</code>, <code>unzip</code>, <code>rsync</code>"
|
||||
},
|
||||
{
|
||||
"option": "6. Terminálne multiplexéry",
|
||||
"behaviourRich": "<code>screen</code>, <code>tmux</code>"
|
||||
},
|
||||
{
|
||||
"option": "7. Analýza",
|
||||
"behaviourRich": "<code>jq</code>, <code>ncdu</code>, <code>iotop</code>"
|
||||
},
|
||||
{
|
||||
"option": "8. Sieť",
|
||||
"behaviourRich": "<code>iperf3</code>, <code>nethogs</code>, <code>nmap</code>, <code>tcpdump</code>, <code>lsof</code>"
|
||||
},
|
||||
{
|
||||
"option": "9. Overiť inštalácie",
|
||||
"behaviourRich": "Prejde každú položku v <code>PROXMENUX_UTILS</code>, overí dostupnosť príkazu v PATH a vypíše súhrn Dostupné / Chýbajúce."
|
||||
}
|
||||
]
|
||||
},
|
||||
"packages": {
|
||||
"heading": "25 balíkov",
|
||||
"intro": "Definované v spoločnom súbore <code>scripts/global/utils-install-functions.sh</code> ako <code>PROXMENUX_UTILS</code> (formát: <code>package:verify_command:description</code>). Ďalšie skripty ProxMenux, napríklad spúšťanie sieťových nástrojov iftop / iptraf-ng / iperf3, tieto položky používajú tiež, aby balík a overovací príkaz zostali zosúladené.",
|
||||
"headerPackage": "Balík",
|
||||
"headerVerify": "Overovací príkaz",
|
||||
"headerDescription": "Popis",
|
||||
"rows": [
|
||||
{
|
||||
"package": "axel",
|
||||
"verify": "axel",
|
||||
"description": "Urýchľovač sťahovania"
|
||||
},
|
||||
{
|
||||
"package": "aria2",
|
||||
"verify": "aria2c",
|
||||
"description": "Sťahovanie z viacerých zdrojov"
|
||||
},
|
||||
{
|
||||
"package": "btop",
|
||||
"verify": "btop",
|
||||
"description": "Moderný monitor zdrojov"
|
||||
},
|
||||
{
|
||||
"package": "cabextract",
|
||||
"verify": "cabextract",
|
||||
"description": "Extrahovať CAB súbory"
|
||||
},
|
||||
{
|
||||
"package": "chntpw",
|
||||
"verify": "chntpw",
|
||||
"description": "Upraviť register Windows / heslá"
|
||||
},
|
||||
{
|
||||
"package": "dos2unix",
|
||||
"verify": "dos2unix",
|
||||
"description": "Previesť DOS / Unix textové súbory"
|
||||
},
|
||||
{
|
||||
"package": "genisoimage",
|
||||
"verify": "genisoimage",
|
||||
"description": "Vytváranie obrazov ISO"
|
||||
},
|
||||
{
|
||||
"package": "grc",
|
||||
"verify": "grc",
|
||||
"description": "Všeobecné farebné zvýrazňovanie záznamov"
|
||||
},
|
||||
{
|
||||
"package": "htop",
|
||||
"verify": "htop",
|
||||
"description": "Interaktívny prehliadač procesov"
|
||||
},
|
||||
{
|
||||
"package": "iftop",
|
||||
"verify": "iftop",
|
||||
"description": "Používanie siete v reálnom čase"
|
||||
},
|
||||
{
|
||||
"package": "intel-gpu-tools",
|
||||
"verify": "intel_gpu_top",
|
||||
"description": "Nástroje Intel GPU"
|
||||
},
|
||||
{
|
||||
"package": "iotop",
|
||||
"verify": "iotop",
|
||||
"description": "Monitorovanie diskových vstupov a výstupov"
|
||||
},
|
||||
{
|
||||
"package": "iperf3",
|
||||
"verify": "iperf3",
|
||||
"description": "Testovanie šírky pásma siete"
|
||||
},
|
||||
{
|
||||
"package": "ipset",
|
||||
"verify": "ipset",
|
||||
"description": "Správa množín IP adries"
|
||||
},
|
||||
{
|
||||
"package": "iptraf-ng",
|
||||
"verify": "iptraf-ng",
|
||||
"description": "Nástroj monitorovania siete"
|
||||
},
|
||||
{
|
||||
"package": "libguestfs-tools",
|
||||
"verify": "virt-filesystems",
|
||||
"description": "Nástroje pre disky VM"
|
||||
},
|
||||
{
|
||||
"package": "msr-tools",
|
||||
"verify": "rdmsr",
|
||||
"description": "Prístup k registrom MSR procesora"
|
||||
},
|
||||
{
|
||||
"package": "net-tools",
|
||||
"verify": "netstat",
|
||||
"description": "Staršie sieťové nástroje"
|
||||
},
|
||||
{
|
||||
"package": "plocate",
|
||||
"verify": "locate",
|
||||
"description": "Rýchlo nájsť súbory"
|
||||
},
|
||||
{
|
||||
"package": "s-tui",
|
||||
"verify": "s-tui",
|
||||
"description": "Stress-Terminal UI"
|
||||
},
|
||||
{
|
||||
"package": "sshpass",
|
||||
"verify": "sshpass",
|
||||
"description": "Neinteraktívne prihlásenie SSH"
|
||||
},
|
||||
{
|
||||
"package": "tmux",
|
||||
"verify": "tmux",
|
||||
"description": "Terminálny multiplexer"
|
||||
},
|
||||
{
|
||||
"package": "unzip",
|
||||
"verify": "unzip",
|
||||
"description": "Extrakcia ZIP súborov"
|
||||
},
|
||||
{
|
||||
"package": "wimtools",
|
||||
"verify": "wimlib-imagex",
|
||||
"description": "Správa obrazov WIM"
|
||||
},
|
||||
{
|
||||
"package": "zip",
|
||||
"verify": "zip",
|
||||
"description": "Vytvoriť ZIP súbory"
|
||||
}
|
||||
]
|
||||
},
|
||||
"howItWorks": {
|
||||
"heading": "Ako funguje inštalácia jedného balíka",
|
||||
"items": [
|
||||
"<code>ensure_repositories</code> rozpozná PVE 8 alebo 9 a načíta repozitáre cez API Proxmox. Pri použiteľnom repozitári Proxmox nič nemení. Hostiteľ bez aktívneho predplatného s jediným repozitárom Enterprise musí potvrdiť prechod na no-subscription. Po potvrdenej zmene sa spustí <code>apt-get update</code>.",
|
||||
"<code>install_single_package \"pkg\" \"verify_cmd\" \"description\"</code> spustí <code>apt-get install -y \"$pkg\"</code> so správami (<code>msg_info</code> / <code>msg_ok</code> / <code>msg_error</code>)."
|
||||
],
|
||||
"verifyIntro": "Po inštalácii sa overovací príkaz skontroluje pomocou <code>command -v \"$verify_cmd\"</code>. Možné sú tri výsledky:",
|
||||
"verifyOutcomes": [
|
||||
"<strong>0 (úspech):</strong> príkaz je dostupný a balík sa počíta ako <em>Úspešný</em>.",
|
||||
"<strong>1 (zlyhanie):</strong> apt zlyhal a balík sa počíta ako <em>Neúspešný</em>.",
|
||||
"<strong>2 (upozornenie):</strong> apt uspel, ale očakávaný príkaz sa nenašiel v PATH; balík sa počíta ako <em>S upozorneniami</em>."
|
||||
],
|
||||
"summary": "Na konci skupinovej/vlastnej inštalácie sa v súhrnnom dialógovom okne zobrazí počet <em>Úspešné / S upozorneniami / Neúspešné</em>."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Overiť inštalácie",
|
||||
"intro": "Možnosť 9 je iba na čítanie: prejde <code>PROXMENUX_UTILS</code> a spustí <code>command -v</code> pre každý príkaz. Výstup vyzerá takto:",
|
||||
"code": "Total: 26\nAvailable: 18\nMissing: 8\n\n✓ axel - Download accelerator\n✓ aria2c - Multi-source downloader\n✓ btop - Modern resource monitor\n✗ cabextract - Extract CAB files\n✓ dos2unix - Convert DOS / Unix text files\n✗ genisoimage - Create ISO images\n✓ grc - Generic log colorizer\n...",
|
||||
"outro": "Užitočné pred spustením skriptov závislých od týchto nástrojov. Napríklad <code>uup_dump_iso_creator.sh</code> potrebuje <code>aria2c</code> + <code>cabextract</code> + <code>wimlib-imagex</code>. Ak niečo chýba, nainštalujte príslušnú skupinu alebo vyberte chýbajúce balíky jednotlivo."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"reposTitle": "„Repozitáre sa nepodarilo nastaviť. Inštalácia sa zrušila.“",
|
||||
"reposBody": "Kontrola repozitárov zlyhala: prechod na no-subscription bol odmietnutý, stav predplatného sa nedal načítať alebo položka repozitára potrebuje zásah. Príčinu uvádza predchádzajúca správa. Repozitáre sú v <em>Node → Updates → Repositories</em>; príkaz <code>apt-get update</code> v konzole zobrazí chybu apt.",
|
||||
"warningsTitle": "Balíček je hlásený \"S upozorneniami,\" ale príkaz funguje po zatvorení menu",
|
||||
"warningsBody": "Po <code>apt-get install</code> funkcia spustí <code>hash -r</code>, krátko počká a overí očakávaný príkaz cez <code>command -v</code>. Upozornenie znamená, že kontrola stále zlyhala, ale neurčuje príčinu. Skúste nový shell a ak príkaz stále chýba, overte inštaláciu balíka a PATH.",
|
||||
"hangsTitle": "Apt inštalácia visí",
|
||||
"hangsBody": "Pravdepodobne je otázka debconf skrytá za potlačeným výstupom. Skript pri volaniach apt používa <code>DEBIAN_FRONTEND=noninteractive</code>, čo zvyčajne otázky potlačí, ale niektoré balíky stále potrebujú vstup. Zrušte operáciu pomocou <kbd>Ctrl</kbd>+<kbd>C</kbd> a ručne spustite <code>apt-get install -y <pkg></code> v shelli, aby ste otázku videli a mohli rozhodnúť."
|
||||
},
|
||||
"files": {
|
||||
"heading": "Príslušné súbory",
|
||||
"code": "scripts/utilities/system_utils.sh # this script\nscripts/global/utils-install-functions.sh # PROXMENUX_UTILS, install_single_package\nscripts/global/repository-functions.sh # ensure_repositories\nscripts/global/repository_policy.py # reads and switches repositories through the Proxmox API\n/etc/apt/sources.list.d/proxmox.sources # no-subscription source, written by Proxmox when the switch is accepted"
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/system-update",
|
||||
"label": "Aktualizácia systému Proxmox",
|
||||
"tailRich": " — pre samotný <code>apt dist-upgrade</code> na hostiteľovi."
|
||||
},
|
||||
{
|
||||
"href": "/docs/network/monitoring",
|
||||
"label": "Živé monitorovacie nástroje (Sieť)",
|
||||
"tailRich": " — používa iftop / iptraf-ng / iperf3 z rovnakého zoznamu."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils",
|
||||
"label": "Prehľad pomocných nástrojov",
|
||||
"tailRich": " — Späť na prehľad sekcie."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,335 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Aktualizácia PVE 8 na PVE 9 | Dokumentácia ProxMenux",
|
||||
"description": "Tri spôsoby prechodu z Proxmox VE 8 na 9 (Debian Bookworm na Trixie a PVE 8 na 9): automaticky, interaktívne alebo ručne podľa oficiálneho postupu. Kontrola pve8to9, migrácia repozitárov, dist-upgrade a záverečné overenie. Spustenie z webového terminálu je zablokované.",
|
||||
"ogTitle": "Aktualizácia PVE 8 na PVE 9 | Dokumentácia ProxMenux",
|
||||
"ogDescription": "Tri postupy (automatický, interaktívny a ručný) na prechod z Proxmox VE 8 na 9."
|
||||
},
|
||||
"header": {
|
||||
"title": "Aktualizácia PVE 8 na PVE 9",
|
||||
"description": "Vykoná prechod z Proxmox VE 8 na 9 podľa oficiálneho postupu: Debian Bookworm na Trixie a PVE 8 na 9. Ponúka automatický, interaktívny a ručný postup aj samostatnú predbežnú kontrolu. Webový terminál blokuje, pretože prerušenie spojenia počas aktualizácie môže poškodiť systém hostiteľa.",
|
||||
"section": "Nástroje"
|
||||
},
|
||||
"dangerCallout": {
|
||||
"title": "Prechod na novú hlavnú verziu je nevratný",
|
||||
"intro": "Táto operácia nahradí základ Debianu (Bookworm → Trixie) a súčasti Proxmoxu priamo v systéme. <strong>Návrat na pôvodnú verziu nie je možný</strong>. Pred začiatkom:",
|
||||
"items": [
|
||||
"<strong>Overené zálohy</strong> všetkých VM a CT (PBS, vzdump, snímky ZFS — overte aj obnovu).",
|
||||
"<strong>Prístup cez konzolu / IPMI / iKVM</strong> k hostiteľovi pre prípad výpadku SSH.",
|
||||
"Hostiteľ už používa aktuálnu PVE 8.4.x (skript to vynucuje).",
|
||||
"Ceph (ak je k dispozícii) vo verzii 19.x Squid.",
|
||||
"Aspoň <strong>5 GB voľného miesta</strong> v koreňovom súborovom systéme."
|
||||
]
|
||||
},
|
||||
"modeMenu": {
|
||||
"heading": "Menu režimu",
|
||||
"intro": "Voľba otvorí štyri položky: Automaticky, Interaktívne, Predbežná kontrola a Ručný návod. Tri možnosti aktualizáciu <em>vykonajú</em> alebo vysvetlia jej postup; samostatná kontrola <em>overí</em> pripravenosť a môže ponúknuť opravy.",
|
||||
"imageAlt": "Ponuka aktualizácie PVE 8 na 9: automaticky, interaktívne, predbežná kontrola a ručný návod"
|
||||
},
|
||||
"threeWays": {
|
||||
"heading": "Tri spôsoby aktualizácie",
|
||||
"intro": "Automatický a interaktívny režim používajú rovnaký postup s predbežnými aj záverečnými kontrolami. Líšia sa odpoveďami na otázky dpkg počas <code>dist-upgrade</code>. Ručný návod zobrazí príkazy vrátane kontrol; každý krok musíte vykonať sami.",
|
||||
"auto": {
|
||||
"title": "Automatické / bez dozoru",
|
||||
"summary": "Nastaví <code>ASSUME_YES=1</code> + <code>DEBIAN_FRONTEND=noninteractive</code>. Pri upravených konfiguračných súboroch použije dpkg predvolenú akciu, ak existuje; inak <strong>ponechá aktuálny súbor</strong> (<code>--force-confold</code>).",
|
||||
"items": [
|
||||
"Najrýchlejšie — bez čakania na odpovede",
|
||||
"Vhodné pre štandardné inštalácie bez vlastných úprav konfigurácie",
|
||||
"Riziko: upravený súbor sa ponechá bez otázky a môže prekryť nové predvolené nastavenia"
|
||||
]
|
||||
},
|
||||
"interactive": {
|
||||
"title": "Interaktívny",
|
||||
"summary": "Rovnaký postup, ale na každú otázku dpkg o konflikte konfigurácie odpovedáte sami. Pomalšie, no s úplným prehľadom.",
|
||||
"items": [
|
||||
"Vidíte každý konflikt a rozhodnite sa.",
|
||||
"Najlepšie keď máte prispôsobené <code>/etc/lvm</code>, <code>/etc/ssh</code>, atď.",
|
||||
"Pozrite si tabuľku odporúčaných odpovedí v ručnom postupe nižšie"
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"title": "Príručka manuálnej aktualizácie",
|
||||
"summary": "Zobrazí oficiálny postup Proxmoxu v 17 krokoch bez jeho vykonania. Príkazy spúšťajte ručne v samostatnom shelli.",
|
||||
"items": [
|
||||
"Úplná kontrola — každý príkaz zadávate sami",
|
||||
"Najlepšie, keď sa chcete naučiť postup alebo neveríte ničomu",
|
||||
"Skript zobrazuje kroky; nič nie je spustené automaticky"
|
||||
]
|
||||
}
|
||||
},
|
||||
"precheckCallout": {
|
||||
"title": "Plus samostatná predbežná kontrola",
|
||||
"body": "Možnosť 3 — <strong>Spustiť kontrolu PVE 8 na 9</strong> — spustí oficiálny nástroj <code>pve8to9 --full</code>, ponúkne opravy bežných problémov a potom <strong>skončí</strong>. Použite ju pred aktualizáciou alebo po ručných opravách. Automatický a interaktívny režim kontrolu tiež spúšťajú; v ručnom návode ju spúšťate sami."
|
||||
},
|
||||
"webTerminal": {
|
||||
"heading": "Prečo je webový terminál zablokovaný?",
|
||||
"body": "Všetky tri režimy zistia <code>termproxy</code> / <code>vncshell</code> v reťazci rodičovských procesov a odmietnu spustenie. Webový terminál závisí od služby <code>pveproxy</code>, ktorá sa počas aktualizácie mení. Po reštarte <code>pveproxy</code> sa ukončí terminál aj skript v ňom. Hostiteľ môže zostať aktualizovaný iba čiastočne.",
|
||||
"warningTitle": "Použite SSH alebo fyzickú konzolu / IPMI / iKVM",
|
||||
"warningBody": "Najčastejšou voľbou je SSH. Spustite ho v <code>tmux</code> alebo <code>screen</code>, aby krátky výpadok siete neprerušil aktualizáciu. Pri bežnom SSH shelli skript najprv zobrazí pripomienku tmux/screen."
|
||||
},
|
||||
"auto": {
|
||||
"heading": "Automatický režim / Bezobslužne",
|
||||
"intro": "Bežné potvrdenia a otázky o konfiguračných súboroch používajú predvolené odpovede. Blokujúce chyby predbežnej kontroly môžu naďalej vyžadovať zásah. Režim použite pri štandardnej inštalácii alebo po overení vplyvu odpovedí na vlastné nastavenia.",
|
||||
"behaviourHeading": "Správanie automatického režimu",
|
||||
"behaviourTable": {
|
||||
"settingHeader": "Nastavenie",
|
||||
"effectHeader": "Účinok",
|
||||
"rows": [
|
||||
{
|
||||
"settingRich": "<code>ASSUME_YES=1</code>",
|
||||
"effectRich": "Interná voľba — automaticky potvrdí otázky skriptu typu áno/nie"
|
||||
},
|
||||
{
|
||||
"settingRich": "<code>DEBIAN_FRONTEND=noninteractive</code>",
|
||||
"effectRich": "apt / dpkg sa spúšťajú bez otázok debconf"
|
||||
},
|
||||
{
|
||||
"settingRich": "<code>--force-confdef</code>",
|
||||
"effectRich": "Pre nedotknuté konfiguračné súbory: nainštalujte novú verziu správcu"
|
||||
},
|
||||
{
|
||||
"settingRich": "<code>--force-confold</code>",
|
||||
"effectRich": "Pri upravených súboroch: predvolená akcia dpkg, ak existuje; inak <strong>ponechať vašu verziu</strong>."
|
||||
}
|
||||
]
|
||||
},
|
||||
"flowHeading": "Postup automatického režimu",
|
||||
"flowIntro": "Šesť po sebe idúcich fáz. Úvodné fázy môžu aktualizovať balíky PVE 8 a zapísať konfiguráciu repozitárov. Chyba postup zastaví, tieto zmeny však nevráti. Fáza 5 vykoná <code>dist-upgrade</code> na PVE 9.",
|
||||
"flowDiagram": "1. KONTROLY\nBlokuje termproxy / vncshell; odmietne PVE 9; overí miesto a pripojenie.\nAk je Ceph nainštalovaný, vyžaduje 19.x Squid.\npve8to9 --full (môže ponúknuť opravy).\n\n2. PRÍPRAVA PVE 8\nscripts/global/update-pve8.sh\nAktualizuje balíky PVE 8; systemctl restart pve-manager.\n\n3. MIGRÁCIA REPOZITÁROV\nBookworm → Trixie; zapíše súbory deb822 .sources.\nZakomentuje staré súbory .list; apt-get update.\n\n4. OVERENIE KANDIDÁTA PVE 9\napt-cache policy proxmox-ve\napt-get -s dist-upgrade\nZastaví sa, ak kandidát nie je 9.x alebo by sa odstránil proxmox-ve.\n\n5. AKTUALIZÁCIA\napt-get -y -o Dpkg::Options::='--force-confdef' -o Dpkg::Options::='--force-confold' dist-upgrade\nProtokol: /var/log/pve8-a-pve9-'<'timestamp'>'.log\n\n6. OVERENIE A REŠTART\nEFI: apt install grub-efi-amd64\npve8to9 --full; skontrolujte výsledok a otázku na reštart.",
|
||||
"preflightHeading": "Kontroly pred aktualizáciou",
|
||||
"preflightTable": {
|
||||
"checkHeader": "Kontrola",
|
||||
"whyHeader": "Prečo na tom záleží",
|
||||
"rows": [
|
||||
{
|
||||
"checkRich": "<strong>Blok webového terminálu</strong>",
|
||||
"whyRich": "Zabráni tomu, aby aktualizácia ukončila shell, v ktorom beží"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>Už na 9.x</strong>",
|
||||
"whyRich": "Skončí, ak hostiteľ už používa PVE 9 — nie je čo aktualizovať"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>Najnovšia verzia PVE 8.4.x</strong>",
|
||||
"whyRich": "Najprv aktualizuje PVE 8 na najnovšiu revíziu pomocou príslušného skriptu; staré verzie 8.x majú odlišné požiadavky"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>pve8to9 --full</strong>",
|
||||
"whyRich": "Kontrola pripravenosti od Proxmoxu; chyby FAIL blokujú aktualizáciu, kým ich neopravíte"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>Miesto na disku</strong>",
|
||||
"whyRich": "≥ 1024 MB voľného miesta v <code>/var/cache/apt/archives</code> pre stiahnuté súbory .deb"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>Pripojenie</strong>",
|
||||
"whyRich": "Ping na <code>download.proxmox.com</code> — pri zlyhaní sa aktualizácia nezačne"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>Ceph 19.x Squid</strong>",
|
||||
"whyRich": "Ak je Ceph nainštalovaný, musí už používať 19.x. PVE 9 nefunguje s Ceph 17/18. Voľby <code>--ignore-ceph-check</code> a <code>--warn-ceph-check</code> obchádzajú kontrolu; používajte ich len so znalosťou dôsledkov."
|
||||
}
|
||||
]
|
||||
},
|
||||
"distUpgradeHeading": "Príkaz dist-upgrade (automatický režim)",
|
||||
"distUpgradeCode": "apt-get -y \\\n -o Dpkg::Options::='--force-confdef' \\\n -o Dpkg::Options::='--force-confold' \\\n dist-upgrade",
|
||||
"distUpgradeOutro": "Výstup sa zobrazuje v reálnom čase na stdout a ukladá sa aj do <code>/var/log/pve8-a-pve9-<timestamp>.log</code>. Vidíte všetko; vynechané sú len otázky.",
|
||||
"postHeading": "Úlohy po aktualizácii (automatický režim)",
|
||||
"postItems": [
|
||||
"<strong>Hostitelia EFI:</strong> nainštaluje <code>grub-efi-amd64</code> podľa známeho problému v dokumentácii Proxmoxu. Aktualizácia ho nepridá automaticky a pri ďalšom štarte môže byť potrebný.",
|
||||
"<strong>Čas reštartu <code>pve-manager</code>.</strong> Výslovný reštart patrí do prípravy PVE 8, pred aktualizáciou balíkov na Trixie/PVE 9.",
|
||||
"<strong>Znova spustí <code>pve8to9 --full</code>.</strong> Zobrazí zostávajúce problémy. Pri chybách FAIL sa otvorí rovnaká ponuka opráv ako pri predbežnej kontrole.",
|
||||
"<strong>Otázka na reštart.</strong> Reštart sa odporúča na načítanie nového jadra a služieb. Odmietnite ho iba z konkrétneho dôvodu: ponechanie starého jadra po prechode na novú hlavnú verziu prináša riziko."
|
||||
]
|
||||
},
|
||||
"interactive": {
|
||||
"heading": "Interaktívny režim",
|
||||
"intro": "Rovnaký postup ako <autolink>automatický režim</autolink>: rovnaké kontroly, migrácia repozitárov aj záverečné overenie. Rozdiel je pri <code>dist-upgrade</code>: <strong>na každú otázku dpkg o konflikte konfigurácie odpovedáte sami</strong>. ProxMenux spustí <code>apt-get dist-upgrade</code> bez volieb <code>--force-conf*</code>.",
|
||||
"distUpgradeHeading": "Dist-upgrade príkaz (interaktívny režim)",
|
||||
"distUpgradeCode": "apt-get dist-upgrade\n# (user answers each dpkg config-file conflict prompt as it appears)",
|
||||
"whenHeading": "Keď interaktívne je správna voľba",
|
||||
"whenItems": [
|
||||
"Prispôsobili ste <code>/etc/lvm/lvm.conf</code>, <code>/etc/ssh/sshd_config</code>, <code>/etc/default/grub</code> alebo akýkoľvek iný konfiguračný súbor, ktorý sa dotkne aktualizácie.",
|
||||
"Chcete vidieť, ktoré balíky spôsobujú konflikty, a rozhodnúť o každom súbore.",
|
||||
"Vylepšujete producenta, kde je akákoľvek skrytá zmena neprijateľná."
|
||||
],
|
||||
"promptCalloutTitle": "Čo odpovedať na každú výzvu",
|
||||
"promptCalloutBody": "Platia rovnaké odporúčania ako pri ručnom postupe: pozrite <dpkglink>Odporúčané odpovede na otázky dpkg</dpkglink> nižšie. Pomocou <strong>D</strong> zobrazíte rozdiely, pomocou <strong>Z</strong> otvoríte shell."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Postup manuálnej aktualizácie",
|
||||
"intro": "Toto zobrazí možnosť <strong>Ručný návod na aktualizáciu</strong>: <wikilink>oficiálny wiki návod Proxmoxu z 8 na 9</wikilink>, rozdelený do štyroch fáz. Skript príkazy <em>zobrazí</em>; vykonáte ich sami v samostatnom shelli používateľa root. Každý krok máte pod kontrolou.",
|
||||
"rootCalloutTitle": "Všetky príkazy vyžadujú root",
|
||||
"rootCalloutBody": "Použite shell používateľa root aj pre presmerovania a dokumenty here-document. Pri <code>sudo</code> zabezpečte, aby sa s oprávneniami root vykonal celý príkaz.",
|
||||
"phase1Heading": "Fáza 1 — Príprava",
|
||||
"phase1Intro": "Aktualizujte hostiteľa na najnovšiu PVE 8.4.x, overte verziu a používaný Ceph, spustite kontrolu Proxmoxu a terminálový multiplexor na prežitie výpadkov spojenia.",
|
||||
"phase1Code": "# Step 1 — Update PVE 8 to the latest 8.4+\napt update && apt dist-upgrade -y\n\n# Step 2 — Verify version (must be 8.4.1 or newer)\npveversion\n\n# Step 2.1 — Hyper-converged Ceph: must already be on 19.x Squid\nceph --version\n# If older, follow https://pve.proxmox.com/wiki/Ceph_Reef_to_Squid\n\n# Step 3 — Run the official upgrade-readiness check\npve8to9 --full\n# If it warns about systemd-boot meta-package, remove it:\n# apt remove systemd-boot\n\n# Step 4 — Start tmux or screen (so SSH disconnect doesn't kill the upgrade)\ntmux new-session -s upgrade\n# or\nscreen -S upgrade",
|
||||
"phase2Heading": "Fáza 2 — Migrácia repozitárov",
|
||||
"phase2Intro": "Zmeňte všetky repozitáre Debianu a Proxmoxu z Bookworm na Trixie a zdroje Proxmoxu preveďte na deb822. <strong>Vyberte krok 7 ALEBO 8</strong> podľa predplatného Enterprise. Bez Ceph vynechajte krok 9.",
|
||||
"phase2Code": "# Step 5 — Debian: bookworm → trixie\nsed -i 's/bookworm/trixie/g' /etc/apt/sources.list\n\n# Step 6 — Same for the legacy enterprise list (only if you use enterprise)\nsed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/pve-enterprise.list\n\n# Step 7 — Add the new PVE 9 enterprise repo (deb822) — Enterprise users only\ncat > /etc/apt/sources.list.d/pve-enterprise.sources << EOF\nTypes: deb\nURIs: https://enterprise.proxmox.com/debian/pve\nSuites: trixie\nComponents: pve-enterprise\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg\nEOF\n\n# Step 8 — OR add the no-subscription repo (most home / lab users)\ncat > /etc/apt/sources.list.d/proxmox.sources << EOF\nTypes: deb\nURIs: http://download.proxmox.com/debian/pve\nSuites: trixie\nComponents: pve-no-subscription\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg\nEOF\n\n# Step 8.1 — Refresh and verify proxmox-ve candidate is 9.x\napt update && apt policy | sed -n '1,120p'\n\n# Step 9 — Update Ceph repo (only if you run Ceph)\ncat > /etc/apt/sources.list.d/ceph.sources << EOF\nTypes: deb\nURIs: http://download.proxmox.com/debian/ceph-squid\nSuites: trixie\nComponents: no-subscription\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg\nEOF\n\n# Step 10 — Remove old .list files now superseded by deb822 .sources\nrm -f /etc/apt/sources.list.d/pve-enterprise.list /etc/apt/sources.list.d/ceph.list\n\n# Step 11 — Final apt update\napt update",
|
||||
"phase3Heading": "Fáza 3 — dist-upgrade",
|
||||
"phase3Intro": "Samotná aktualizácia. Krok 12 je voliteľný, ale odporúčaný na obmedzenie správ auditu. Krok 13 trvá dlhšie: odpovedajte podľa tabuľky. Krok 13.1 je iba pre EFI a vychádza zo známych problémov v oficiálnom návode.",
|
||||
"phase3Code": "# Step 12 — Disable kernel audit messages (optional)\nsystemctl disable --now systemd-journald-audit.socket\n\n# Step 13 — The main upgrade (this takes a while)\napt dist-upgrade\n# (answer prompts using the table below)\n\n# Step 13.1 — EFI hosts: install grub for EFI (per known issues)\n[ -d /sys/firmware/efi ] && apt install grub-efi-amd64",
|
||||
"dpkgHeading": "Odporúčané odpovede na otázky dpkg",
|
||||
"dpkgIntro": "Odporúčania Proxmoxu: <strong>Y</strong> nainštaluje nový súbor správcu balíka a prepíše váš; <strong>N</strong> ponechá aktuálny súbor. Pri pochybnostiach najprv skontrolujte rozdiely:",
|
||||
"dpkgTable": {
|
||||
"fileHeader": "Súbor / otázka",
|
||||
"answerHeader": "Odporúčaná odpoveď",
|
||||
"whyHeader": "Prečo?",
|
||||
"rows": [
|
||||
{
|
||||
"fileRich": "/etc/issue",
|
||||
"answerRich": "<strong>N</strong> (ponechať aktuálny súbor)",
|
||||
"whyRich": "Ponechá prihlasovací oznam, na ktorý ste zvyknutí",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "/etc/lvm/lvm.conf",
|
||||
"answerRich": "<strong>Y</strong> (verzia správcu balíka)",
|
||||
"whyRich": "PVE 9 potrebuje nové predvolené nastavenia LVM",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "/etc/ssh/sshd_config",
|
||||
"answerRich": "<strong>Y</strong> pri iba predvolených zmenách; vlastné úpravy najprv skontrolujte",
|
||||
"whyRich": "Pred nahradením súboru overte miestne nastavenia SSH a zachovajte prístup. Predvolené zmeny zahŕňajú premenované voľby a komentáre.",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "/etc/default/grub",
|
||||
"answerRich": "<strong>N</strong> v prípade prispôsobenia",
|
||||
"whyRich": "Sú tu parametre zavádzania, napríklad IOMMU a PCI passthrough",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "/etc/chrony/chrony.conf",
|
||||
"answerRich": "<strong>Y</strong>, ak nebol upravený; miestne nastavenia najprv zachovajte",
|
||||
"whyRich": "Trixie mení predvolené nastavenia synchronizácie času. Pred prijatím nového súboru presuňte miestne nastavenia do adresárov conf.d / sources.d programu chrony.",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "Reštarty služieb počas aktualizácie",
|
||||
"answerRich": "<strong>Áno</strong> (predvolené)",
|
||||
"whyRich": "Reštartuje väčšinu služieb bez reštartu hostiteľa",
|
||||
"fileFont": false
|
||||
},
|
||||
{
|
||||
"fileRich": "<code>apt-listchanges</code>",
|
||||
"answerRich": "Stlačte <kbd>q</kbd>",
|
||||
"whyRich": "Ukončí iba prehliadač textu; zobrazené informácie sú súhrnom zmien",
|
||||
"fileFont": false
|
||||
}
|
||||
]
|
||||
},
|
||||
"inspectCalloutTitle": "Kontrola špecifického dpkg konfliktu",
|
||||
"inspectCalloutBody": "Pri otázke dpkg o konfiguračnom súbore zobrazí <strong>D</strong> rozdiely medzi vaším súborom a novou verziou; <strong>Z</strong> otvorí shell na ďalšie overenie. Rozhodnutie tak nemusíte odhadovať.",
|
||||
"phase4Heading": "Fáza 4 — Po aktualizácii",
|
||||
"phase4Intro": "Overte úspešné dokončenie, reštartujte na jadro PVE 9 a potvrďte verziu. Potom môžete zostávajúce staré súbory <code>.list</code> previesť na deb822.",
|
||||
"phase4Code": "# Step 14 — Re-run the readiness check (should be much cleaner now)\npve8to9 --full\n\n# Step 15 — Reboot to load the new kernel and PVE 9 daemons\nreboot\n\n# Step 16 — After reboot, confirm PVE 9.x\npveversion\n# Should show pve-manager/9.x.x\n\n# Step 17 — Optional: modernise the remaining legacy .list files to deb822\napt modernize-sources\n# (keeps .list backups as .bak)"
|
||||
},
|
||||
"clusterCeph": {
|
||||
"heading": "Klaster a Ceph",
|
||||
"clusterCalloutTitle": "Klaster: aktualizujte uzly po jednom",
|
||||
"clusterCalloutBody": "Zistené cez <code>pvecm status</code>. <strong>Neaktualizujte</strong> viac uzlov naraz. Presuňte hostí, aktualizujte uzol, reštartujte a overte členstvo v klastri. Až potom pokračujte. Počas aktualizácie funguje živá migrácia zo staršej verzie PVE na novšiu; opačný smer spravidla nie je podporovaný. Skupiny HA sa automaticky prevedú na pravidlá HA, keď všetky uzly používajú PVE 9.",
|
||||
"cephCalloutTitle": "Ceph: NAJPRV inovujte Ceph, potom Proxmox",
|
||||
"cephCalloutBody": "Ceph musí pred aktualizáciou Proxmoxu už používať 19.x Squid. Postupujte v oficiálnom poradí Quincy 17 → Reef 18 → Squid 19: aktualizujte balíky a postupne reštartujte démony Ceph podľa návodu. Pred každým uzlom Proxmoxu overte <code>ceph --version</code>. Celý postup: <cephlink>wiki aktualizácie Ceph Reef na Squid</cephlink>."
|
||||
},
|
||||
"troubleshooting": {
|
||||
"heading": "Riešenie problémov",
|
||||
"items": [
|
||||
{
|
||||
"title": "Skript skončí: \"This script cannot be executed from the Proxmox web terminal\"",
|
||||
"bodyRich": "Otvorte SSH alebo konzolu / IPMI / iKVM a spustite ho odtiaľ. Najprv použite <code>tmux new -s pveupgrade</code>, aby krátky výpadok siete neprerušil beh."
|
||||
},
|
||||
{
|
||||
"title": "pve8to9 hlási FAIL a oprava cez možnosť 1 hlási \"command not found\"",
|
||||
"bodyRich": "Ak chyba spomína <code>configure_repositories</code>, kópia skriptu je zastaraná. Aktuálna oprava používa cleanup_duplicate_repos a ensure_repositories. Aktualizujte ju alebo cez možnosť 2 skontrolujte ručné príkazy. <code>apt-get update</code> obnoví zoznamy balíkov, ale nevyrieši všetky blokujúce kontroly."
|
||||
},
|
||||
{
|
||||
"title": "Simulácia apt hlási \"proxmox-ve will be REMOVED\"",
|
||||
"bodyRich": "Nové repozitáre sú nedostupné alebo sa nezmenil názov vydania. Skontrolujte <code>cat /etc/apt/sources.list.d/proxmox.sources</code>: riadok <code>Suites:</code> musí obsahovať <code>trixie</code>, nie <code>bookworm</code>. <code>apt-cache policy proxmox-ve</code> musí zobrazovať kandidáta 9.x z nového repozitára."
|
||||
},
|
||||
{
|
||||
"title": "dist-upgrade zlyhá čiastočne cez",
|
||||
"bodyRich": "Opravte závislosti pomocou <code>apt-get -f install</code> a zopakujte aktualizáciu. Ak zlyhá, pozrite koniec protokolu <code>/var/log/pve8-a-pve9-<timestamp>.log</code>. Nereštartujte, kým <code>dpkg -l | grep ^iU</code> nevráti prázdny výstup."
|
||||
},
|
||||
{
|
||||
"title": "EFI host nebude štartovať po reštarte",
|
||||
"bodyRich": "Po aktualizácii sa inštaluje <code>grub-efi-amd64</code>. Ak ste krok vynechali alebo zlyhal, spustite ISO Proxmoxu v záchrannom režime, pripojte koreňový súborový systém, použite chroot a <code>apt-get install grub-efi-amd64 && update-grub</code>."
|
||||
},
|
||||
{
|
||||
"title": "GUI sa po aktualizácii nenačíta",
|
||||
"bodyRich": "Spustite <code>systemctl status pveproxy</code> a <code>systemctl restart pveproxy</code>. Ak problém pretrváva, pozrite chybu cez <code>journalctl -u pveproxy -b</code>."
|
||||
},
|
||||
{
|
||||
"title": "Sieť nefunguje po reštarte",
|
||||
"bodyRich": "Overte, že <code>/etc/network/interfaces</code> odkazuje na existujúce zariadenia a je nainštalovaný <code>ifupdown2</code>: <code>apt install ifupdown2</code>. Pri zmene názvov pozrite <netlink>Trvalé názvy sieťových rozhraní</netlink>."
|
||||
},
|
||||
{
|
||||
"title": "Split-brain klastra po aktualizácii jedného uzla",
|
||||
"bodyRich": "Zmiešané klastre PVE 8 / PVE 9 sú počas aktualizácie podporované. Živá migrácia zo starších na novšie verzie funguje; opačný smer spravidla nie je podporovaný. Ak sa uzol javí odpojený, skontrolujte <code>corosync</code> a konfiguráciu QDevice / siete. Na každom uzle spustite <code>pvecm status</code> na overenie kvóra."
|
||||
}
|
||||
]
|
||||
},
|
||||
"files": {
|
||||
"heading": "Príslušné súbory",
|
||||
"code": "scripts/utilities/upgrade_pve8_to_pve9.sh # main upgrade orchestrator\nscripts/utilities/pve8to9_check.sh # pre-check (separate menu option)\nscripts/utilities/proxmox-upgrade-pve8-to-pve9-manual-guide.sh # 17-step runbook\nscripts/global/update-pve8.sh # PVE 8 worker (final patches)\n/etc/apt/sources.list # bookworm → trixie sed\n/etc/apt/sources.list.d/proxmox.sources # created (deb822 PVE 9)\n/etc/apt/sources.list.d/debian.sources # created (deb822 trixie)\n/etc/apt/sources.list.d/ceph.sources # created if Ceph\n/etc/apt/sources.list.d/*.list # legacy files commented out / removed\n/var/log/pve8-a-pve9-'<'timestamp'>'.log # full upgrade log"
|
||||
},
|
||||
"references": {
|
||||
"heading": "Oficiálne zdroje",
|
||||
"intro": "Ručný postup skriptu vychádza z týchto oficiálnych zdrojov. Pri pochybnostiach počas aktualizácie postupujte podľa oficiálneho wiki: ProxMenux pomáha s vykonaním, rozhodujúci je návod Proxmoxu.",
|
||||
"items": [
|
||||
{
|
||||
"href": "https://pve.proxmox.com/wiki/Upgrade_from_8_to_9",
|
||||
"title": "Aktualizácia z 8 na 9",
|
||||
"desc": "Hlavná stránka Proxmox wiki pre aktualizáciu 8 → 9. Zdroj pravdy pre každý príkaz v manuálnom postupe vyššie."
|
||||
},
|
||||
{
|
||||
"href": "https://pve.proxmox.com/wiki/Ceph_Reef_to_Squid",
|
||||
"title": "Aktualizácia na Ceph Squid (19.x)",
|
||||
"desc": "Povinný predbežný krok pre hyperkonvergované uzly Ceph. Pred PVE 9 musí Ceph používať 19.x Squid."
|
||||
},
|
||||
{
|
||||
"href": "https://pve.proxmox.com/wiki/Roadmap",
|
||||
"title": "Plán Proxmox VE",
|
||||
"desc": "Poznámky k vydaniu PVE 9 a zmeny oproti 8.x — prečítajte si ich pred aktualizáciou."
|
||||
},
|
||||
{
|
||||
"href": "https://www.debian.org/releases/trixie/releasenotes",
|
||||
"title": "Poznámky k vydaniu Debianu Trixie",
|
||||
"desc": "PVE 9 vychádza z Debianu Trixie. Poznámky Debianu vysvetľujú zmeny operačného systému, ktoré ovplyvnia aj hostiteľa."
|
||||
},
|
||||
{
|
||||
"href": "https://forum.proxmox.com/forums/proxmox-ve-installation-and-configuration.16/",
|
||||
"title": "Inštalačné fórum Proxmox VE",
|
||||
"desc": "Pri problémoch počas aktualizácie najprv prehľadajte toto fórum; rovnaký problém už možno niekto riešil."
|
||||
},
|
||||
{
|
||||
"href": "https://pve.proxmox.com/wiki/Backup_and_Restore",
|
||||
"title": "Zálohovanie a obnova",
|
||||
"desc": "Aktualizácia hlavnej verzie je nevratná. Pred začiatkom overte svoje zálohy."
|
||||
}
|
||||
]
|
||||
},
|
||||
"video": {
|
||||
"heading": "Videonávod",
|
||||
"intro": "Preferovať sledovanie upgrade spustiť end-to-end pred tým, než to urobiť sám? Tento prechod demonštruje tok upgrade ProxMenux v reálnom čase.",
|
||||
"title": "ProxMenux — Videonávod na aktualizáciu Proxmox VE 8 na 9",
|
||||
"caption": "Externé video na YouTube. Prehrávanie v režime rozšíreného súkromia, bez cookies až do spustenia videa."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/system-update",
|
||||
"label": "Aktualizácia systému Proxmox",
|
||||
"tail": " — pre bežné aktualizácie v rámci rovnakej hlavnej verzie (8.4.1 → 8.4.5 a podobne)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils",
|
||||
"label": "Prehľad pomocných nástrojov",
|
||||
"tail": " — späť na prehľad sekcie."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,161 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Tvorba ISO cez UUP Dump | Dokumentácia ProxMenux",
|
||||
"description": "Vytvorte aktuálny inštalačný obraz ISO systému Windows na hostiteľovi Proxmox pomocou nástroja UUP Dump ISO Creator v ProxMenux. Automatizuje inštaláciu závislostí, sťahovanie a konverziu súborov UUP na zavádzací obraz ISO na vytvorenie VM.",
|
||||
"ogTitle": "Tvorba ISO cez UUP Dump | Dokumentácia ProxMenux",
|
||||
"ogDescription": "Vytvorte aktuálny obraz ISO systému Windows z UUP Dump pomocou ProxMenux. Závislosti, sťahovanie aj konverzia sú plne automatizované.",
|
||||
"ogImageAlt": "ProxMenux — Tvorca ISO UUP Dump"
|
||||
},
|
||||
"header": {
|
||||
"title": "Tvorba ISO cez UUP Dump",
|
||||
"description": "Vytvorte aktuálny inštalačný obraz ISO systému Windows na hostiteľovi Proxmox pomocou UUP Dump. ProxMenux spravuje závislosti, paralelne sťahuje súbory UUP, spustí konvertor UUP Dump a presunie obraz ISO do vybraného výstupného adresára. Predvolene je to rozpoznané úložisko ISO Proxmox.",
|
||||
"section": "Nástroje"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo robí tento skript",
|
||||
"body": "Zadajte URL vytvorenú službou uupdump.net po výbere zostavy, jazyka a edície. Skript nainštaluje chýbajúce závislosti, stiahne konvertor UUP Dump aj súbory UUP, vytvorí zavádzací obraz ISO systému Windows a presunie ho do vybraného výstupného adresára. Ako predvolený cieľ ponúkne rozpoznané úložisko ISO Proxmox."
|
||||
},
|
||||
"hero": {
|
||||
"imageAlt": "Položka UUP Dump ISO Creator v ProxMenux",
|
||||
"caption": "Položka UUP Dump ISO Creator v ProxMenux"
|
||||
},
|
||||
"what": {
|
||||
"heading": "Čo je UUP Dump?",
|
||||
"intro": "UUP Dump je komunitná služba na sťahovanie pôvodných súborov Unified Update Platform (UUP), ktoré Windows Update používa na distribúciu systému Windows. Tieto súbory možno zostaviť do štandardného zavádzacieho obrazu ISO. Umožňuje získať:",
|
||||
"items": [
|
||||
"Najnovšiu zostavu systému Windows vrátane kanálov Insider Preview.",
|
||||
"Konkrétnu staršiu zostavu, ktorú už Microsoft neuvádza na stránke na stiahnutie.",
|
||||
"Čisté, nemodifikované súbory pochádzajúce priamo zo serverov Microsoft.",
|
||||
"Presná kombinácia edícií a jazykov, ktoré chcete v jednom ISO."
|
||||
],
|
||||
"learnMore": "Viac informácií nájdete na <extlink>stránke projektu UUP Dump</extlink>."
|
||||
},
|
||||
"automates": {
|
||||
"heading": "Čo skript automatizuje"
|
||||
},
|
||||
"dependencies": {
|
||||
"heading": "Závislosti",
|
||||
"intro": "Skript najprv skontroluje nástroje potrebné na stiahnutie súborov UUP a vytvorenie obrazu ISO. Chýbajúce nástroje nainštaluje pomocou <code>apt-get</code>:",
|
||||
"headerPackage": "Balík",
|
||||
"headerRole": "Úloha",
|
||||
"rows": [
|
||||
{
|
||||
"pkg": "curl",
|
||||
"roleRich": "Sťahovanie cez HTTP na spustenie konvertora."
|
||||
},
|
||||
{
|
||||
"pkg": "aria2",
|
||||
"roleRich": "Paralelné sťahovanie všetkých súborov UUP."
|
||||
},
|
||||
{
|
||||
"pkg": "cabextract",
|
||||
"roleRich": "Rozbalí balíky Microsoft CAB."
|
||||
},
|
||||
{
|
||||
"pkg": "wimtools",
|
||||
"roleRich": "Buduje <code>install.wim</code> (wimlib-imagex)."
|
||||
},
|
||||
{
|
||||
"pkg": "genisoimage",
|
||||
"roleRich": "Vytvorí výsledný zavádzací obraz ISO (alebo <code>mkisofs</code>)."
|
||||
},
|
||||
{
|
||||
"pkg": "chntpw",
|
||||
"roleRich": "Počas vytvárania upravuje súbory registra Windows."
|
||||
}
|
||||
],
|
||||
"manualIntro": "Ručný ekvivalent, ak budete musieť nástroje nainštalovať sami:",
|
||||
"manualCode": "apt-get install curl aria2 cabextract wimtools genisoimage chntpw"
|
||||
},
|
||||
"flow": {
|
||||
"heading": "Sťahovanie a konverzia",
|
||||
"steps": [
|
||||
"Rozpozná úložisko ISO Proxmox cez <code>pvesm status -content iso</code> alebo použije náhradnú cestu <code>/var/lib/vz/template/iso</code>.",
|
||||
"Vyžiada základný priečinok pre dočasné súbory (predvolene <code>/root/uup-temp</code>).",
|
||||
"Stiahne konvertor UUP Dump z <code>git.uupdump.net</code>.",
|
||||
"Z vloženej URL načíta <code>id</code>, <code>pack</code> a <code>edition</code>.",
|
||||
"Zavolá <code>https://uupdump.net/get.php?…&aria2=2</code> a vytvorí zoznam na sťahovanie cez aria2.",
|
||||
"Stiahne všetky súbory UUP do <code>UUPs/</code> pomocou aria2, paralelne a s možnosťou pokračovania.",
|
||||
"Spustí <code>convert.sh wim UUPs 1</code> z konvertora a vytvorí výsledný obraz ISO.",
|
||||
"Presunie obraz ISO do vybraného výstupného adresára a vyčistí dočasné súbory."
|
||||
]
|
||||
},
|
||||
"aria2": {
|
||||
"heading": "Použité prepínače sťahovania Aria2",
|
||||
"code": "aria2c --no-conf --console-log-level=warn --log-level=info \\\n --log=aria2_download.log \\\n -x16 -s16 -j5 -c -R \\\n -d\"$destDir\" -i\"$tempScript\"",
|
||||
"flags": [
|
||||
"<code>-x16</code> — najviac 16 pripojení na server.",
|
||||
"<code>-s16</code> — rozdelí každý súbor na 16 segmentov.",
|
||||
"<code>-j5</code> — sťahuje 5 súborov súčasne.",
|
||||
"<code>-c</code> — pokračuje v neúplných sťahovaniach.",
|
||||
"<code>-R</code> — prenesie časovú značku vzdialeného súboru na stiahnutý súbor, ak je dostupná."
|
||||
],
|
||||
"runtime": "Bežný čas je približne 10 minút a závisí najmä od rýchlosti internetu a vyťaženia serverov na sťahovanie UUP Dump."
|
||||
},
|
||||
"step1": {
|
||||
"heading": "Krok 1 · Získajte UUP Dump URL",
|
||||
"intro": "Pred spustením skriptu potrebujete URL UUP Dump s parametrami <code>id</code>, <code>pack</code> a <code>edition</code>. Vytvorte ju na <extlink>uupdump.net</extlink>:",
|
||||
"stepBadge": "Krok",
|
||||
"items": [
|
||||
{
|
||||
"title": "Vyberte verziu Windows",
|
||||
"img": "/iso-creator/step-1-select-version-windows.png",
|
||||
"caption": "Hlavná stránka UUP Dump: vyberte verziu Windows",
|
||||
"body": "Otvorte domovskú stránku UUP Dump a vyberte verziu Windows, ktorú chcete."
|
||||
},
|
||||
{
|
||||
"title": "Vyberte konkrétnu zostavu",
|
||||
"img": "/iso-creator/step-2-select-version-windows.png",
|
||||
"caption": "Vyberte konkrétnu zostavu",
|
||||
"body": "Vyberte zostavu: najnovšiu, z kanála Insider Preview alebo konkrétnu staršiu, ktorá je ešte uvedená."
|
||||
},
|
||||
{
|
||||
"title": "Vybrať jazyk",
|
||||
"img": "/iso-creator/step-3-select-version-windows.png",
|
||||
"caption": "Vybrať jazyk",
|
||||
"body": "Vyberte jazyk, ktorý má obraz ISO obsahovať."
|
||||
},
|
||||
{
|
||||
"title": "Vybrať edície",
|
||||
"img": "/iso-creator/step-4-select-version-windows.png",
|
||||
"caption": "Vyberte edície, ktoré sa majú zahrnúť",
|
||||
"body": "Vyberte edície, ktoré chcete zahrnúť do obrazu ISO (Home, Pro, Enterprise, …). Môžete ich skombinovať viacero."
|
||||
},
|
||||
{
|
||||
"title": "Kopírovať URL",
|
||||
"img": "/iso-creator/step-5-select-version-windows.png",
|
||||
"caption": "Kopírovať URL z panela adries",
|
||||
"bodyRich": "Na poslednej stránke skopírujte URL <em>z panela s adresou prehliadača</em>. Musí obsahovať <code>id=…</code>, <code>pack=…</code> a <code>edition=…</code>. Tento reťazec skript spracuje."
|
||||
}
|
||||
]
|
||||
},
|
||||
"step2": {
|
||||
"heading": "Krok 2 · Spustite tvorcu",
|
||||
"intro": "Po skopírovaní URL otvorte ProxMenux a spustite tvorbu ISO:",
|
||||
"stepBadge": "Krok",
|
||||
"items": [
|
||||
{
|
||||
"title": "Spustiť UUP Dump ISO Creator",
|
||||
"img": "/iso-creator/start-uupdump-iso-creator.png",
|
||||
"caption": "Spustiť UUP Dump ISO Creator z ProxMenux",
|
||||
"bodyRich": "V ProxMenux otvorte <strong>Utilities → UUP Dump ISO Creator</strong>. Skript skontroluje závislosti a adresár ISO pred vyžiadaním údajov."
|
||||
},
|
||||
{
|
||||
"title": "Vložiť UUP Dump URL",
|
||||
"img": "/iso-creator/add-url-iso-creator.png",
|
||||
"caption": "Vložte URL, ktoré ste skopírovali z uupdump.net",
|
||||
"body": "Vložte URL do vstupného dialógu. Skript potvrdzuje, že sú prítomné tri požadované parametre; ak nejaký chýba, preruší sa čisto."
|
||||
},
|
||||
{
|
||||
"title": "Počkajte na dokončenie vytvárania",
|
||||
"img": "/iso-creator/end-uupdump-iso-creator.png",
|
||||
"caption": "Vytváranie je dokončené — obraz ISO je pripravený v úložisku ISO Proxmox",
|
||||
"bodyRich": "Konzola zobrazuje priebeh aria2 a potom výstup konvertora. Hotový obraz ISO sa presunie do vybraného výstupného adresára. Ak je v nakonfigurovanom úložisku ISO Proxmox, možno ho vybrať cez <strong>Create VM → System Windows → Install with ISO from UUP Dump</strong>."
|
||||
}
|
||||
]
|
||||
},
|
||||
"tempFiles": {
|
||||
"title": "Dočasné súbory",
|
||||
"body": "Predvolený dočasný priečinok je <code>/root/uup-temp</code>, so stiahnutými súbormi v <code>UUPs/</code> a konvertorom v <code>converter/</code>. Vlastná základná cesta dostane samostatný podadresár relácie. Vetvy úspešného vytvorenia a nevytvoreného ISO odstránia dočasnú reláciu. Skoršie chyby alebo zrušenie môžu zanechať dočasné súbory."
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user