PowerFlex: GET_INFO - Destek Paketi Toplama Yardımcı Programı

"get_info.sh" [SEÇENEKLER]

AÇIKLAMA

get_info.sh", bir PowerFlex (eski adıyla ScaleIO) ana bilgisayarından hata ayıklama bilgilerini toplayan bir tanılama yardımcı programıdır. Toplanan verileri, destek personeli tarafından analiz edilmek üzere sıkıştırılmış bir pakette arşivler.

Yardımcı program, aşağıdakiler de dahil olmak üzere birden çok kaynaktan veri toplar:

• PowerFlex bileşen günlükleri, yapılandırması ve izleme dosyaları
• MDM/SCLI sorgu çıktıları ve dahili hata ayıklama dökümü
• PowerFlex bileşeni dahili tanılama
• İşletim sistemi yapılandırması, günlükler ve çalışma zamanı durumu
• Donanım envanteri (depolama denetleyicileri, ağ aygıtları, NVMe, NVDIMM vb.)
• Çekirdek dökümleri (mevcut ve isteğe bağlı olarak istek üzerine oluşturulur)
• Tanılama verisi toplayıcısı ("diag_coll") istatistikleri

Ortaya çıkan paket, daha fazla analiz için PowerFlex desteğine aktarılabilen tek bir sıkıştırılmış arşivdir (varsayılan olarak tar/gz).

Bir ana bilgisayarda belirli bir anda yalnızca bir "get_info.sh" örneği çalıştırılabilir. Çıktısı için yeterli boş alan yoksa çalışmayı reddeder (alan denetimi açıkça atlanmadığı sürece).

SEÇENEKLER

Genel Seçenekler

• -a, --all
  Tüm verileri toplayın. Bu, "--mdm-repository", "--collect-cores", "--max-cores=2", "--valgrind-cores" ve "--analyse-diag-coll" belirtmekle eş değerdir.

• -A, --analyse-diag-coll
  Tanılama veri toplayıcısı ("diag coll") verilerini analiz etme

• -b[COMPONENTS], --collect-cores[=COMPONENTS]
  Boşlukla ayrılmış kullanıcı alanı "BİLEŞENLER" listesi için mevcut çekirdek dökümlerini toplayın. Varsayılan ("BİLEŞENLER" atlandığında): Tüm kullanıcı alanı bileşenleri

  Bilginize: -b" ve "COMPONENTS" arasında boşluk olmamalıdır. Uzun biçim için, = ile ayırın

  Örnek

  -b'mdm sds'

  --collect-cores='mdm sds'

• -d OUT_DIR, --output-dir=OUT_DIR
  Elde edilen paketi "OUT_DIR. dizini altında saklayın. " Varsayılan: "<WORK_DIR>/scaleio-getinfo" (bkz. "--work-dir").

• -f, --skip-mdm-login
  PowerFlex MDM oturum açma kimlik bilgileri sorgusunu atlayın. Kullanıcı zaten manuel olarak oturum açmışsa kullanışlıdır.

• -h, --help
  Yardım mesajını gösterir ve çıkış yapar. --tech" ile birleştirildiğinde teknisyen seçeneklerini de görüntüler.

• -J, --xz
  Toplanan paket için varsayılan "tar/gz" yerine "tar/xz" biçimini kullanın. Sistemin "tar(1)" değeri "--use-compress-program" veya "xz(1)" öğesini desteklemiyorsa yok sayılır.

• -k NUM, --max-cores=NUM
  Her bileşenden en fazla "NUM" çekirdek dosyası toplayın. Varsayılan: Tüm çekirdek dosyaları, "--collect-cores" anlamına gelir

• -l, --light
  Hafif bir paket oluşturun. Yalnızca en yeni nesil numaralı günlük dosyaları toplanır ve bileşen yürütülebilir dosyaları veya kitaplıkları çekirdekler toplanırken dahil edilmez. Bu seçeneğin kullanılması desteklenebilirliği azaltır ve kullanılması önerilmez.

• -m NUM, --max-traces=NUM
  Her bileşenden "NUM" a kadar PowerFlex izleme dosyası toplayın. Varsayılan: Tüm dosyalar

