VMware vCenter Server BackUp Restore Failed Hatası ve Çözümü

VMware vCenter Server Appliance (VCSA) ortamında file-based backup restore işlemi gerçekleştirirken özellikle Stage 2 (System Validation) aşamasında sıkça karşılaşılan bir hata vardır.

“Metadata and system validation failed. Error: Unknown system resource type log”

Bu hata yedekten geri yükleme (restore) işlemi sırasında yedek dosyasıyla yeniden dağıtılan (deploy edilen) VCSA arasında disk yapısı uyumsuzluğu olduğunda ortaya çıkar. Bugün bu hatanın neden oluştuğunu, nasıl tespit edildiğini ve adım adım çözüm sürecini anlatacağız.

Önemli Uyarı: İşleme başlamadan önce mevcut vCenter Appliance’ınızın snapshot veya clone ‘unu mutlaka almanızı öneririz. Herhangi bir yanlış adımda geri dönüş için bu hayati önem taşır.

Sorunun Genel Tanımı

Yedekten geri yükleme işlemi (file-based restore) iki temel aşamada ilerler:

1. Stage 1: Appliance deploy edilir (temel sistem kurulur).
2. Stage 2: Metadata ve sistem bileşenleri doğrulanır.

İşte hata tam olarak Stage 2 sırasında metadata kontrolü yapılırken meydana gelir:

Metadata and system validation failed.
Error: Unknown system resource type log

Bu hata genellikle orijinal vCenter sunucusunda genişletilmiş (extended) bir disk bulunmasından kaynaklanır.
Örneğin “log” veya “seat” diski sonradan büyütülmüşse yedek alma anındaki disk boyutu restore sırasında oluşturulan yeni VCSA ile eşleşmez. Sistem yedek metadata dosyasındaki disk yapısını doğrularken farkı algılar ve “Unknown system resource type” hatası verir.

Hatanın Kaynağının Doğrulanması

Sorunun hangi diskte oluştuğunu anlamak için yedek dosyası içindeki meta verileri kontrol etmemiz gerekir.

Yedek Dosyasını Açın

Yedek dosyanız .tar veya .tgz uzantılı olacaktır.
Örnek:

vcsa-backup-2025-10-07.tgz

Bu dosyayı bir klasöre çıkarın:

tar -xvf vcsa-backup-2025-10-07.tgz

“backup-metadata.json” Dosyasını İnceleyiniz

Çıkarılan klasörde bir backup-metadata.json dosyası göreceksiniz.
Bu dosya, yedek alındığı sırada VCSA’nın disk yapısı, boyut bilgileri ve volume ilişkilerini içerir.
İlgili diskin boyutunu burada görebilirsiniz:

{
  "disk": [
    {
      "name": "log",
      "size": "10240"
    },
    {
      "name": "seat",
      "size": "20480"
    }
  ]
}

Hata mesajınızda örneğin “log” diski geçiyorsa log bölümündeki boyutu not edin.
Bu değer restore sırasında oluşturulan diskin boyutuyla birebir eşleşmelidir.

Çözüm: Disk Boyutunu Eşitleme ve Yeniden Deneme

Şimdi diski doğru boyuta getirip restore işlemini yeniden başlatalım.

1. Host Üzerinden Disk Boyutunu Arttırma

1. ESXi host’a bağlanın. (vCenter değil !!!)
2. Restore için deploy edilen VCSA sanal makinesini bulun.
3. Sanal makinenin Settings > Hard Disk kısmına gidin.
4. “log” diskinin boyutunu backup-metadata.json dosyasında yazan değere göre artırın.
   Örneğin:
   • Metadata’da 10240 MB yazıyor, sizde 8192 MB ise → log diski 10240 MB olacak şekilde büyütün.
5. Değişiklikleri kaydedin.

2. VCSA Üzerinde Disk Kontrolü (SSH Üzerinden)

1. vCenter Appliance’a SSH ile bağlanın. ssh root@vcsa-ip
2. Diskleri kontrol edin: df -h
3. Genişlettiğiniz diskin sistem tarafından tanınıp tanınmadığını gözlemleyin.

3. Disk Otomatik Genişletme Komutu

Şimdi VMware’in kendi yapılandırma aracını kullanarak diski sistemsel olarak genişletelim:

vpxd_servicecfg storage lvm autogrow

Bu komut LVM (Logical Volume Manager) yapısını günceller ve eklenen alanı dosya sistemine dahil eder.

Eğer işlem başarılı olursa aşağıdaki sonucu göreceksiniz:

VC_CFG_RESULT=0

Bu çıktı ile işlemin başarıyla tamamlandığını gösterir.
Artık disk alanı doğru biçimde tanımlanmıştır.

4. Restore İşlemini Yeniden Başlatma

1. Önceki hatalı restore oturumunu iptal edin.
2. Aynı yedek dosyasını kullanarak yeniden “Stage 1 → Stage 2” restore işlemini başlatın.
3. Bu sefer sistem validation aşaması başarıyla tamamlanacaktır. Metadata doğrulaması başarıyla geçilir ve restore işlemi hatasız devam eder.

5. Ek Kontroller ve Doğrulama

• Restore tamamlandıktan sonra VCSA arayüzüne giriş yapın (https://vcsa-ip:5480).
• Disklerin doğru boyutta göründüğünü doğrulamak için: df -h
• Gerekirse şu komutla LVM haritasını da kontrol edin: lvs

Tüm değerler backup-metadata.json ile örtüşüyorsa işlem başarıyla tamamlanmıştır.

• Yedek alma işlemlerinde, disk genişletmesi yaptıktan sonra mutlaka yeni bir full backup alın.
• Restore öncesinde “backup integrity check” yapın: tar -tvf vcsa-backup-2025-10-07.tgz > /dev/null
• iLO veya vSphere Client üzerinden virtual hardware snapshot oluşturmak, hatalı restore durumlarında kurtarma için faydalıdır.
• Özellikle “log” ve “seat” disklerinin boyutları en sık değiştirilen alanlardır — metadata dosyasıyla her zaman karşılaştırın.

Kaynak : https://knowledge.broadcom.com/external/article/316602/increasing-the-disk-space-for-the-vcente.html