PowerFlex: PFMP_SUPPORT – Support Bundle Collection Utility

pfmp_support [VAIHTOEHDOT]

KUVAUS

pfmp_support on diagnostiikka-apuohjelma, joka kerää virheenkorjaustietoja PowerFlex Managerista tai PowerFlex Manager Installer -isännästä ja arkistoi ne pakattuun pakettiin tukihenkilöstön analysoitavaksi.

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

• Kubernetes-diagnostiikkatiedot, määritykset ja lokit
• Ruorin vapautustiedot
• Docker-ohjaimen ja säilön ajonaikaiset tiedot
• PowerFlex Manager -asennusohjelman lokit
• Käyttöjärjestelmän kokoonpano, lokit ja suorituksenaikainen tila
• Laitteistoluettelo

Kun tietoja kerätään useista Kubernetes-klusterisolmuista, vakiopaketti (--skip-kubernetes-shared not defined) on kerättävä vähintään yhdestä solmusta, jossa kubectl ja helm ovat käytettävissä ja niillä on pääsy Kubernetes-ohjaustasoon. Myöhemmissä solmuissa --skip-kubernetes-shared voidaan käyttää kerättyjen tietojen koon pienentämiseen.

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

Vain yksi pfmp_support esiintymä voi toimia isännässä kerrallaan. Jos sen tulosteelle ei ole tarpeeksi vapaata tilaa, se kieltäytyy suorittamasta (ellei välilyöntitarkistusta nimenomaisesti ohiteta).

VAIHTOEHTOJA

Yleiset asetukset

• -A DIR, --installer-root-path=DIR

  Käytä DIR-hakemistoa PowerFlex Manager -asennusohjelman perushakemistona. Kätevä kerättäessä PowerFlexin asennusohjelman tietoja ja asennussäilöä (atlantic_installer) ei ole käynnissä. Oletus: tunnistetaan automaattisesti tai /var.

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

  Tallenna saatu paketti hakemistoon OUT_DIR. Default: <WORK_DIR>/powerflex-pfmpsupport (katso --work-dir).

• -h, --apua

  Näytä ohjeviesti ja poistu. Kun tämä yhdistetään --tech-kenttään, näytä myös teknikon asetukset.

• -J, --xz

  Käytä kerätylle paketille tar/xz-muotoa oletusarvoisen tar/gz-muodon sijaan. Ohitetaan, jos järjestelmä tar(1) Ei tue --use-compress-program tai xz(1) ei löydy.

• -n NIMIAVARUUS, --nimiavaruus=NIMIAVARUUS

  Lisätietojen kerääminen sovelluskohtaisesta Kubernetes-nimitilasta NAMESPACE. Default: powerflex.

• -N, --ohita-välilyönti tarkista

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

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

  Kerää lisäpolun POLKU. 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, --hiljainen, --hiljaa

  Estää viestit vakiotulosteessa.

• -s, --skip-kubernetes-jaettu

  Ohita jaettujen (koko klusterinlaajuisten) Kubernetes-tietojen kerääminen. Solmukohtaisia Kubernetes-tietoja ja isäntätietoja kerätään edelleen. Hyödyllinen usean solmun kokoelmissa koon pienentämiseksi; Klusteritiedot on kerättävä vähintään yhdestä solmusta.

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

  Käytä hakemisto-WORK_DIR tilapäistiedostoille. Default: /tmp.

• - x TIEDOSTO,--output-file=TIEDOSTO

  Tallenna kerätty nippu tiedostona, jonka nimi on FILE. Asianmukainen tiedostonimen pääte (.tgz, .zipjne.) lisätään automaattisesti. Jos TIEDOSTO on - (viiva), kirjoita nippu vakiolähtöön (tarkoittaa --quiet). Kun paketti kirjoitetaan vakiotulosteena, levylle ei luoda pakettitiedostoa. Default: pfmpSupport.