• -N, --skip-space-check
  Veri toplama işleminden önce boş disk alanı doğrulamasını atlayın.

• -P PATH, --collect-path=PATH
  PATH" ek yolunu toplayın. Yalnızca mutlak yollar kabul edilir. Joker karakterleri kabul eder; Joker karakterler alıntılanmalıdır. Bu seçenek, birden fazla yol toplamak için birden çok kez belirtilebilir.

• -q, --quiet, --silent
  Standart çıktıdaki mesajları bastırın.

• -r, --mdm-repository
  MDM depo dosyalarını toplayın.

• -s, --skip-sdbg
  SDBG (tanılama hata ayıklayıcısı) çıktısının toplanmasını atlayın.

• -S, --pause-core-generation
  Veri toplama sırasında PowerFlex bileşenlerinin çekirdek üretimini duraklatın. Toplama işlemi tamamlandıktan sonra orijinal yapılandırma geri yüklenir.

• -w WORK_DIR, --work-dir=WORK_DIR
  Geçici dosyalar için "WORK_DIR" dizinini kullanın. Varsayılan: /tmp.

• -x FILE, --output-file=FILE
  Toplanan paketi "FILE" adlı dosya olarak depolayın. Uygun dosya adı son eki (".tgz", ".zip" vb.) otomatik olarak eklenir. "FILE", "-" (tire) ise, paketi standart çıktıya yazın ("--quiet" anlamına gelir). Bir paket standart çıktıya yazıldığında, diskte paket dosyası oluşturulmaz. Varsayılan: getInfoDump.

• -z, --zip
  Toplanan paket için varsayılan "tar/gz" yerine "zip" biçimini kullanın. Sistemde "zip(1)" bulunamazsa yok sayılır.

• --mdm-port=PORT
  SCLI komutları için "PORT" bağlantı noktasını kullanarak MDM'ye bağlanın. Varsayılan: scli varsayılan davranışı.

• --overwrite-output-file
  Zaten mevcutsa çıktı dosyasının üzerine yazın. Bir çıktı dosyası veya dizini açıkça belirtildiğinde ("-x" veya "-d" kullanılarak), varsayılan davranış üzerine yazmayı reddetmektir; Bu seçenek bunu geçersiz kılar.

• --tech
  Yardım mesajı çıktısına teknisyen seçeneklerini dahil edin.

MDM Oturum Açma Seçenekleri

Aşağıdaki seçenekler SCLI "--login" komutuna geçirilir. Davranışları ve varsayılan değerleri SCLI tarafından yönetilir.

• -n, --use-nonsecure-communication
  Güvenli olmayan modda MDM'ye bağlanın.

• -p PASSWORD, --password=PASSWORD
  PowerFlex MDM oturumu açmak için "PASSWORD" kullanın. Varsayılan: SCLI varsayılan davranışı

• -u USERNAME, --username=USERNAME
  PowerFlex MDM oturumu açmak için "USERNAME" kullanın. Varsayılan: SCLI varsayılan davranışı

• --ldap-authentication
  LDAP tabanlı kimlik doğrulamayı kullanarak PowerFlex MDM'de oturum açın.

• --management-system-ip=ADDRESS
  PowerFlex oturumu açmak için "ADDRESS" konumundan "SSO/M&O"ya bağlanın. Varsayılan: SCLI varsayılan davranışı

• --p12-password=PASSWORD
  PASSWORD" kullanarak PowerFlex oturum açma "PKCS#12" dosyasını şifreleyin. Varsayılan: SCLI varsayılan davranışı

• --p12-path=FILE
  PowerFlex oturum açma "PKCS#12" dosyasını "FILE" olarak saklayın. Varsayılan: SCLI varsayılan davranışı

Teknisyen Seçenekleri

Aşağıdaki seçenekler destek teknisyenleri tarafından kullanılmak üzere tasarlanmıştır ve yalnızca "--tech" belirtildiğinde yardım mesajında gösterilir.

