PowerFlex: GET_INFO – Supportpakkeindsamlingsværktøj

get_info.sh [VALGMULIGHEDER]

BESKRIVELSE

get_info.sh er et diagnosticeringsværktøj, der indsamler fejlfindingsoplysninger fra en PowerFlex-vært (tidligere ScaleIO) og arkiverer dem i en komprimeret pakke til analyse af supportpersonale.

Forsyningen indsamler data fra flere kilder, herunder:

• Logfiler, konfiguration og sporing af PowerFlex-komponenter
• MDM/SCLI-forespørgselsoutput og intern fejlfindingsdump
• Intern diagnosticering af PowerFlex-komponent
• Operativsystemkonfiguration, logge og driftstilstand
• Hardwarelager (storagecontrollere, netværksenheder, NVMe, NVDIMM osv.)
• Kernedumps (eksisterende og valgfrit genereret efter behov)
• Indsamler af diagnosticeringsdata (diag_coll) Statistik

Den resulterende pakke er et enkelt komprimeret arkiv (tar/gz som standard), der kan overføres til PowerFlex-support med henblik på yderligere analyse.

Kun én forekomst af get_info.sh kan køre på en vært på et givet tidspunkt. Hvis der ikke er nok ledig plads til outputtet, nægter det at køre (medmindre pladskontrol udtrykkeligt springes over).

MULIGHEDER

Generelle indstillinger

• -a, --all

  Indsaml alle data. Dette svarer til at specificere --mdm-repository, --collect-cores, --max-cores=2, --valgrind-coresog --analyse-diag-coll.

• -A, --analyse-diag-coll

  Analysere indsamler af diagnosticeringsdata (diag coll) oplysninger

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

  Indsaml eksisterende kernedumper til den rumseparerede liste over brugerjord COMPONENTS. Standard (når COMPONENTS er udeladt): Alle komponenter i brugerland
   

Eksempel

-b'mdm sds'

--collect-cores='mdm sds'

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

  Gem det resulterende bundt under mappe OUT_DIR. Default: <WORK_DIR>/scaleio-getinfo (Se --work-dir).

• -f, --skip-mdm-login

  Spring forespørgslen om loginoplysninger til PowerFlex MDM over. Nyttigt, når brugeren allerede har logget ind manuelt.

• -h, --help

  Vis hjælpemeddelelsen, og afslut. Når det kombineres med --tech, også vise teknikerindstillinger.

• -J, --xz

  Brug tar/xz Format for det indsamlede bundt i stedet for standardindstillingen tar/gz. Ignoreres, hvis systemets tar(1) understøtter ikke --use-compress-program eller xz(1) ikke fundet.

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

  Saml op til NUM kernefiler fra hver komponent. Standard: Alle kernefiler, indebærer --collect-cores

• -l, --light

  Generer et let bundt. Kun den nyeste generation af nummererede logfiler indsamles, og eksekverbare komponentfiler eller biblioteker medtages ikke ved indsamling af kerner. Brug af denne mulighed reducerer understøttelsen, og dens brug frarådes.

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

  Saml op til NUM PowerFlex-sporingsfiler fra hver komponent. Standard: Alle filer

• -N, --skip-space-check

  Spring bekræftelse af ledig diskplads over før dataindsamling.

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

  Indsaml den ekstra sti PATH. Kun absolutte stier accepteres. Accepterer jokertegn; Jokertegn skal angives. Denne indstilling kan angives flere gange for at indsamle flere stier.

• -q, --quiet, --silent

  Undertryk meddelelser på standardoutput.

• -r, --mdm-repository

  Indsaml MDM-arkivarkiver.

• -s, --skip-sdbg

  Spring indsamling af SDBG-output (diagnostisk debugger) over.

• -S, --pause-core-generation

  Sæt kernegenereringen af PowerFlex-komponenter på pause under dataindsamlingen. Den oprindelige konfiguration gendannes, når indsamlingen er fuldført.

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

  Brug vejviser WORK_DIR til midlertidige filer. Standard: /tmp.

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

  Gem det indsamlede bundt som fil med navnet FILE. Det relevante filnavnsuffiks (.tgz, .zip, og så videre) tilføjes automatisk. Hvis FILE Er - (bindestreg), skriv bundtet til standardoutput (indebærer --quiet). Når et bundt skrives til standardoutput, oprettes der ingen bundtfil på disken. Standard: getInfoDump.

