VxRail: VxRail Yükseltmesi Öncesi VxVerify ile İlgili Sorunları Giderme

Bu KB makalesi, VxVerify ın başarıyla çalışmasını engelleyen sorunları gidermeye yöneliktir.

Bu bilgi bankası makalesine, ilgili yanıtları için hedeflenmiş bir makalesi olmayan testlerden başvurulur (örneğin: Uyarı, Hata ve Kritik). Bunun bir örneği, bir sorgudan beklenmeyen bir yanıt döndüren bir sorgu olabilir.

VxVerify, VxRail yükseltmeleri sırasında karışık durumlara veya hatalara neden olabilecek sorunları tespit etmek için tasarlanmıştır. VxVerify, Minions olarak bilinen ve VxRail düğümlerine gönderilen Python programları oluşturur. Aşağıda, beklenmesi gereken tipik test sonuçları verilmiştir. vxverify_tests.json:

Yanlış pozitif test sonucu bulunursa VxVerify günlüklerini toplayın ve VxRail Mühendislik ekibiyle bir Jira VXV bileti açmak için Dell Destek ile iletişime geçin.

VxVerify'ın başarılı bir şekilde çalışmasını engelleyen birden çok neden vardır.

• Hataların en yaygın nedeni, Python komut dosyasının süresinin dolmasıdır. Her VxVerify sürümü, yayınlanma tarihinden itibaren yalnızca iki hafta boyunca geçerli olmak üzere ayarlanmıştır. VxVerify, VxRail sağlık kontrolü çerçevesine yönelik bir eklenti olarak çalıştırıldığında (bu yapıldığında VxVerify'ın işlevi değişir) bu durum geçerli değildir.
• Diğer nedenler, VxRail yöneticisindeki izin sorunları veya ana bilgisayarlarla iletişim sorunları olabilir.
• Olayın nedeni belirsizse VxRail Mühendislik ekibiyle bir VXV bileti açmak için Dell Destek ile iletişime geçin.

Aşağıdaki bölümde, günlüklerin nasıl toplanacağına ve VxVerify ın düzgün çalışmaması durumunda nasıl sorun giderileceğine ilişkin talimatlar yer almaktadır.

Destek Katılımı için Günlük Toplama

VxVerify ile ilgili sorunlarla ilgili destek alırken arşivlenen tüm dosyaları vxv analiz klasörü veya vxverify Günlük .zip dosyasını kullanması gerekir. Geçerli bağımsız VxVerify sürümleri bir arşivlenmiş dosyayı şuraya kaydeder: /tmp, analiz için gerekli tüm sonuçlara ve günlüklere sahiptir.

Örneğin: /tmp/vxverify-c9.zip

Buna ek olarak .zip dosyasında, VxVerify ın en son çalıştırılmasından elde edilen en fazla beş adet önceki günlük grubu da /tmp Klasör. Dosya adlarında, bu günlüklerin dosya özniteliklerinde çalıştırıldığı tarih ve saat bilgileri bulunur: 

vxv_previous_01.zip

Alternatif olarak, ilgili tüm dosyaları arşivlemek için aşağıdaki komutu çalıştırın:

tar cvzf vxverify-2020-12-31.tgz /tmp/vxv/

Sorun Giderme

VxVerify 2'yi (VxRail 4.5, 4.7 ve 7.0.000 için) çalıştırmak için kullanılan tipik sorun giderme adımları

• VxVerify'ın çalıştırılması için Python gerekir. Bu amaçla kullanılacak komut satırı şöyledir:

python /tmp/vxv/vxverify.pyc

• Sihirli sayı hatası oluşursa bu durum genellikle, VxRM deki Python sürümü için yanlış VxVerify sürümünün kullanıldığını gösterir. Örneğin, VxVerify 2'yi 7.0.320 üzerinde çalıştırdığınızda aşağıdaki hatayla karşılaşılır.

RuntimeError: Bad magic number in .pyc file

• VxVerify ın doğru sürümünün kullanıldığından emin olmak için (aşağıdaki bağlantı, Dell Destek portalında kimlik doğrulama gerektirir) makalesine bakın:
  • VxRail: VxRail Verify aracını çalıştırma (VxVerify Sürümleri bölümü) 
• VxVerify, kullanılarak gönderilen, çalıştırılan ve alınan minion adlı programlar oluşturur. SSH. Eğer SSH kullanılabilir. Zaten etkin olmasa bile VxVerify açılır SSH çalıştırılacak komutların her ana bilgisayarı için. Ana bilgisayarlar nerede kilitliyse: SSH çalıştırılamaz, minionlar çalıştırılamaz ve ana bilgisayar testleri bir sonuç kodu döndürür: 2 (Arıza) veya 3 (Kritik). Böyle bir durumda, SSH Yönetici izinleri.
• VxVerify2, Python 2.7 de çalışacak şekilde tasarlanmıştır. Bu sürüm, VxRM VM de mevcuttur ve genellikle kullanılabilir olan tek Python sürümüdür. Daha fazla Python sürümü varsa bunu test etmek için aşağıdaki komutu çalıştırın (bu sürümde -h seçeneği, yani --helpkullanarak):

python2.7 vxverify.pyc -h

VxVerify, günlükleri ve çıktı dosyalarını /tmp/vxv/. Yeterli izinlere sahip değilse çalıştırılamaz. Klasör izinlerini aşağıdaki komutlarla kontrol edin. Tüm kullanıcılar için okuma/yazma izinleri yoksa bunları chmod (kök izinleri gerekebilir):

$ ls -lad /tmp/vxv

drwxrwxrwx  3 mystic   users      4096 Oct  1 07:42 vxv

• VxVerify da izin hataları devam ederse (ör. "Önceki günlükleri silme izni reddedildi.") vxv klasöründe aşağıdaki komut bulunur (kök parola, sudo erişim). Bu silme komutu çalıştırıldıktan sonra VxVerify, yalnızca mystic izinleri kullanılarak yeniden yüklenmelidir:

sudo rm -r -d /tmp/vxv

• Başka bir seçenek de VxVerify çıktı dosyalarını yeni bir klasöre kaydetmektir. Mevcut değilse VxVerify, -l veya --log seçeneğini ve ardından günlüklerin kaydedileceği yolu seçin. Örneğin:

python vxverify.pyc -l /tmp/vx1

VxVerify2 ve VxVerify 3 Arasındaki Farklarda Sorun Giderme (VxRail 7.0.010+ için)

VxRail 7.0.010 ve sonraki sürümlerde, VxRM'deki temel değişiklikler nedeniyle VxVerify 3 kullanılmalıdır.

Aşağıdaki durumlar haricinde VxVerify2 için de aynı sorun giderme adımları VxVerify3 için de geçerlidir:

• VxVerify3 için Python sürümü 3.6'dır.
• VxVerify'ın değişiklik gerektirdiği site paketlerinin konumu aşağıdaki konumlardan birinde yer alır:
  • /mystic/telemetry/DCManager/venv/lib/python3.6/site-packages
  • /mystic/radar/venv/lib/python3.6/site-packages
• Bu klasörlerin ikisi de mystic kullanıcısından erişilemiyorsa VxVerify programı, site paketleri hakkında bir hata mesajı verir ve çıkış yapar.
  • Geçici bir çözüm, kök kullanıcıyı kullanmaktır.

Zaman aşımı

Mini işlemin tamamlanması 20 dakikadan uzun sürerse VxVerify, özet tablosunda bir zaman aşımı olayı sağlamalıdır.

| Node-name  |Critical 66460| minion: Maximum run time for minion exceeded

• Karşılık gelen vxv.log Bunun için girişler şunlardır:

2022-10-06 06:42:51-WARNING  Creating a fault json for missing minion

2022-10-06 06:42:51-WARNING  [fail_minion] Producing result file for lab-esx22, due to: Maximum run time for minion exceeded. See minion logs in /tmp/vxv

• Bu, miniyonun durmasına neden olan bir hatayla karşılaşıp karşılaşmadığını veya testin yavaş devam edip etmediğini ve tamamlanması için zamanın dolup dolmadığını görmek için o ana bilgisayarın minion günlüğüne bakılarak kontrol edilmelidir.
• Bir minion doğru şekilde tamamlanırsa günlükteki son satırlar aşağıdakiler olmalıdır:

2022-10-06 06:39:30 INFO    Writing to JSON: /tmp/xc882-61f1f3b9-7cb2-130a-35b0-minion.json

2022-10-06 06:39:30 INFO    JSON save: os.stat_result(st_mode=33206, st_ino=47144, st_dev=1, st_nlink=1, st_uid=0, st_gid=0, st_size=499562, st_atime=1665038370, st_mtime=1665038370, st_ctime=1665038370)

2022-10-06 06:39:30 DEBUG   ESXi minion's work is done.

JSON dosya aktarımı çalışmıyor

Ana bilgisayar minion sonuçları SCP veya SFTP kullanılarak VxRM ye geri aktarılamazsa çıktı tablosunda aşağıdakiler görülebilir:

| Node-name  |Critical 66460| minion: No JSON downloaded from node via SSH

• Karşılık gelen vxv.log Bunun için girişler şunlardır:

2022-10-06 06:42:51-WARNING  Creating a fault json for missing minion

2022-10-06 06:42:51-WARNING  [fail_minion] Producing result file for lab-esx22, due to: No JSON downloaded from node via SSH. See minion logs in /tmp/vxv

• Bu, miniyonun durmasına neden olan bir hatayla karşılaşıp karşılaşmadığını veya bir JSON dosyasının üretilip üretilmediğini görmek için o ana bilgisayarın minion günlüğüne bakılarak kontrol edilmelidir. SSH.
• Bir minion doğru şekilde tamamlanırsa günlükteki son satırlar aşağıda olmalıdır. Bu satır, bir JSON'un /tmp Düğümün klasörü:

2022-10-06 06:39:30 INFO    Writing to JSON: /tmp/xc882-61f1f3b9-7cb2-130a-35b0-minion.json

2022-10-06 06:39:30 INFO    JSON save: os.stat_result(st_mode=33206, st_ino=47144, st_dev=1, st_nlink=1, st_uid=0, st_gid=0, st_size=499562, st_atime=1665038370, st_mtime=1665038370, st_ctime=1665038370)

2022-10-06 06:39:30 DEBUG   ESXi minion's work is done.

Yukarıdaki sorunları gidermek için önerilen adımlar şunlardır:

• VxVerify3 kullanıyorsanız --fix bir alternatif kullanan bayrak SSH Mekanizması. Bu bazılarını önleyebilir SSH İzin sorunları.
• 'ı kullanarak yeni bir yol belirtin -1 (klasörün önce oluşturulması gerekmez), bu da VxRM izin hatalarının dosya aktarımını engellemesi durumunda yardımcı olabilir:
• Örneğin, > python vxv2.pyc -l \tmp\vxv0
• Yukarıdakiler hala çalışmıyorsa içindeki gereksiz dosya ve klasörleri temizlemeden önce VxRM'nin anlık görüntüsünü alın /tmp ve /home/mystic, daha önce VxVerify tarafından kullanılanlar gibi.
• VxRM'yi (VxRail Manager) yeniden başlatın.

VxVerify, yukarıdaki adımlarla düzeltilemeyen bir hatayla karşılaşırsa yukarıda açıklandığı gibi vxv günlük paketini kaydedin ve sorunu Dell Destek ile iletin.

VxVerify2 ve VxVerify3'te oturum açma ve kimlik bilgisi hataları

• VxVerify, VxRM (VxRail Manager) ve VxRail düğümlerinde test çalıştırmak için herhangi bir kimlik bilgisi gerektirmez. VxVerify, şifrelenmiş kimlik bilgilerine doğrudan VxRM veritabanı üzerinden erişebilir ve bunları kullanmadan önce şifrelerini çözebilir. Bazen VC yönetimi kimlik bilgilerine erişilemez. Bu durumda, bu kimlik bilgileri VxVerify komut satırında belirtilebilir:

python vxverify.py --verbose -u vxrailmgmt@localos -p ChangeMe1!

• vCenter tarafından izin verilen bazı özel karakterlerin kullanımı VxRail Manager için sorunlara neden olabilir (özellikle Linux Shell'i kullanan komutlar için). vCenter veya ESXi ana bilgisayarlarının parolalarında aşağıdaki karakterlerden hiçbirinin kullanılmadığından emin olun:

` $ % / \

• Yönetim için hangi kullanıcı adının kullanıldığı konusunda şüpheniz varsa, vxv.log. Örneğin:

... - DEBUG Users from runtime & settings records:     vxrailmgmt@localos & vxrailmgmt@localos

• SSH kullanılarak vCenter için yapılan testlerde, ile belirtilebilecek kök kullanıcı adı ve parola bilgisi gereklidir. -r ve -w seçenekleri sırasıyla. vCenter testleri yalnızca bunlar belirtilmişse çalıştırılır (ancak kök kullanıcı rootvarsayılan ayardır, bu durumda yalnızca kök parolanın belirtilmesi gerekir). Örneğin:

python vxverify.py --verbose -w R00tPassword!

Kritik test hataları örnekleri

Bunlar, başka testlerin çalıştırılmasını engelleyen ciddi hataların sonucunda görülebilir. Örneğin, VxRM de kaydedilen vCenter yönetim kullanıcı adı ve parolası güncel değilse VC API ye yapılan tüm sorgular başarısız olur ve başka hiçbir test çalıştırılamaz. Buna şu örnekler verilebilir:

#========================#======#=========#====================================================================#==============#
|  Hostname / Category   |Status  Dell_KB |  Warnings or Failures, unless tests Passed                         | Product S.N. |
#========================#======#=========#====================================================================#==============#
| VxRM                   | Critical 66460 | vc_external: VC MOB API connection failed                                        .| <- Stored vCenter password rejected
| VxRail                 | Critical 66460 | vxtii_err: Internal DO host query failed. See vxv.log for details in /tmp/vxv    .| <- ESXi node data cannot be retrieved from the VxRM config service
| _cluster               | Critical 66460 | esx_vers: No valid ESXi test results found                                       .| <- No ESXi tests could be run

VxVerify dosyaları

VxVerify, içinde aşağıdaki dosyaları oluşturur /tmp/vxv/ veya /var/log/mystic/vxv/ ( -l bağımsız değişken).  Bu dosyaların tümü tek bir arşiv dosyasına kaydedilir. /tmpGibi /tmp/vxverify-569ae010.zip veya /tmp/vxv_previous_01.zip'dir.
Bu dosyaları manuel olarak kontrol etmek, VxVerify komut dosyası tam olarak tamamlanmamış bile kümedeki sorunları tespit etmeye yardımcı olabilir:   

• vxv.log - (VxVerify komut dosyası için günlük dosyası)
• minion_hostname.log - (her ana bilgisayarda çalışan minion komut dosyası için uzak günlük)
• minion_hostname.txt - (her bir minion için hangi test numarasının devam ettiğini gösteren uzak metin çıktısı)
• /json/host_uid.json - (test sonuçlarıyla birlikte her bir minion tarafından oluşturulan ve daha sonra diğer ana bilgisayar verileriyle birleştirilen ve ardından silinen dosya)
• vxverify_tests.json - (her test sonucunu görmek için manuel olarak kontrol edilebilen tüm testler için birleşik çıktı)
• vxtii.json - (iDRAC Donanım Envanteri gibi sorgular için ana bilgisayarlardan gelen birleşik yanıtlar)
• vxtii.txt - (her düğüm için iDRAC ve ESXi bilgilerini özetleyen rapor)
• vxverify.txt - (VxVerify sessiz modda çalıştırılmadığında ekranda gösterilen özet tablosu)
• vxverify.html - (VxVerify ve VxTii raporlarını HTML biçiminde birleştirdi) (VxRail Manager sağlık kontrollerine eklenmek yerine yalnızca doğrudan VxVerify çalıştırıldığında kullanılabilir)