PowerFlex: GET_INFO – Support Bundle Collection Utility

get_info.sh [VAIHTOEHDOT]

KUVAUS

get_info.sh on diagnostiikkaapuohjelma, joka kerää virheenkorjaustietoja PowerFlex (aiemmin ScaleIO) -isännästä ja arkistoi ne pakattuun pakettiin tukihenkilöstön analysoitavaksi.

Apuohjelma kerää tietoja useista lähteistä, mukaan lukien:

• PowerFlexin osalokit, kokoonpano- ja jäljitystiedostot
• MDM-/SCLI-kyselyjen tulokset ja sisäinen virheenkorjausvedos
• PowerFlex-komponentin sisäinen diagnostiikka
• Käyttöjärjestelmän kokoonpano, lokit ja suorituksenaikainen tila
• Laitteistoluettelo (tallennusohjaimet, verkkolaitteet, NVMe, NVDIMM jne.)
• Ydindumpit (olemassa olevat ja valinnaisesti tarpeen mukaan luotavat)
• Diagnostisten tietojen keräystoiminto (diag_coll) tilastot

Tuloksena oleva paketti on yksi pakattu arkisto (oletusarvoisesti tar/gz), joka voidaan siirtää PowerFlex-tukeen lisäanalyysia varten.

Vain yksi esiintymä get_info.sh voidaan suorittaa isännässä tiettynä ajankohtana. Jos sen tulosteelle ei ole tarpeeksi vapaata tilaa, se kieltäytyy suorittamasta (ellei välilyöntitarkistusta nimenomaisesti ohiteta).

VAIHTOEHTOJA

Yleiset asetukset

• -a, --all

  Kerää kaikki tiedot. Tämä vastaa määritystä --mdm-repository, --collect-cores, --max-cores=2, --valgrind-coresja --analyse-diag-coll.

• -A, --analyse-diag-coll

  Diagnostiikkatietojen keräystoiminnon analysointi (diag coll) tiedot

• -b[COMPONENTS], --collect-cores[=COMPONENTS]

  Kerää olemassa olevat ydinkaatopaikat avaruudella eroteltuun käyttäjämaan luetteloon COMPONENTS. Oletus (kun: COMPONENTS on jätetty pois): Kaikki käyttäjämaata koskevat komponentit
   

Esimerkki

-b'mdm sds'

--collect-cores='mdm sds'

• -d OUT_DIR, --output-dir=OUT_DIR

  Tallenna saatu paketti hakemistoon OUT_DIR. Default: <WORK_DIR>/scaleio-getinfo ( --work-dir).

• -f, --skip-mdm-login

  Ohita PowerFlex MDM -kirjautumistietojen kysely. Tästä on hyötyä, kun käyttäjä on jo kirjautunut sisään manuaalisesti.

• -h, --help

  Näytä ohjeviesti ja poistu. Yhdistettynä --tech, näytä myös teknikon asetukset.

• -J, --xz

  Käyttö tar/xz Kerätyn paketin muoto oletusarvon sijaan tar/gz. Ohitetaan, jos järjestelmä tar(1) Ei tue --use-compress-program tai xz(1) ei löydy.

• -k NUM, --max-cores=NUM

  Kerää jopa NUM kunkin komponentin ydintiedostot. Default: Kaikki ydintiedostot, tarkoittaa --collect-cores

• -l, --light

  Luo kevyt paketti. Vain uusimman sukupolven numeroidut lokitiedostot kerätään, eivätkä suoritettavat komponenttitiedostot tai kirjastot sisälly ytimien keräämiseen. Tämän vaihtoehdon käyttö vähentää tuettavuutta ja sen käyttöä ei suositella.

• -m NUM, --max-traces=NUM

  Kerää jopa NUM PowerFlex jäljittää tiedostot kustakin osasta. Default: Kaikki tiedostot

• -N, --skip-space-check

  Ohita vapaan levytilan tarkistus ennen tietojen keräämistä.

• -P PATH, --collect-path=PATH

  Kerää ylimääräinen polku PATH. Vain absoluuttiset polut hyväksytään. Hyväksyy yleismerkit; Jokerimerkit on mainittava. Tämä vaihtoehto voidaan määrittää useita kertoja useiden polkujen keräämiseksi.

