Kako nadgraditi Proxmox VE 7 na Proxmox VE 8

Ta vodnik opisuje nadgradnjo vozlišča Proxmox VE 7 na Proxmox VE 8 na mestu (in-place) z uporabo apt. Nadgradnja prestavi sistem z Debiana 11 Bullseye na Debian 12 Bookworm in zamenja jedro 5.15 z novejšim. Načrtujte izpad: vozlišče je treba znova zagnati vsaj enkrat, običajno dvakrat.

Warning

Proxmox VE 7 je dosegel konec podpore (EOL) konec julija 2024, Proxmox VE 8 pa je dosegel konec podpore 31. avgusta 2026. Nadgradnja na različico 8 je obvezen vmesni korak, vendar vas ne pusti na podprti izdaji. Po zaključku tega vodnika načrtujte naslednjo nadgradnjo na Proxmox VE 9.

Preden začnete

Zahteve

Preden se dotaknete katerega koli repozitorija, preverite naslednje:

vsa vozlišča uporabljajo najnovejše pakete Proxmox VE 7.4 (pve-manager 7.4-15 ali novejši);
vsaj 5 GB prostega prostora na korenskem datotečnem sistemu;
gruča je v dobrem stanju, če je vozlišče del gruče;
imate dostop do strežnika, ki ni odvisen od njegovega omrežja, na primer prek IP-KVM;
obstaja veljavna in preizkušena varnostna kopija vseh virtualnih strojev in vsebnikov.

Preverite prosti prostor na korenskem datotečnem sistemu:

df -h /

Warning

Pred nadgradnjo varnostno kopirajte vsak virtualni stroj in vsebnik ter se prepričajte, da je varnostne kopije mogoče obnoviti. Večja nadgradnja zamenja osnovni sistem, jedro in pakete zagonskega nalagalnika. Če gre kaj narobe, je obnovitev edina zanesljiva pot nazaj. Varnostne kopije hranite zunaj vozlišča, ki ga nadgrajujete, na primer na ločenem pomnilniku ali v storitvi INTROSERV Backup Service. Kopirajte tudi /etc/pve, /etc/network/interfaces, /etc/passwd in /etc/resolv.conf.

Info

Če imate hiperkonvergirano gručo Ceph, mora pred začetkom teči Ceph 17.2 Quincy. Različico preverite v podoknu Ceph vsakega vozlišča. Če gruča teče na različici Octopus ali Pacific, najprej nadgradite Ceph na Quincy in šele nato nadaljujte s tem vodnikom.

Info

Če je Proxmox Backup Server nameščen na istem gostitelju, ga pred nadgradnjo Proxmox VE nadgradite z različice 2 na različico 3. Sledite uradnemu vodniku za nadgradnjo Proxmox Backup Server z 2 na 3.

Kako se povezati z vozliščem

Danger

Večje nadgradnje ne izvajajte iz Shell (konzole) v spletnem vmesniku Proxmox VE. Spletno konzolo zagotavljajo storitve Proxmox VE, ki se med nadgradnjo znova zaženejo, zato bo seja sredi postopka prekinjena.

Povežite se prek SSH ali IP-KVM. Pri SSH zaženite sejo tmux, da se nadgradnja nadaljuje, če povezava pade:

apt update apt install tmux tmux new -s upgrade

Če se povezava izgubi, se znova povežite in se vrnite v sejo:

tmux attach -t upgrade

Najvarnejša možnost je IP-KVM, ker deluje tudi, če omrežje na vozlišču po ponovnem zagonu ne zaživi. Za povezavo z namenskim strežnikom prek IP-KVM glejte Povezava z IDRAC KVM ali Vodnik za dostop IP-KVM prek OpenVPN (strežniki DC2, DC3).

Virtualni stroji in vsebniki na vozlišču

Ugasnite virtualne stroje in vsebnike na vozlišču ali jih preselite na drugo vozlišče, če morajo še naprej delovati. Selitev s starejše različice Proxmox VE na novejšo je podprta. Selitev z novejše različice nazaj na starejšo ni podprta.

Info

