CentOS cPanel Sunucu Almalinux’e Nasıl Geçirilir?

Amaç cPanel ELevate Projesi, mevcut bir cPanel & WHM CentOS 7 sunucu kurulumunu AlmaLinux 8 veya Rocky Linux 8‘e yükseltmek için bir komut dosyası sağlar. Sorumluluk Reddi Bu depodaki yazılımların işlevselliğini garanti etmiyoruz. Bu depodan …

Yazan: Ahmet Çadırcı

Tarih:

Amaç

cPanel ELevate Projesi, mevcut bir cPanel & WHM CentOS 7 sunucu kurulumunu AlmaLinux 8 veya Rocky Linux 8‘e yükseltmek için bir komut dosyası sağlar.

Sorumluluk Reddi

Bu depodaki yazılımların işlevselliğini garanti etmiyoruz. Bu depodan yüklediğiniz herhangi bir yazılımın kullanımına ilişkin tüm riskleri üstlenirsiniz. Bu yazılımın yüklenmesi, deneyimli yöneticiler için bile önemli işlevsellik hatalarına neden olabilir.

Bununla birlikte, cPanel Teknik Destek yardım etmeye hazır! Sorunla karşılaşırsanız lütfen cPanel Teknik Destek ile iletişime geçin.

Giriş

Bu proje, RedHat tabanlı sistemlerin yerinde yükseltmeleri için oluşturulan LEAPP Projesine büyük ölçüde dayanan Alma Linux ELevate projesine dayanmaktadır.

Alma Linux ELevate projesi, dağıtım paketlerini CentOS 7‘den AlmaLinux 8 veya Rocky Linux 8‘e yükseltmede çok etkilidir. Ancak, doğrudan CentOS 7 tabanlı bir cPanel kurulumunda kullanmaya çalışırsanız, bozuk bir sistemle sonuçlanırsınız.

Bu proje, kesintileri en aza indirmek amacıyla bir cPanel kurulumunu başarıyla yükseltmenize izin vermek için Alma Linux ELevate projesi etrafında bir sarmalayıcı olarak tasarlanmıştır.

Mevcut yaklaşımımız aşağıdaki gibi özetlenebilir:

  1. Engelleyicileri kontrol edin
  2. yum update && reboot komutunu çalıştırın
  3. Bir cPanel sistemine genellikle yüklenen yazılımları analiz edin ve kaldırın (veri değil)
  4. AlmaLinux yükseltmesini gerçekleştirin
  5. Yükseltmeden önce tespit edilen önceki olarak kaldırılmış yazılımları yeniden yükleyin. Bunlar şunları içerebilir:
  • cPanel (upcp)
  • EA4
  • MySQL varyantları
  • Distro Perl/PECL binary yeniden yüklemeleri
  1. Son yeniden başlatma (tüm hizmetlerin yeni ikili dosyalar üzerinde çalıştığından emin olun)

Riskler

Her zamanki gibi, yükseltmeler veri kaybına veya davranış değişikliklerine neden olabilir ve sizi bozuk bir sistemle baş başa bırakabilir.

Başarısızlık durumları aşağıdakileri içerir, ancak bunlarla sınırlı değildir:

  • Özel sürücüler nedeniyle çekirdeği yükseltememe
  • Bu kod tabanının farkında olmadığı için yazılımın eksik yükseltilmesi.

Bu yükseltme, tüm yazılımların yükseltilmesi için 30-90 dakika kadar sürebilir. Bu sürenin çoğunda, sunucu işlevsiz ve erişilemez olacaktır. Harici sistemlerin beklenmedik bir şekilde başarısız olmak yerine daha sonra yeniden denemesini sağlamak için çoğu yazılımı devre dışı bırakmaya çalışıyoruz. Bununla birlikte, beklenmeyen hatalar nedeniyle bazı veri kaybı oluşabilecek küçük pencereler vardır.

Güncellemeden Önce