• -q, --quiet, --silent

  Estää viestit vakiotulosteessa.

• -r, --mdm-repository

  Kerää MDM-säilötiedostoja.

• -s, --skip-sdbg

  Ohita SDBG-tulosten (diagnostic debugger) kerääminen.

• -S, --pause-core-generation

  Keskeytä PowerFlex-komponenttien ydinluonti tiedonkeruun aikana. Alkuperäinen kokoonpano palautetaan kokoonpanon jälkeen.

• -w WORK_DIR, --work-dir=WORK_DIR

  Käytä hakemistoa WORK_DIR väliaikaisia tiedostoja varten. Default: /tmp.

• -x FILE, --output-file=FILE

  Tallenna kerätty paketti tiedostona nimeltä FILE. Asianmukainen tiedostonimen pääte (.tgz, .zip, ja niin edelleen) lisätään automaattisesti. Jos FILE On - (viiva), kirjoita nippu vakiotulosteeseen (tarkoittaa --quiet). Kun paketti kirjoitetaan vakiotulosteena, levylle ei luoda pakettitiedostoa. Default: getInfoDump.

• -z, --zip

  Käyttö zip Kerätyn paketin muoto oletusarvon sijaan tar/gz. Ohitetaan, jos zip(1) ei löydy järjestelmästä.

• --mdm-port=PORT

  Muodosta yhteys MDM:ään portin kautta PORT SCLI-komennoille. Default: scli default behavior.

• --overwrite-output-file

  Korvaa tulostiedosto, jos se on jo olemassa. Kun tulostiedosto tai hakemisto on eksplisiittisesti määritetty (käyttämällä -x tai -d), oletustoiminta on kieltäytyä korvaamasta; Tämä vaihtoehto ohittaa sen.

• --tech

  Sisällytä teknikon asetukset ohjeviestin tulokseen.

MDM-kirjautumisvaihtoehdot

Seuraavat vaihtoehdot välitetään SCLI:lle --login Komento. Niiden toimintaa ja oletusarvoja säätelee SCLI.

• -n, --use-nonsecure-communication

  Muodosta yhteys MDM:ään suojaamattomassa tilassa.

• -p PASSWORD, --password=PASSWORD

  Käyttö PASSWORD PowerFlex MDM -kirjautumista varten. Default: SCLI:n oletustoiminta

• -u USERNAME, --username=USERNAME

  Käyttö USERNAME PowerFlex MDM -kirjautumista varten. Default: SCLI:n oletustoiminta

• --ldap-authentication

  Kirjaudu PowerFlex MDM:ään LDAP-pohjaisella todennuksella.

• --management-system-ip=ADDRESS

  Yhdistä kohteeseen SSO/M&O klo ADDRESS PowerFlex-kirjautumista varten. Default: SCLI:n oletustoiminta

• --p12-password=PASSWORD

  Salaa PowerFlex-kirjautuminen PKCS#12 tiedostoa käyttäen PASSWORD. Default: SCLI:n oletustoiminta

• --p12-path=FILE

  Tallenna PowerFlex-kirjautumistunnus PKCS#12 tiedosto muodossa FILE. Default: SCLI:n oletustoiminta

Teknikon vaihtoehdot

Seuraavat asetukset on tarkoitettu tukiteknikoiden käyttöön, ja ne näkyvät ohjeviestissä vain, kun: --tech on määritetty.

• -c[COMPONENTS], --generate-cores[=COMPONENTS]

Luo ydintiedostoja (käyttämällä gcore(1)) välilyönneillä erotetun käyttäjämaaluettelon käynnissä oleville prosesseille COMPONENTS. Oletus: kaikki käyttäjän maakomponentit, tarkoittaa --collect-executablesja vaatii gdb ja gcore.

Esimerkkejä:

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

• -C CORE_FILE, --reference-core-file=CORE_FILE

  Kerää tuotelokit ja -ytimet suhteessa viimeisimpään muokkausaikaan (mtime) ja CORE_FILE, suorituksen alkamisajan sijaan. Merkitsee --collect-cores

• -E REF_TIME, --event-time=REF_TIME

  Kerää tuotelokit ja -ytimet suhteessa REF_TIME, suorituksen alkamisajan sijaan. Hyväksyy minkä tahansa muodon, jonka ymmärtää date(1). Merkitsee --collect-cores.