Če je vozlišče del gruče, nadgrajujte vozlišča eno za drugim in pred nadgradnjo vsako vozlišče preklopite v način vzdrževanja. Način vzdrževanja prestavi goste, ki jih upravlja HA, na druga vozlišča: ha-manager crm-command node-maintenance enable <node>. Gostje, ki jih ne upravlja HA, se ne prestavijo samodejno, zato jih ročno preselite ali ugasnite. Ponovni zagon ne izklopi načina vzdrževanja. Ko je vozlišče nadgrajeno in znova zagnano, ga ročno izklopite: ha-manager crm-command node-maintenance disable <node>.

Korak 1. Nadgradnja Proxmox VE 7 na različico 7.4

Orodje za preverjanje pve7to8 in varna pot nadgradnje sta na voljo samo z najnovejšimi paketi 7.4. Posodobitve lahko namestite v spletnem vmesniku ali iz ukazne vrstice.

Konfiguracija repozitorijev

Odprite vozlišče v spletnem vmesniku in pojdite na Updates → Repositories.

Če nimate plačljive naročnine, izberite repozitorij pve-enterprise in kliknite Disable. Ta repozitorij zahteva naročniški ključ.

Kliknite Add, izberite No-Subscription in v pogovornem oknu kliknite Add.

Tip

Če imate plačljivo naročnino, obdržite repozitorij pve-enterprise in ta del preskočite.

Namestitev posodobitev

Pojdite na Updates in kliknite Refresh. Počakajte, da se seznam paketov posodobi.

Kliknite Upgrade. Odpre se okno terminala. Ko vas vpraša, ali želite nadaljevati, vnesite Y in pritisnite Enter.

Počakajte, da se postopek konča, in ne zapirajte okna. Na koncu izpis zahteva ponovni zagon vozlišča.

Ista posodobitev iz ukazne vrstice. Brez plačljive naročnine najprej onemogočite repozitorij enterprise in dodajte repozitorij no-subscription, kot v spletnem vmesniku zgoraj:

sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list echo "deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

Nato namestite posodobitve:

apt update apt dist-upgrade

Tip

Debian 11 ni več podprt in njegovi paketi bodo sčasoma morda premaknjeni z rednih zrcal na archive.debian.org. Če apt update za bullseye vrne napake 404, zamenjajte vrstice Debiana v /etc/apt/sources.list z:

deb http://archive.debian.org/debian bullseye main contrib deb http://archive.debian.org/debian-security bullseye-security main contrib

Te vrstice so potrebne samo za dokončanje Koraka 1. V Koraku 3 jih zamenjajte z vrsticami Bookworm, prikazanimi tam, namesto da zaženete sed.

Ponovni zagon in preverjanje različice

Znova zaženite vozlišče:

reboot

Ko se vozlišče zažene, osvežite stran v brskalniku in preverite različico v Summary vozlišča ali zaženite:

pveversion

Izpis mora prikazati 7.4-15 ali novejšo različico.

Korak 2. Zagon orodja za preverjanje pve7to8

Proxmox VE 7.4 vključuje skripto pve7to8. Ta le preveri sistem in poroča o težavah; ničesar ne spremeni. Zaženite jo z vključenimi vsemi preverjanji:

pve7to8 --full

Preglejte rezultat:

elemente FAIL je treba odpraviti pred nadgradnjo;
elemente WARN je treba prebrati in oceniti, tudi če nadgradnje ne blokirajo;
po vsakem popravku znova zaženite skripto, da potrdite, da je težava odpravljena.

Tip

Preden nadaljujete, odstranite pakete, vtičnike in module za shrambo tretjih oseb, ki jih Proxmox VE 8 ne podpira. Vtičnik za shrambo tretje osebe mora imeti različico, združljivo s Proxmox VE 8, sicer počakajte, da jo avtor izda.

Warning

Če je bil Proxmox VE nameščen na čist sistem Debian 11 in ne z ISO-slike Proxmox VE, preverite, ali je nameščen paket linux-image-amd64. Ta je v konfliktu s paketi jedra Proxmox VE in lahko povzroči, da apt poskuša odstraniti paket proxmox-ve. Odstranite ga, preden nadaljujete: apt remove linux-image-amd64.

Korak 3. Preklop repozitorijev na Bookworm

Repozitoriji Debiana

V glavnem seznamu virov zamenjajte Bullseye z Bookworm:

sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list

Če ste se v Koraku 1 preklopili na archive.debian.org, bi sed usmeril vrstice na pot Bookworm, ki v arhivu ne obstaja. Namesto tega vsebino /etc/apt/sources.list zamenjajte s standardnimi vrsticami za Debian 12:

