PowerFlex: GET_INFO – Dienstprogramm zur Erfassung von Supportbündeln

get_info.sh [OPTIONEN]

BESCHREIBUNG

get_info.sh ist ein Diagnosedienstprogramm, das Debug-Informationen von einem PowerFlex-Host (ehemals ScaleIO) sammelt und in einem komprimierten Bundle zur Analyse durch Supportmitarbeiter archiviert.

Das Dienstprogramm sammelt Daten aus mehreren Quellen, darunter:

• PowerFlex-Komponentenprotokolle, -Konfiguration und -Trace-Dateien
• MDM/SCLI-Abfrageausgaben und interne Debug-Speicherabbilder
• Interne Diagnose der PowerFlex-Komponente
• Konfiguration, Protokolle und Laufzeitstatus des Betriebssystems
• Hardwarebestand (Speicher-Controller, Netzwerkgeräte, NVMe, NVDIMM usw.)
• Core-Speicherabbilder (vorhanden und optional nach Bedarf generiert)
• Statistik des Diagnostic Data Collector (diag_coll)

Das resultierende Bundle ist ein einzelnes komprimiertes Archiv (standardmäßig tar/gz), das zur weiteren Analyse an den PowerFlex-Support übertragen werden kann.

Es kann immer nur eine Instanz von get_info.sh auf einem Host ausgeführt werden. Wenn nicht genügend freier Speicherplatz für die Ausgabe vorhanden ist, wird die Ausführung verweigert (es sei denn, die Speicherplatzprüfung wird explizit übersprungen).

OPTIONEN

Allgemeine Optionen

• -a, --all

  Sammeln Sie alle Daten. Dies entspricht der Angabe von --mdm-repository, --collect-cores, --max-cores=2, --valgrind-cores und --analyse-diag-coll.

• -A, --Analyse-Diag-coll

  Analysieren von Diagnostic Data Collector-Daten (diag coll)

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

  Erfassen Sie vorhandene Core-Speicherabbilder für die durch Leerzeichen getrennte Liste von User-Land-KOMPONENTEN. Standard (wenn COMPONENTS weggelassen wird): alle User-Land-Komponenten.

  Hinweis: Es darf kein Leerzeichen zwischen -b und KOMPONENTEN. Für die lange Form trennen Sie mit =

   

  Beispiele:

  -b'mdm sds'

  --collect-cores='mdm sds'

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

  Speichern Sie das resultierende Bundle im Verzeichnis OUT_DIR. Default: <WORK_DIR>/scaleio-getinfo (siehe --work-dir).

• -f, --skip-mdm-login

  Überspringen Sie die Abfrage der Anmeldedaten für PowerFlex MDM. Nützlich, wenn sich der Nutzer bereits manuell angemeldet hat.

• -h, --help

  Zeigen Sie die Hilfemeldung an und beenden Sie den Vorgang. In Kombination mit --tech werden auch Technikeroptionen angezeigt.

• -J, --xz

  Verwenden Sie das tar/xz-Format für das erfasste Bundle anstelle des Standardformats tar/gz. Ignoriert, wenn die tar(1) Unterstützt nicht --use-compress-program oder xz(1) nicht gefunden wird.

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

  Erfassen Sie bis zu NUM-Core-Dateien von jeder Komponente. Standardeinstellung: alle Core-Dateien. Impliziert --collect-cores.

• -l, --light

  Erzeugen Sie ein Lichtbündel. Es wird nur die neueste Generation nummerierter Protokolldateien erfasst und ausführbare Komponentendateien/-bibliotheken werden bei der Core-Erfassung nicht berücksichtigt. Die Verwendung dieser Option verringert die Unterstützbarkeit und daher wird von ihrer Verwendung abgeraten.

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

  Erfassen Sie von jeder Komponente PowerFlex-Trace-Dateien bis zu NUM. Standardeinstellung: alle Dateien.

• -N, --skip-space-check

  Überspringen Sie die Überprüfung des freien Speicherplatzes vor der Datenerfassung.

• -P PFAD,--collect-path=PFAD

  Erfassen Sie den zusätzlichen Pfad PATH. Es werden nur absolute Pfade akzeptiert. Akzeptiert Platzhalter; Platzhalter sollten in Anführungszeichen gesetzt werden. Diese Option kann mehrmals angegeben werden, um mehrere Pfade zu erfassen.

• -q, --quiet, --silent

  Unterdrückt Meldungen in der Standardausgabe.