• -g[COMPONENTS], --valgrind-cores[=COMPONENTS]

Kerätä valgrind Määritetyn käyttäjämaan ydinkaatopaikat COMPONENTS. Oletus: kaikki käyttäjän maakomponentit. Merkitsee --collect-executables.

Esimerkkejä:

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

• -t MIN, --minutes-before-event=MIN

  Kerää tuotelokit ja -ytimet, jotka on luotu enintään MIN minuuttia ennen viiteaikaa. Default: 15

• -T MIN, --minutes-after-event=MIN

  Kerää tuotelokit ja -ytimet, jotka on luotu enintään MIN minuuttia viiteajan jälkeen. Default: 5

• -X[COMPONENTS], --collect-executables[=COMPONENTS]

  Komponenttien suoritettavien tiedostojen ja niiden jaettujen kirjastojen kerääminen määritettyä käyttäjämaata varten COMPONENTS. Default: Kaikki käyttäjämaata koskevat komponentit

Esimerkkejä:

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

• --keep-work-dir

  Säilytä luotu tilapäinen työhakemisto nipun luonnin jälkeen (tyhjennetään automaattisesti).

PAKETIN RAKENNE

Tulospaketti on yksi pakattu arkisto.

• Paketin ylimmän tason hakemisto on kerätyn järjestelmän isäntänimi.
• Yleiset isännän komentojen tulokset menevät server/ Alihakemistoon.
  Tiedostonimi on <command> + <arguments> + jälkiliite (.txt oletuksena). Välilyönnit korvattu _, ei-aakkosnumeeriset merkit poistettu
  Esimerkki: server/ip_-s_addr.txt – output of ip -s addr
• Tuotteen komentojen tulokset siirtyvät komponentin alihakemistoon. mdm/ varten scli, sdc/ varten drv_cfgja niin edelleen.
  Komennon nimi (scli, drv_cfg, ja niin edelleen) on riisuttu. Ensimmäisestä merkityksellisestä argumentista tulee tiedostonimi. Tiedostot määritetään asiaankuuluvaksi päätteeksi, .txt oletuksena.

Esimerkkejä: 

• • mdm/query_cluster.txt - tuotos scli --query_cluster
  • mdm/tgt_dump.txt - tuotos scli --debug_action --tgt_dump
  • sdc/query_mdms.txt - tuotos drv_cfg --query_mdms
  • sds/sdbg.txt - SDBG: n tuotos dumpallscreens käyttöturvallisuustiedotteelle
• Tuotteen komponenttitiedostot (toisin kuin komentojen tulosteet), <component>/cfg, <component>/logsja niin edelleen
  Kopioitu komponentin hakemistosta etuliite poistettuna.

Esimerkkejä: 

• • mdm/cfg/conf.txt - kopio /opt/emc/scaleio/mdm/cfg/conf.txt
  • sds/logs/trc.0 - kopio /opt/emc/scaleio/sds/logs/trc.0
• Isäntätiedostojärjestelmätiedostot sijoitetaan tiedostojärjestelmäpolkuunsa suhteessa nipun juureen.

Esimerkkejä:

• • etc/os-release - kopio /etc/os-release
  • var/log/messages - kopio /var/log/messages
  • proc/cpuinfo - kopio /proc/cpuinfo
• Diagnostic Collector (diag_coll) -tiedostot kopioidaan /opt etuliite riisuttu, säilyttäen sisäisen rakenteen.
  Esimerkki: diag_coll/logs/sar.0 - kopio /opt/diag_coll/logs/sar.0
• Piilotetut tiedostot (pisteen etuliite) "piilotetaan" poistamalla alussa oleva piste.
• Apuohjelman suoritusloki, get_info_run.log, sijoitettu suoraan isäntänimen>/juuren <alle

Nipun hakemiston puurakenne:

<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)

TUOTELOKI JA YDINTIEDOSTOJEN SUODATUS

Tässä osassa kuvatut asetukset määrittävät, miten tuotteen lokitiedostot (joita kutsutaan myös jäljitystiedostoiksi, esimerkiksi) trc.0, trc.1, exp.0) ja Core-vedostiedostot valitaan sisällytettäviksi kerättyyn nippuun. He tekevät sen määrittämällä viiteajan, aikaikkunan sen ympärille ja laskemalla rajat.

