Proxmox VE 7, Proxmox VE 8'e nasıl yükseltilir

Bu kılavuz, bir Proxmox VE 7 düğümünün apt ile Proxmox VE 8'e yerinde (in-place) yükseltilmesini açıklar. Yükseltme, sistemi Debian 11 Bullseye'den Debian 12 Bookworm'a taşır ve 5.15 çekirdeğini daha yeni bir çekirdekle değiştirir. Kesinti süresi planlayın: düğümün en az bir kez, genellikle iki kez yeniden başlatılması gerekir.

Başlamadan önce

Gereksinimler

Herhangi bir depoya dokunmadan önce aşağıdakileri kontrol edin:

• tüm düğümler en son Proxmox VE 7.4 paketlerini çalıştırıyor (pve-manager 7.4-15 veya daha yeni);
• kök dosya sisteminde en az 5 GB boş alan var;
• düğüm bir kümenin parçasıysa küme sağlıklı durumda;
• sunucuya, ağına bağlı olmayan bir erişiminiz var, örneğin IP-KVM;
• tüm sanal makinelerin ve konteynerlerin geçerli ve test edilmiş bir yedeği mevcut.

Kök dosya sistemindeki boş alanı kontrol edin:

df -h /

Düğüme nasıl bağlanılır

SSH veya IP-KVM ile bağlanın. SSH ile bağlantı kopsa bile yükseltmenin devam etmesi için bir tmux oturumu başlatın:

apt update
apt install tmux
tmux new -s upgrade

Bağlantı kesilirse yeniden bağlanın ve oturuma dönün:

tmux attach -t upgrade

En güvenli seçenek IP-KVM'dir, çünkü düğümün ağı yeniden başlatmadan sonra gelmese bile çalışmaya devam eder. Özel bir sunucuya IP-KVM ile bağlanmak için IDRAC KVM'ye bağlanma veya OpenVPN üzerinden IP-KVM erişim kılavuzu (DC2, DC3 sunucuları) sayfalarına bakın.

Düğümdeki sanal makineler ve konteynerler

Düğümdeki sanal makineleri ve konteynerleri kapatın veya çalışmaya devam etmeleri gerekiyorsa başka bir düğüme taşıyın. Eski bir Proxmox VE sürümünden daha yeni bir sürüme taşıma desteklenir. Yeni bir sürümden eskisine geri taşıma desteklenmez.

Adım 1. Proxmox VE 7'yi 7.4 sürümüne yükseltin

pve7to8 denetleyicisi ve güvenli yükseltme yolu yalnızca en son 7.4 paketlerinde bulunur. Güncellemeleri web arayüzünde veya komut satırından yükleyebilirsiniz.

Depoları yapılandırın

Web arayüzünde düğümü açın ve Updates → Repositories bölümüne gidin.

Ücretli aboneliğiniz yoksa pve-enterprise deposunu seçin ve Disable düğmesine tıklayın. Bu depo bir abonelik anahtarı gerektirir.

Add düğmesine tıklayın, No-Subscription seçeneğini seçin ve iletişim kutusunda Add düğmesine tıklayın.

Güncellemeleri yükleyin

Updates bölümüne gidin ve Refresh düğmesine tıklayın. Paket listesi güncellenene kadar bekleyin.

Upgrade düğmesine tıklayın. Bir terminal penceresi açılır. Devam etmek isteyip istemediğiniz sorulduğunda Y yazın ve Enter tuşuna basın.

İşlemin bitmesini bekleyin ve pencereyi kapatmayın. Sonunda çıktı sizden düğümü yeniden başlatmanızı ister.

Aynı güncelleme komut satırından. Ücretli abonelik yoksa önce yukarıdaki web arayüzünde olduğu gibi enterprise deposunu devre dışı bırakın ve no-subscription deposunu ekleyin:

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

Ardından güncellemeleri yükleyin:

apt update
apt dist-upgrade

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

Bu satırlar yalnızca Adım 1'i tamamlamak için gereklidir. Adım 3'te sed çalıştırmak yerine bunları orada gösterilen Bookworm satırlarıyla değiştirin.

Yeniden başlatın ve sürümü kontrol edin

Düğümü yeniden başlatın:

reboot

Düğüm başladıktan sonra tarayıcı sayfasını yenileyin ve sürümü düğümün Summary bölümünde kontrol edin veya şunu çalıştırın:

pveversion

Çıktıda 7.4-15 veya daha yeni bir sürüm görünmelidir.

Adım 2. pve7to8 denetleyicisini çalıştırın

Proxmox VE 7.4, pve7to8 betiğini içerir. Yalnızca sistemi denetler ve sorunları raporlar; hiçbir şeyi değiştirmez. Tüm denetimler etkin olarak çalıştırın:

pve7to8 --full

Sonucu inceleyin:

• FAIL öğeleri yükseltmeden önce düzeltilmelidir;
• WARN öğeleri yükseltmeyi engellemese bile okunmalı ve değerlendirilmelidir;
• her düzeltmeden sonra sorunun giderildiğini doğrulamak için betiği yeniden çalıştırın.

Adım 3. Depoları Bookworm'a geçirin

Debian depoları

Ana kaynak listesinde Bullseye'i Bookworm ile değiştirin:

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

Adım 1'de archive.debian.org adresine geçtiyseniz, sed satırları arşivde bulunmayan bir Bookworm yoluna yönlendirir. Bunun yerine /etc/apt/sources.list içeriğini standart Debian 12 satırlarıyla değiştirin:

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

Ardından hiçbir dosyada Bullseye girdisi kalmadığından emin olun:

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

Komut satır bulursa bunları Bookworm'a güncelleyin veya # ile yorum satırı yapın. Tüm backports satırlarını kaldırın: yükseltme backports paketleriyle test edilmemiştir.

Ayrıca tutulan (held) veya yarım kurulmuş paket olmadığını kontrol edin. Her iki komut da boş çıktı vermelidir:

apt-mark showhold
dpkg --audit

Proxmox VE deposu

Depo dosyasının adı, deponun nasıl eklendiğine bağlıdır. Önce dosyaları listeleyin:

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

Abonelik yoksa pve-no-subscription satırını içeren dosyayı güncelleyin. ISO'dan kurulmuş bir sistemde bu genellikle pve-install-repo.list dosyasıdır:

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

Abonelik olmadan Proxmox VE 8 için doğru satır şudur:

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

Bazı sistemlerde satır, deb ifadesinden sonra [arch=amd64] da içerir. Bu normaldir, olduğu gibi bırakın.

Enterprise deposunun devre dışı olduğundan emin olun: pve-enterprise.list mevcutsa, satırı Adım 1'de devre dışı bıraktıktan sonraki gibi # ile yorum satırı yapılmış olmalıdır.

Ücretli abonelikle enterprise deposunu yazın ve diğer dosyalarda etkin bir pve-no-subscription satırı kalmadığından emin olun:

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

Ceph deposu

Düğümde Ceph kurulu değilse bu bölümü atlayın.

Ücretli abonelikle:

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

Abonelik olmadan:

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

Paket dizinini yenileyin

apt update

Çıktıda hata bulunmamalıdır. Her satır bookworm adresine işaret etmelidir.

Adım 4. Sistemi Proxmox VE 8'e yükseltin

Yükseltmeyi başlatın:

apt dist-upgrade

Süre kök diskin hızına bağlıdır: SSD'de birkaç dakika, yavaş bir HDD'de bir saate veya daha uzun süreye kadar.

Yükseltme sırasındaki istemler

Başlangıçta sürüm notlarının bulunduğu bir sayfa açılırsa, kapatmak için q tuşuna basın ve devam edin.

Paket yükseltmeleri sırasında hizmetlerin otomatik olarak yeniden başlatılıp başlatılmayacağı sorulduğunda, ok tuşlarıyla Yes seçeneğini seçin ve Enter tuşuna basın.

Yapılandırma dosyası istemleri

Yükseltme sırasında apt, hem sizin hem de paketin değiştirdiği yapılandırma dosyalarıyla ne yapılacağını sorar. Yanıt vermeden önce farkı görmek için D tuşuna basın. Yaygın dosyalar için önerilen yanıtlar:

• /etc/issue: kendi sürümünüzü koruyun (N). Proxmox VE bu dosyayı açılışta yeniden oluşturur, yalnızca oturum açma ekranını etkiler;
• /etc/lvm/lvm.conf: dosyayı kendiniz düzenlemediyseniz paket bakımcısının sürümünü kurun (Y);
• /etc/apt/sources.list.d/pve-enterprise.list: apt bu dosyayı sorarsa kendi sürümünüzü koruyun (N), aksi halde apt Adım 3'te yapılandırdığınız depoyu üzerine yazar;
• /etc/ssh/sshd_config: dosyayı düzenlemediyseniz bakımcının sürümünü kurun (Y), bu sürüm kullanımdan kaldırılmış ChallengeResponseAuthentication seçeneğini KbdInteractiveAuthentication ile değiştirir. SSH ayarlarını kendiniz değiştirdiyseniz dosyaları dikkatle karşılaştırın;
• /etc/default/grub: bu istem genellikle yalnızca dosyayı değiştirdiyseniz, örneğin çekirdek parametreleri eklemek için, görünür. Farkı kontrol edin; emin değilseniz kendi sürümünüzü koruyun (N).

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

Bu komutu GRUB ile önyükleme yapan UEFI sistemlerde çalıştırın; kökü LVM üzerinde olan Proxmox VE ISO kurulumlarında varsayılan durum budur. Eski (legacy) BIOS sistemde hiçbir şey yapmaz. Kök ZFS üzerindeyse atlayın: bu tür sistemler proxmox-boot-tool ile önyükleme yapar ve etkilenmez.

Sonucu kontrol edin

apt dist-upgrade hatasız tamamlandığında denetleyiciyi yeniden çalıştırın:

pve7to8 --full

Yeniden başlatmadan önce denetleyici, çalışan çekirdek ve LXCFS'nin hâlâ eski FUSE kütüphanesini kullanması hakkında WARN öğeleri gösterebilir. Bu beklenen bir durumdur: her ikisi de Adım 5'te yeni çekirdeğe yeniden başlattığınızda ortadan kalkar. FAIL öğesi olmamalıdır.

Adım 5. Yeni çekirdeğe yeniden başlatın

Düğümü yeniden başlatın. Proxmox VE 7'de isteğe bağlı 6.2 çekirdeğini zaten kullanmış olsanız bile bu gereklidir:

reboot

Adım 6. Sonucu kontrol edin

Tarayıcı önbelleğini temizleyin veya web arayüzünü Ctrl+Shift+R (macOS'ta Cmd+Shift+R) ile zorla yeniden yükleyin. Sürümü düğümün Summary bölümünde veya şu komutla kontrol edin:

pveversion

Sanal makineleri ve konteynerleri başlatın ve çalıştıklarını kontrol edin. Bir kümede düğümdeki bakım modunu kapatın ve gereksinim kontrolünden başlayarak bir sonraki düğümle devam edin.

Sorun giderme

Yükseltme proxmox-ve paketini kaldırmak istiyor

W: (pve-apt-hook) You are attempting to remove the meta-package 'proxmox-ve'! iletisi, bir deponun hâlâ Bullseye için yapılandırıldığı veya Bookworm için mevcut olmadığı anlamına gelir. /etc/apt/sources.list.d/ içindeki tüm dosyaları kontrol edin, depoları düzeltin ve apt update komutunu yeniden çalıştırın. Kaldırmayı onaylamayın.

Yükseltme yarıda kesildi

Bağlantı koptuysa veya yükseltme yarıda durduysa tmux oturumuna yeniden bağlanın ya da yeniden oturum açın ve şunu çalıştırın:

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

Ceph paketleri için bağımlılık hataları

Ceph olmayan bir düğümde apt dist-upgrade Ceph paketleri için karşılanmamış bağımlılıkları bildirirse, Adım 3'teki Ceph Quincy no-subscription deposunu ekleyin ve apt update komutunu yeniden çalıştırın. Bazı Proxmox VE paketleri yükseltme sırasında buna ihtiyaç duyabilir.

Düğüm önyükleme yapmıyor

Önyükleme hatasını görmek için IP-KVM ile bağlanın. GRUB sorunları için resmî Recover From Grub Failure sayfasına bakın.

Sırada ne var

Proxmox VE 8 artık güncelleme almıyor. Aynı prosedürü pve8to9 denetleyicisiyle izleyen, Debian 13 Trixie üzerindeki Proxmox VE 9'a yükseltmeyi planlayın.

Ana sürüm yükseltmelerini kendiniz yapmak istemezseniz, INTROSERV Sistem Yönetimi uzmanları yükseltmeyi sizin için planlayıp gerçekleştirebilir.