• -z, --zip

  Brug zip Format for det indsamlede bundt i stedet for standardindstillingen tar/gz. Ignoreret, hvis zip(1) findes ikke i systemet.

• --mdm-port=PORT

  Opret forbindelse til MDM vha. port PORT til SCLI-kommandoer. Standard: scli default behavior.

• --overwrite-output-file

  Overskriv outputfilen, hvis den allerede findes. Når en outputfil eller mappe udtrykkeligt er angivet (ved hjælp af -x eller -d), er standardadfærden at nægte at overskrive; Denne indstilling tilsidesætter dette.

• --tech

  Medtag teknikerindstillinger i outputtet af hjælpemeddelelsen.

Indstillinger for MDM-login

Følgende valgmuligheder overføres til SCLI --login Kommando. Deres funktionsmåde og standardværdier styres af SCLI.

• -n, --use-nonsecure-communication

  Opret forbindelse til MDM i usikker tilstand.

• -p PASSWORD, --password=PASSWORD

  Brug PASSWORD til PowerFlex MDM-login. Standard: SCLI-standardadfærd

• -u USERNAME, --username=USERNAME

  Brug USERNAME til PowerFlex MDM-login. Standard: SCLI-standardadfærd

• --ldap-authentication

  Log ind på PowerFlex MDM med LDAP-baseret godkendelse.

• --management-system-ip=ADDRESS

  Opret forbindelse til SSO/M&O På ADDRESS til PowerFlex-login. Standard: SCLI-standardadfærd

• --p12-password=PASSWORD

  Krypter PowerFlex-login PKCS#12 fil ved hjælp af PASSWORD. Standard: SCLI-standardadfærd

• --p12-path=FILE

  Gem PowerFlex-login PKCS#12 fil som FILE. Standard: SCLI-standardadfærd

Teknikermuligheder

Følgende indstillinger er beregnet til brug af supportteknikere og vises kun i hjælpemeddelelsen, når --tech er angivet.

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

Generer kernefiler (ved hjælp af gcore(1)) for de løbende processer i den rumseparerede liste over brugerarealer COMPONENTS. Standard: alle brugerjordkomponenter, indebærer --collect-executables, og kræver gdb og gcore.

Eksempler:

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

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

  Indsaml produktlogfiler og -kerner i forhold til det seneste ændringstidspunkt (mtime) af CORE_FILEi stedet for udførelsens starttidspunkt. Indebærer --collect-cores

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

  Indsaml produktlogfiler og -kerner i forhold til REF_TIMEi stedet for udførelsens starttidspunkt. Accepterer ethvert format, der forstås af date(1). Indebærer --collect-cores.

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

Indsamle valgrind kernedumps for det angivne brugerland COMPONENTS. Standard: alle brugerjordkomponenter. Indebærer --collect-executables.

Eksempler:

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

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

  Indsamle produktlogfiler og -kerner, der er genereret op til MIN minutter før referencetidspunktet. Standard: 15

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

  Indsamle produktlogfiler og -kerner, der er genereret op til MIN minutter efter referencetiden. Standard: 5

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

  Indsaml eksekverbare komponentfiler og deres delte biblioteker for det angivne brugerland COMPONENTS. Standard: Alle komponenter i brugerland

Eksempler:

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

• --keep-work-dir

  Behold den genererede midlertidige arbejdsmappe efter oprettelse af pakken (ryddes op automatisk).

BUNDTSTRUKTUR

Outputbundtet er et enkelt komprimeret arkiv.

• Bundtbiblioteket på øverste niveau er værtsnavnet for det indsamlede system.
• Generelle værtskommandooutput går ind i en server/ Undermappe.
  Filnavnet er <command> +- <arguments> + suffiks (.txt som standard). Mellemrum erstattet med _, ikke-alfanumeriske tegn fjernet
  Eksempel: server/ip_-s_addr.txt – output of ip -s addr
• Produktkommandooutput går ind i komponentens undermappe. mdm/ For scli, sdc/ For drv_cfg, og så videre.
  Kommandonavn (scli, drv_cfg, og så videre) er strippet. Det første meningsfulde argument bliver filnavnet. Filer tildeles som det relevante suffiks, .txt som standard.

Eksempler: 