deb http://deb.debian.org/debian bookworm main contrib deb http://deb.debian.org/debian bookworm-updates main contrib deb http://security.debian.org/debian-security bookworm-security main contrib

Nato se prepričajte, da v nobeni datoteki ni ostalo vnosov Bullseye:

grep -r bullseye /etc/apt/sources.list /etc/apt/sources.list.d/

Če ukaz najde vrstice, jih posodobite na Bookworm ali zakomentirajte z #. Odstranite vse vrstice backports: nadgradnja ni bila preizkušena s paketi iz backports.

Preverite tudi, da ni zadržanih (held) ali napol nameščenih paketov. Oba ukaza morata vrniti prazen izpis:

apt-mark showhold dpkg --audit

Repozitorij Proxmox VE

Ime datoteke repozitorija je odvisno od tega, kako je bil repozitorij dodan. Najprej izpišite datoteke:

ls /etc/apt/sources.list.d/

Brez naročnine posodobite datoteko, ki vsebuje vrstico pve-no-subscription. Na sistemu, nameščenem z ISO, je to običajno pve-install-repo.list:

sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list.d/pve-install-repo.list

Pravilna vrstica za Proxmox VE 8 brez naročnine je:

deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription

Na nekaterih sistemih vrstica za deb vsebuje tudi [arch=amd64]. To je v redu, pustite.

Prepričajte se, da je repozitorij enterprise onemogočen: če pve-enterprise.list obstaja, mora biti njegova vrstica zakomentirana z #, kot je po onemogočenju v Koraku 1.

S plačljivo naročnino zapišite repozitorij enterprise in se prepričajte, da v drugih datotekah ni ostala aktivna vrstica pve-no-subscription:

echo "deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise" > /etc/apt/sources.list.d/pve-enterprise.list

Repozitorij Ceph

Ta del preskočite, če Ceph na vozlišču ni nameščen.

S plačljivo naročnino:

echo "deb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise" > /etc/apt/sources.list.d/ceph.list

Brez naročnine:

echo "deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription" > /etc/apt/sources.list.d/ceph.list

Tip

Če apt update za repozitorij Ceph enterprise vrne napako 401, osvežite naročnino z pvesubscription update --force in poskusite znova.

Osvežitev indeksa paketov

apt update

Izpis ne sme vsebovati napak. Vsaka vrstica mora kazati na bookworm.

Korak 4. Nadgradnja sistema na Proxmox VE 8

Zaženite nadgradnjo:

apt dist-upgrade

Trajanje je odvisno od hitrosti korenskega diska: nekaj minut na SSD, do ene ure ali več na počasnem HDD.

Vprašanja med nadgradnjo

Če se na začetku odpre stran z opombami ob izdaji, pritisnite q, da jo zaprete, in nadaljujte.

Ko vas vpraša, ali naj se storitve med nadgradnjo paketov samodejno znova zaženejo, s puščičnimi tipkami izberite Yes in pritisnite Enter.

Vprašanja o konfiguracijskih datotekah

Med nadgradnjo apt vpraša, kaj storiti s konfiguracijskimi datotekami, ki ste jih spremenili tako vi kot paket. Pred odgovorom pritisnite D, da vidite razliko. Priporočeni odgovori za pogoste datoteke:

/etc/issue: obdržite svojo različico (N). Proxmox VE to datoteko ob zagonu znova ustvari, vpliva le na prijavni zaslon;
/etc/lvm/lvm.conf: namestite različico vzdrževalca paketa (Y), če datoteke niste urejali sami;
/etc/apt/sources.list.d/pve-enterprise.list: če apt vpraša o tej datoteki, obdržite svojo različico (N), sicer apt prepiše repozitorij, ki ste ga nastavili v Koraku 3;
/etc/ssh/sshd_config: če datoteke niste urejali, namestite različico vzdrževalca (Y), ki opuščeno možnost ChallengeResponseAuthentication nadomesti z KbdInteractiveAuthentication. Če ste nastavitve SSH spremenili sami, datoteki previdno primerjajte;
/etc/default/grub: to vprašanje se običajno pojavi le, če ste datoteko spremenili, na primer za dodajanje parametrov jedra. Preverite razliko; če niste prepričani, obdržite svojo različico (N).

Warning