• -c[COMPONENTS], --generate-cores[=COMPONENTS]
  Boşlukla ayrılmış kullanıcı alanı "COMPONENTS" listesinin çalışan işlemleri için çekirdek dosyaları ("gcore(1)" kullanarak) oluşturun. Varsayılan: tüm kullanıcı alanı bileşenleri, "--collect-executables" anlamına gelir ve "gdb" ve "gcore" gerektirir.

  Bilginize: -c" ve "COMPONENTS" arasında boşluk olmamalıdır. Uzun biçim için "=" ile ayırın.

  Örnekler:

  -c'mdm sds'
  --generate-cores='mdm sds'

• -C CORE_FILE, --reference-core-file=CORE_FILE
  Yürütme başlangıç zamanı yerine "CORE_FILE" değerinin son değişiklik zamanına ("mtime") göre ürün günlüklerini ve çekirdeklerini toplayın. "--collect-cores" anlamına gelir

• -E REF_TIME, --event-time=REF_TIME
  Ürün günlüklerini ve çekirdekleri yürütme başlangıç zamanı yerine "REF_TIME" ile ilgili olarak toplayın. "date(1)" ile anlaşılan herhangi bir biçimi kabul eder. "--collect-cores" anlamına gelir.

• -g[COMPONENTS], --valgrind-cores[=COMPONENTS]
  Belirtilen kullanıcı alanı "COMPONENTS" için "valgrind" çekirdek dökümlerini toplayın. Varsayılan: tüm kullanıcı alanı bileşenleri. "--collect-executables" anlamına gelir.

   

  Bilginize: -b" ve "COMPONENTS" arasında boşluk olmamalıdır. Uzun form için "=" ile ayırın

  Örnekler:

  -g'mdm sds'
  --valgrind-cores='mdm sds'

• -t MIN, --minutes-before-event=MIN
  Referans zamanından "MIN" dakika öncesine kadar oluşturulan ürün günlüklerini ve çekirdekleri toplayın. Varsayılan: 15

• -T MIN, --minutes-after-event=MIN
  Referans süresinden "MIN" dakika sonrasına kadar oluşturulan ürün günlüklerini ve çekirdekleri toplayın. Varsayılan: 5

• -X[COMPONENTS], --collect-executables[=COMPONENTS]
  Belirtilen kullanıcı alanı "COMPONENTS" için bileşen yürütülebilir dosyalarını ve bunların paylaşılan kitaplıklarını toplayın. Varsayılan: Tüm kullanıcı alanı bileşenleri

  Bilginize: -b" ve "COMPONENTS" arasında boşluk olmamalıdır. Uzun form için "=" ile ayırın

  Örnekler:

  -X'mdm sds'
  --collect-executables='mdm sds'

• --keep-work-dir
  Paket oluşturulduktan sonra oluşturulan geçici çalışma dizinini koruyun (otomatik olarak temizlenir).

PAKET YAPISI

Çıktı paketi, sıkıştırılmış tek bir arşivdir.

• Paket üst düzey dizini, toplanan sistemin ana bilgisayar adıdır.
• Genel ana bilgisayar komut çıktıları bir "server/" alt dizinine gider.
  Dosya adı "<command> + <arguments> + suffix (varsayılan olarak .txt). " Boşluklar "_" ile değiştirilmiş, alfasayısal olmayan karakterler çıkarılmış
  Örnek: server/ip_-s_addr.txt - "ip -s addr" çıktısı
• Ürün komutu çıktıları, bileşenin alt dizinine gider. "scli" için "MDM/", "drv_cfg" için "SDC/" vb.
  Komut adı ("scli", "drv_cfg" vb.) çıkarılır. İlk anlamlı bağımsız değişken dosya adı olur. Dosyalar, varsayılan olarak ilgili son ek olan ".txt" olarak atanır.
  Örnekler:
  • mdm/query_cluster.txt - "scli --query_cluster" çıktısı
  • mdm/tgt_dump.txt - "scli --debug_action --tgt_dump" çıktısı
  • sdc/query_mdms.txt - "drv_cfg --query_mdms" çıktısı
  • sds/sdbg.txt - SDS için SDBG "dumpallscreens" çıktısı