Jos suodatusasetuksia ei ole määritetty, kerätään kaikki tuotteen lokitiedostot ja (jos ydinkokoelma on käytössä) kaikki Core-vedostiedostot. Suodatusasetukset kaventavat tätä valintaa asteittain alla kuvatulla tavalla.

Viiteaika

Viiteaika voidaan asettaa jommallakummalla -E/--event-time tai -C/--reference-core-file.

Jos ei kumpaakaan --event-time Eikä --reference-core-file on annettu, aikaikkunan suodatusta ei suoriteta: viiteaika on oletusarvoisesti nykyinen aika ja sitä käytetään vain läheisyyteen perustuvassa järjestyksessä, kun määräraja (-m tai -k) on voimassa (katso laskentarajat alla).

Jos molemmat -E ja -C Näyttöön tulee komentorivin viimeinen kohta.

Aikaikkuna

Kun viiteaika on asetettu (käyttämällä --event-time tai --reference-core-file), sen ympärille muodostuu aikaikkuna. Aikaikkunan laajuus voidaan asettaa seuraavasti: -t/--minutes-before-event ja tai -T/--minutes-after-event, joiden oletusarvo on vastaavasti 15 ja 5 minuuttia. Vain tiedostot, joiden sisältö on päällekkäinen tämän ikkunan kanssa, ovat kelvollisia kokoelmaan.

Esimerkki: -E "2020-03-20 14:30" -t 10 -T 3 Kerää tiedostot ajalta 14:20:00 – 14:33:00.

--minutes-before-event ja --minutes-after-event jätetään huomiotta, kun kumpikaan ei --event-time Eikä --reference-core-file on määritetty.

Lukumäärän rajat

Tiedostomäärärajoituksen voi asettaa seuraavasti: -m/--max-traces ja -k/--max-cores, lokitiedostoille ja ydintiedostoille. Raja mitataan komponenttikohtaisesti.

Kun aikaikkunaan mahtuu enemmän tiedostoja kuin NUM, (tai ne ovat käytettävissä, jos mikään ikkuna ei ole aktiivinen), viiteaikaa lähinnä olevat NUM-tiedostot kerätään.

Kun määrärajaa käytetään ilman --event-time tai --reference-core-file, kaikki tiedostot ovat ehdokkaita (ei aikaikkunaa) ja NUM: n uusimmat tiedostot valitaan.

Suodatuslogiikka

Tiedostojen suodatus koskee ensin aikaikkunaa ja sitten määrärajaa:

1. Määritä ehdokkaat. Kaikki osan tuotteen lokitiedostot ja/tai Core-vedostiedostot luetteloidaan.
2. Johda sisältöjakso. Tuotteen lokitiedostojen sisältö edustaa pistettä. Sisältöjakson katsotaan alkavan edeltäjänsä viimeisestä muokkausajankohdasta (mtime) tai UNIX-aikakausi, kun edeltäjää ei ole; Se päättyy tiedoston omaan mtime. Core-vedostiedostot edustavat tiedoston tiettynä ajankohtana mtime.
3. Käytä aikaikkunaa (jos -E tai -C määritetty). Tiedostot, joiden sisältö on kokonaan ikkunan ulkopuolella, hylätään valinnasta. Jos tuotteen lokitiedostoissa ei ole mitään tiedostoa, ikkunaa lähinnä oleva tiedosto säilytetään, jotta osan nippu ei ole koskaan tyhjä. Core-vedostiedostoihin ei sovelleta tällaista varajärjestelmää.
4. Käytä määrärajaa (jos -m ja tai -k määritetty). Muiden tiedostojen joukossa enintään NUM valitaan mieluummin viiteaikaa lähinnä olevia. Tiedostot ennen viiteaikaa ja sen jälkeen kilpailevat tasapuolisesti valinnasta.

TODENNUS

Apuohjelma yrittää kirjautua paikalliseen MDM:ään, jos ensisijainen MDM-prosessi havaitaan odotetun portin kuuntelussa (oletus: 6611)