Na sistemu, ki se zaganja v načinu UEFI s korenom na LVM, se GRUB po nadgradnji morda ne bo zagnal z napako disk 'lvmid/...' not found. Na takem sistemu pred ponovnim zagonom namestite pravilni paket GRUB:

[ -d /sys/firmware/efi ] && apt install grub-efi-amd64

Ta ukaz zaženite na sistemih UEFI, ki se zaganjajo z GRUB, kar je privzeto pri namestitvah z ISO-slike Proxmox VE s korenom na LVM. Na sistemu z BIOS-om legacy ne naredi ničesar. Preskočite ga, če je koren na ZFS: taki sistemi se zaganjajo prek proxmox-boot-tool in jih to ne zadeva.

Preverjanje rezultata

Ko se apt dist-upgrade konča brez napak, znova zaženite orodje za preverjanje:

pve7to8 --full

Pred ponovnim zagonom lahko orodje prikaže elemente WARN o jedru, ki trenutno teče, in o LXCFS, ki še uporablja staro knjižnico FUSE. To je pričakovano: oba izgineta, ko se v Koraku 5 znova zaženete v novo jedro. Elementov FAIL ne sme biti.

Korak 5. Ponovni zagon v novo jedro

Znova zaženite vozlišče. To je obvezno, tudi če ste na Proxmox VE 7 že uporabljali izbirno jedro 6.2:

reboot

Warning

Novo jedro lahko na nekaterih strojnih opremah preimenuje omrežne vmesnike. Če se vozlišče po ponovnem zagonu ne odziva v omrežju, se povežite prek IP-KVM, z ip link preverite trenutna imena vmesnikov in jih posodobite v /etc/network/interfaces. Nato konfiguracijo uveljavite z ifreload -a.

Korak 6. Preverjanje rezultata

Počistite predpomnilnik brskalnika ali prisilno znova naložite spletni vmesnik s Ctrl+Shift+R (Cmd+Shift+R v macOS). Različico preverite v Summary vozlišča ali z:

pveversion

Zaženite virtualne stroje in vsebnike ter preverite, ali delujejo. V gruči izklopite način vzdrževanja na vozlišču in nadaljujte z naslednjim vozliščem, pri čemer znova začnete s preverjanjem zahtev.

Info

Sistemi, ki se zaganjajo v načinu UEFI prek proxmox-boot-tool, običajno s korenom na ZFS in nameščeni z ISO, po nadgradnji prejmejo opozorilo pve7to8 o paketu systemd-boot. Paket namestite le, če orodje za preverjanje sporoči to opozorilo. Na drugih sistemih ni potreben, njegova namestitvena skripta pa lahko GRUB nadomesti kot zagonski nalagalnik.

Odpravljanje težav

Nadgradnja želi odstraniti proxmox-ve

Sporočilo W: (pve-apt-hook) You are attempting to remove the meta-package 'proxmox-ve'! pomeni, da je kak repozitorij še vedno nastavljen za Bullseye ali za Bookworm ne obstaja. Preverite vse datoteke v /etc/apt/sources.list.d/, popravite repozitorije in znova zaženite apt update. Odstranitve ne potrjujte.

Nadgradnja je bila prekinjena

Če se je povezava izgubila ali se je nadgradnja ustavila na pol poti, se znova povežite v sejo tmux ali se znova prijavite in zaženite:

dpkg --configure -a apt -f install apt dist-upgrade

Napake odvisnosti za pakete Ceph

Če apt dist-upgrade na vozlišču brez Ceph poroča o nezadovoljenih odvisnostih za pakete Ceph, dodajte repozitorij no-subscription za Ceph Quincy iz Koraka 3 in znova zaženite apt update. Nekateri paketi Proxmox VE ga lahko med nadgradnjo potrebujejo.

Vozlišče se ne zažene

Povežite se prek IP-KVM, da vidite napako pri zagonu. Za težave z GRUB glejte uradno stran Recover From Grub Failure.

Kaj sledi

Proxmox VE 8 ne prejema več posodobitev. Načrtujte nadgradnjo na Proxmox VE 9 na Debianu 13 Trixie, ki poteka po enakem postopku z orodjem za preverjanje pve8to9.

Če večjih nadgradenj raje ne izvajate sami, lahko strokovnjaki za sistemsko administracijo podjetja INTROSERV nadgradnjo načrtujejo in izvedejo namesto vas.