• • mdm/query_cluster.txt - produktion af scli --query_cluster
  • mdm/tgt_dump.txt - produktion af scli --debug_action --tgt_dump
  • sdc/query_mdms.txt - produktion af drv_cfg --query_mdms
  • sds/sdbg.txt - output fra SDBG dumpallscreens til SDS
• Produktkomponentfiler (i modsætning til kommandooutput), <component>/cfg, <component>/logs, og så videre
  Kopieret fra komponentens mappe med præfikset fjernet.

Eksempler: 

• • mdm/cfg/conf.txt - kopi af /opt/emc/scaleio/mdm/cfg/conf.txt
  • sds/logs/trc.0 - kopi af /opt/emc/scaleio/sds/logs/trc.0
• Værtsfilsystemfiler placeres på deres filsystemsti i forhold til bundtroden.

Eksempler:

• • etc/os-release - kopi af /etc/os-release
  • var/log/messages - kopi af /var/log/messages
  • proc/cpuinfo - kopi af /proc/cpuinfo
• Diagnostisk collector-filer (diag_coll) kopieres med /opt præfiks strippet, bevare intern struktur.
  Eksempel: diag_coll/logs/sar.0 - kopi af /opt/diag_coll/logs/sar.0
• Skjulte filer (punktum-præfiks) "skjules" ved at fjerne den førende prik.
• Utility udførelse log, get_info_run.log, placeret direkte under værtsnavnet>/roden <

Bundtmappetræstruktur:

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

FILTRERING AF PRODUKTLOG OG KERNEFILER

De indstillinger, der er beskrevet i dette afsnit, styrer, hvordan produktlogfiler (også kaldet sporingsfiler, f.eks. trc.0, trc.1, exp.0) og centrale dumpfiler vælges til medtagelse i det indsamlede bundt. De gør det ved at definere en referencetid, et tidsvindue omkring det og tællegrænser.

Når der ikke er angivet nogen filtreringsindstillinger, indsamles alle produktlogfiler og (hvis kerneindsamling er aktiveret) alle centrale dumpfiler. Filtreringsindstillingerne indsnævrer gradvist dette valg som beskrevet nedenfor.

Referencetidspunkt

En referencetid kan indstilles ved hjælp af enten -E/--event-time eller -C/--reference-core-file.

Hvis ingen af delene --event-time Eller --reference-core-file er angivet, udføres der ingen filtrering af tidsvinduet: referencetiden er som standard den aktuelle tid og bruges kun til nærhedsbaseret rækkefølge, når en optællingsgrænse (-m eller -k) er gældende (se Antalsgrænser nedenfor).

Hvis begge dele -E og -C vises, træder det sidste element på kommandolinjen i kraft.

Tidsvindue

Når der er indstillet en referencetid (ved hjælp af --event-time eller --reference-core-file), er der etableret et tidsvindue omkring det. Tidsvinduets omfang kan indstilles ved hjælp af -t/--minutes-before-event og/eller -T/--minutes-after-event, som som standard er henholdsvis 15 og 5 minutter. Kun filer, hvis indhold overlapper dette vindue, kan indsamles.

F.eks. -E "2020-03-20 14:30" -t 10 -T 3 Indsamler filer, der dækker perioden 14:20:00 til 14:33:00.

--minutes-before-event og --minutes-after-event ignoreres, når ingen af dem --event-time Eller --reference-core-file er angivet.

Grænser for antal

En filtællingsgrænse kan indstilles ved hjælp af -m/--max-traces og -k/--max-cores, for henholdsvis logfiler og kernefiler. Grænsen måles pr. komponent.

Når flere filer end NUM falder inden for tidsvinduet (eller er tilgængelige, hvis intet vindue er aktivt), indsamles de NUM-filer, der er tættest på referencetidspunktet.

Når en optællingsgrænse bruges uden --event-time eller --reference-core-file, er alle filer kandidater (uden tidsvindue), og de seneste NUM-filer er markeret.

Filtreringslogik

Filfiltrering gælder først for tidsvinduet og derefter for tællegrænsen:

1. Opret kandidater. Alle produktlogfiler og/eller kernedumpfiler for en komponent tælles.
2. Udlede indholdsperiode. Produktlogfilernes indhold repræsenterer et punktum. Indholdsperioden anses for at starte på forgængerens sidste ændringstidspunkt (mtime) eller UNIX-epoken, når der ikke findes nogen forgænger; Det ender ved filens egen mtime. Centrale dumpfiler repræsenterer et tidspunkt på filens mtime.
3. Anvend tidsvindue (hvis -E eller -C specificeret). Filer, hvis indhold falder helt uden for vinduet, kasseres fra markeringen. For produktlogfiler, hvis der ikke er nogen fil i vinduet, bevares den enkelte fil, der er tættest på vinduet, så bundtet aldrig er tomt for en komponent. For centrale dumpfiler gælder ingen sådan fallback.
4. Anvend antalsgrænse (hvis -m og/eller -k specificeret). Blandt de resterende filer er der højst NUM er valgt, idet man foretrækker dem, der er tættest på referencetiden. Filer før og efter referencetidspunktet konkurrerer ligeligt om valg.

GODKENDELSE

Hjælpeprogrammet forsøger at logge ind på den lokale MDM, hvis der registreres en primær MDM-proces, der lytter på den forventede port (standard: 6611)

MDM-loginmuligheder overføres til SCLI --login kommando og behandles af den.

Hvis login mislykkes, afsluttes værktøjet med en fejl.

Når login springes over, forsøges SCLI-kommandoer stadig (for at understøtte scenarier, hvor brugeren har logget på manuelt på forhånd). Efter tre SCLI-fejl vises en advarsel, og alle yderligere SCLI-kommandoer springes over.

Login springes over, når:

• Der findes ingen primær MDM-proces på den lokale vært.
• Ikonet --skip-mdm-login Indstillingen er angivet.

Login mislykkes, når:

• MDM-procesejeren findes ikke på listen over autoriserede brugere (standard: root), og sikkert login er aktiveret.
• The SCLI --login Kommandoen returnerer en fejl (f.eks. forkerte legitimationsoplysninger).

DISKPLADS

Krav til diskplads til midlertidige filer og den resulterende pakke kan variere betydeligt.

Værktøjet forsøger at minimere midlertidigt pladsforbrug; Det er begrænset til kommandoudgange og kopier af indsamlet virtuelt filsystem (/proc og /sys) filer.

Pakken kan streames fra en ekstern vært med --output-file=- for at minimere diskpladsforbruget på PowerFlex-værten. Bundtfilen skrives direkte til standardoutput (stdout), når du streamer; Den er ikke oprettet på disken.

Værktøjet estimerer den nødvendige diskplads til både den midlertidige arbejdsmappe og outputbundtet, før der indsamles data.

Hvis den estimerede krævede plads overstiger den ledige plads på de relevante filsystemer, afsluttes værktøjet med en fejl. Denne kontrol kan omgås med --skip-space-check.

Arbejdsmappen og outputmappen kan være placeret på forskellige filsystemer; Hver kontrolleres uafhængigt.

Det estimerede pladsbehov skrives til forsyningsselskabets logfil, get_info_run.log.

STATUS FOR AFSLUTNING

FILER

MILJØ

Forudsætninger

• Hjælpeprogrammet skal køres som root (eller en bruger med tilstrækkelige rettigheder til at læse komponentfiler, køre diagnosticeringskommandoer og få adgang /proc, /sysog så videre).
• Standard hjælpeprogrammer: tar, gzip, stat, find, awk, sed, getopt(1) (udvidet) nice.
• Valgfri: zip (til --zip), xz (til --xz), gdb/gcore (til --generate-cores)

Samtidighed

Kun én forekomst af get_info.sh kan køre ad gangen. Værktøjet søger efter en eksisterende kørende forekomst ved hjælp af pidof(1) og afsluttes, hvis der findes en forekomst.

Signalhåndtering

Hjælpeprogrammerne fælder: INT, EXITog TERM signaler under dataindsamling. Ved modtagelse af et signal:

1. Gendanner alle sikkerhedskopierede konfigurationsfiler (f.eks. indstillinger for kernegeneration).
2. Rydder op i midlertidige mapper
3. Afslut med status 1

Udførelsesloggen bevares, og dens sti udskrives til standardfejl.

Eksempler

Saml en standardsupportpakke:

get_info.sh

Stream et bundt via en SSH-forbindelse uden at oprette en pakkefil på fjernværten for PowerFlex:

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

Brug en anden arbejdsmappe for at undgå at fylde op /tmp:

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

Medtag tilpassede stier i bundtet:

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

Indsaml kun den nyeste kernedump for SDS- og MDM-komponenterne:

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

Indsaml data centreret omkring en kernefils ændringstid med et brugerdefineret tidsvindue:

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