Genel Bakış
cvgather -f_VolName [-sukxr] [-o OutputFile] [-n NumberOfCvlogs] [-U UserCore]
[-K KernelCore] [-p SnfsPath]
Açıklama
cvgather programı, bir birimden hata ayıklama bilgilerini toplamak için kullanılır. Bu, sistemin Xsan Dosya Sistemi hata ayıklama günlüklerinin, yapılandırmasının, sürüm bilgilerinin ve disk aygıtlarının bir tar dosyasını oluşturur.
cvgather programı, istemci makinelerindeki istemci hata ayıklama bilgilerini ve sunucu makinelerindeki sunucu bilgilerini, ayrıca tüm makinelerdeki portmapper bilgilerini toplayacaktır. Sistem günlüğü dosyalarının yanı sıra Xsan günlük dosyaları da dahil edilir. Kullanıcının tercihine bağlı olarak cvgather, fsm gibi kullanıcı alanı yardımcı programlarından ve mevcut olduğunda işletim sistemi çekirdeğinden (kernel) gelen çekirdek dökümü (core) dosyalarını da toplar.
Kullanım
Operatör, Xsan kullanırken bir hatayla karşılaştığında ve Apple teknik desteğine hata ayıklama bilgileri göndermek istediğinde, cvgather yardımcı programı çalıştırılabilir. Aşağıdaki komut argümanları ve seçenekleri cvgather'ın davranışını etkiler.
-f VolName Hata ayıklama bilgilerinin toplanması gereken birimin adını belirtir. Bazı bilgiler yüklü tüm birimler için ortaktır, bazıları ise her dosya sistemine özeldir.
-k: İşletim sistemi çekirdeğinden (kernel) çekirdek dökümü (core) dosyasını toplar. Bu seçenek Linux üzerinde desteklenmez. -k seçeneği, makinenin işletim sistemi için varsayılan konumdan çekirdek dökümünü toplar. Çekirdek dökümünü başka bir konumdan toplamak için -K seçeneğini kullanın.
-K KernelCore Çekirdek dökümü dosyasını herhangi bir dosyadan toplar. Yolun yanı sıra tam dosya adını da belirtmeniz gerekir.
-n NumberOfCvlogs Tar dosyasına dahil edilecek cvlog dosyası sayısını belirtir. Bu seçenek seçilmezse 4 kullanılacaktır. Bu, fsm tarafından kullanılan varsayılan cvlog sayısıdır.
-o OutputFile Çıktı dosyasının adını belirtir. Bu ismin sonuna bir _zaman_damgası ve '.tgz' uzantısı eklenir. Birden fazla tar dosyasının bulunabilmesini sağlamak için dosya adına zaman damgası eklenir. Bu seçenek seçilmezse, varsayılan olarak birimin adı kullanılacaktır.
-p SnfsPath Xsan kurulum dizininin dosya yolunu belirtir. Bu seçenek seçilmezse, varsayılan olarak /System/Library/Filesystems/acfs.fs/Contents yolu kullanılacaktır.
-s: Çekirdek dökümü (core) dosyaları olmadan sembol bilgilerini toplar.-u: fsm gibi kullanıcı yürütülebilir dosyalarından çekirdek dökümü (core) dosyasını toplar. Varsayılan olarak, eğer mevcutlarsa, cvgather "core" adlı bir dosyayı ve uzantılı çekirdek dökümü dosya adlarını destekleyen sistemlerde en son değiştirilen "core.*" dosyasını alacaktır. -u seçeneği, Xsan dizinindeki 'debug' dizininden çekirdek dökümü dosyalarını toplar. Kullanıcı çekirdek dökümü dosyalarını başka bir konumdan veya standart dışı adlara sahip çekirdek dökümü dosyalarından toplamak için -U seçeneğini kullanın.
-U UserCore Kullanıcı çekirdek dökümü dosyasını herhangi bir dosyadan toplar. Yolun yanı sıra tam dosya adını da belirtmeniz gerekir.
-r: Sembolik ana bilgisayar adlarını belirlemeye çalışmak yerine sayısal adresleri gösterir.-x: pse_snapshot tarafından toplanan dosyaları hariç tutar. Bu seçeneğin genel kullanım için değil, yalnızca pse_snapshot tarafından kullanılmak üzere tasarlandığını unutmayın. Bu seçeneğin davranışı uyarı yapılmaksızın değişebilir.
cvgather çalıştırıldığında, değerlendirme için doğrudan Apple teknik desteğine e-postayla gönderilebilecek bir tar dosyası oluşturacaktır. Tar dosyasının compress, gzip veya bzip2 gibi standart bir sıkıştırma biçiminde sıkıştırılması önerilir.
Notlar
ÖNEMLİ: cvgather bir dizi geçici dosya oluşturur, bu nedenle çalıştırıldığı dizin için yazma yetkilerine sahip olmalıdır. Bu dosyalar ve çıktı tar dosyası, özellikle çekirdek dökümü (kernel core) dosyası dahil edildiğinde çok büyük olabilir, bu nedenle yeterli disk alanı mevcut olmalıdır.
Birkaç önemli günlük dosyasına yalnızca root kullanıcısı erişebilir, bu nedenle yararlı bilgilerin tümünü toplamak için cvgather'ın root ayrıcalıklarıyla çalıştırılması önemlidir.
Dosyalar
/Library/Preferences/Xsan/.cfg
/Library/Logs/Xsan/debug/cvfsd.out
/Library/Logs/Xsan/debug/nssdbg.out
/Library/Logs/Xsan/debug/fsmpm.out
/Library/Logs/Xsan/data/
Sınırlandırmalar
cvgather ile yalnızca Linux platformu desteklenir
cvgather'ın Windows sürümü farklı özellikler ve seçenekler içerir. Daha fazla bilgi için StorNext Windows "Gather Debugging Info (cvgather.exe)" yardım sayfasına bakın.
Ayrıca Bakınız
cvdb(8), cvversions(1), cvfsid(8) cvlabel(8)
Xsan Dosya Sistemi Eylül 2024 CVGATHER(8)