• -r, --mdm-repository

  Erfassen Sie MDM-Repository-Dateien.

• -s, --skip-sdbg

  Überspringen Sie die Erfassung der SDBG-Ausgabe (Diagnose-Debugger).

• -S, --pause-core-generation

  Halten Sie die Core-Generierung von PowerFlex-Komponenten während der Datenerhebung an. Die ursprüngliche Konfiguration wird nach Abschluss der Erfassung wiederhergestellt.

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

  Verwenden Sie das WORK_DIR für temporäre Dateien. Default: /tmpherunter.

• -x DATEI,--output-file=DATEI

  Speichern Sie das erfasste Bundle als Datei mit dem Namen FILE. Das entsprechende Dateinamensuffix (.tgz, .zipusw.) wird automatisch hinzugefügt. Wenn FILE - (Bindestrich), schreibt das Bundle in die Standardausgabe (impliziert --quiet). Wenn das Bundle in die Standardausgabe geschrieben wird, wird keine Bundle-Datei auf der Festplatte erstellt. Default: getInfoDumpherunter.

• -z, --zip

  Verwenden Sie das ZIP-Format für das erfasste Bundle anstelle des Standardformats tar/gz. Ignoriert, wenn zip(1) wurde auf dem System nicht gefunden.

• --mdm-port=PORT

  Stellen Sie eine Verbindung zum MDM her, indem Sie Port PORT für SCLI-Befehle verwenden. Standard: SCLI Standardverhalten.

• --überschreiben-Ausgabe-Datei

  Überschreiben Sie die Ausgabedatei, wenn sie bereits vorhanden ist. Wenn eine Ausgabedatei oder ein Ausgabeverzeichnis explizit angegeben wird (über -x oder -d), besteht das Standardverhalten darin, das Überschreiben abzulehnen. Diese Option überschreibt dies.

• --Tech

  Fügen Sie Technikeroptionen in die Ausgabe der Hilfemeldung ein.

MDM-Anmeldeoptionen

Die folgenden Optionen werden an die SCLI übergeben --login . Ihr Verhalten und ihre Standardwerte werden durch SCLI geregelt.

• -n, --use-nonsecure-communication

  Stellen Sie eine Verbindung zum MDM im nicht gesicherten Modus her.

• -p KENNWORT,--password=PASSWORT

  Verwenden Sie PASSWORD für die PowerFlex-MDM-Anmeldung. Default: SCLI-Standardverhalten.

• -u BENUTZERNAME,--username=BENUTZERNAME

  Verwenden Sie USERNAME für die PowerFlex-MDM-Anmeldung. Standard: SCLI Standardverhalten.

• --ldap-Authentifizierung

  Melden Sie sich mit LDAP-basierter Authentifizierung bei PowerFlex MDM an.

• --management-system-ip=ADRESSE

  Stellen Sie eine Verbindung zu SSO/M&O unter der Adresse für die PowerFlex-Anmeldung her. Standard: SCLI Standardverhalten.

• --p12-password=PASSWORT

  Verschlüsseln Sie die PowerFlex-Anmelde-PKCS#12-Datei mit PASSWORD. Standard: SCLI Standardverhalten.

• --p12-path=DATEI

  Speichern Sie die PowerFlex-Anmeldedatei PKCS#12 als FILE. Standard: SCLI Standardverhalten.

Technikeroptionen

Die folgenden Optionen sind für Supporttechniker vorgesehen und werden nur dann in der Hilfemeldung angezeigt, wenn --tech angegeben ist.

-c[KOMPONENTEN],--generate-cores[=KOMPONENTEN]

Generieren von Core-Dateien (über gcore(1)) für die laufenden Prozesse der durch Leerzeichen getrennten Liste von User-Land-KOMPONENTEN. Standardeinstellung: alle User-Land-Komponenten. Impliziert --collect-executables. Erfordert gdb und gcoreherunter.

Beispiele:

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

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

  Erfassen Sie Produktprotokolle und Cores relativ zur letzten Änderungszeit (mtime) von CORE_FILE anstelle der Startzeit der Ausführung. Impliziert --collect-cores.

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

  Erfassen Sie Produktprotokolle und Cores relativ zum REF_TIME anstatt zur Startzeit der Ausführung. Akzeptiert jedes Format, das von date(1)herunter. Impliziert --collect-cores.

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