Güncellemeden önce lütfen tüm ön gereksinimleri karşıladığınızı kontrol edin:

  • Kök kullanıcı olarak etkileşimli bir kabuk erişiminiz olması gerekmektedir.
    • Birincil erişim yöntemi kullanılamaz durumlar için birden fazla formun bulunması kesinlikle önerilir.
    • Kabul edilebilir erişim biçimleri şunları içerir:
      • Sisteme kök SSH erişimi,
      • Doğrudan fiziksel konsol erişimi,
      • IPMI uzaktan konsol erişimi,
      • Hipervizör aracılığıyla sanal konsola erişim veya
      • Sunucu sağlayıcınız tarafından sağlanan bu yöntemlerden birine dayalı özel bir sistem kullanımı.
  • Bu yükseltmeyi denemeden önce sunucunuzu yedekleyin. Yükseltme işlemi, işlem devam etse bile bozuk bir sistemle sonuçlanacak koşulları tespit etmeye çalışır, ancak bu kusursuz değildir.
    • Bu yedeklemenin bir bütün sistem imajı veya anlık görüntü şeklinde olmasını kesinlikle öneririz.
      • Bu durumda kurtarma, sistemi o imajdan veya anlık görüntüden yüklemeyi içerir.
    • Sadece bireysel cPanel hesaplarının şeklindeki yedeklemeler, cPanel tarafından yönetilen verileri korur. Bu yedeklemeler, cPanel tarafından yönetilmeyen programları veya verileri korumaz veya yükseltme sürecinden kaynaklanan felaket durumlarında kullanımda kesintiyi en aza indirgeme olanağı sağlamaz. cPanel Yedekleme sistemi, bireysel cPanel hesaplarını yedekler.
      • Bu durumda kurtarma, mevcut sistemi silme, hedef işletim sistemini yükleme, yeni işletim sistemine cPanel’i yükleme, tüm sistem özelleştirmelerini yeni işletim sistemiyle uyumlu bir şekilde yeniden oluşturma ve cPanel hesaplarını yedekten geri yükleme işlemlerini içerir.
      • Yalnızca bireysel cPanel hesabı yedeklemelerinin yedekleme seçeneğiniz olduğu ve sürekli çalışma süresinin kritik bir düşünce olduğu durumlarda, başarısızlık durumunda ELevate kullanarak yerinde yükseltme yapmak yerine Transfer Aracı kullanarak yeni bir sisteme taşıma yapmanızı öneririz. Bu, başarısızlık durumunda geçiş üzerinde daha fazla kontrol sağlayacaktır.
    • Yedek hizmetinizin sisteminizin ne kadarını kapsadığını bilmiyorsanız, bu hizmetin sağlayıcısıyla iletişime geçerek daha fazla bilgi alabilirsiniz.
  • Sunucunuzun güncel olduğundan emin olun: yum update
  • En son kararlı sürümde cPanel & WHM kullanıyor olmanız gerekmektedir.
  • Hedef dağıtımla uyumlu bir MySQL/MariaDB sürümü kullanmalısınız.
  • Yükseltme işlemi sırasında oluşabilecek sorunlarda cPanel ile destek talebi açmak için gereken bilgileri not edin, çünkü bu bilgiler sistemden alınamaz hale gelebilir.

Daha fazla ön kontrol için betiği indirin ve ardından ön kontrolleri çalıştırın.

Karşılaşabileceğiniz bazı sorunlar şunları içerebilir:

  • Ana CentOS havuzunda bulunmayan x86_64 RPM’leri yükseltilir.
    • rpm -qa|grep el7
  • EA4 RPM’leri yanlışdır
    • EA4, C7/A8 üzerinde farklı bağımlılıklar ve bağlantılar sağlar
  • cPanel ikili dosyaları (cpanelsync) geçersizdir.
  • 3. taraf repo paketleri yükseltilmez (imunify 360, epel, …).
  • El ile yüklenen Perl XS (arch) CPAN yüklemeleri geçersizdir.
  • El ile yüklenen PECL yeniden derlenmelidir.
  • Cpanel::CachedCommand yanlıştır.
  • Cpanel::OS dağıtım ayarı yanlıştır.
  • MySQL artık yükseltilemeyebilir (MySQL sürümleri < 8.0 genellikle A8’de bulunmaz).
  • nobody kullanıcısı, A8’e yükseltildikten sonra bile UID 99’dan UID 65534’e geçmez.

Betiği kullanma

elevate-cpanel betiğini indirin

  • cPanel sunucunuzda çalıştırmak üzere betiğin bir kopyasını indirebilirsiniz:
wget -O /scripts/elevate-cpanel \    https://raw.githubusercontent.com/cpanel/elevate/release/elevate-cpanel ;chmod 700 /scripts/elevate-cpanel

Yükseltme öncesi kontroller

Yükseltme öncesi bilinen engelleyicileri kontrol etmenizi öneririz. Kontrol, sisteminize herhangi bir değişiklik yapmaz.

Sisteminizin AlmaLinux 8’ye yükseltilebilir olup olmadığını kontrol etmek için aşağıdakini çalıştırabilirsiniz:

# AlmaLinux 8 yükseltmesini kontrol etme (kuru çalıştırma modu)

/scripts/elevate-cpanel --check --upgrade-to=almalinux

Sisteminizin Rocky Linux 8’e yükseltilebilir olup olmadığını kontrol etmek için aşağıdakini çalıştırabilirsiniz:

# Rocky Linux 8 yükseltmesini kontrol etme (kuru çalıştırma modu)

/scripts/elevate-cpanel --check --upgrade-to=rocky

Yükseltme yapmak için

Sunucunuzun bir yedeğine sahip olduğunuzdan emin olun (cPanel elevate betiği yükseltmeden önce yedekleme yapmaz) ve Yükseltme öncesi kontrollerle yükseltme engelleyicilerini temizledikten sonra, göçe başlayabilirsiniz.

NOT Bu yükseltme 30 dakikadan fazla sürebilir. Sunucunuzun bu süre boyunca kapalı ve ulaşılamaz olduğunu kullanıcılarınıza bildirin.

AlmaLinux 8’e yükseltmek için aşağıdakini çalıştırabilirsiniz:

# AlmaLinux 8'e göçü başlatma

/scripts/elevate-cpanel --start --upgrade-to=almalinux

Rocky Linux 8’e yükseltmek için aşağıdakini çalıştırabilirsiniz:

# Rocky Linux 8'e göçü başlatma

/scripts/elevate-cpanel --start --upgrade-to=rocky

Komut satırı seçenekleri

# Yardımı okuyun (ve bu belgelerde belirtilen riskleri)
/scripts/elevate-cpanel --help

# Sunucunuzun yükseltme için hazır olup olmadığını kontrol edin (kuru çalıştırma modu)
/scripts/elevate-cpanel --check # defaults to AlmaLinux
/scripts/elevate-cpanel --check --upgrade-to=almalinux
/scripts/elevate-cpanel --check --upgrade-to=rocky

# Geçişi başlatın
/scripts/elevate-cpanel --start # defaults to AlmaLinux
/scripts/elevate-cpanel --start --upgrade-to=almalinux
/scripts/elevate-cpanel --start --upgrade-to=rocky

... # birden fazla yeniden başlatma bekleyin (~30 dakika)

# Mevcut durumu kontrol edin
/scripts/elevate-cpanel --status

# Yükseltme günlüğünü izleyin
/scripts/elevate-cpanel --log

# Hata olması durumunda, düzeltildikten sonra taşıma işlemine devam edebilirsiniz
/scripts/elevate-cpanel --continue

Yükseltme süreci özet

Yükseltme süreci, bir dizi aşamaya bölünmüştür. Her aşama, yükseltmenin bir bölümünden sorumludur. Her aşamadan önce bir yeniden başlatma gerçekleştirilir ve sonunda bir final yeniden başlatma yapılır.

Aşama 1

Birden fazla yeniden başlatmayı gerçekleştiren elevate-cpanel servisini yükleyerek yükseltme sürecini başlatın.

Aşama 2

Mevcut dağıtım paketlerini güncelleyin. cPanel hizmetlerini devre dışı bırakın ve motd’yi ayarlayın.

Aşama 3

elevate-release-latest-el7 havuzunu yapılandırın ve leapp paketlerini yükleyin. cPanel paketlerini güncelleme için hazırlayın.

Bazı bilinen çakışan paketleri kaldırın ve bazı mevcut yapılandırmaları yedekleyin (bu paketler, bir sonraki aşamada yeniden yüklenir).

Birkaç leapp sorusuna yanıtlar sağlayın.

leapp yükseltmesini gerçekleştirmeye çalışın.