MDM-kirjautumisvaihtoehdot välitetään SCLI:lle --login komento ja se käsittelee niitä.

Jos kirjautuminen epäonnistuu, apuohjelma päättyy virheeseen.

Kun kirjautuminen ohitetaan, SCLI-komentoja yritetään edelleen (tukemaan tilanteita, joissa käyttäjä on kirjautunut sisään manuaalisesti etukäteen). Kolmen SCLI-virheen jälkeen näyttöön tulee varoitus ja kaikki muut SCLI-komennot ohitetaan.

Kirjautuminen ohitetaan, kun:

• Paikallisesta isännästä ei löydy ensisijaista MDM-prosessia.
• pikanäppäimellä --skip-mdm-login vaihtoehto on määritetty.

Kirjautuminen epäonnistuu, kun:

• MDM-prosessin omistaja ei ole valtuutettujen käyttäjien luettelossa (oletus: root) ja suojattu kirjautuminen on käytössä.
• The SCLI --login Komento palauttaa virheen (esimerkiksi väärät tunnistetiedot).

LEVYTILAA

Tilapäistiedostojen ja niistä saatavan paketin levytilavaatimukset voivat vaihdella huomattavasti.

Apuohjelma pyrkii minimoimaan väliaikaisen tilankäytön; Se rajoittuu kerättyjen näennäistiedostojärjestelmien komentojen tuloksiin ja kopioihin (/proc ja /sys) tiedostoja.

Paketti voidaan suoratoistaa etäisännästä --output-file=- minimoidaksesi levytilan käytön PowerFlex-isännässä. Pakettitiedosto kirjoitetaan suoraan vakiotulosteeseen (stdout) suoratoiston aikana; Sitä ei luoda levylle.

Apuohjelma arvioi sekä tilapäisen työhakemiston että tulostuspaketin tarvitseman levytilan ennen tietojen keräämistä.

Jos arvioitu tarvittava tila ylittää asianomaisten tiedostojärjestelmien käytettävissä olevan tilan, apuohjelma päättyy virheeseen. Tämä tarkistus voidaan ohittaa --skip-space-check.

Työhakemisto ja tulostushakemisto voivat sijaita eri tiedostojärjestelmissä; Jokainen tarkistetaan itsenäisesti.

Arvioidut tilantarpeet kirjoitetaan laitoksen lokitiedostoon, get_info_run.log.

SULJE TILA

TIEDOSTOT

YMPÄRISTÖ

Edellytykset

• Apuohjelma on suoritettava seuraavasti: root (tai käyttäjä, jolla on riittävät oikeudet lukea komponenttitiedostoja, suorittaa diagnostiikkakomentoja ja käyttää /proc, /sysja niin edelleen).
• Tavalliset apuohjelmat: tar, gzip, stat, find, awk, sed, getopt(1) (parannettu), nice.
• Valinnainen: zip (varten --zip), xz (varten --xz), gdb/gcore (varten --generate-cores)

Samanaikaisuuden

Vain yksi esiintymä get_info.sh voi olla käynnissä kerrallaan. Apuohjelma tarkistaa olemassa olevan käynnissä olevan esiintymän käyttämällä pidof(1) ja päättyy, jos esiintymä löytyy.

Signaalin käsittely

Apuohjelman keskeytykset INT, EXITja TERM signaalit tiedonkeruun aikana. Vastaanotettuaan signaalin se:

1. Palauttaa varmuuskopioidut kokoonpanotiedostot (esimerkiksi ydinten luontiasetukset).
2. Puhdistaa väliaikaiset hakemistot
3. Poistuu tilasta 1

Suoritusloki säilytetään ja sen polku tulostetaan keskivirheeseen.

Esimerkkejä

Kerää vakiomuotoinen tukipaketti:

get_info.sh

Suoratoista paketti SSH-yhteyden kautta luomatta pakettitiedostoa PowerFlex-etäisäntään:

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

Käytä toista työhakemistoa välttääksesi täyttymisen /tmp:

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

Sisällytä pakettiin mukautettuja polkuja:

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

Kerää uusin ydinvedos vain SDS- ja MDM-komponenteista:

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

Kerää tietoja, jotka keskittyvät ydintiedoston muokkausaikaan, mukautetun aikaikkunan avulla:

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