[TR] VMware vCenter 6.7 → 7.0.2 Yükseltme Sırasında “Case Sensitive Hostname” Hatası

[TR] VMware vCenter 6.7 → 7.0.2 Yükseltme Sırasında “Case Sensitive Hostname” Hatası

Geçtiğimiz bir vCenter yükseltme sürecinde (6.7’den 7.0.2’ye geçiş yaparken) daha önce karşılaşmadığım bir hata ile karşılaştım. Yükseltme sihirbazının Pre-Upgrade Check aşamasında sistem ilerlemedi ve aşağıdaki uyarıyı verdi:

The source appliance FQDN must be the same as the source appliance primary network identifier

İlk bakışta oldukça basit görünen bu hata, aslında vCenter’ın kimlik doğrulama ve servis mimarisi açısından oldukça kritik bir noktaya işaret ediyor. Hostname (FQDN) ile PNID birebir aynı değil. Üstelik burada büyük/küçük harf duyarlılığı (case sensitive) geçerli.

Yani sadece harflerin büyük ya da küçük yazılmış olması bile yükseltmeyi tamamen durdurabiliyor.

PNID Nedir, Neden Önemlidir?

PNID (Primary Network Identifier), vCenter’ın kendi iç servisleri tarafından kullanılan temel kimlik bilgisidir.

Özellikle şu servisler PNID değerini referans alır;

  • vmdir
  • vmafd
  • SSO (Single Sign-On)
  • Sertifika altyapısı

Eğer PNID ile sistemin FQDN bilgisi tam olarak eşleşmezse, kimlik doğrulama ve sertifika kontrollerinde tutarsızlık oluşur. Bu da:

  • Pre-upgrade check hatasına
  • Yükseltmenin başlamamasına
  • Bazı ortamlarda vROPS bildirim listesinin boş görünmesine
  • Entegrasyon problemlerine neden olabilir.

Sorunun Kaynağı: Büyük/Küçük Harf Duyarlılığı

Linux tabanlı VCSA (vCenter Server Appliance) ortamında hostname kontrolü teknik olarak case sensitive olabilir.

Örnek bir problem senaryosu;

PNID çıktısı:

VCENTER.domain.local

Hostname çıktısı;

vcenter.domain.local

İnsan gözüyle baktığınızda aynı gibi görünür. Ancak sistem açısından bu iki değer farklıdır. İşte yükseltme sihirbazı da tam olarak bunu kontrol eder. VMware bu konu ile ilgili resmi açıklamayı KB 84355 makalesinde paylaşmıştır.

Mevcut PNID ve Hostname Nasıl Kontrol Edilir?

Yükseltmeye başlamadan önce mutlaka iki değeri karşılaştırmanızı öneririm.

PNID Değerini Öğrenme

SSH ile vCenter’a bağlandıktan sonra;

/usr/lib/vmware-vmafd/bin/vmafd-cli get-pnid --server-name localhost

Bu komut size sistemin Primary Network Identifier değerini verecektir.

Hostname (FQDN) Kontrolü

hostname

Bu komut mevcut hostname bilgisini gösterir.

#Use vmafd-cli to get the PNID value
/usr/lib/vmware-vmafd//bin/vmafd-cli get-pnid --server-name localhost

#Primary Network Identifier (PNID)
/usr/lib/vmware-vmafd//bin/vmafd-cli get-pnid --server-name localhost

#Fully Qualified Domain Name (FQDN)
hostname

Eğer Değerler Farklıysa Ne Yapmalıyım?

Eğer PNID ve hostname arasında en ufak bir farklılık varsa (harf büyüklüğü dahil), hostname’i PNID değerine göre düzeltmeniz gerekir.

Hostname Değiştirme (VAMI Üzerinden)

SSH ile bağlandıktan sonra şu komutu çalıştırınız.

/opt/vmware/share/vami/vami_config_net
Karşınıza bir menü çıkacaktır:
  1. Hostname seçeneğini seçin
  • PNID çıktısındaki değeri birebir aynı şekilde giriniz.
  • IPv4 ve IPv6 için güncelleme yapılacaktır.

İşlem tamamlandıktan sonra sistemi yeniden başlatmanız önerilir.

reboot




Dikkat Edilmesi Gereken Ek Kontroller

Bu sorunu çözerken sadece hostname değişikliği yeterli olmayabilir. Aşağıdaki kontrolleri de yapmanızı öneririm:

  • Forward DNS kaydı doğru mu?
  • Reverse DNS kaydı doğru mu?
  • /etc/hosts dosyasında çakışma var mı?
  • Sertifikalarda eski hostname referansı bulunuyor mu?

Özellikle kurumsal ortamlarda DNS tutarsızlığı farklı problemlere yol açabilir.