• Ürün bileşeni dosyaları (komut çıktılarının aksine), "<component>/cfg", "<component>/logs" vb
  . Bileşenin dizininden ön ek çıkartılmış olarak kopyalanır.
  Örnekler:
  • mdm/cfg/conf.txt - "/opt/emc/scaleio/mdm/cfg/conf.txt" kopyası
  • sds/logs/trc.0 - "/opt/emc/scaleio/sds/logs/trc.0" kopyası
• Ana bilgisayar dosya sistemi dosyaları, paket köküne göre dosya sistemi yollarına yerleştirilir.
  Örnekler:
  • etc/os-release - "/etc/os-release" kopyası
  • var/log/messages - "/var/log/messages" kopyası
  • proc/cpuinfo - "/proc/cpuinfo" kopyası
• Tanılama toplayıcısı (diag_coll) dosyaları, "/opt" öneki çıkarılmış olarak kopyalanır ve iç yapı korunur.
  Örnek: diag_coll/logs/sar.0 - "/opt/diag_coll/logs/sar.0" kopyası
• Gizli dosyalar (nokta önekli), baştaki nokta kaldırılarak "gösterilmez".
• Yardımcı program yürütme günlüğü, get_info_run.log, doğrudan ana bilgisayar adının>/kökün <altına yerleştirilir

Paket dizin ağacı yapısı:

<hostname>/
|-- get_info_run.log                   Utility execution log
|-- server/                            General command output directory
|   |-- ip_-s_addr.txt
|   |-- uptime.txt
|   |-- uname_-a.txt
|   |-- ps_-elF.txt
|   |-- dmesg.txt
|   +-- ...                            (one file per collected command)
|
|-- mdm/                               PowerFlex component data (if installed)
|   |-- cfg/                           Configuration files (excl. PEM)
|   |-- logs/                          Trace and log files
|   |-- rep/                           Repository (if --mdm-repository)
|   |-- query_all.txt                  SCLI query outputs
|   |-- sdbg.txt                       SDBG screen dumps
|   +-- ...
|-- sds/
|-- pds/  
|-- dgwt/
|-- sdr/
|-- sdt/
|-- lia/
|-- sdc/
|-- gateway/
|
|-- diag_coll/                         Diagnostic data collector (if installed)
|   |-- logs/
|   |-- cfg/
|   +-- ...
|
|-- etc/                               Host files
|   |-- os-release
|   |-- sysconfig/
|   |-- network/
|   +-- ...
|-- var/
|   |-- log/
|   |   |-- messages
|   |   +-- ...
|   +-- ...
|-- proc/
|   |-- cpuinfo
|   |-- meminfo
|   +-- ...
|-- sys/
|-- ...
|
|-- scaleio-getinfo-extra/        Extra diagnostic data (if present)
+-- scaleio-getinfo-backup/       Backed-up configuration files (if any)

ÜRÜN GÜNLÜĞÜ VE ÇEKIRDEK DOSYA FILTRELEME

Bu bölümde açıklanan seçenekler, ürün günlük dosyalarının (izleme dosyaları olarak da adlandırılır, örneğin "trc.0", "trc.1", "exp.0") ve çekirdek döküm dosyalarının toplanan pakete eklenmek üzere nasıl seçildiğini kontrol eder. Bunu, bir referans zamanı, etrafında bir zaman penceresi ve sayma limitleri tanımlayarak yaparlar.

Herhangi bir filtreleme seçeneği belirtilmediğinde, tüm ürün günlük dosyaları ve (çekirdek toplama etkinse) tüm çekirdek döküm dosyaları toplanır. Filtreleme seçenekleri, bu seçimi aşağıda açıklandığı gibi aşamalı olarak daraltır.

Referans Zamanı
Referans zamanı "-E/--event-time" veya "-C/--reference-core-file" kullanılarak ayarlanabilir.