Sammeln Sie Valgrind-Core-Dumps für die angegebenen User-Land-KOMPONENTEN. Standardeinstellung: alle User-Land-Komponenten. Impliziert --collect-executables.

Hinweis: Es darf kein Leerzeichen zwischen -b und KOMPONENTEN. Für die lange Form trennen Sie mit =

Beispiele:

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

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

  Erfassen Sie Produktprotokolle und -kerne, die bis zu MIN-Minuten vor der Referenzzeit generiert wurden. Default: 15.

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

  Erfassen Sie Produktprotokolle und -kerne, die bis zu Minuten nach der Referenzzeit generiert wurden. Default: 5.

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

  Erfassen Sie ausführbare Komponentendateien und ihre gemeinsam genutzten Bibliotheken für die angegebenen KOMPONENTEN auf Benutzerland. Standardeinstellung: alle User-Land-Komponenten.

  Hinweis: Es darf kein Leerzeichen zwischen -b und KOMPONENTEN. Für die lange Form trennen Sie mit =

  Beispiele:

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

• --keep-work-dir

  Behalten Sie das erzeugte temporäre Arbeitsverzeichnis nach der Bundle-Erstellung bei (normalerweise automatisch bereinigt).

BUNDLE-STRUKTUR

Das Ausgabe-Bundle ist ein einzelnes komprimiertes Archiv.

• Das Bundle-Verzeichnis der obersten Ebene ist der Hostname des erfassten Systems.
• Allgemeine Ausgaben von Hostbefehlen werden in eine server/ Unterverzeichnis.
  Der Dateiname lautet <command> + <arguments> + Suffix (.txt standardmäßig). Leerzeichen ersetzt durch _, nicht-alphanumerische Zeichen entfernt.
  Beispiel: server/ip_-s_addr.txt – Ausgabe von ip -s addr
• Produktbefehlsausgaben werden in das Unterverzeichnis der Komponente übertragen. mdm/ Für scli, sdc/ Für drv_cfgEtc.
  Befehlsname (scli, drv_cfgusw.) abgestreift wird. Das erste sinnvolle Argument ist der Dateiname. Dateien wird das entsprechende Suffix zugewiesen, .txt Standardmäßig.
  Beispiele:
  • mdm/query_cluster.txt – Ausgabe von scli --query_cluster
  • mdm/tgt_dump.txt – Ausgabe von scli --debug_action --tgt_dump
  • sdc/query_mdms.txt – Ausgabe von drv_cfg --query_mdms
  • sds/sdbg.txt – Ausgabe von SDBG dumpallscreens für SDS
• Produktkomponentendateien (im Gegensatz zu Befehlsausgaben), <component>/cfg, <component>/logsEtc.
  Kopiert aus dem Verzeichnis der Komponente, wobei das Präfix entfernt wurde.
  Beispiele:
  • mdm/cfg/conf.txt – Kopie von /opt/emc/scaleio/mdm/cfg/conf.txt
  • sds/logs/trc.0 – Kopie von /opt/emc/scaleio/sds/logs/trc.0
• Hostdateisystemdateien werden in Bezug auf den Bundle-Stamm an ihrem Dateisystempfad abgelegt.
  Beispiele:
  • etc/os-release – Kopie von /etc/os-release
  • var/log/messages – Kopie von /var/log/messages
  • proc/cpuinfo – Kopie von /proc/cpuinfo
• Diagnostic Collector (diag_coll)-Dateien werden mit dem Befehl /opt Das Präfix wurde entfernt, um die interne Struktur zu erhalten.
  Beispiel: diag_coll/logs/sar.0 – Kopie von /opt/diag_coll/logs/sar.0
• Ausgeblendete Dateien (mit Präfix) werden durch Entfernen des führenden Punktes "eingeblendet".
• Ausführungsprotokoll des Dienstprogramms, get_info_run.log, die direkt unter dem Hostnamen>/Root <platziert wird.

Bundle-Verzeichnisstruktur:

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

PRODUKTPROTOKOLL UND FILTERUNG VON CORE-DATEIEN

Die in diesem Abschnitt beschriebenen Optionen steuern, wie Produktprotokolldateien (auch Trace-Dateien genannt, z. trc.0, trc.1, exp.0) und Core-Speicherabbilddateien werden für die Aufnahme in das erfasste Bundle ausgewählt. Sie tun dies, indem sie eine Referenzzeit, ein Zeitfenster um sie herum und Zählgrenzen definieren.

