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": "Exportera VM till OVA / OVF | ProxMenux-dokumentation",
|
||||
"description": "Exportera en Proxmox-VM till ett portabelt OVA-arkiv eller en OVF-katalog med DMTF-standardschemat. VMDK-diskar i formatet streamOptimized och SHA1-manifest. Kan importeras i VMware ESXi / Workstation / Fusion, VirtualBox och tillbaka i Proxmox.",
|
||||
"ogTitle": "Exportera VM till OVA / OVF | ProxMenux-dokumentation",
|
||||
"ogDescription": "Konvertera en Proxmox-VM till ett portabelt OVA- / OVF-paket som är kompatibelt med VMware och VirtualBox."
|
||||
},
|
||||
"header": {
|
||||
"title": "Exportera VM till OVA / OVF",
|
||||
"description": "Konverterar en Proxmox-VM till ett portabelt OVA-paket (ett enda TAR-arkiv) eller OVF-paket (beskrivningsfil och VMDK-filer) med DMTF:s OVF-standardschema. Diskarna konverteras med qemu-img till VMDK i formatet streamOptimized. Resultatet kan importeras i VMware (ESXi / Workstation / Fusion), VirtualBox och tillbaka i Proxmox med importverktyget.",
|
||||
"section": "Verktyg"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Vad detta gör",
|
||||
"body": "Läser konfigurationen för en stoppad VM, konverterar varje disk till VMDK i formatet streamOptimized, skapar en OVF-beskrivningsfil och ett SHA1-manifest och paketerar allt som en enda <code>.ova</code>-fil eller en <code>-ovf</code>-katalog. Den ursprungliga virtuella maskinen ändras aldrig."
|
||||
},
|
||||
"picker": {
|
||||
"heading": "VM-väljare",
|
||||
"body": "Vid start visar skriptet alla virtuella maskiner från <code>qm list</code> med VMID, namn och status. Välj den som ska exporteras:",
|
||||
"imgAlt": "Dialog för att välja en VM att exportera, med en lista över alla virtuella maskiner"
|
||||
},
|
||||
"stopped": {
|
||||
"heading": "Den virtuella maskinen måste vara stoppad",
|
||||
"intro": "En konsekvent diskavbildning kräver en stoppad VM. Om den valda virtuella maskinen körs erbjuder ProxMenux att stänga av den:",
|
||||
"items": [
|
||||
"Normal avstängning med <code>qm shutdown $VMID --timeout 120</code> (väntar 2 minuter på gästens ACPI-avstängning).",
|
||||
"Om väntetiden löper ut erbjuds ett tvångsstopp: <code>qm stop $VMID</code> (motsvarar att bryta strömmen).",
|
||||
"Om du avböjer båda avbryts exporten utan att några data ändras."
|
||||
],
|
||||
"warnTitle": "Ett tvångsstopp motsvarar att bryta strömmen",
|
||||
"warnBody": "<code>qm stop</code> motsvarar att dra ur strömkabeln. Gästens filsystem kan behöva repareras vid nästa start. Använd normal avstängning när det går och reservera tvångsstopp för gäster som inte svarar."
|
||||
},
|
||||
"format": {
|
||||
"heading": "Formatval: OVA eller OVF",
|
||||
"headerFormat": "Format",
|
||||
"headerOutput": "Utdata",
|
||||
"headerPros": "Fördelar",
|
||||
"headerCons": "Nackdelar",
|
||||
"rows": [
|
||||
{
|
||||
"format": "OVA",
|
||||
"output": "name-vmid-ts.ova",
|
||||
"pros": "En enda fristående fil som är lätt att flytta, överföra med sftp eller bifoga till ett supportärende.",
|
||||
"cons": "Kräver ~220% av den virtuella diskstorleken (extra utrymme för TAR-arkivet medan det skapas)."
|
||||
},
|
||||
{
|
||||
"format": "OVF",
|
||||
"output": "name-vmid-ts-ovf/",
|
||||
"pros": "~120% av den virtuella diskstorleken. Lättare att granska eftersom beskrivningsfilen är vanlig XML-text. Kan redigeras före import.",
|
||||
"cons": "Flera filer som måste överföras tillsammans."
|
||||
}
|
||||
]
|
||||
},
|
||||
"destination": {
|
||||
"heading": "Destinationskatalog",
|
||||
"body": "Välj en förinställd sökväg (<code>/var/lib/vz/dump</code>, <code>/var/lib/vz/template/iso</code>) eller ange en egen. Skriptet kontrollerar att katalogen är skrivbar och varnar om det lediga utrymmet verkar otillräckligt innan du börjar.",
|
||||
"calloutTitle": "Tumregel för ledigt utrymme",
|
||||
"calloutBody": "För OVF-export av en VM med totalt 100 GB virtuell diskstorlek bör du ha ~120 GB ledigt; för OVA, ~220 GB. Den faktiska användningen kan bli lägre för nästan tomma diskar. OVA-arkivet skapas med okomprimerad TAR medan de tillfälliga VMDK-filerna finns kvar, så det behövs plats för båda. Om utrymmet tar slut under exporten städar EXIT-hanteraren den tillfälliga katalogen och du måste börja om."
|
||||
},
|
||||
"package": {
|
||||
"heading": "Vad som hamnar i paketet",
|
||||
"intro": "För en OVA / OVF som heter <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": "Vad blir exporterat",
|
||||
"items": [
|
||||
"<strong>Diskar:</strong> alla poster av typen <code>scsi*</code>, <code>sata*</code>, <code>virtio*</code> och <code>ide*</code> i VM-konfigurationen, konverterade till VMDK i formatet streamOptimized.",
|
||||
"<strong>Antal vCPU:er</strong> (RASD ResourceType 3) och <strong>minne</strong> i MiB (ResourceType 4).",
|
||||
"<strong>Antal nätverkskort</strong> (ResourceType 10: endast antalet, inte bryggan eller modellen).",
|
||||
"<strong>VM-namn</strong> och en uppgift om typen av operativsystem."
|
||||
],
|
||||
"notTitle": "Vad exporteras INTE",
|
||||
"notItems": [
|
||||
"CD-ROM- / ISO-anslutningar (avsiktligt uteslutna).",
|
||||
"Cloud-init-enheter (avsiktligt uteslutna).",
|
||||
"Nätverkskortets specifika brygga och modell (endast antalet bevaras).",
|
||||
"Valet av BIOS / UEFI, som måste ställas in igen vid import.",
|
||||
"Konfiguration av PCI-genomkoppling.",
|
||||
"Snapshots - endast det nuvarande tillståndet fångas.",
|
||||
"Inställningar på VM-nivå (NUMA, hugepages, hotplug, …)."
|
||||
]
|
||||
},
|
||||
"conversion": {
|
||||
"heading": "Diskkonvertering",
|
||||
"intro": "Varje disk konverteras med:",
|
||||
"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> är VMwares format som kan läsas i en enda genomgång. Det stöds av ESXi 6.7+, VMware Workstation, VirtualBox och Proxmox självt. Det är det VMDK-underformat som har bredast kompatibilitet och passar för flytt mellan system. Nackdelen är att det saknar direktåtkomst till godtyckliga positioner och därför inte kan monteras direkt utan konvertering."
|
||||
},
|
||||
"manifest": {
|
||||
"heading": "SHA1-manifest",
|
||||
"intro": "Varje paket innehåller en <code>.mf</code>-fil med SHA1-hashar för OVF-beskrivningsfilen och varje 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": "Manifestet är valfritt i OVF-specifikationen och många program ignorerar det, men det kan användas för att kontrollera att paketet överfördes oskadat. Verifiera manuellt med <code>sha1sum -c file.mf</code>."
|
||||
},
|
||||
"import": {
|
||||
"heading": "Importera resultatet",
|
||||
"intro": "Det exporterade paketet kan importeras i:",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/import-vm",
|
||||
"preRich": "<strong>Proxmox</strong> — använd det tillhörande verktyget ",
|
||||
"linkLabel": "Importera VM från OVA / OVF",
|
||||
"tailRich": "."
|
||||
},
|
||||
{
|
||||
"tailRich": "<strong>VMware ESXi</strong> — Datacenter → Deploy OVF Template; välj .ova- eller .ovf-filen."
|
||||
},
|
||||
{
|
||||
"tailRich": "<strong>VMware Workstation / Fusion</strong> — File → Open; välj .ova- eller .ovf-filen."
|
||||
},
|
||||
{
|
||||
"tailRich": "<strong>VirtualBox</strong> — File → Import Appliance; välj .ova- eller .ovf-filen."
|
||||
}
|
||||
]
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Felsökning",
|
||||
"noSpaceTitle": "qemu-img convert misslyckas under konverteringen med \"No space left on device\"",
|
||||
"noSpaceBody": "Utrymmet tog slut på destinationen. EXIT-hanteraren städar automatiskt den tillfälliga katalogen. Välj en destination med mer ledigt utrymme (se tumregeln ovan) och kör exporten igen.",
|
||||
"unsupportedHwTitle": "Exporten slutförs men VMware vägrar importera: \"Unsupported hardware family\"",
|
||||
"unsupportedHwBody": "Vissa ESXi-versioner avvisar OVF-beskrivningsfiler som anger en okänd maskinvarufamilj. Öppna .ovf-filen i en textredigerare, eller packa först upp .ova-filen, leta efter <code><vssd:VirtualSystemType></code> och ange ett värde som ESXi godtar, till exempel <code>vmx-13</code> för ESXi 6.5+. Prova VirtualBox som en snabb lösning; det är mindre strikt.",
|
||||
"nicTitle": "Den importerade virtuella maskinen använder ett annat nätverkskort eller en annan SCSI-styrenhet",
|
||||
"nicBody": "OVF bevarar antalet nätverkskort, men inte deras ursprungliga modell. Granska nätverksinställningarna för den importerade virtuella maskinen i destinationshypervisorn. Exporten anger en lsilogic-SCSI-styrenhet för VMware-kompatibilitet. Vid återimport i Proxmox kan du välja <code>VirtIO SCSI</code> om gästen har lämpliga drivrutiner.",
|
||||
"runningTitle": "Den virtuella maskinen kördes och jag avböjde avstängning: exporten avbröts",
|
||||
"runningBody": "Skriptet kan inte skapa en konsekvent avbildning medan data skrivs till diskarna. Acceptera avstängningsfrågan nästa gång, eller stäng först av den virtuella maskinen manuellt (<code>qm shutdown $VMID</code>) och kör exporten igen.",
|
||||
"slowTitle": "Diskkonverteringen är långsam",
|
||||
"slowBody": "<code>qemu-img convert</code> använder en tråd och läser källan med full hastighet. Räkna med 15–30 minuter för en disk på 100 GB på en mekanisk hårddisk. Från NVMe till NVMe går det 5–10 gånger snabbare. Diskarna i en VM konverteras i följd; tiden ökar linjärt med den totala virtuella storleken."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relaterat",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/import-vm",
|
||||
"label": "Importera VM från OVA / OVF",
|
||||
"tail": " — det kompletterande verktyget för återimport."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils",
|
||||
"label": "Verktygsöversikt",
|
||||
"tail": " — tillbaka till avsnittsöversikten."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,218 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importera VM från OVA / OVF | ProxMenux-dokumentation",
|
||||
"description": "Importera en VM från VMware ESXi / Workstation / Fusion / VirtualBox / ProxMenux till Proxmox VE. Packar automatiskt upp OVA, läser OVF-metadata, skapar den virtuella maskinen och importerar varje disk i lagringens inbyggda format (qcow2 / raw).",
|
||||
"ogTitle": "Importera VM från OVA / OVF | ProxMenux-dokumentation",
|
||||
"ogDescription": "Importera virtuella maskiner från VMware-, VirtualBox- eller ProxMenux-exporter till Proxmox. Diskarna konverteras automatiskt till lagringens inbyggda format."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importera VM från OVA / OVF",
|
||||
"description": "Importerar ett OVA- / OVF-paket till Proxmox VE: packar upp OVA-arkiv, läser antalet vCPU:er, minne, nätverkskort och diskreferenser från OVF-filen, skapar sedan den virtuella maskinen och importerar varje disk med qm importdisk till vald lagring. Kompatibelt med exporter från VMware (ESXi / Workstation / Fusion), VirtualBox och ProxMenux.",
|
||||
"section": "Verktyg"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Vad detta gör",
|
||||
"body": "Skapar en komplett VM i Proxmox från ett portabelt paket. Efter importen är den redo att startas. Vissa kontroller och justeringar av nätverkskortsmodell, firmware och operativsystemstyp rekommenderas för prestanda och kompatibilitet."
|
||||
},
|
||||
"picker": {
|
||||
"heading": "Filväljare",
|
||||
"intro": "Vid start erbjuder skriptet två förinställda kataloger eller en egen sökväg:",
|
||||
"items": [
|
||||
"<code>/var/lib/vz/dump</code> - standard Proxmox vzdump backup katalog.",
|
||||
"<code>/var/lib/vz/template/iso</code> — användbart om du överförde OVA-filen dit med sftp.",
|
||||
"Egen sökväg för OVA- / OVF-filer på andra platser på värden."
|
||||
],
|
||||
"outro": "Den listar sedan varje <code>.ova</code> och <code>.ovf</code>-fil i den valda katalogen.",
|
||||
"imageAlt": "Filvalsdialog för import av en VM"
|
||||
},
|
||||
"flow": {
|
||||
"heading": "Hur importen fungerar",
|
||||
"nodes": [
|
||||
{
|
||||
"label": "OVA / OVF in",
|
||||
"detail": ".ova → tar xf till\n /tmp/.proxmenux-import-*\n.ovf → använd på plats",
|
||||
"variant": "source"
|
||||
},
|
||||
{
|
||||
"label": "Tolkning och dialoger",
|
||||
"detail": "AWK läser OVF\n(namn, vCPU, RAM, NIC,\ndiskar). Val av\nVMID / lagring / brygga",
|
||||
"variant": "bridge"
|
||||
},
|
||||
{
|
||||
"label": "qm create + importdisk",
|
||||
"detail": "qm create $VMID\nqm importdisk\n(VMDK → lagringsformat)\nqm set --scsiN",
|
||||
"variant": "target"
|
||||
}
|
||||
]
|
||||
},
|
||||
"ovf": {
|
||||
"heading": "OVF-tolkning",
|
||||
"intro": "En <strong>gawk</strong>-parser läser OVF-filen och hämtar VM-metadata. Den använder <code>match()</code> med tre argument, en gawk-funktion som inte stöds av mawk, standardvalet för <code>awk</code> i Debian / Proxmox. Om gawk saknas installeras det automatiskt vid första importen via <code>ensure_repositories</code> + <code>install_single_package</code>. Senare importer behöver inte det steget. Fält som läses:",
|
||||
"headerField": "Fält",
|
||||
"headerSource": "Källa i OVF",
|
||||
"headerDefault": "Standard om saknas",
|
||||
"rows": [
|
||||
{
|
||||
"field": "VM namn",
|
||||
"source": "<Name> (första matchen)",
|
||||
"default": "imported-vm"
|
||||
},
|
||||
{
|
||||
"field": "Antal vCPU:er",
|
||||
"source": "RASD ResourceType 3 → VirtualQuantity",
|
||||
"default": "1"
|
||||
},
|
||||
{
|
||||
"field": "Minne (MiB)",
|
||||
"source": "RASD ResourceType 4 → VirtualQuantity",
|
||||
"default": "1024"
|
||||
},
|
||||
{
|
||||
"field": "Antal nätverkskort",
|
||||
"source": "antal poster med ResourceType 10",
|
||||
"default": "1"
|
||||
},
|
||||
{
|
||||
"field": "OS-typ",
|
||||
"source": "/Linux/ eller /Windows/ i beskrivning",
|
||||
"default": "other"
|
||||
},
|
||||
{
|
||||
"field": "Diskreferenser",
|
||||
"source": "href attribut slutar i .vmdk / .qcow2 / .img / .raw",
|
||||
"default": "Inga (importen avbryts)"
|
||||
}
|
||||
]
|
||||
},
|
||||
"memWarn": {
|
||||
"title": "Tvetydiga minnesenheter",
|
||||
"body": "Parsern konverterar kända minnesenheter till <strong>MiB</strong>, inklusive byte, KiB, MiB, GiB och stödda textetiketter. Saknade eller okända enheter <em>behandlas som MiB</em>. Jämför efter importen <code>qm config $VMID | grep memory</code> med källmaskinens dokumenterade RAM och korrigera vid behov med <code>qm set $VMID --memory <MiB></code>."
|
||||
},
|
||||
"dialog": {
|
||||
"heading": "Importens dialogsteg",
|
||||
"items": [
|
||||
"<strong>VMID</strong> — föreslår nästa lediga ID (<code>pvesh get /cluster/nextid</code>).",
|
||||
"<strong>VM-namn</strong> — använder namnet från OVF-filen som standard; du kan ändra det.",
|
||||
"<strong>Mållagring</strong> — meny med lagringar som stöder innehållet <code>images</code>, från <code>pvesm status -content images</code>.",
|
||||
"<strong>Nätverksbrygga</strong> — meny med bryggor från <code>ip link show type bridge</code>. En ensam brygga väljs automatiskt; standardvalet är <code>vmbr0</code>.",
|
||||
"<strong>Bekräftelse</strong> — sammanfattning med VMID, namn, vCPU:er, minne, nätverkskort, lagring, brygga och diskar att importera. Avbryt här så ändras inget."
|
||||
]
|
||||
},
|
||||
"create": {
|
||||
"heading": "Skapa den virtuella maskinen",
|
||||
"intro": "Efter bekräftelsen kör skriptet:",
|
||||
"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 controller standarder till <code>lsi</code> (LSI Logic) för VMDK kompatibilitet. NICs standard till <code>e1000</code> (universell kompatibilitet) på den valda bron."
|
||||
},
|
||||
"diskLoop": {
|
||||
"heading": "Importloop för diskar",
|
||||
"intro": "För varje diskreferens i OVF:",
|
||||
"items": [
|
||||
"<code>qm importdisk $VMID $disk_path $STORAGE</code> — importerar disken i ett format som stöds av mållagringen och skapar en post <code>unusedN:</code> i VM-konfigurationen.",
|
||||
"Skriptet söker med grep efter den nyskapade referensen <code>unusedN</code> i konfigurationen.",
|
||||
"<code>qm set $VMID --scsiN $unused_disk</code> fäster disken som <code>scsi0</code>, <code>scsi1</code>, …",
|
||||
"<code>qm set $VMID --delete unusedN</code> - rensar den numera oanvända markören."
|
||||
],
|
||||
"outro": "Boot är inställd på den första SCSI-skivan: <code>qm set $VMID --boot c --bootdisk scsi0</code>."
|
||||
},
|
||||
"postImport": {
|
||||
"heading": "Rekommenderade justeringar efter import",
|
||||
"intro": "Importen använder brett kompatibla inställningar för att den virtuella maskinen ska kunna starta vid första försöket. När du har bekräftat att den startar kan du välja effektivare inställningar i Proxmox-gränssnittet eller via CLI:",
|
||||
"headerSetting": "Inställning",
|
||||
"headerDefault": "Standard efter import",
|
||||
"headerRecommended": "Rekommenderas (om gästen stöder)",
|
||||
"rows": [
|
||||
{
|
||||
"setting": "NIC modell",
|
||||
"default": "e1000",
|
||||
"recommended": "VirtIO (mycket snabbare, kräver drivrutin i gästen)"
|
||||
},
|
||||
{
|
||||
"setting": "SCSI-kontroller",
|
||||
"default": "LSI",
|
||||
"recommended": "VirtIO SCSI single (modern Linux eller Windows med VirtIO-drivrutiner)"
|
||||
},
|
||||
{
|
||||
"setting": "Fast programvara (BIOS / UEFI)",
|
||||
"default": "Proxmox standard (BIOS)",
|
||||
"recommended": "Använd källmaskinens firmware; ett felaktigt val kan hindra start"
|
||||
},
|
||||
{
|
||||
"setting": "QEMU gästagent",
|
||||
"default": "Av",
|
||||
"recommendedRich": "På + installera <code>qemu-guest-agent</code> i gästen (bättre säkerhetskopior, IP-rapportering)"
|
||||
},
|
||||
{
|
||||
"setting": "OS-typ",
|
||||
"default": "l26 / win10 / other (heuristik)",
|
||||
"recommended": "Kontrollera mot gästens faktiska operativsystem"
|
||||
},
|
||||
{
|
||||
"setting": "Visning",
|
||||
"default": "Standard",
|
||||
"recommended": "VirtIO-GPU eller SPICE (bättre konsolprestanda)"
|
||||
}
|
||||
]
|
||||
},
|
||||
"fwWarn": {
|
||||
"title": "Firmware mismatch = ingen start",
|
||||
"body": "Om källmaskinen använde UEFI men Proxmox skapar den med BIOS, eller tvärtom, hittar gästen ingen startbar disk. Kontrollera <em>FirmwareType / firmware</em> i OVF-filen eller ursprungsinställningarna och välj samma i Proxmox: <code>qm set $VMID --bios ovmf</code> för UEFI; standardvalet för BIOS är <code>seabios</code>."
|
||||
},
|
||||
"notImported": {
|
||||
"heading": "Vad importeras INTE",
|
||||
"items": [
|
||||
"<strong>Specifika nätverksbryggor</strong> — bara antalet kort bevaras. Alla använder den brygga du valde vid importen.",
|
||||
"<strong>Nätverkskortsmodell</strong> — standardvalet är e1000.",
|
||||
"<strong>Firmwaretypen BIOS / UEFI</strong> — använder Proxmox standardval BIOS.",
|
||||
"<strong>Konfiguration av PCI-genomkoppling</strong>.",
|
||||
"<strong>TPM</strong> (vTPM).",
|
||||
"<strong>Cloud-init</strong>-enheter.",
|
||||
"<strong>Snapshots</strong> - endast det nuvarande tillståndet.",
|
||||
"<strong>USB / seriella / parallella enheter</strong> förklaras i OVF.",
|
||||
"<strong>VM taggar / anteckningar / start-on-boot</strong> alternativ."
|
||||
]
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Felsökning",
|
||||
"orphanTitle": "VM skapades men diskimporten misslyckades: en ofullständig VM blev kvar",
|
||||
"orphanIntro": "När importen misslyckas erbjuder skriptet att ta bort den ofullständiga virtuella maskinen och dess importerade diskar. Om du avböjde eller automatisk radering misslyckades, granska maskinen och ta bort den manuellt med:",
|
||||
"orphanCode": "qm destroy $VMID --destroy-unreferenced-disks 1",
|
||||
"orphanOutro": "Fastställ sedan den underliggande orsaken (sannolikt diskutrymme på mållagringen) och återimportera.",
|
||||
"memTitle": "Importerad VM har 8 MB RAM (eller 8 TB)",
|
||||
"memIntro": "Parsern konverterar kända AllocationUnits till MiB. Saknade eller okända enheter behandlas som MiB. Granska OVF-filen och jämför det importerade minnet med källmaskinen. Korrigera vid behov:",
|
||||
"memCode": "qm set $VMID --memory 8192 # 8 GiB",
|
||||
"bootTitle": "Den importerade virtuella maskinen startar inte: \"No bootable device\"",
|
||||
"bootIntro": "En vanlig orsak är fel val av BIOS / UEFI. Källmaskinen använde UEFI men Proxmox skapade den med BIOS. Välj matchande firmware:",
|
||||
"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": "En annan vanlig orsak: startordningen pekar på scsi0 medan operativsystemet ligger på scsi1. Ändra ordningen i VM-fliken Options.",
|
||||
"bsodTitle": "En Windows-VM exporterad från VMware visar blåskärm vid första starten",
|
||||
"bsodBody": "Windows är känsligt för byte av diskstyrenhet. Installera VirtIO-drivrutiner <em>före</em> exporten från VMware eller behåll standardstyrenheten <code>lsi</code>. Byt till VirtIO SCSI först efter att gästen startat och VirtIO-drivrutiner installerats i Windows.",
|
||||
"zeroTitle": "OVF-parsern rapporterar 0 diskar",
|
||||
"zeroBody": "OVF-filen kan använda diskreferenser som parsern inte känner igen. Öppna filen och leta efter varje disks post <code><File ovf:href=\"...vmdk\" ...></code>. Om disken faktiskt är VMDK men har ett ovanligt suffix som <code>.dat</code>, byt namn till <code>.vmdk</code> och uppdatera OVF-referensen. Ett namnbyte konverterar inte formatet.",
|
||||
"awkTitle": "awk: syntax error at or near , — parsern misslyckas med varje OVA / OVF",
|
||||
"awkIntro": "OVF-parsern använder gawk-syntaxen <code>match()</code> med tre argument, som saknas i mawk, standardvalet för <code>awk</code> i Debian / Proxmox. Nyare skriptversioner installerar gawk vid första användningen via <code>ensure_repositories</code> + <code>install_single_package</code>. Om du kör en äldre kopia, installera det manuellt:",
|
||||
"awkCode": "apt-get install -y gawk",
|
||||
"awkOutro": "Kör sedan importen igen.",
|
||||
"netTitle": "Nätverket fungerar inte efter första starten",
|
||||
"netBody": "Gästen kan sakna drivrutiner för e1000-modellen i Proxmox, eller den valda bryggan kan vara fel. Ändra Network Device → Model på VM-fliken Hardware. Kontrollera också <code>ip a</code> i gästen: gränssnittet kan ha fått namnet ens18 i stället för eth0, medan nätverkskonfigurationen fortfarande använder det gamla namnet."
|
||||
},
|
||||
"files": {
|
||||
"heading": "Filer involverade",
|
||||
"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": "Relaterat",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/export-vm",
|
||||
"label": "Exportera VM till OVA / OVF",
|
||||
"tail": " — det kompletterande verktyget för export."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils",
|
||||
"label": "Verktygsöversikt",
|
||||
"tail": " — tillbaka till avsnittsöversikten."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,115 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Proxmox-verktyg — UUP Dump, uppgradering från PVE 8 till 9, OVA-export/-import | ProxMenux",
|
||||
"description": "Verktyg för vardagen i Proxmox VE: skapa Windows-ISO-filer med UUP Dump, installera utvalda CLI-verktyg, uppdatera Proxmox-systemet säkert, uppgradera från PVE 8 till PVE 9, exportera virtuella maskiner till OVA / OVF och importera OVA- / OVF-maskiner från VMware eller VirtualBox.",
|
||||
"ogTitle": "Proxmox-verktyg — UUP Dump, uppgradering från PVE 8 till 9, OVA-export/-import",
|
||||
"ogDescription": "Skapa Windows-ISO-filer, installera CLI-verktyg, kör en säker uppdatering, uppgradera från PVE 8 till PVE 9 och exportera eller importera virtuella maskiner i OVA / OVF.",
|
||||
"twitterTitle": "Proxmox-verktyg | ProxMenux",
|
||||
"twitterDescription": "ISO-skapande, CLI-verktyg, Proxmox-uppdatering, uppgradering PVE 8→9 och portabla virtuella maskiner i OVA / OVF."
|
||||
},
|
||||
"header": {
|
||||
"title": "Hjälpverktyg",
|
||||
"description": "Sex verktyg kompletterar det dagliga arbetet i Proxmox VE: ISO-skapande, systemunderhåll och flytt av virtuella maskiner. Varje alternativ är fristående. Välj det du behöver; inget installeras förrän du begär det.",
|
||||
"section": "Verktyg"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Vad denna meny är för",
|
||||
"body": "Tre grupper med fristående men ofta användbara verktyg: <strong>skapa en Windows-ISO</strong> med UUP Dump, <strong>underhåll Proxmox-värden</strong> (CLI-verktyg, uppdateringar och uppgradering av huvudversion) samt <strong>importera och exportera virtuella maskiner</strong> i Proxmox med standardformatet OVA / OVF."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Öppna menyn",
|
||||
"body": "Välj <strong>Utilities</strong> i ProxMenux huvudmeny. Då visas följande:",
|
||||
"imageAlt": "Verktygsmenyn med UUP Dump, systemverktyg, uppdatering, uppgradering, export och import"
|
||||
},
|
||||
"groups": {
|
||||
"heading": "Tre verktygsgrupper",
|
||||
"intro": "De sex verktygen är indelade i tre fristående grupper. Klicka på ett kort nedan för att gå till motsvarande avsnitt.",
|
||||
"iso": {
|
||||
"title": "Skapa ISO-filer",
|
||||
"body": "Skapa officiella Windows-ISO-filer med UUP Dump direkt på Proxmox-värden.",
|
||||
"bullets": [
|
||||
"Delad UUP Dump-länk → startbar ISO",
|
||||
"Beroenden installeras automatiskt",
|
||||
"Resultatet sparas i Proxmox katalog för ISO-mallar"
|
||||
]
|
||||
},
|
||||
"maintenance": {
|
||||
"title": "Systemunderhåll",
|
||||
"body": "Håll värden frisk: CLI-verktyg, regelbundna uppdateringar och storversionsuppgraderingen när det är dags.",
|
||||
"bullets": [
|
||||
"Installationsprogram för systemverktyg (25 CLI-verktyg)",
|
||||
"Proxmox systemuppdatering (apt + dist-upgrade)",
|
||||
"Uppgradering av huvudversion PVE 8 → PVE 9"
|
||||
]
|
||||
},
|
||||
"portability": {
|
||||
"title": "Flytt av virtuella maskiner",
|
||||
"body": "Importera och exportera virtuella maskiner i Proxmox med standardformatet OVA / OVF.",
|
||||
"bullets": [
|
||||
"Exportera Proxmox-VM → OVA / OVF",
|
||||
"Importera OVA / OVF → Proxmox VM",
|
||||
"Kompatibel med VMware och VirtualBox"
|
||||
]
|
||||
}
|
||||
},
|
||||
"upgradeWarn": {
|
||||
"title": "Uppgraderingen PVE 8 → 9 är destruktiv och går inte att ångra",
|
||||
"body": "En uppgradering av huvudversion ersätter Debianbasen (Bookworm → Trixie) och Proxmox-komponenterna i det befintliga systemet. Det finns ingen väg tillbaka: du behöver <strong>verifierade säkerhetskopior</strong> av varje VM och CT samt <strong>åtkomst via konsol / IPMI / iKVM</strong> innan du börjar. Därför vägrar uppgraderingsverktyget att köras från Proxmox webbterminal."
|
||||
},
|
||||
"isoSection": {
|
||||
"heading": "Skapa ISO-filer",
|
||||
"body": "Skapa en ny och aktuell Windows-installations-ISO direkt på Proxmox-värden. Skriptet automatiserar hela UUP Dump-flödet: installation av beroenden (aria2c, cabextract, wimlib-imagex, …), parallell nedladdning av uppdateringsfiler med aria2 och konvertering till en enda startbar ISO. Den sparas i <code>/var/lib/vz/template/iso</code> och är redo att anslutas till en VM.",
|
||||
"options": [
|
||||
{
|
||||
"title": "UUP Dump ISO-skapare",
|
||||
"description": "Skapa en aktuell Windows-installations-ISO från en delad UUP Dump-länk. Beroenden, nedladdning och konvertering hanteras helt automatiskt. Den färdiga ISO-filen sparas i /var/lib/vz/template/iso, redo för att skapa en VM.",
|
||||
"href": "/docs/utils/UUp-Dump-ISO-Creator"
|
||||
}
|
||||
]
|
||||
},
|
||||
"maintenanceSection": {
|
||||
"heading": "Systemunderhåll",
|
||||
"body": "Tre verktyg täcker det dagliga och det mer sällsynta arbetet på värden. <strong>Installationsprogrammet för systemverktyg</strong> installerar de CLI-verktyg du använder efter en nyinstallation. <strong>Proxmox systemuppdatering</strong> sköter det veckovisa eller månatliga underhållet. <strong>Uppgradering från PVE 8 till PVE 9</strong> är det stora steget vid varje ny huvudversion, med extra säkerhetskontroller eftersom det inte går att ångra.",
|
||||
"options": [
|
||||
{
|
||||
"title": "Installationsprogram för systemverktyg",
|
||||
"description": "Välj bland 25 utvalda CLI-verktyg (htop, btop, iperf3, jq, tmux, ncdu, ...) med eget urval eller fördefinierade grupper (grundläggande, utveckling, komprimering, multiplexrar, analys och nätverk). Använder standardflödet med paketförråd och verifieringskommando.",
|
||||
"href": "/docs/utils/system-utils"
|
||||
},
|
||||
{
|
||||
"title": "Proxmox systemuppdatering",
|
||||
"description": "Kontroll av paketförråd + apt update + apt dist-upgrade med bekräftelse före omstart. Identifierar PVE-huvudversionen (8 eller 9), behåller konfigurerade paketförråd och frågar innan en värd utan abonnemang byter till no-subscription-förrådet. Därefter körs autoremove.",
|
||||
"href": "/docs/utils/system-update"
|
||||
},
|
||||
{
|
||||
"title": "Uppgradera PVE 8 till PVE 9",
|
||||
"description": "Uppgradering av huvudversion (Debian Bookworm → Trixie + PVE 8 → 9). Förkontroller, migrering av paketförråd, automatiskt eller interaktivt läge, validering efter uppgraderingen och omstart. Vägrar att köras från webbterminalen.",
|
||||
"href": "/docs/utils/upgrade-pve8-pve9"
|
||||
}
|
||||
]
|
||||
},
|
||||
"portabilitySection": {
|
||||
"heading": "Flytt av virtuella maskiner (OVA / OVF)",
|
||||
"body": "OVA och OVF är paketeringsformat för överföring mellan hypervisorer enligt DMTF-standarden. De stöds av VMware, VirtualBox och Proxmox. De två verktygen är avsedda för export och återimport: en VM som exporteras från Proxmox kan importeras tillbaka och tvärtom. Använd dem för att flytta arbetslaster från ESXi, skapa en portabel säkerhetskopia av en VM eller dela en förberedd VM med någon som använder VirtualBox.",
|
||||
"options": [
|
||||
{
|
||||
"title": "Exportera VM till OVA / OVF",
|
||||
"description": "Konvertera en Proxmox-VM till ett portabelt OVA-arkiv eller en OVF-katalog. DMTF-standardschema, SHA1-manifest och VMDK-diskar i formatet streamOptimized. Kan importeras i VMware (ESXi / Workstation / Fusion), VirtualBox och tillbaka i Proxmox.",
|
||||
"href": "/docs/utils/export-vm"
|
||||
},
|
||||
{
|
||||
"title": "Importera VM från OVA / OVF",
|
||||
"description": "Importera en export från VMware / VirtualBox / ProxMenux i Proxmox. Verktyget packar automatiskt upp OVA, läser OVF-metadata, skapar den virtuella maskinen och importerar varje disk i lagringens inbyggda format.",
|
||||
"href": "/docs/utils/import-vm"
|
||||
}
|
||||
]
|
||||
},
|
||||
"diskSpaceCallout": {
|
||||
"title": "Om diskutrymme för export / import",
|
||||
"body": "Båda verktygen konverterar diskformat: exporten använder <code>qemu-img convert -O vmdk -o subformat=streamOptimized</code>; importen använder <code>qm importdisk</code> för att konvertera tillbaka till lagringens inbyggda format (qcow2 / raw). Räkna vid export med <strong>~120% av den virtuella diskstorleken</strong> för OVF och <strong>~220%</strong> för OVA. OVA-arkivet använder okomprimerad TAR och skapas medan de tillfälliga VMDK-filerna finns kvar. Kontrollera att målkatalogen har tillräckligt med ledigt utrymme innan du börjar."
|
||||
},
|
||||
"fitsTogether": {
|
||||
"heading": "Så är menyn organiserad",
|
||||
"body": "Varje verktyg har ett eget skript under <code>scripts/utilities/</code>. Proxmox systemuppdatering anropar ett enda säkert arbetsskript i <code>scripts/global/</code>, update-pve-safe.sh, som identifierar huvudversionen och hanterar både PVE 8 och PVE 9. Uppgraderingen PVE 8 → 9 erbjuder två extra åtgärder i sin egen meny: en fristående <em>Kontroll före uppgradering</em> (kör <code>pve8to9 --full</code>) och en skrivskyddad <em>Guide för manuell uppgradering</em> (17 steg), för användare som vill granska processen eller utföra den för hand."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,168 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Proxmox systemuppdatering | ProxMenux-dokumentation",
|
||||
"description": "Uppdaterar paket inom den aktuella Proxmox-huvudversionen med apt-get update och apt full-upgrade -y. Kontrollerar diskutrymme och konfigurerade paketförråd, försöker återställa GPG-nycklar, kontrollerar och reparerar gamla LVM-PV-huvuden, bygger om hanterade DKMS-drivrutiner vid behov, kör autoremove/autoclean och erbjuder omstart när det behövs.",
|
||||
"ogTitle": "Proxmox systemuppdatering | ProxMenux-dokumentation",
|
||||
"ogDescription": "apt full-upgrade med kontroll av paketförråd, autoremove/autoclean och omstartsfråga vid behov."
|
||||
},
|
||||
"header": {
|
||||
"title": "Proxmox systemuppdatering",
|
||||
"description": "Anropar ett enda arbetsskript (<code>update-pve-safe.sh</code>) som identifierar den aktuella Proxmox-huvudversionen. Konfigurerade paketförråd läses via Proxmox API och bevaras. En värd utan abonnemang som bara använder Enterprise måste bekräfta ett byte till no-subscription. Skriptet uppdaterar paket och bygger om ProxMenux-hanterade DKMS-drivrutiner för en kärna som är klar för nästa start. Huvudskriptet erbjuder omstart om systemets omstartsmarkering finns eller om den senaste installerade kärnan skiljer sig från den som körs. Processen kan också startas med <em>Update Now</em> i ProxMenux Monitor-huvudet när väntande uppdateringar upptäcks.",
|
||||
"section": "Verktyg"
|
||||
},
|
||||
"calloutWhat": {
|
||||
"title": "Vad detta gör",
|
||||
"body": "Uppdaterar värden till den senaste korrigeringsnivån inom dess aktuella huvudversion. Uppgraderar <strong>inte</strong> till en annan huvudversion. För PVE 8 → PVE 9, se <link>Uppgradera PVE 8 till PVE 9</link>."
|
||||
},
|
||||
"official": {
|
||||
"heading": "Proxmox officiella rekommendation",
|
||||
"intro": "För att uppdatera en värd inom samma huvudversion rekommenderar Proxmox att du kör:",
|
||||
"code": "apt update && apt full-upgrade -y",
|
||||
"outro": "Den här raden är det officiella kommandot för aktuella Proxmox-versioner. Du behöver också kontrollera att paketförråden är korrekta, att rätt förråd är aktiverade och att värden fungerar som den ska efter uppdateringen."
|
||||
},
|
||||
"onTop": {
|
||||
"heading": "Vad ProxMenux lägger till: verifierat i skriptet",
|
||||
"intro": "Använder <strong>samma apt full-upgrade-åtgärd</strong>, med kontroll av paketförråd, DKMS-ombyggnad och efterföljande städning. Stegen nedan motsvarar <code>scripts/utilities/proxmox_update.sh</code> och dess enda arbetsskript <code>scripts/global/update-pve-safe.sh</code>:",
|
||||
"items": [
|
||||
"<strong>Identifierar PVE-huvudversionen</strong> i arbetsskriptet (<code>pveversion | grep -oP ''pve-manager/\\K[0-9]+''</code>). Ett enda skript hanterar PVE 8 och PVE 9. Konfigurerade paketförråd bevaras om inte en värd utan abonnemang accepterar det erbjudna bytet.",
|
||||
"<strong>Behåller konfigurerade paketförråd.</strong> <code>ensure_repositories</code> läser förråd och abonnemangsstatus via Proxmox API. Med ett aktivt abonnemang eller ett redan använt no-subscription- eller testförråd ändras inget. En värd utan aktivt abonnemang som bara använder Enterprise måste bekräfta bytet till no-subscription. Ett nej avslutar uppdateringen utan att ändra några källor.",
|
||||
"<strong>Kör uppdateringen utan interaktion</strong> med <code>DEBIAN_FRONTEND=noninteractive</code> och <code>--force-confdef --force-confold</code>. För dpkg-konfigurationsfiler väljs standardåtgärden om en sådan finns; annars behålls den befintliga filen.",
|
||||
"<strong>Tvingar inte fram valfria verktyg.</strong> Arbetsskriptet installerar inte <code>zfsutils-linux</code>, <code>chrony</code>, <code>ifupdown2</code> eller liknande paket mot det tidigare valet. En Proxmox-installation som avstått från något av dem behåller det valet. Saknade paket visas av de överordnade installationsflödena, inte av uppdateringsflödet.",
|
||||
"<strong>Kontroll och reparation av LVM-metadata.</strong> Identifierar gamla PV-huvuden och kör vgck --updatemetadata och vgchange -ay för berörda volymgrupper. Detta kan ändra LVM-metadata; det är inte en kontroll som bara visar varningar.",
|
||||
"<strong>Rengör efteråt:</strong> <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>.",
|
||||
"<strong>DKMS byggs om före omstartsfrågan.</strong> Arbetsskriptet anropar <code>pmx_rebuild_dkms_after_kernel</code> när en nyare installerad kärna är klar. Huvudskriptet kontrollerar <code>/var/run/reboot-required</code> och använder <code>dpkg-query</code> för att jämföra kärnan från <code>uname -r</code> med det senaste installerade paketet <code>proxmox-kernel-*-pve-signed</code> / <code>pve-kernel-*-pve</code>. Markeringen kan saknas på värdar utan <code>needrestart</code>; kärnjämförelsen fungerar ändå."
|
||||
]
|
||||
},
|
||||
"calloutOneSentence": {
|
||||
"title": "I en mening",
|
||||
"body": "Uppdaterar värdens paket, behåller paketförråd om du inte accepterar ett byte, kontrollerar LVM-metadata, bygger om hanterade DKMS-drivrutiner, städar med autoremove/autoclean och erbjuder omstart vid behov."
|
||||
},
|
||||
"confirm": {
|
||||
"heading": "Bekräftelsedialog",
|
||||
"intro": "När du väljer alternativet öppnas en sammanfattning av de planerade åtgärderna som kräver en uttrycklig bekräftelse:",
|
||||
"imageAlt": "Bekräftelsedialog för Proxmox systemuppdatering med kontroll av paketförråd, paketuppdateringar och städning"
|
||||
},
|
||||
"routes": {
|
||||
"heading": "Så delegerar huvudskriptet arbetet",
|
||||
"nodes": {
|
||||
"source": {
|
||||
"label": "proxmox_update.sh",
|
||||
"detail": "pveversion |\ngrep -oP ''pve-manager/\\K[0-9]+''"
|
||||
},
|
||||
"bridge": {
|
||||
"label": "Ett enda arbetsskript",
|
||||
"detail": "update-pve-safe.sh\n(detekterar PVE 8 / 9\ninternt)"
|
||||
},
|
||||
"target": {
|
||||
"label": "Efter uppdatering",
|
||||
"detail": "apt-get autoremove\napt-get autoclean\nOmstartsfråga vid behov"
|
||||
}
|
||||
}
|
||||
},
|
||||
"worker": {
|
||||
"heading": "Vad arbetsskriptet gör",
|
||||
"intro": "Ett arbetsskript (<code>scripts/global/update-pve-safe.sh</code>) hanterar PVE 8 (<code>bookworm</code>) och PVE 9 (<code>trixie</code>). Det identifierar huvudversionen internt och kontrollerar befintliga paketförråd utan att skriva om Debians grundkällor. Stegen är:",
|
||||
"items": [
|
||||
"<strong>Förkontroller.</strong> Kontrollerar att minst ~1 GB är ledigt i <code>/var/cache/apt/archives</code>. Vid för lite utrymme avbryts processen tidigt med ett tydligt meddelande så att den inte misslyckas mitt i en apt-transaktion.",
|
||||
"<strong>Kontroll av paketförråd.</strong> <code>ensure_repositories</code> läser förråd och abonnemangsstatus. Med ett användbart Proxmox-förråd ändras inget. En värd utan aktivt abonnemang som bara använder Enterprise måste bekräfta bytet till no-subscription; ett nej avslutar uppdateringen.",
|
||||
"<strong>apt update med automatisk GPG-återställning.</strong> Vid <code>NO_PUBKEY</code> för ett paketförråd, även ett från tredje part, importerar arbetsskriptet den saknade nyckeln och försöker igen innan det rapporterar ett fel.",
|
||||
"<strong>Väntande uppdateringar och säkerhetsuppdateringar.</strong> Visar hur många paket som kommer att ändras och hur många som kommer från säkerhetssviten, så att bekräftelsedialogen visar konkreta antal.",
|
||||
"<strong>Bekräftelsedialog.</strong> Efter uppdatering av paketlistorna kräver arbetsskriptet ett uttryckligt ja innan paketen uppdateras.",
|
||||
"<strong>apt full-upgrade.</strong> Använder <code>DEBIAN_FRONTEND=noninteractive</code> och <code>--force-confdef --force-confold</code>. Dpkg följer standardåtgärden för konfigurationsfiler när en sådan finns och behåller annars den befintliga filen.",
|
||||
"<strong>LVM-kontroll.</strong> <code>lvm_repair_check</code> uppdaterar volymgruppernas metadata när diskar som genomkopplats till gäst-VM:er (DSM, TrueNAS eller lagringsapparater) återkommer med gamla PV-huvuden.",
|
||||
"<strong>DKMS-ombyggnad för ProxMenux-hanterade drivrutiner.</strong> När en ny kärna är klar läser <code>pmx_rebuild_dkms_after_kernel</code> de ProxMenux-installerade drivrutinerna i <code>components_status.json</code> (för närvarande <code>nvidia_driver</code> → modul <code>nvidia</code> och <code>coral_driver</code> → modul <code>gasket</code>), installerar matchande kärnheaders (<code>proxmox-headers-<newkver></code> om de finns, annars <code>pve-headers-<newkver></code>) och kör <code>dkms autoinstall -k <newkver></code>. Om <code>dkms status</code> därefter inte visar moduler byggda för den nya kärnan körs respektive installationsprogram igen med <code>--auto-reinstall</code>. Fel loggas men avbryter inte uppdateringen, som ändå når omstartsfrågan.",
|
||||
"<strong>Efterföljande städning.</strong> <code>apt-get autoremove</code> + <code>apt-get autoclean</code> innan kontrollen lämnas tillbaka till huvudskriptet."
|
||||
]
|
||||
},
|
||||
"post": {
|
||||
"heading": "Rensning och omstart efter uppdatering",
|
||||
"intro": "När arbetsskriptet har avslutats kör huvudskriptet:",
|
||||
"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": "Huvudskriptet kontrollerar också om en omstart behövs. Var och en av följande signaler utlöser frågan:",
|
||||
"items": [
|
||||
"<code>/var/run/reboot-required</code> finns: ett paket eller systemverktyg har markerat att värden behöver startas om.",
|
||||
"Det senaste installerade Proxmox-kärnpaketet skiljer sig från kärnan som körs, enligt <code>dpkg-query</code> och uname -r."
|
||||
],
|
||||
"outro": "Om något av villkoren uppfylls frågar en whiptail-dialog <em>”Vissa ändringar kräver en omstart. Vill du starta om nu?”</em>. Avböj för att fortsätta med den aktuella kärnan tills du startar om manuellt, till exempel under ett planerat underhållsfönster."
|
||||
},
|
||||
"end": {
|
||||
"heading": "Vad du ser i slutet",
|
||||
"intro": "När arbetsskriptet är klart visar terminalen resultatet av städningen och omstartsfrågan om en omstart behövs:",
|
||||
"imageAlt": "Slutsammanfattning för Proxmox systemuppdatering med städningsresultat och omstartsfråga"
|
||||
},
|
||||
"calloutDeclineReboot": {
|
||||
"title": "Skjut bara upp omstarten om du har ett tydligt skäl",
|
||||
"body": "När du installerar ett nytt paket av typen <code>proxmox-kernel-*</code> ersätts den kärna som körs först efter en omstart. Den nya kärnan och dess matchande moduler aktiveras vid nästa start. Planera omstarten till ett lämpligt underhållsfönster och granska eventuella DKMS-byggvarningar i förväg."
|
||||
},
|
||||
"noSub": {
|
||||
"heading": "Så hanterar arbetsskriptet Enterprise-förrådet",
|
||||
"intro": "Proxmox aktiverar Enterprise-förrådet som standard. Utan ett aktivt abonnemang returnerar det 401 vid <code>apt-get update</code>. Arbetsskriptet ändrar förråden endast i detta fall och efter bekräftelse, via Proxmox API som används av <em>Node → Updates → Repositories</em>. De olika fallen:",
|
||||
"items": [
|
||||
"Med ett <strong>aktivt abonnemang</strong> behålls förråden och Enterprise tillhandahåller uppdateringarna.",
|
||||
"Om <strong>no-subscription- eller testförrådet redan är aktiverat</strong> behålls förråden, oavsett vilka andra källor som har konfigurerats.",
|
||||
"Med <strong>inget aktivt abonnemang och enbart Enterprise-förrådet</strong> erbjuder en dialog ett byte. Om du accepterar inaktiveras Enterprise, no-subscription aktiveras och paketlistorna uppdateras. Ändringen registreras i vyn <em>Changes</em> i Audit & Report. Ett nej avslutar uppdateringen utan att ändra källorna.",
|
||||
"Befintliga <strong>Enterprise-källor för Ceph</strong> inaktiveras vid samma byte utan att någon annan Ceph-kanal väljs. En värd som använder Ceph konfigurerar dess kanal separat.",
|
||||
"Om <strong>ingen terminal finns för bekräftelsen</strong> ändras inga källor och uppdateringen avslutas med ett meddelande som hänvisar till <em>Node → Updates → Repositories</em>."
|
||||
],
|
||||
"outro": "Debians källor och övriga filer för paketförråd ändras aldrig av det här flödet. En post som blandar Enterprise med andra komponenter byts inte: uppdateringen avbryts och ber dig dela upp posten i Proxmox vy för paketförråd."
|
||||
},
|
||||
"cluster": {
|
||||
"heading": "Att tänka på för kluster",
|
||||
"calloutTitle": "På kluster: uppdatera en nod i taget",
|
||||
"calloutBody": "Kör det här alternativet på <strong>en nod i taget</strong> i ett Proxmox-kluster och vänta tills omstarten är klar innan du fortsätter. Migrera först gäster från noden för att undvika tjänsteavbrott i hela klustret. Olika mindre versioner, till exempel 8.4.1 och 8.4.5, kan köras parallellt under några timmar. Olika kärnor kan ge oväntat beteende för HA-hanterade gäster."
|
||||
},
|
||||
"doesnt": {
|
||||
"heading": "Vad det inte gör",
|
||||
"items": [
|
||||
"<strong>Uppgradering av huvudversion.</strong> 8 → 9 är en separat åtgärd; se <link>Uppgradera PVE 8 till PVE 9</link>.",
|
||||
"<strong>Säkerhetskopiering.</strong> Inga ögonblicksbilder eller automatisk återgång. Apt-åtgärder är inte transaktionella. Behåll dina vanliga säkerhetskopieringsrutiner (PBS, vzdump, ZFS-ögonblicksbilder).",
|
||||
"<strong>Uppdateringar av containrar / VM:er.</strong> Bara värden uppdateras; gästerna lämnas oförändrade.",
|
||||
"<strong>Separat firmwareflashning.</strong> Detta är inget verktyg för att flasha BIOS eller enheters firmware. Installerade paket för firmware eller CPU-mikrokod kan fortfarande uppdateras via apt."
|
||||
]
|
||||
},
|
||||
"troubleshooting": {
|
||||
"heading": "Felsökning",
|
||||
"items": [
|
||||
{
|
||||
"title": "apt update misslyckas med 401 Unauthorized",
|
||||
"body": "Enterprise-förrådet är aktiverat utan ett aktivt abonnemang. Före <code>apt-get update</code> erbjuder arbetsskriptet ett byte till no-subscription. Om du avböjde kan du köra uppdateringen igen och acceptera, eller inaktivera Enterprise i <em>Node → Updates → Repositories</em> och aktivera no-subscription."
|
||||
},
|
||||
{
|
||||
"title": "dist-upgrade fastnar vid \"Configuring grub-pc\"",
|
||||
"body": "Om en interaktiv GRUB-fråga visas frågar den vilka enheter som ska få starthanteraren. Alternativet <code>--force-confold</code> gäller konfigurationsfiler, inte det här enhetsvalet. Välj lämpliga startdiskar med <kbd>Tab</kbd> + <kbd>Space</kbd> och sedan OK. Du kan konfigurera valet i förväg med <code>dpkg-reconfigure grub-pc</code>."
|
||||
},
|
||||
{
|
||||
"title": "Kärnan har uppgraderats men nya moduler saknas för en extern drivrutin",
|
||||
"body": "För hanterade drivrutiner (<code>nvidia_driver</code> och <code>coral_driver</code>) kör hjälpfunktionen <code>dkms autoinstall -k <newkver></code> och kan försöka igen med deras installationsprogram och <code>--auto-reinstall</code>. Kontrollera resultatet med <code>dkms status</code>. Kommandot autoinstall kan också bygga om andra registrerade DKMS-moduler. Reservvägen via installationsprogram är begränsad till de hanterade posterna i <code>components_status.json</code>. Granska tredjepartsmoduler som fortfarande saknas och bygg om dem med <code>dkms autoinstall</code> vid behov."
|
||||
},
|
||||
{
|
||||
"title": "Omstartsfrågan visades inte trots att en ny kärna installerades",
|
||||
"body": "Signalerna är alternativ: <code>/var/run/reboot-required</code> eller en skillnad mellan den kärna som körs och den senaste installerade Proxmox-kärnan. Huvudskriptet tolkar inte linux-image-poster i apt-loggen. Kontrollera den aktuella versionen med <code>uname -r</code> och installerade kärnpaket med <code>dpkg-query</code>. Planera en nödvändig omstart eller kör <code>shutdown -r now</code> när du är redo."
|
||||
}
|
||||
]
|
||||
},
|
||||
"files": {
|
||||
"heading": "Filer involverade",
|
||||
"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": "Relaterat",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/upgrade-pve8-pve9",
|
||||
"label": "Uppgradera PVE 8 till PVE 9",
|
||||
"tail": " — för uppgraderingen av huvudversion med ett annat verktyg och en annan säkerhetsmodell."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils/system-utils",
|
||||
"label": "Installationsprogram för systemverktyg",
|
||||
"tail": " — för att installera användbara CLI-verktyg för uppdateringar (htop / btop / ncdu)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils",
|
||||
"label": "Verktygsöversikt",
|
||||
"tail": " — tillbaka till avsnittsöversikten."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,252 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Installationsprogram för systemverktyg | ProxMenux-dokumentation",
|
||||
"description": "Installationsprogram för CLI-verktyg i Proxmox VE, med 25 paket i den gemensamma listan (htop, btop, iperf3, tmux, ...). Eget urval, installation av allt och fördefinierade grupper (grundläggande, utveckling, komprimering, multiplexrar, analys, nätverk). Grupper kan innehålla fler paket. Använder ensure_repositories + install_single_package.",
|
||||
"ogTitle": "Installationsprogram för systemverktyg | ProxMenux-dokumentation",
|
||||
"ogDescription": "Installera utvalda CLI-verktyg i Proxmox VE med ett klick eller eget urval."
|
||||
},
|
||||
"header": {
|
||||
"title": "Installationsprogram för systemverktyg",
|
||||
"description": "Välj bland 25 CLI-verktyg i den gemensamma listan PROXMENUX_UTILS. Erbjuder eget urval, installation av allt, sex fördefinierade grupper och installationskontroll. Grupper kan innehålla verktyg utanför listan. De gemensamma funktionerna ensure_repositories() + install_single_package() ger enhetlig hantering av paketförråd och återkoppling per paket.",
|
||||
"section": "Verktyg"
|
||||
},
|
||||
"info": {
|
||||
"title": "Vad detta gör",
|
||||
"body": "Installerar CLI-verktyg från en lista med 25 paket. Varje installation följer samma flöde: <code>ensure_repositories</code> kontrollerar att värden har ett användbart Proxmox-förråd för den aktuella PVE-huvudversionen; sedan installerar <code>install_single_package</code> paketet och kontrollerar att kommandot finns i PATH."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Öppna installationsprogrammet",
|
||||
"intro": "Från menyn Utilities väljer du <strong>System Utilities Installer</strong>. Huvudmenyn erbjuder nio alternativ:",
|
||||
"imageAlt": "Menyn för installation av systemverktyg med eget urval, ALL, fördefinierade grupper och verifiering"
|
||||
},
|
||||
"actions": {
|
||||
"heading": "Menyns 9 åtgärder",
|
||||
"headerOption": "Alternativ",
|
||||
"headerBehaviour": "Beteende",
|
||||
"rows": [
|
||||
{
|
||||
"option": "1. Anpassat urval",
|
||||
"behaviourRich": "Urvalslista med alla 25 paket. Använd SPACE för att markera och ENTER för att bekräfta; bara valda paket installeras."
|
||||
},
|
||||
{
|
||||
"option": "2. Installera alla verktyg",
|
||||
"behaviourRich": "Installerar alla paket i <code>PROXMENUX_UTILS</code> i ett steg. Använd efter en ny Proxmox-installation."
|
||||
},
|
||||
{
|
||||
"option": "3. Grundläggande",
|
||||
"behaviourRich": "<code>grc</code>, <code>htop</code>, <code>tree</code>, <code>curl</code>, <code>wget</code>"
|
||||
},
|
||||
{
|
||||
"option": "4. Utveckling",
|
||||
"behaviourRich": "<code>git</code>, <code>vim</code>, <code>nano</code>"
|
||||
},
|
||||
{
|
||||
"option": "5. Kompression",
|
||||
"behaviourRich": "<code>zip</code>, <code>unzip</code>, <code>rsync</code>"
|
||||
},
|
||||
{
|
||||
"option": "6. Terminalmultiplexrar",
|
||||
"behaviourRich": "<code>screen</code>, <code>tmux</code>"
|
||||
},
|
||||
{
|
||||
"option": "7. Analys",
|
||||
"behaviourRich": "<code>jq</code>, <code>ncdu</code>, <code>iotop</code>"
|
||||
},
|
||||
{
|
||||
"option": "8. Nätverk",
|
||||
"behaviourRich": "<code>iperf3</code>, <code>nethogs</code>, <code>nmap</code>, <code>tcpdump</code>, <code>lsof</code>"
|
||||
},
|
||||
{
|
||||
"option": "9. Verifiera installationer",
|
||||
"behaviourRich": "Går igenom varje post i <code>PROXMENUX_UTILS</code>, kontrollerar om verifieringskommandot finns i PATH och visar en sammanfattning med Tillgängligt / Saknas."
|
||||
}
|
||||
]
|
||||
},
|
||||
"packages": {
|
||||
"heading": "De 25 paketen",
|
||||
"intro": "Definieras i den gemensamma filen <code>scripts/global/utils-install-functions.sh</code> som <code>PROXMENUX_UTILS</code> (format: <code>package:verify_command:description</code>). Andra ProxMenux-skript, till exempel de som startar iftop / iptraf-ng / iperf3, återanvänder posterna så att paket och verifieringskommandon hålls samordnade.",
|
||||
"headerPackage": "Paket",
|
||||
"headerVerify": "Verifieringskommando",
|
||||
"headerDescription": "Beskrivning",
|
||||
"rows": [
|
||||
{
|
||||
"package": "axel",
|
||||
"verify": "axel",
|
||||
"description": "Nedladdningsaccelerator"
|
||||
},
|
||||
{
|
||||
"package": "aria2",
|
||||
"verify": "aria2c",
|
||||
"description": "Nedladdare med flera källor"
|
||||
},
|
||||
{
|
||||
"package": "btop",
|
||||
"verify": "btop",
|
||||
"description": "Modern resursövervakning"
|
||||
},
|
||||
{
|
||||
"package": "cabextract",
|
||||
"verify": "cabextract",
|
||||
"description": "Extrahera CAB filer"
|
||||
},
|
||||
{
|
||||
"package": "chntpw",
|
||||
"verify": "chntpw",
|
||||
"description": "Redigera Windows-registret / lösenord"
|
||||
},
|
||||
{
|
||||
"package": "dos2unix",
|
||||
"verify": "dos2unix",
|
||||
"description": "Konvertera DOS / Unix textfiler"
|
||||
},
|
||||
{
|
||||
"package": "genisoimage",
|
||||
"verify": "genisoimage",
|
||||
"description": "Skapa ISO-bilder"
|
||||
},
|
||||
{
|
||||
"package": "grc",
|
||||
"verify": "grc",
|
||||
"description": "Allmän färgmarkering av loggar"
|
||||
},
|
||||
{
|
||||
"package": "htop",
|
||||
"verify": "htop",
|
||||
"description": "Interaktiv processvisare"
|
||||
},
|
||||
{
|
||||
"package": "iftop",
|
||||
"verify": "iftop",
|
||||
"description": "Realtidsnätverksanvändning"
|
||||
},
|
||||
{
|
||||
"package": "intel-gpu-tools",
|
||||
"verify": "intel_gpu_top",
|
||||
"description": "Intel GPU verktyg"
|
||||
},
|
||||
{
|
||||
"package": "iotop",
|
||||
"verify": "iotop",
|
||||
"description": "Övervaka diskarnas in- och utmatning"
|
||||
},
|
||||
{
|
||||
"package": "iperf3",
|
||||
"verify": "iperf3",
|
||||
"description": "Testning av nätverkets bandbredd"
|
||||
},
|
||||
{
|
||||
"package": "ipset",
|
||||
"verify": "ipset",
|
||||
"description": "Hantera mängder av IP-adresser"
|
||||
},
|
||||
{
|
||||
"package": "iptraf-ng",
|
||||
"verify": "iptraf-ng",
|
||||
"description": "Verktyg för nätverksövervakning"
|
||||
},
|
||||
{
|
||||
"package": "libguestfs-tools",
|
||||
"verify": "virt-filesystems",
|
||||
"description": "Verktyg för VM-diskar"
|
||||
},
|
||||
{
|
||||
"package": "msr-tools",
|
||||
"verify": "rdmsr",
|
||||
"description": "Åtkomst till processorns MSR-register"
|
||||
},
|
||||
{
|
||||
"package": "net-tools",
|
||||
"verify": "netstat",
|
||||
"description": "Äldre nätverksverktyg"
|
||||
},
|
||||
{
|
||||
"package": "plocate",
|
||||
"verify": "locate",
|
||||
"description": "Hitta filer snabbt"
|
||||
},
|
||||
{
|
||||
"package": "s-tui",
|
||||
"verify": "s-tui",
|
||||
"description": "Stress-Terminal UI"
|
||||
},
|
||||
{
|
||||
"package": "sshpass",
|
||||
"verify": "sshpass",
|
||||
"description": "Icke-interaktiv SSH inloggning"
|
||||
},
|
||||
{
|
||||
"package": "tmux",
|
||||
"verify": "tmux",
|
||||
"description": "Terminalmultiplexer"
|
||||
},
|
||||
{
|
||||
"package": "unzip",
|
||||
"verify": "unzip",
|
||||
"description": "Extrahera ZIP-filer"
|
||||
},
|
||||
{
|
||||
"package": "wimtools",
|
||||
"verify": "wimlib-imagex",
|
||||
"description": "Hantera WIM-avbildningar"
|
||||
},
|
||||
{
|
||||
"package": "zip",
|
||||
"verify": "zip",
|
||||
"description": "Skapa ZIP-filer"
|
||||
}
|
||||
]
|
||||
},
|
||||
"howItWorks": {
|
||||
"heading": "Så installeras ett enskilt paket",
|
||||
"items": [
|
||||
"<code>ensure_repositories</code> identifierar PVE 8 eller 9 och läser paketförråden via Proxmox API. Med ett användbart Proxmox-förråd ändras inget. En värd utan aktivt abonnemang som bara använder Enterprise måste bekräfta ett byte till no-subscription; <code>apt-get update</code> körs efter ett godkänt byte.",
|
||||
"<code>install_single_package \"pkg\" \"verify_cmd\" \"description\"</code> kör <code>apt-get install -y \"$pkg\"</code> med feedback (<code>msg_info</code> / <code>msg_ok</code> / <code>msg_error</code>)."
|
||||
],
|
||||
"verifyIntro": "Efter installationen kontrolleras verifieringskommandot med <code>command -v \"$verify_cmd\"</code>. Tre resultat:",
|
||||
"verifyOutcomes": [
|
||||
"<strong>0 (lyckat):</strong> kommandot finns tillgängligt och paketet räknas som <em>Lyckat</em>.",
|
||||
"<strong>1 (misslyckat):</strong> apt misslyckades och paketet räknas som <em>Misslyckat</em>.",
|
||||
"<strong>2 (varning):</strong> apt lyckades men det förväntade kommandot hittades inte i PATH; paketet räknas som <em>Med varningar</em>."
|
||||
],
|
||||
"summary": "Efter en gruppinstallation eller ett eget urval visar en dialog antalet <em>Lyckade / Med varningar / Misslyckade</em>."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Verifiera installationer",
|
||||
"intro": "Alternativ 9 är skrivskyddat: det går igenom <code>PROXMENUX_UTILS</code> och kör <code>command -v</code> för varje verifieringskommando. Utdata ser ut så här:",
|
||||
"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": "Användbart innan du kör skript som behöver verktygen. Till exempel kräver <code>uup_dump_iso_creator.sh</code> kommandona <code>aria2c</code> + <code>cabextract</code> + <code>wimlib-imagex</code>. Om något saknas kan du installera motsvarande grupp eller välja de saknade paketen själv."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Felsökning",
|
||||
"reposTitle": "”Kunde inte konfigurera paketförråden. Installationen avbröts.”",
|
||||
"reposBody": "Kontrollen av paketförråd misslyckades: bytet till no-subscription avböjdes, abonnemangsstatusen kunde inte läsas eller en post kräver åtgärd. Föregående meddelande anger orsaken. Förråden visas i <em>Node → Updates → Repositories</em>; <code>apt-get update</code> i en konsol visar apt-felet.",
|
||||
"warningsTitle": "Ett paket rapporteras \"Med varningar\" men kommandot fungerar när jag stänger menyn",
|
||||
"warningsBody": "Efter <code>apt-get install</code> kör hjälpfunktionen <code>hash -r</code>, väntar kort och kontrollerar det förväntade kommandot med <code>command -v</code>. En varning betyder att kontrollen fortfarande misslyckades, utan att ange orsaken. Prova ett nytt skal och kontrollera paketinstallationen och PATH om kommandot fortfarande saknas.",
|
||||
"hangsTitle": "En apt-installation fastnar",
|
||||
"hangsBody": "En debconf-fråga är sannolikt dold av den tysta utmatningen. Skriptet använder <code>DEBIAN_FRONTEND=noninteractive</code> vid apt-anrop, vilket vanligen undviker frågor, men vissa paket kräver ändå inmatning. Avbryt med <kbd>Ctrl</kbd>+<kbd>C</kbd> och kör <code>apt-get install -y <pkg></code> manuellt i ett skal för att se frågan och välja åtgärd."
|
||||
},
|
||||
"files": {
|
||||
"heading": "Filer involverade",
|
||||
"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": "Relaterat",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/system-update",
|
||||
"label": "Proxmox systemuppdatering",
|
||||
"tailRich": " — för den faktiska <code>apt dist-upgrade</code> på värden."
|
||||
},
|
||||
{
|
||||
"href": "/docs/network/monitoring",
|
||||
"label": "Verktyg för liveövervakning (nätverk)",
|
||||
"tailRich": " - använder iftop / iptraf-ng / iperf3 från samma lista."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils",
|
||||
"label": "Verktygsöversikt",
|
||||
"tailRich": " — tillbaka till avsnittsöversikten."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,335 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Uppgradera PVE 8 till PVE 9 | ProxMenux-dokumentation",
|
||||
"description": "Tre sätt att uppgradera Proxmox VE 8 till 9 (Debian Bookworm till Trixie och PVE 8 till 9): automatiskt, interaktivt eller manuellt enligt Proxmox officiella anvisningar. Kontroller med pve8to9, ändrade paketkällor, dist-upgrade och slutkontroll. Körning från webbterminalen blockeras.",
|
||||
"ogTitle": "Uppgradera PVE 8 till PVE 9 | ProxMenux-dokumentation",
|
||||
"ogDescription": "Tre metoder (automatisk, interaktiv och manuell) för att uppgradera Proxmox VE 8 till 9."
|
||||
},
|
||||
"header": {
|
||||
"title": "Uppgradera PVE 8 till PVE 9",
|
||||
"description": "Uppgraderar Proxmox VE 8 till 9 enligt de officiella anvisningarna: Debian Bookworm till Trixie och PVE 8 till 9. Välj automatisk, interaktiv eller manuell metod, eller en separat förkontroll. Webbterminalen blockeras eftersom en bruten anslutning under uppgraderingen kan göra värden obrukbar.",
|
||||
"section": "Verktyg"
|
||||
},
|
||||
"dangerCallout": {
|
||||
"title": "En uppgradering till en ny huvudversion kan inte ångras",
|
||||
"intro": "Åtgärden ersätter Debian-basen (Bookworm → Trixie) och Proxmox-komponenterna på det befintliga systemet. Det finns <strong>ingen återgång till den gamla versionen</strong>. Innan du börjar:",
|
||||
"items": [
|
||||
"<strong>Verifierade säkerhetskopior</strong> av varje VM och CT (PBS, vzdump, ZFS-ögonblicksbilder — kontrollera även att de går att återställa).",
|
||||
"<strong>Åtkomst via konsol / IPMI / iKVM</strong> till värden om SSH kopplas ned under uppgraderingen.",
|
||||
"Värden ska redan vara uppdaterad till aktuell PVE 8.4.x, vilket skriptet kontrollerar.",
|
||||
"Ceph (om den finns) på version 19.x Squid.",
|
||||
"Minst <strong>5 GB ledigt</strong> i rotfilsystemet."
|
||||
]
|
||||
},
|
||||
"modeMenu": {
|
||||
"heading": "Menyn för val av läge",
|
||||
"intro": "Alternativet öppnar en meny med fyra val: Automatiskt, Interaktivt, Förkontroll och Manuell guide. Tre alternativ <em>utför</em> uppgraderingen eller visar hur den görs; den separata kontrollen <em>verifierar</em> förutsättningarna och kan erbjuda reparationer.",
|
||||
"imageAlt": "Meny för uppgradering av PVE 8 till 9 med automatiskt och interaktivt läge, förkontroll och manuell guide"
|
||||
},
|
||||
"threeWays": {
|
||||
"heading": "Tre sätt att uppgradera",
|
||||
"intro": "Automatiskt och interaktivt läge följer samma förlopp med förkontroller och slutkontroll. Skillnaden är hur dpkg-frågor under <code>dist-upgrade</code> besvaras. Den manuella guiden visar kommandona inklusive kontrollerna; du ansvarar för att utföra varje steg.",
|
||||
"auto": {
|
||||
"title": "Automatiskt / Utan tillsyn",
|
||||
"summary": "Anger <code>ASSUME_YES=1</code> + <code>DEBIAN_FRONTEND=noninteractive</code>. För ändrade konfigurationsfiler använder dpkg sin standardåtgärd om den finns; annars <strong>behålls den befintliga filen</strong> (<code>--force-confold</code>).",
|
||||
"items": [
|
||||
"Snabbast — ingen väntan på svar",
|
||||
"Passar standardinstallationer utan anpassade konfigurationsfiler",
|
||||
"Risk: en anpassad konfiguration behålls utan fråga och kan dölja nya standardvärden"
|
||||
]
|
||||
},
|
||||
"interactive": {
|
||||
"title": "Interaktiv",
|
||||
"summary": "Samma förlopp, men du besvarar varje dpkg-fråga om konfigurationskonflikter. Långsammare, med full insyn.",
|
||||
"items": [
|
||||
"Du ser varje konfig konflikt och bestämmer",
|
||||
"Bäst när du har anpassat <code>/etc/lvm</code>, <code>/etc/ssh</code>, etc.",
|
||||
"Rådfråga tabellen rekommenderade svar i manuell procedur nedan"
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"title": "Manuell uppgraderingsguide",
|
||||
"summary": "Visar det officiella Proxmox-förfarandet i 17 steg utan att köra det. Kör kommandona själv i ett separat skal.",
|
||||
"items": [
|
||||
"Maximal kontroll - du skriver varje kommando",
|
||||
"Bäst när du vill lära dig förfarandet eller du litar på ingenting",
|
||||
"Skriptet visar stegen; ingenting utförs automatiskt"
|
||||
]
|
||||
}
|
||||
},
|
||||
"precheckCallout": {
|
||||
"title": "Plus en separat Pre-check",
|
||||
"body": "Alternativ 3 — <strong>Kör kontroll för PVE 8 till 9</strong> — kör Proxmox officiella <code>pve8to9 --full</code>, erbjuder guidade reparationer för vanliga problem och <strong>avslutas sedan</strong>. Använd det före uppgraderingen eller efter manuella reparationer. Automatiskt och interaktivt läge kör också kontrollen; den manuella guiden säger åt dig att köra den själv."
|
||||
},
|
||||
"webTerminal": {
|
||||
"heading": "Varför webbterminalen blockeras",
|
||||
"body": "Alla tre lägen upptäcker <code>termproxy</code> / <code>vncshell</code> i kedjan av överordnade processer och vägrar starta. Webbterminalen beror på <code>pveproxy</code>, en tjänst som uppdateras under förloppet. När <code>pveproxy</code> startas om avslutas terminalsessionen och skriptet i den. Värden kan då bli endast delvis uppgraderad.",
|
||||
"warningTitle": "Använd SSH eller fysisk konsol / IPMI / iKVM",
|
||||
"warningBody": "SSH är det vanligaste valet. Kör det i <code>tmux</code> eller <code>screen</code> så att uppgraderingen klarar korta nätavbrott. Om skriptet upptäcker ett vanligt SSH-skal visas först en påminnelse om tmux/screen."
|
||||
},
|
||||
"auto": {
|
||||
"heading": "Automatiskt läge / Utan tillsyn",
|
||||
"intro": "Vanliga bekräftelser och frågor om konfigurationsfiler använder de valda standardsvaren. Blockerande fel i förkontrollen kan fortfarande kräva åtgärder. Använd läget för standardinstallationer eller efter att ha granskat hur standardsvaren påverkar dina anpassade filer.",
|
||||
"behaviourHeading": "Beteende i automatiskt läge",
|
||||
"behaviourTable": {
|
||||
"settingHeader": "Inställning",
|
||||
"effectHeader": "Effekt",
|
||||
"rows": [
|
||||
{
|
||||
"settingRich": "<code>ASSUME_YES=1</code>",
|
||||
"effectRich": "Intern inställning — bekräftar automatiskt skriptets ja/nej-frågor"
|
||||
},
|
||||
{
|
||||
"settingRich": "<code>DEBIAN_FRONTEND=noninteractive</code>",
|
||||
"effectRich": "apt / dpkg körs utan debconf-frågor"
|
||||
},
|
||||
{
|
||||
"settingRich": "<code>--force-confdef</code>",
|
||||
"effectRich": "För orörda konfigfiler: installera underhållarens nya version"
|
||||
},
|
||||
{
|
||||
"settingRich": "<code>--force-confold</code>",
|
||||
"effectRich": "För ändrade filer: dpkg:s standardåtgärd om den finns; annars <strong>behåll din version</strong>."
|
||||
}
|
||||
]
|
||||
},
|
||||
"flowHeading": "Förlopp i automatiskt läge",
|
||||
"flowIntro": "Sex faser i följd. Tidiga faser kan uppdatera PVE 8-paket och skriva konfiguration för paketkällor. Ett fel stoppar förloppet men återställer inte ändringarna. Fas 5 kör <code>dist-upgrade</code> till PVE 9.",
|
||||
"flowDiagram": "1. KONTROLLER\nBlockera termproxy / vncshell; avvisa PVE 9; kontrollera utrymme och anslutning.\nKräv Ceph 19.x Squid om det är installerat.\npve8to9 --full (kan erbjuda reparationer).\n\n2. FÖRBERED PVE 8\nscripts/global/update-pve8.sh\nUppdatera PVE 8-paket; systemctl restart pve-manager.\n\n3. ÄNDRA PAKETKÄLLOR\nBookworm → Trixie; skriv deb822-filer .sources.\nKommentera bort gamla .list-filer; apt-get update.\n\n4. KONTROLLERA PVE 9-KANDIDATEN\napt-cache policy proxmox-ve\napt-get -s dist-upgrade\nStoppa om kandidaten inte är 9.x eller om proxmox-ve skulle tas bort.\n\n5. UPPGRADERA\napt-get -y -o Dpkg::Options::='--force-confdef' -o Dpkg::Options::='--force-confold' dist-upgrade\nLogg: /var/log/pve8-a-pve9-'<'timestamp'>'.log\n\n6. KONTROLLERA OCH STARTA OM\nEFI: apt install grub-efi-amd64\npve8to9 --full; granska resultatet och frågan om omstart.",
|
||||
"preflightHeading": "Förkontroll: vad som kontrolleras",
|
||||
"preflightTable": {
|
||||
"checkHeader": "Kontroll",
|
||||
"whyHeader": "Varför det spelar roll",
|
||||
"rows": [
|
||||
{
|
||||
"checkRich": "<strong>Webbterminalblock</strong>",
|
||||
"whyRich": "Förhindrar att uppgraderingen avslutar skalet som kör den"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong> Redan på 9.x</strong>",
|
||||
"whyRich": "Avslutas om värden redan kör PVE 9 — inget behöver göras"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>Senaste versionen av PVE 8.4.x</strong>",
|
||||
"whyRich": "Uppdaterar först PVE 8 till senaste korrigeringsnivån med PVE 8-skriptet; gamla 8.x-versioner har andra förutsättningar"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>pve8to9 --full</strong>",
|
||||
"whyRich": "Proxmox egen kontroll av uppgraderingskraven; FAIL-fel blockerar uppgraderingen tills de åtgärdats"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>Diskutrymme</strong>",
|
||||
"whyRich": "≥ 1024 MB ledigt i <code>/var/cache/apt/archives</code> för hämtade .deb-filer"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>Anslutning</strong>",
|
||||
"whyRich": "Ping till <code>download.proxmox.com</code> — om det misslyckas startar inte uppgraderingen"
|
||||
},
|
||||
{
|
||||
"checkRich": "<strong>Ceph 19.x Squid</strong>",
|
||||
"whyRich": "Installerat Ceph måste redan vara 19.x. PVE 9 fungerar inte med Ceph 17/18. Alternativen <code>--ignore-ceph-check</code> och <code>--warn-ceph-check</code> kringgår kontrollen; använd dem endast om du förstår följderna."
|
||||
}
|
||||
]
|
||||
},
|
||||
"distUpgradeHeading": "Kommandot dist-upgrade (automatiskt läge)",
|
||||
"distUpgradeCode": "apt-get -y \\\n -o Dpkg::Options::='--force-confdef' \\\n -o Dpkg::Options::='--force-confold' \\\n dist-upgrade",
|
||||
"distUpgradeOutro": "Utdata visas i realtid på stdout och sparas även i <code>/var/log/pve8-a-pve9-<timestamp>.log</code>. Allt är synligt; endast frågorna hoppas över.",
|
||||
"postHeading": "Åtgärder efter uppgraderingen (automatiskt läge)",
|
||||
"postItems": [
|
||||
"<strong>EFI-värdar:</strong> installerar <code>grub-efi-amd64</code> enligt det kända problemet i Proxmox dokumentation. Uppgraderingen installerar inte paketet automatiskt och det kan behövas vid nästa start.",
|
||||
"<strong>När <code>pve-manager</code> startas om.</strong> Den uttryckliga omstarten ingår i förberedelsen av PVE 8, före paketuppgraderingen till Trixie/PVE 9.",
|
||||
"<strong>Kör <code>pve8to9 --full</code> igen.</strong> Visar kvarstående problem. Vid FAIL-fel visas samma reparationsmeny som under förkontrollen.",
|
||||
"<strong>Fråga om omstart.</strong> Omstart rekommenderas för att läsa in den nya kärnan och tjänsterna. Avböj endast av ett konkret skäl: det innebär risker att använda den gamla kärnan efter ett huvudversionsbyte."
|
||||
]
|
||||
},
|
||||
"interactive": {
|
||||
"heading": "Interaktivt läge",
|
||||
"intro": "Samma förlopp som <autolink>automatiskt läge</autolink>: samma förkontroller, ändrade paketkällor och slutkontroll. Skillnaden gäller <code>dist-upgrade</code>: <strong>du besvarar själv varje dpkg-fråga om konfigurationskonflikter</strong>. ProxMenux kör <code>apt-get dist-upgrade</code> utan alternativen <code>--force-conf*</code>.",
|
||||
"distUpgradeHeading": "kommandot för dist-upgrade (interaktivt läge)",
|
||||
"distUpgradeCode": "apt-get dist-upgrade\n# (user answers each dpkg config-file conflict prompt as it appears)",
|
||||
"whenHeading": "När interaktivt är rätt val",
|
||||
"whenItems": [
|
||||
"Du har anpassat <code>/etc/lvm/lvm.conf</code>, <code>/etc/ssh/sshd_config</code>, <code>/etc/default/grub</code> eller någon annan konfigfil som blir rörd av uppgraderingen.",
|
||||
"Du vill se vilka paket som orsakar konflikter och fatta beslut för varje fil.",
|
||||
"Du uppgraderar en produktionsvärd där någon dold förändring är oacceptabel."
|
||||
],
|
||||
"promptCalloutTitle": "Vad du ska svara på varje fråga",
|
||||
"promptCalloutBody": "Samma rekommendationer gäller som för det manuella förfarandet: se <dpkglink>Rekommenderade svar på dpkg-frågor</dpkglink> nedan. Ange <strong>D</strong> för att se skillnaderna eller <strong>Z</strong> för att öppna ett skal."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Manuellt uppgraderingsförfarande",
|
||||
"intro": "Detta visar menyalternativet <strong>Manuell uppgraderingsguide</strong>: <wikilink>Proxmox officiella wiki för uppgradering från 8 till 9</wikilink>, uppdelad i fyra faser. Skriptet <em>visar</em> kommandona; du kör dem själv i ett separat root-skal. Varje steg är synligt.",
|
||||
"rootCalloutTitle": "Alla kommandon kräver root",
|
||||
"rootCalloutBody": "Använd ett root-skal för kommandona, även för omdirigeringar och here-dokument. Med <code>sudo</code> måste hela kommandot köras med root-behörighet.",
|
||||
"phase1Heading": "Fas 1 - Förberedelse",
|
||||
"phase1Intro": "Uppdatera värden till senaste PVE 8.4.x, verifiera version och Ceph om det används, kör Proxmox förkontroll och starta en terminalmultiplexer för att klara avbrutna anslutningar.",
|
||||
"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": "Fas 2 — Ändra paketkällor",
|
||||
"phase2Intro": "Byt från Bookworm till Trixie i alla Debian- och Proxmox-paketkällor och konvertera Proxmox-källorna till deb822. <strong>Välj steg 7 ELLER 8</strong> beroende på Enterprise-abonnemang. Hoppa över steg 9 om du inte använder Ceph.",
|
||||
"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": "Fas 3 — dist-upgrade",
|
||||
"phase3Intro": "Själva uppgraderingen. Steg 12 är valfritt men rekommenderas för att minska audit-meddelanden. Steg 13 tar längre tid: besvara dpkg-frågorna enligt tabellen. Steg 13.1 gäller endast EFI och följer de officiellt kända problemen.",
|
||||
"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": "Rekommenderade svar för dpkg-prompts",
|
||||
"dpkgIntro": "Rekommendationer från Proxmox: <strong>Y</strong> installerar paketunderhållarens nya fil och skriver över din; <strong>N</strong> behåller din befintliga fil. Granska skillnaderna först om du är osäker:",
|
||||
"dpkgTable": {
|
||||
"fileHeader": "Fil / prompt",
|
||||
"answerHeader": "Rekommenderat svar",
|
||||
"whyHeader": "Varför",
|
||||
"rows": [
|
||||
{
|
||||
"fileRich": "/etc/issue",
|
||||
"answerRich": "<strong>N</strong> (behåll befintlig fil)",
|
||||
"whyRich": "Banner du är van vid att se",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "/etc/lvm/lvm.conf",
|
||||
"answerRich": "<strong>Y</strong> (paketunderhållarens version)",
|
||||
"whyRich": "PVE 9 behöver de nya LVM-standardvärdena",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "/etc/ssh/sshd_config",
|
||||
"answerRich": "<strong>Y</strong> om endast standardändringar finns; granska anpassade filer först",
|
||||
"whyRich": "Granska lokala SSH-inställningar och säkerställ åtkomsten innan filen ersätts. Standardändringarna omfattar omdöpta alternativ och kommentarer.",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "/etc/default/grub",
|
||||
"answerRich": "<strong>N</strong> om anpassad",
|
||||
"whyRich": "Här finns startparametrar, till exempel IOMMU och PCI-genomkoppling",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "/etc/chrony/chrony.conf",
|
||||
"answerRich": "<strong>Y</strong> om oförändrad; bevara lokala inställningar först",
|
||||
"whyRich": "Trixie uppdaterar standardvärdena för tidssynkronisering. Flytta lokala inställningar till chronys conf.d / sources.d innan den nya filen godtas.",
|
||||
"fileFont": true
|
||||
},
|
||||
{
|
||||
"fileRich": "Omstart av tjänster under uppgraderingen",
|
||||
"answerRich": "<strong>Ja</strong> (standard)",
|
||||
"whyRich": "Startar om de flesta tjänster utan att starta om värden",
|
||||
"fileFont": false
|
||||
},
|
||||
{
|
||||
"fileRich": "<code>apt-listchanges</code>",
|
||||
"answerRich": "Tryck på <kbd>q</kbd>",
|
||||
"whyRich": "Avslutar endast textvisaren; informationen är en sammanfattning av ändringsloggen",
|
||||
"fileFont": false
|
||||
}
|
||||
]
|
||||
},
|
||||
"inspectCalloutTitle": "Inspektera en specifik dpkg-konflikt",
|
||||
"inspectCalloutBody": "Vid en dpkg-fråga om konfigurationsfiler visar <strong>D</strong> skillnaderna mellan din fil och den nya versionen; <strong>Z</strong> öppnar ett skal för närmare granskning. Då kan du fatta ett underbyggt beslut.",
|
||||
"phase4Heading": "Fas 4 - Post-upgrade",
|
||||
"phase4Intro": "Verifiera att uppgraderingen slutförts, starta om med PVE 9-kärnan och kontrollera versionen. Därefter kan kvarvarande gamla <code>.list</code>-filer konverteras till 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": "Kluster och Ceph",
|
||||
"clusterCalloutTitle": "Cluster: uppgradera noder en i taget",
|
||||
"clusterCalloutBody": "Identifieras med <code>pvecm status</code>. <strong>Uppgradera inte</strong> flera noder samtidigt. Flytta gästerna, uppgradera noden, starta om och verifiera klustermedlemskapet innan du fortsätter. Under uppgraderingen fungerar livemigrering från äldre till nyare PVE-versioner; motsatt riktning stöds normalt inte. HA-grupper omvandlas automatiskt till HA-regler när alla noder kör PVE 9.",
|
||||
"cephCalloutTitle": "Ceph: uppgradera Ceph FÖRST, sedan Proxmox",
|
||||
"cephCalloutBody": "Ceph måste redan köra 19.x Squid före Proxmox-uppgraderingen. Följ den officiella ordningen Quincy 17 → Reef 18 → Squid 19: uppdatera paket och starta om Ceph-demoner stegvis i dokumenterad ordning. Kontrollera <code>ceph --version</code> före varje Proxmox-nod. Fullständigt förfarande: <cephlink>wikin för uppgradering av Ceph Reef till Squid</cephlink>."
|
||||
},
|
||||
"troubleshooting": {
|
||||
"heading": "Felsökning",
|
||||
"items": [
|
||||
{
|
||||
"title": "Skriptet avbryts: \"This script cannot be executed from the Proxmox web terminal\"",
|
||||
"bodyRich": "Öppna en SSH-anslutning eller använd konsol / IPMI / iKVM och kör igen. Starta först <code>tmux new -s pveupgrade</code> för att klara korta nätavbrott."
|
||||
},
|
||||
{
|
||||
"title": "pve8to9 rapporterar FAIL och reparationsalternativ 1 ger \"command not found\"",
|
||||
"bodyRich": "Om felet nämner <code>configure_repositories</code> är skriptkopian gammal: aktuell reparation använder cleanup_duplicate_repos och ensure_repositories. Uppdatera kopian eller granska de manuella kommandona med alternativ 2. <code>apt-get update</code> uppdaterar paketlistor men löser inte alla blockerande kontroller."
|
||||
},
|
||||
{
|
||||
"title": "apt-simuleringen varnar för \"proxmox-ve will be REMOVED\"",
|
||||
"bodyRich": "De nya paketkällorna är oåtkomliga eller kodnamnet har inte ändrats. Kontrollera <code>cat /etc/apt/sources.list.d/proxmox.sources</code>: raden <code>Suites:</code> ska ange <code>trixie</code> i stället för <code>bookworm</code>. <code>apt-cache policy proxmox-ve</code> ska visa en 9.x-kandidat från den nya källan."
|
||||
},
|
||||
{
|
||||
"title": "dist-upgrade misslyckas under körningen",
|
||||
"bodyRich": "Kör <code>apt-get -f install</code> för att lösa brutna beroenden, kör sedan om uppgraderingen. Om det misslyckas, kolla in loggen på <code>/var/log/pve8-a-pve9-<timestamp>.log</code> - de sista raderna brukar ange det förolämpande paketet. Starta inte om förrän <code>dpkg -l | grep ^iU</code> returnerar tomma (inga halvinstallerade paket)."
|
||||
},
|
||||
{
|
||||
"title": "EFI värd kommer inte starta efter omstart",
|
||||
"bodyRich": "Installationen av <code>grub-efi-amd64</code> efter uppgraderingen hanterar detta. Om steget hoppades över eller misslyckades, starta Proxmox-ISO:n i räddningsläge, montera rotfilsystemet, använd chroot och kör <code>apt-get install grub-efi-amd64 && update-grub</code>."
|
||||
},
|
||||
{
|
||||
"title": "GUI laddas inte efter uppgradering",
|
||||
"bodyRich": "Kör <code>systemctl status pveproxy</code> och <code>systemctl restart pveproxy</code>. Om problemet kvarstår, leta efter felet med <code>journalctl -u pveproxy -b</code>."
|
||||
},
|
||||
{
|
||||
"title": "Nätverk fungerar inte efter omstart",
|
||||
"bodyRich": "Kontrollera att <code>/etc/network/interfaces</code> anger befintliga enheter och att <code>ifupdown2</code> är installerat: <code>apt install ifupdown2</code>. Om namnen ändrats, se <netlink>Beständiga gränssnittsnamn</netlink>."
|
||||
},
|
||||
{
|
||||
"title": "Cluster split-brain efter att ha uppgraderat en nod",
|
||||
"bodyRich": "Blandade PVE 8 / PVE 9-kluster stöds under uppgraderingen. Livemigrering från äldre till nyare versioner fungerar; motsatt riktning stöds normalt inte. Om noden visas som frånkopplad, kontrollera <code>corosync</code> och QDevice-/nätverkskonfigurationen. Kör <code>pvecm status</code> på varje nod för att bekräfta kvorum."
|
||||
}
|
||||
]
|
||||
},
|
||||
"files": {
|
||||
"heading": "Filer involverade",
|
||||
"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": "Officiella referenser",
|
||||
"intro": "Skriptets manuella förfarande följer dessa officiella källor. Vid osäkerhet under en uppgradering gäller den officiella wikin: ProxMenux hjälper dig att utföra stegen, men Proxmox är referensen.",
|
||||
"items": [
|
||||
{
|
||||
"href": "https://pve.proxmox.com/wiki/Upgrade_from_8_to_9",
|
||||
"title": "Uppgradera från 8 till 9",
|
||||
"desc": "Den viktigaste Proxmox wiki sida för 8 → 9 uppgradering. Sanningens källa för varje kommando i det manuella förfarandet ovan."
|
||||
},
|
||||
{
|
||||
"href": "https://pve.proxmox.com/wiki/Ceph_Reef_to_Squid",
|
||||
"title": "Uppgradering till Ceph Squid (19.x)",
|
||||
"desc": "Obligatoriskt förberedande steg för hyperkonvergerade Ceph-noder. Ceph måste köra 19.x Squid före PVE 9."
|
||||
},
|
||||
{
|
||||
"href": "https://pve.proxmox.com/wiki/Roadmap",
|
||||
"title": "Utvecklingsplan för Proxmox VE",
|
||||
"desc": "Versionsinformation för PVE 9 och ändringar sedan 8.x — läs före uppgraderingen."
|
||||
},
|
||||
{
|
||||
"href": "https://www.debian.org/releases/trixie/releasenotes",
|
||||
"title": "Versionsinformation för Debian Trixie",
|
||||
"desc": "PVE 9 bygger på Debian Trixie. Debians versionsinformation beskriver ändringar i operativsystemet som även påverkar din värd."
|
||||
},
|
||||
{
|
||||
"href": "https://forum.proxmox.com/forums/proxmox-ve-installation-and-configuration.16/",
|
||||
"title": "Proxmox VE installationsforum",
|
||||
"desc": "Om något går fel under uppgraderingen, sök först i forumet. Någon kan redan ha stött på samma problem."
|
||||
},
|
||||
{
|
||||
"href": "https://pve.proxmox.com/wiki/Backup_and_Restore",
|
||||
"title": "Säkerhetskopiering och återställning",
|
||||
"desc": "En storversionsuppgradering är inte reversibel. Kontrollera din backup disciplin innan du börjar."
|
||||
}
|
||||
]
|
||||
},
|
||||
"video": {
|
||||
"heading": "Videoguide",
|
||||
"intro": "Föredrar att titta på uppgraderingen kör slut innan du gör det själv? Denna genomgång visar ProxMenux uppgraderingsflöde i realtid.",
|
||||
"title": "ProxMenux — Videoguide för att uppgradera Proxmox VE 8 till 9",
|
||||
"caption": "Extern YouTube-video. Spelas i utökat integritetsläge, utan cookies tills du startar videon."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relaterat",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/utils/system-update",
|
||||
"label": "Proxmox systemuppdatering",
|
||||
"tail": " — för vanliga uppdateringar inom samma huvudversion (8.4.1 → 8.4.5 osv.)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils",
|
||||
"label": "Verktygsöversikt",
|
||||
"tail": " — tillbaka till avsnittets översikt."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,161 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "UUP Dump ISO-skapare | ProxMenux-dokumentation",
|
||||
"description": "Skapa en aktuell Windows-installations-ISO på Proxmox-värden med ProxMenux UUP Dump ISO-skapare. Automatiserar installation av beroenden, nedladdning och konvertering av UUP-filer till en startbar ISO för att skapa en VM.",
|
||||
"ogTitle": "UUP Dump ISO-skapare | ProxMenux-dokumentation",
|
||||
"ogDescription": "Skapa en aktuell Windows-ISO med UUP Dump och ProxMenux. Beroenden, nedladdning och konvertering hanteras helt automatiskt.",
|
||||
"ogImageAlt": "ProxMenux — UUP Dump ISO-skapare"
|
||||
},
|
||||
"header": {
|
||||
"title": "UUP Dump ISO-skapare",
|
||||
"description": "Skapa en aktuell Windows-installations-ISO på Proxmox-värden med UUP Dump. ProxMenux hanterar beroenden, laddar ner UUP-filer parallellt, kör UUP Dump-konverteraren och flyttar ISO-filen till den valda utdatakatalogen. Standardvalet är den identifierade ISO-lagringen i Proxmox.",
|
||||
"section": "Verktyg"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Vad skriptet gör",
|
||||
"body": "Ange en URL som uupdump.net skapar efter val av version, språk och utgåva. Skriptet installerar saknade beroenden, laddar ner UUP Dump-konverteraren och UUP-filerna, skapar en startbar Windows-ISO och flyttar den till den valda utdatakatalogen. Den identifierade ISO-lagringen i Proxmox föreslås som standardmål."
|
||||
},
|
||||
"hero": {
|
||||
"imageAlt": "UUP Dump ISO Creator i ProxMenux-menyn",
|
||||
"caption": "UUP Dump ISO Creator i ProxMenux-menyn"
|
||||
},
|
||||
"what": {
|
||||
"heading": "Vad är UUP Dump?",
|
||||
"intro": "UUP Dump är en communitytjänst som låter dig ladda ner de ursprungliga Unified Update Platform-filerna (UUP) som Windows Update använder för att distribuera Windows. Filerna kan sammanställas till en vanlig startbar ISO. Det ger dig:",
|
||||
"items": [
|
||||
"Den senaste Windows-versionen, inklusive Insider Preview-kanaler.",
|
||||
"En viss äldre version som inte längre visas på Microsofts nedladdningssida.",
|
||||
"Rena, omodifierade filer som kommer direkt från Microsofts servrar.",
|
||||
"Den exakta kombinationen av utgåvor och språk du vill ha i en enda ISO."
|
||||
],
|
||||
"learnMore": "Läs mer på <extlink>UUP Dump-projektsidan</extlink>."
|
||||
},
|
||||
"automates": {
|
||||
"heading": "Vad skriptet automatiserar"
|
||||
},
|
||||
"dependencies": {
|
||||
"heading": "Beroenden",
|
||||
"intro": "Skriptet kontrollerar först verktygen som behövs för att ladda ner UUP-filer och skapa ISO-filen. Verktyg som saknas installeras med <code>apt-get</code>:",
|
||||
"headerPackage": "Paket",
|
||||
"headerRole": "Funktion",
|
||||
"rows": [
|
||||
{
|
||||
"pkg": "curl",
|
||||
"roleRich": "HTTP-nedladdningar för att starta konverteraren."
|
||||
},
|
||||
{
|
||||
"pkg": "aria2",
|
||||
"roleRich": "Parallell nedladdning av alla UUP-filer."
|
||||
},
|
||||
{
|
||||
"pkg": "cabextract",
|
||||
"roleRich": "Extraherar Microsoft CAB-paket."
|
||||
},
|
||||
{
|
||||
"pkg": "wimtools",
|
||||
"roleRich": "Bygger <code>install.wim</code> (wimlib-imagex)."
|
||||
},
|
||||
{
|
||||
"pkg": "genisoimage",
|
||||
"roleRich": "Skriver den slutliga startbara ISO (eller <code>mkisofs</code>)."
|
||||
},
|
||||
{
|
||||
"pkg": "chntpw",
|
||||
"roleRich": "Ändrar Windows-registerfiler under skapandet."
|
||||
}
|
||||
],
|
||||
"manualIntro": "Manuell motsvarighet - om du någonsin behöver installera dem själv:",
|
||||
"manualCode": "apt-get install curl aria2 cabextract wimtools genisoimage chntpw"
|
||||
},
|
||||
"flow": {
|
||||
"heading": "Nedladdning och konvertering",
|
||||
"steps": [
|
||||
"Identifierar Proxmox ISO-lagring med <code>pvesm status -content iso</code> eller använder <code>/var/lib/vz/template/iso</code> som reserv.",
|
||||
"Begär en basmapp för tillfälliga filer (standard <code>/root/uup-temp</code>).",
|
||||
"Laddar ner UUP Dump-konverteraren från <code>git.uupdump.net</code>.",
|
||||
"Läser <code>id</code>, <code>pack</code> och <code>edition</code> från URL:en som du klistrar in.",
|
||||
"Anropar <code>https://uupdump.net/get.php?…&aria2=2</code> för att skapa en aria2-nedladdningslista.",
|
||||
"Laddar ner alla UUP-filer till <code>UUPs/</code> med aria2, parallellt och med möjlighet att återuppta.",
|
||||
"Kör <code>convert.sh wim UUPs 1</code> från omvandlaren för att producera den slutliga ISO.",
|
||||
"Flyttar ISO-filen till den valda utdatakatalogen och tar bort tillfälliga filer."
|
||||
]
|
||||
},
|
||||
"aria2": {
|
||||
"heading": "aria2-alternativ som används för nedladdning",
|
||||
"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> — upp till 16 anslutningar per server.",
|
||||
"<code>-s16</code> - delar upp varje fil i 16 segment.",
|
||||
"<code>-j5</code> — 5 filer som laddats ned parallellt.",
|
||||
"<code>-c</code> - återupptar partiella nedladdningar.",
|
||||
"<code>-R</code> — ger den nedladdade filen fjärrfilens tidsstämpel om den är tillgänglig."
|
||||
],
|
||||
"runtime": "En typisk körning tar omkring 10 minuter och beror framför allt på internetanslutningens hastighet och belastningen på UUP Dumps nedladdningsservrar."
|
||||
},
|
||||
"step1": {
|
||||
"heading": "Steg 1 · Få en UUP Dump URL",
|
||||
"intro": "Innan du kör skriptet behöver du en UUP Dump URL som innehåller <code>id</code>, <code>pack</code> och <code>edition</code> frågeparametrar. Skapa den på <extlink>uupdump.net</extlink>:",
|
||||
"stepBadge": "Steg",
|
||||
"items": [
|
||||
{
|
||||
"title": "Välj en Windows-version",
|
||||
"img": "/iso-creator/step-1-select-version-windows.png",
|
||||
"caption": "UUP Dump huvudsida - välj en Windows-version",
|
||||
"body": "Öppna UUP Dump hemsida och välj den Windows-version du vill ha."
|
||||
},
|
||||
{
|
||||
"title": "Välj en viss version",
|
||||
"img": "/iso-creator/step-2-select-version-windows.png",
|
||||
"caption": "Välj en viss version",
|
||||
"body": "Välj version: den senaste, en Insider Preview-kanal eller en viss äldre version som fortfarande visas."
|
||||
},
|
||||
{
|
||||
"title": "Välj ett språk",
|
||||
"img": "/iso-creator/step-3-select-version-windows.png",
|
||||
"caption": "Välj ett språk",
|
||||
"body": "Välj språket som ska ingå i ISO-filen."
|
||||
},
|
||||
{
|
||||
"title": "Välj utgåvor",
|
||||
"img": "/iso-creator/step-4-select-version-windows.png",
|
||||
"caption": "Välj utgåvorna att inkludera",
|
||||
"body": "Välj utgåvor för att bunta i ISO (Home, Pro, Enterprise, ...). Du kan kombinera flera."
|
||||
},
|
||||
{
|
||||
"title": "Kopiera URL",
|
||||
"img": "/iso-creator/step-5-select-version-windows.png",
|
||||
"caption": "Kopiera webbadressen från adressfältet",
|
||||
"bodyRich": "Kopiera URL:en <em>från webbläsarens adressfält</em> på den sista sidan. Den måste innehålla <code>id=…</code>, <code>pack=…</code> och <code>edition=…</code>. Det är den sträng som skriptet läser."
|
||||
}
|
||||
]
|
||||
},
|
||||
"step2": {
|
||||
"heading": "Steg 2 · Kör skaparen",
|
||||
"intro": "När URL:en är kopierad öppnar du ProxMenux och startar ISO-skaparen:",
|
||||
"stepBadge": "Steg",
|
||||
"items": [
|
||||
{
|
||||
"title": "Starta UUP Dump ISO Creator",
|
||||
"img": "/iso-creator/start-uupdump-iso-creator.png",
|
||||
"caption": "Starta UUP Dump ISO Creator från ProxMenux",
|
||||
"bodyRich": "Öppna <strong>Utilities → UUP Dump ISO Creator</strong> i ProxMenux. Skriptet kontrollerar beroenden och ISO-katalogen innan det frågar efter uppgifter."
|
||||
},
|
||||
{
|
||||
"title": "Klistra in UUP Dump-URL:en",
|
||||
"img": "/iso-creator/add-url-iso-creator.png",
|
||||
"caption": "Klistra in URL:en som du kopierade från uupdump.net",
|
||||
"body": "Klistra in URL:en i inmatningsdialogen. Skriptet kontrollerar att de tre obligatoriska parametrarna finns och avslutar ordnat om någon saknas."
|
||||
},
|
||||
{
|
||||
"title": "Vänta tills ISO-filen är klar",
|
||||
"img": "/iso-creator/end-uupdump-iso-creator.png",
|
||||
"caption": "Skapandet är klart: ISO-filen finns i Proxmox ISO-lagring",
|
||||
"bodyRich": "Konsolen visar aria2-förloppet och sedan konverterarens utdata. Den färdiga ISO-filen flyttas till den valda utdatakatalogen. Om den ligger i konfigurerad Proxmox ISO-lagring kan du välja den via <strong>Create VM → System Windows → Install with ISO from UUP Dump</strong>."
|
||||
}
|
||||
]
|
||||
},
|
||||
"tempFiles": {
|
||||
"title": "Tillfälliga filer",
|
||||
"body": "Den tillfälliga standardmappen är <code>/root/uup-temp</code>, med nedladdningar i <code>UUPs/</code> och konverteraren i <code>converter/</code>. En egen bassökväg får en separat sessionsunderkatalog. Grenarna för lyckat skapande och utebliven ISO-fil tar bort den tillfälliga sessionen. Tidigare fel eller avbrott kan lämna kvar tillfälliga filer."
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user