Ne "--event-time" ne de "--reference-core-file" verilmezse, zaman penceresi filtrelemesi yapılmaz: referans zamanı varsayılan olarak geçerli saate ayarlanır ve yalnızca bir sayım sınırı ("-m" veya "-k") geçerli olduğunda yakınlık tabanlı sıralama için kullanılır (aşağıdaki Sayım Sınırları'na bakın).

Hem "-E" hem de "-C" görünürse, komut satırındaki son öğe etkili olur.

Zaman Penceresi
Bir referans zamanı ayarlandığında ("--event-time" veya "--reference-core-file" kullanılarak), etrafında bir zaman penceresi oluşturulur. Zaman penceresi kapsamı, varsayılan olarak sırasıyla 15 ve 5 dakika olan "-t/--minutes-before-event" ve/veya "-T/--minutes-after-event" kullanılarak ayarlanabilir. Yalnızca içeriği bu pencereyle çakışan dosyalar toplanmaya uygundur.

Örneğin, "-E "2020-03-20 14:30" -t 10 -T 3", 14:20:00 ile 14:33:00 arasındaki dönemi kapsayan dosyaları toplar.

"--event-time" veya "--reference-core-file" belirtilmediğinde "--minutes-before-event" ve "--minutes-after-event" yoksayılır.

Sayım Limitleri
Günlük dosyaları ve çekirdek dosyalar için sırasıyla "-m/--max-traces" ve "-k/--max-cores" kullanılarak bir dosya sayısı sınırı ayarlanabilir. Sınır, bileşen başına ölçülür.

Zaman penceresine NUM'dan fazla dosya denk geldiğinde (veya herhangi bir pencere etkin değilse kullanılabilir olduğunda), referans zamanına en yakın NUM dosyaları toplanır.

"--event-time" veya "--reference-core-file" olmadan bir sayı sınırı kullanıldığında, tüm dosyalar adaydır (zaman penceresi yok) ve NUM'un en son dosyaları seçilir.

Filtreleme Mantığı
Dosya filtreleme, önce zaman aralığına, ardından sayı sınırına uygulanır:

1. Adayları belirleyin. Bir bileşenin tüm ürün günlük dosyaları ve/veya çekirdek döküm dosyaları numaralandırılır.
2. İçerik dönemini türetin. Ürün günlük dosyalarının içeriği bir dönemi temsil eder. İçerik döneminin, öncülünün son değişiklik zamanında ("mtime") veya öncül olmadığında UNIX döneminde başladığı kabul edilir; Dosyanın kendi "mtime"ında sona erer. Çekirdek döküm dosyaları, dosyanın "mtime" noktasındaki bir noktayı temsil eder.
3. Zaman penceresi uygulayın ("-E" veya "-C" belirtilmişse). İçeriği tamamen pencerenin dışında kalan dosyalar seçimden atılır. Ürün günlüğü dosyaları için, pencereye herhangi bir dosya girmezse, pencereye en yakın tek dosya saklanır, böylece paket bir bileşen için asla boş kalmaz. Çekirdek döküm dosyaları için böyle bir geri dönüş uygulanmaz.
4. Sayı sınırı uygulayın ("-m" ve/veya "-k" belirtilmişse). Kalan dosyalar arasında, referans zamanına en yakın olanları tercih ederek en fazla "SAYI" seçilir. Referans zamanından önceki ve sonraki dosyalar seçim için eşit olarak yarışır.

KIMLIK DOĞRULAMA

Birincil MDM işleminin beklenen bağlantı noktasını dinlediği algılanırsa yardımcı program yerel MDM'de oturum açmaya çalışır (varsayılan: 6611)

MDM oturum açma seçenekleri SCLI "--login" komutuna geçirilir ve bu komut tarafından işlenir.

Giriş başarısız olursa yardımcı program bir hata ile sonlandırılır.

Oturum açma atlandığında SCLI komutları denenmeye devam edilir (kullanıcının önceden manuel olarak oturum açtığı senaryoları desteklemek için). Üç SCLI hatasından sonra bir uyarı görüntülenir ve diğer tüm SCLI komutları atlanır.

Oturum açma şu durumlarda atlanır :

• Yerel ana bilgisayarda birincil MDM işlemi bulunamadı.
• --skip-mdm-login" seçeneği belirtilir.

Oturum açma şu durumlarda başarısız olur :

• MDM işlem sahibi yetkili kullanıcılar listesinde değildir (varsayılan: "kök") ve güvenli oturum açma etkindir.
• SCLI "--login" komutu bir hata (örneğin, yanlış kimlik bilgileri) döndürür.

DISK ALANI

Geçici dosyalar ve ortaya çıkan paket için disk alanı gereksinimleri önemli ölçüde farklılık gösterebilir.

Yardımcı program, geçici alan kullanımını en aza indirmeye çalışır; Toplanan sanal dosya sistemi ("/proc" ve "/sys") dosyalarının komut çıktıları ve kopyaları ile sınırlıdır.

PowerFlex ana bilgisayardaki disk alanı kullanımını en aza indirmek için paket akışı uzak bir ana bilgisayardan "--output-file=-" ile yapılabilir. Paket dosyası, akış sırasında doğrudan standart çıktıya ("stdout") yazılır; Diskte oluşturulmadı.

Yardımcı program, veri toplamadan önce hem geçici çalışma dizini hem de çıktı paketi için gerekli disk alanını tahmin eder.

Tahmini gerekli alan, ilgili dosya sistemlerindeki kullanılabilir alanı aşarsa yardımcı program bir hata ile sonlandırılır. Bu denetim "--skip-space-check" ile atlanabilir.

Çalışma dizini ve çıktı dizini farklı dosya sistemlerinde bulunabilir; Her biri bağımsız olarak kontrol edilir.

Tahmini alan gereksinimleri, yardımcı programın "get_info_run.log" günlük dosyasına yazılır.

ÇIKIŞ DURUMU

DOSYALAR

ORTAM

Ön koşullar

• Yardımcı program "root" olarak çalıştırılmalıdır (veya bileşen dosyalarını okumak, tanılama komutlarını çalıştırmak ve "/proc", "/sys" vb. öğelere erişmek için yeterli ayrıcalıklara sahip bir kullanıcı) çalıştırılmalıdır.
• Standart yardımcı programlar: tar, gzip, stat, find, awk, sed, getopt(1) (geliştirilmiş), nice.
• İsteğe Bağlı: zip ("--zip" için), xz ("--xz" için), gdb/gcore ("--generate-cores" için)

Eşzamanlılık
Aynı anda yalnızca bir "get_info.sh" örneği çalıştırılabilir. Yardımcı program, "pidof(1)" kullanarak mevcut bir çalışan örneği kontrol eder ve bir örnek bulunursa sonlandırılır.

Sinyal İşleme
Yardımcı program, veri toplama sırasında "INT", "EXIT" ve "TERM" sinyallerini yakalar. Bir sinyal aldıktan sonra:

1. Yedeklenmiş yapılandırma dosyalarını geri yükler (örneğin, çekirdek oluşturma ayarları).
2. Geçici dizinleri temizler
3. Durum 1 ile çıkar

Yürütme günlüğü korunur ve yolu standart hataya yazdırılır.

Örnekler
Standart bir destek paketi toplayın:

get_info.sh

Uzak PowerFlex ana bilgisayarında paket dosyası oluşturmadan SSH bağlantısı üzerinden paket akışı yapın:

ssh <host> 'get_info.sh --output-file=-' > getInfoDump-<host>.tgz

/tmp" dosyasının doldurulmasını önlemek için farklı bir çalışma dizini kullanın:

get_info.sh --work-dir=/var/tmp

Pakete özel yollar ekleyin:

get_info.sh --collect-path=/opt/custom/app/logs --collect-path='/var/log/app*'

Yalnızca SDS ve MDM bileşenleri için en son çekirdek dökümünü toplayın:

get_info.sh --collect-cores='mdm sds' --max-cores=1

Özel bir zaman penceresiyle, bir çekirdek dosyanın değişiklik süresi etrafında toplanmış verileri toplayın:

get_info.sh --reference-core-file=/opt/emc/scaleio/sds/bin/core.1000 \
            --minutes-before-event=10 \  
            --minutes-after-event=2