Wenn keine Filteroptionen angegeben werden, werden alle Produktprotokolldateien und (bei aktivierter Core-Sammlung) alle Core-Speicherabbilddateien erfasst. Die Filteroptionen schränken diese Auswahl schrittweise ein, wie unten beschrieben.

Referenzzeit

Eine Referenzzeit kann mit folgenden Parametern eingestellt werden: -E/--event-time oder -C/--reference-core-fileherunter.

Wenn keiner von beiden --event-time Noch --reference-core-file angegeben ist, wird keine Zeitfensterfilterung durchgeführt: Die Referenzzeit wird standardmäßig auf die aktuelle Zeit festgelegt und nur für die näherungsbasierte Reihenfolge verwendet, wenn eine Zählgrenze (-m oder -k) in Kraft ist (siehe Grenzwerte für die Anzahl unten).

Wenn beide -E und -C angezeigt wird, wird der letzte auf der Befehlszeile wirksam.

Zeitfenster

Wenn eine Referenzzeit eingestellt ist (mit --event-time oder --reference-core-file), wird ein Zeitfenster um ihn herum eingerichtet. Der Umfang des Zeitfensters kann mithilfe von -t/--minutes-before-event und/oder -T/--minutes-after-event, die standardmäßig auf 15 bzw. 5 Minuten festgelegt sind. Nur Dateien, deren Inhalt sich mit diesem Fenster überschneidet, können erfasst werden.

Zum Beispiel: -E "2020-03-20 14:30" -t 10 -T 3 Sammelt Dateien für den Zeitraum von 14:20:00 bis 14:33:00.

--minutes-before-event und --minutes-after-event werden ignoriert, wenn keiner von beiden --event-time Noch --reference-core-file angegeben wird.

Begrenzungen der Anzahl

Ein Grenzwert für die Dateianzahl kann mithilfe von -m/--max-traces und -k/--max-cores, für Protokolldateien bzw. Core-Dateien. Der Grenzwert wird pro Komponente gemessen.

Wenn mehr Dateien als NUM in das Zeitfenster fallen (oder verfügbar sind, wenn kein Fenster aktiv ist), werden die NUM-Dateien gesammelt, die der Referenzzeit am nächsten liegen.

Wenn eine Zählbegrenzung ohne --event-time oder --reference-core-filesind alle Dateien Kandidaten (kein Zeitfenster) und die neuesten Dateien der NUM werden ausgewählt.

Filterlogik

Bei der Dateifilterung wird zuerst das Zeitfenster und dann die Anzahlbegrenzung angewendet:

1. Etablieren Sie Kandidaten. Alle Produktprotokolldateien und/oder Core-Speicherabbilddateien für eine Komponente werden aufgelistet.
2. Zeitraum der Ableitung von Inhalten. Der Inhalt der Produktprotokolldateien stellt einen Zeitraum dar. Es wird davon ausgegangen, dass der Inhaltszeitraum mit der letzten Änderung des Vorgängers (mtime) oder der UNIX-Epoche beginnt, wenn kein Vorgänger vorhanden ist. Sie endet mit der eigenen mtime der Datei. Core-Speicherabbilddateien stellen einen Point-in-Time zum mtime der Datei dar.
3. Zeitfenster anwenden (falls -E oder -C spezifiziert). Dateien, deren Inhalt vollständig außerhalb des Fensters liegt, werden aus der Auswahl ausgeschlossen. Wenn bei Produktprotokolldateien keine Datei in das Fenster fällt, wird die einzelne Datei, die dem Fenster am nächsten ist, aufbewahrt, sodass das Bundle für eine Komponente nie leer ist. Für Kernspeicherabbilddateien gilt kein solcher Fallback.
4. Anwenden der Anzahlbegrenzung (falls -m und/oder -k spezifiziert). Unter den übrigen Dateien werden höchstens NUM ausgewählt, wobei diejenigen bevorzugt werden, die der Referenzzeit am nächsten liegen. Dateien vor und nach der Referenzzeit konkurrieren gleichermaßen um die Auswahl.

AUTHENTIFIZIERUNG

Das Dienstprogramm versucht, sich beim lokalen MDM anzumelden, wenn ein primärer MDM-Prozess erkannt wird, der den erwarteten Port überwacht (Standardeinstellung: 6611).

MDM-Anmeldeoptionen werden an die SCLI übergeben --login Befehl und werden von ihm verarbeitet.

Wenn die Anmeldung fehlschlägt, wird das Dienstprogramm mit einem Fehler beendet.