Başarısızlık durumunda, muhtemelen birkaç ek soruya yanıt vermek veya bazı çakışan paketleri kaldırmak isteyeceksiniz.

Aşama 4

Bu aşamada, şimdi Alamalinux 8 (veya RockyLinux 8) çalıştırmamız gerekiyor. Yeni dağıtım için cPanel ürününü güncelleyin.

Önceki aşamada kaldırılan paketleri geri yükleyin.

Aşama 5

Bu, yükseltme sürecinin son aşamasıdır. Bazı sağlamlık kontrolleri yapın ve temizlik yapın. Yükseltme süreci sırasında kullanılan elevate-cpanel servisini kaldırın.

Bu aşamanın sonunda bir final yeniden başlatma yapılır.

Sıkça Sorulan Sorular

Mevcut durumu nasıl kontrol edebilirim?

Elevate sürecinin mevcut durumunu kontrol etmek için aşağıdaki komutu çalıştırabilirsiniz:

/scripts/elevate-cpanel --status

Elevate günlüğünü nerede bulabilirim?

/scripts/elevate-cpanel ile başlayan ana günlük aşağıdaki komutla okunabilir:

/scripts/elevate-cpanel --log

Leapp sorunlarını nerede bulabilirim?

Leapp sürecinin neden başarısız olduğu hakkında daha fazla ayrıntıya ihtiyacınız varsa, kayıtlara aşağıdaki konumdan erişebilirsiniz:

        /var/log/leapp/leapp-report.txt
        /var/log/leapp/leapp-report.json

Elevate sürecine nasıl devam edebilirim?

Rapor edilen sorunları düzelttikten sonra, mevcut bir elevate sürecini devam ettirmek için aşağıdaki komutu çalıştırabilirsiniz:

/scripts/elevate-cpanel --continue

Elevate süreci Aşama 1’de kilitlendi

Elevate sürecinin Aşama 1 de kilitlendiğini fark ederseniz ve şu öneride döngüye girdiğinizi görüyorsanız:

# Aşağıdaki komutları çalıştırabilirsiniz:

/scripts/elevate-cpanel --start

Durumu --clean seçeneği kullanarak açabilirsiniz.

# Önceki durumu temizle (bir elevation süreci Aşama 2 veya daha fazla aşamayı geçtiğinde çalıştırmayın)

/scripts/elevate-cpanel --clean

# Ardından süreci yeniden başlatın

/scripts/elevate-cpanel --start

Bilinen Engelleyiciler

Aşağıdaki liste, betiğin bu yükseltmeleri bilinçli olarak engelleyeceği kurulum durumlarını içermektedir. Bu, bu koşullar altında başarılı bir yükseltme garanti edilemediği için betik tarafından engellenir.

Temel kontroller

Bu betiği her çalıştırdığınızda aşağıdaki koşulların sağlandığı varsayılır:

  • CentOS 7.9 veya daha yeni bir sürümü kurulu olmalıdır.
    • Alternatif RHEL 7 (CloudLinux dahil) varyantlarını desteklemiyoruz.
  • cPanel sürümü 102 veya daha yeni bir sürümde kurulu olmalıdır.
  • root olarak oturum açmış olmalısınız.

Disk alanı

Herhangi bir anda yükseltme işlemi, 5 GB’den fazla veya bu miktar kadar disk alanı kullanabilir. Karmaşık bir bağlama sistemine sahipseniz, aşağıdaki alanların bir süre boyunca disk alanı gerektirebileceğini belirledik:

  • /boot: 120 MB
  • /usr/local/cpanel: 1.5 GB
  • /var/lib: 5 GB

Desteklenmeyen yazılım

Aşağıdaki yazılım, bu betik kullanıldığında bozuk bir kurulumla sonuçlanabileceği bilinmektedir. Algılandığında yükseltmeyi engelliyoruz:

  • cPanel CCS Calendar Server – Postgresql < 10.0 gerektirir
  • Postgresql – Sizi Postgresql 10.x’e yükseltir ve 9.x Postgresql’ye geri dönüşü imkansız hale getirir.

İlk olarak yükseltmeniz gereken şeyler