• -z, --zip

  Käytä kerätylle paketille zip-muotoa oletusarvoisen tar/gz-tiedoston sijaan. Ohitetaan, jos zip(1) ei löydy järjestelmästä.

• --overwrite-output-file

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

• --Tech

  Sisällytä teknikon asetukset ohjeviestin tulokseen.

Teknikon vaihtoehdot

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

• --keep-work-dir

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

• --vanhat-pod-lokit

  Kerää vanhat Kubernetes-pod-lokit paikallisesta rsyslog-säilöstä. Kun jätetään pois, virta (kubectl logs) ja sitä ennen (kubectl logs --previous) konttilokeja kerätään edelleen.

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 _, muut kuin aakkosnumeeriset merkit poistettuina.
  Esimerkki: 

  server/ip_-s_addr.txt - output of ip -s addr

• Kubectl-, Helm- ja Docker-komentojen tulokset menevät omiin alihakemistoihinsa. Ne järjestetään edelleen laajuuden mukaan, <namespace>/<pod>/<container>Tarvittaessa.
  Komennon nimeen, laajuuteen ja tulosmuotoon liittyvät argumentit poistetaan. Tiedostonimi on <subcommand> + <arguments> + jälkiliite (.txt oletuksena). Välilyönnit korvattu _, muut kuin aakkosnumeeriset merkit poistettuina.
  Kubectl EXEC -komentojen tulokset tallennetaan kansioon exec/ podin alihakemistosta.
  Esimerkkejä:
  • kubectl/version.txt - tuotos kubectl version
  • kubectl/all-namespaces/get_pods.yaml -- tuotos kubectl -o=yaml get --all-namespaces pods
  • kubectl/powerflex/asmui-7d6944dcb8-zqqtk/asmui/logs_--previous.txt - tuotos kubectl logs -n powerflex --container asmui --previous asmui-7d6944dcb8-zqqtk
  • kubectl/powerflex/nats-server-box-6d685b4b7d-cf278/nats-box/exec/nats_stream_report.txt - tuotos kubectl exec -n powerflex --container nats-box nats-server-box-6d685b4b7d-cf278 -- nats stream report
  • helm/powerflex/get_all_asmmanager.txt - tuotos helm get -n powerflex all asmmanager
  • docker/ps_-a.txt - tuotos docker ps -a
• Pod-säilöistä puretut tiedostot sijoitetaan säilön hakemistoon niiden säilön sisäiseen tiedostojärjestelmäpolkuun.
  Esimerkki: kubectl/powerflex/thin-deployer-5657659bc7-gzbq4/thin-deployer/opt/Dell/ASM/deployments/8aaa809298a9efe10198aa58c8874f35/deployment.log - kopio /opt/Dell/ASM/deployments/8aaa809298a9efe10198aa58c8874f35/deployment.log uutetaan thin-deployer säiliö thin-deployer-5657659bc7-gzbq4 Pod
• Isäntätiedostojärjestelmätiedostot sijoitetaan tiedostojärjestelmäpolkuunsa suhteessa nipun juureen.
  Esimerkkejä:
  • etc/os-release - copy of /etc/os-release
  • var/log/messages - copy of /var/log/messages
  • proc/cpuinfo - copy of /proc/cpuinfo
  • var/lib/rancher/rke2/agent/logs/kubelet.log - copy of /var/lib/rancher/rke2/agent/logs/kubelet.log
• Piilotetut tiedostot (pisteen etuliite) "piilotetaan" poistamalla alussa oleva piste.
• Apuohjelman suoritusloki, pfmp_support.log, sijoitettu suoraan isäntänimen>/juuren <alle.

Nipun hakemiston puurakenne:

<hostname>/
|-- pfmp_support.log                   Utility execution log
|-- server/                            General command output directory
|   |-- ip_-s_addr.txt
|   |-- uptime.txt
|   |-- uname_-a.txt
|   |-- ps_-elF.txt
|   |-- dmesg_-T.txt
|   +-- ...                            (one file per collected command)
|
|-- kubectl/                           kubectl command output directory
|   |-- version.txt                    Non-namespace-specific commands
|   |-- ...
|   |-- all-namespaces/                Cross-namespace commands
|   |   |-- get_pods.txt
|   |   |-- get_pods.yaml
|   |   +-- ...
|   +-- <namespace>/                   Per-namespace Kubernetes data
|       +-- <pod>/                     Per-pod data
|           +-- <container>/           Per-container data
|               |-- logs.txt           Current container logs
|               |-- exec/              Commands executed within container (if any)
|               |   +-- ...
|               |-- <dir>/             Files extracted from container (if any)
|               +-- ...
|-- helm/                              helm command output directory
|-- docker/                            docker command output directory
|
|-- etc/                               Host files
|   |-- os-release
|   |-- sysconfig/
|   |-- network/
|   +-- ...
|-- var/
|   |-- log/
|   |   |-- messages
|   |   +-- ...
|   |-- lib/rancher/rke2/
|   +-- ...
|-- proc/
|   |-- cpuinfo
|   |-- meminfo
|   +-- ...
|-- sys/
|-- ...
|
|-- powerflex-pfmpsupport-extra/       Extra diagnostic data (if present)
+-- powerflex-pfmpsupport-backup/      Backed-up configuration files (if any)

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.

PowerFlex Manager -isännän levytilan käytön minimoimiseksi paketti voidaan suoratoistaa etäisännästä komennolla --output-file=-. Suoratoiston aikana nipputiedosto kirjoitetaan suoraan vakiolähtöön (stdout); Sitä ei luoda levylle.

Ennen tietojen keräämistä apuohjelma arvioi tarvittavan levytilan sekä tilapäiselle työhakemistolle että tulostuspaketille.

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

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

Arvioidut tilantarpeet kirjoitetaan laitoksen lokitiedostoon, pfmp_support.log.

SULJE TILA

TIEDOSTOT

YMPÄRISTÖ

Edellytykset

• Apuohjelma on suoritettava pääkäyttäjänä (tai käyttäjänä, jolla on riittävät oikeudet lukea järjestelmätiedostoja, suorittaa diagnostiikkakomentoja, käyttää Kubernetes-klusteria ja käyttää /proc, /sysjne.).
• Tavalliset apuohjelmat: tar, gzip, stat, find, awk, sed, getopt(1) (parannettu), nice.
• Valinnainen: zip (varten --zip), xz (varten --xz).

Samanaikaisuuden

Vain yksi pfmp_support esiintymä voi olla käynnissä kerrallaan. Apuohjelma tarkistaa olemassa olevan käynnissä olevan esiintymän seuraavasti: pidof(1) ja päättyy, jos sellainen löytyy.

Signaalin käsittely

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

1. Palauttaa varmuuskopioidut määritystiedostot.
2. Puhdistaa väliaikaiset hakemistot.
3. Poistuu tilasta 1.

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

ESIMERKKEJÄ

Kerää vakiomuotoinen tukipaketti:

pfmp_support

Kerää paketteja useista Kubernetes-klusterin solmuista.

• Yhdessä solmussa, jossa on kubectl ja helm käyttää, kerätä kaikki Kubernetes-tiedot:

  pfmp_support

• Seuraavissa solmuissa ohita jaetut Kubernetes-tiedot:

  pfmp_support --skip-kubernetes-shared

Suoratoista paketti SSH-yhteydellä luomatta pakettitiedostoa PowerFlex Manager -etäisäntään:

ssh <host> 'pfmp_support --output-file=-' > pfmpSupport-<host>.tgz

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

pfmp_support --work-dir=/var/tmp

Sisällytä pakettiin mukautettuja polkuja:

pfmp_support --collect-path=/opt/custom/app/logs --collect-path='/var/log/app*'