Wenn die Anmeldung übersprungen wird, werden weiterhin SCLI-Befehle versucht (zur Unterstützung von Szenarien, in denen sich der Nutzer zuvor manuell angemeldet hat). Nach drei SCLI-Fehlern wird eine Warnung angezeigt und alle weiteren SCLI-Befehle werden übersprungen.

Die Anmeldung wird übersprungen, wenn:

• Es wurde kein primärer MDM-Prozess auf dem lokalen Host gefunden.
• Die Option --skip-mdm-login ist angegeben.

Die Anmeldung schlägt fehl, wenn:

• Der MDM-Prozesseigentümer ist nicht in der Liste der autorisierten Nutzer enthalten (Standardeinstellung: root) und die sichere Anmeldung aktiviert ist.
• Der SCLI --login Der Befehl gibt einen Fehler zurück (z. B. falsche Anmeldeinformationen).

SPEICHERPLATZ

Die Speicherplatzanforderungen für temporäre Dateien und das resultierende Bundle können erheblich variieren.

Das Dienstprogramm versucht, die temporäre Speicherplatznutzung zu minimieren. Sie ist auf Befehlsausgaben und Kopien des erfassten virtuellen Dateisystems (/proc und /sys) Dateien.

Um die Speicherplatzauslastung auf dem PowerFlex-Host zu minimieren, kann das Bundle mit --output-file=- von einem Remotehost gestreamt werden. Beim Streaming wird die Bundle-Datei direkt in die Standardausgabe (stdout) geschrieben. Es wird nicht auf der Festplatte erstellt.

Vor der Datenerfassung schätzt das Dienstprogramm den erforderlichen Speicherplatz für das temporäre Arbeitsverzeichnis und das Ausgabe-Bundle.

Wenn der geschätzte erforderliche Speicherplatz den verfügbaren Speicherplatz auf dem/den relevanten Dateisystem(en) überschreitet, wird das Dienstprogramm mit einem Fehler beendet. Diese Prüfung kann mit --skip-space-check umgangen werden.

Das Arbeitsverzeichnis und das Ausgabeverzeichnis können sich auf unterschiedlichen Dateisystemen befinden. Jede wird unabhängig geprüft.

Der geschätzte Speicherplatzbedarf wird in die Protokolldatei des Dienstprogramms geschrieben. get_info_run.logherunter.

BEENDIGUNGSSTATUS

DATEIEN

UMGEBUNG

Voraussetzungen

• Das Dienstprogramm muss als Root-Nutzer ausgeführt werden (oder als NutzerIn mit ausreichenden Berechtigungen zum Lesen von Komponentendateien, zum Ausführen von Diagnosebefehlen und zum Zugriff auf /proc, /sysusw.).
• Standard-Dienstprogramme: tar, gzip, stat, find, awk, sed, getopt(1) (erweitert), niceherunter.
• Optional: zip (für --zip), xz (für --xz), gdb/gcore (für --generate-cores) enthalten.

Parallelität

Es kann jeweils nur eine Instanz von get_info.sh ausgeführt werden. Das Dienstprogramm prüft, ob eine vorhandene Instanz ausgeführt wird über pidof(1) und beendet, wenn eine gefunden wird.

Signalverarbeitung

Die Dienstprogramm-Traps INT, EXITund TERM Signale während der Datenerfassung. Beim Empfang eines Signals:

1. Stellt alle gesicherten Konfigurationsdateien wieder her (z. B. Core-Generierungseinstellungen).
2. Bereinigt temporäre Verzeichnisse.
3. Beendet mit Status 1.

Das Ausführungsprotokoll wird beibehalten und der Pfad wird mit Standardfehler gedruckt.

BEISPIELE

Erfassen eines Standard-Support-Bundles:

get_info.sh

Streamen Sie ein Bundle über eine SSH-Verbindung, ohne eine Bundle-Datei auf dem PowerFlex-Remotehost zu erstellen:

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

Verwenden Sie ein anderes Arbeitsverzeichnis, um eine Auslastung zu vermeiden /tmpverwalten:

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

Nutzerdefinierte Pfade in das Bundle aufnehmen:

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

Erfassen Sie den neuesten Core-Speicherabbild nur für die SDS- und MDM-Komponenten:

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

Erfassen Sie Daten, die sich um die Änderungszeit einer Core-Datei drehen, mit einem nutzerdefinierten Zeitfenster:

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