Bu sorunların birçoğunu elevate-cpaneli indirip /scripts/elevate-cpanel --check komutunu çalıştırarak tespit edebilirsiniz. Aşağıda, kullanıcıların karşılaşabileceği temel engellerin özeti bulunmaktadır.

  • Dağıtım güncel
    • Yum güncellemesinin bir şey yapılacak bir şey olmadığını göstermesini bekliyoruz.
    • Önlem: yum update
  • cPanel güncel
    • http://httpupdate.cpanel.net/ adresindeki “Latest cPanel & WHM Builds (All Architectures)” bölümünde belirtilen bir sürümde olmanız gerekmektedir.
    • Önlem: /usr/local/cpanel/scripts/upcp
  • name sunucusu
    • cPanel, bir dizi ad sunucusunu desteklemektedir (MyDNS, nsd, bind, powerdns). AlmaLinux 8 / Rocky 8’de her zaman PowerDNS kullanmanız tercih edilir.
    • Önlem: /scripts/setupnameserver powerdns
  • MySQL
    • Mevcut AlmaLinux 8 / Rocky 8 cPanel kurulumlarının %99’u MySQL 8 ile sonuçlanır. Mümkünse MySQL’inizi 8.0’a yükseltmenizi öneririz.
    • MariaDB: Zaten MariaDB’ye geçtiyseniz, MySQL’e erişmeniz mümkün değildir. AlmaLinux 8 / Rocky 8’e geçmeden önce 10.3 veya daha yeni bir sürümde olduğunuzdan emin olun.
  • AlmaLinux 8 / Rocky 8’de desteklenmeyen bazı EA4 paketleri bulunmaktadır.
    • Örnek: CentOS 7’de mevcut olan PHP sürümleri 5.4 ile 7.1, AlmaLinux 8 / Rocky 8’de mevcut değildir. AlmaLinux 8 / Rocky 8’e yükseltmeden önce bu paketleri kaldırmanız gerekebilir. Bu işlem sistem kullanıcılarını etkileyebilir. Dikkatli olun.
  • Sistemin, GRUB2 yapılandırmasını değiştirerek önyükleme sürecini kontrol edebilmesi gerekmektedir.
    • Bunun nedeni, dağıtım tarafından sağlanan yazılımın yükseltilmesini gerçekleştiren çerçevenin, dağıtımı güvenli bir şekilde yükseltmek için özel bir erken önyükleme ortamı (initrd) çalıştırabilmesi gerekmektedir.
    • Bu kontrolü, sistemdeki işletim sistemi çekirdeğinin, sistemin varsayılan önyükleme seçeneği olarak belirlediği sürümle aynı olup olmadığına bakarak yapıyoruz.
  • Makinenizin birden fazla ağ arabirim kartı (NIC) kernel adları (ethX) kullanıyorsa,
    • ethX stil isimlerinin kernel tarafından otomatik olarak atandığı için, yeni bir kernel sürümüne yükseltme yapıldığında bu ismin aynı kalacağına dair garanti yoktur.
    • network-scripts yapılandırma dosyalarındaki NIC’leri DEVICE ile belirtmenin, yukarıdaki nedenlerden dolayı sorunlara yol açabileceği durumlar vardır.
    • Bu sorunun nedeni ve bununla ilgili olarak ne yapılması gerektiği hakkında daha ayrıntılı bir açıklamaya freedesktop.org adresinden ulaşılabilir.
    • Bu sorunları önlemenin bir yolu, yapılandırmada istediğiniz bir ad atamak ve NIC’leri önceden yeniden başlatmaktır.

Diğer Bilinen Sorunlar

Aşağıdaki liste, sunucunuzun başarılı bir şekilde yükselmesini engelleyebilecek diğer bilinen sorunları içermektedir.

OVH proaktif müdahale izleme kullanımı

OVH tarafından barındırılan bir sunucu kullanıyorsanız, yükseltme işlemine başlamadan önce proaktif izlemeyi devre dışı bırakmanız gerekmektedir. Proaktif izleme, yeniden başlatmalar sırasında sunucunuzda bir sorun algılar ve sunucunuz kurtarma moduna geçer, yükseltme işlemini keser.

OVH izlemesi hakkında daha fazla bilgi edinin

Daha fazla yardıma ihtiyacım var mı?

cPanel Teknik Destek’e bir sorun bildirebilirsiniz.