PowerFlex: GET_INFO – Support Bundle Collection Utility

"get_info.sh" [OPTIONEN]

BESCHREIBUNG

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

Das Dienstprogramm sammelt Daten aus mehreren Quellen, darunter:

• Protokolle, Konfigurations- und Trace-Dateien für PowerFlex-Komponenten
• MDM/SCLI-Abfrageausgaben und internes Debug-Speicherabbild
• Interne Diagnose der PowerFlex-Komponente
• Betriebssystemkonfiguration, Protokolle und Laufzeitstatus
• Hardware-Bestandsaufnahme (Storage-Controller, Netzwerkgeräte, NVMe, NVDIMM usw.)
• Core-Speicherabbilder (vorhanden und optional nach Bedarf erzeugt)
• Statistik für 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.

Auf einem Host kann zu einem bestimmten Zeitpunkt jeweils nur eine Instanz von "get_info.sh" 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
  Alle Daten sammeln. Dies entspricht der Angabe von "--mdm-repository", "--collect-cores", "--max-cores=2", "--valgrind-cores" und "--analyse-diag-coll".

• -A, --analyse-diag-coll
  Analysieren von diagnostischen Data Collector-Daten ("diag coll")

• -b[COMPONENTS], --collect-cores[=COMPONENTS]
  Sammeln Sie vorhandene Core-Speicherabbilder für die durch Leerzeichen getrennte Liste der "KOMPONENTEN" für Nutzerland. Standard (wenn "COMPONENTS" ausgelassen wird): Alle Nutzerland-Komponenten

  Hinweis: Zwischen "-b" und "COMPONENTS" darf kein Leerzeichen stehen. Trennen Sie die lange Form durch =

  Beispiel

  -b'mdm sds'

  --collect-cores='mdm sds'

• -d OUT_DIR, --output-dir=OUT_DIR
  Speichern Sie das resultierende Bundle im Verzeichnis "OUT_DIR. " Standard: "<WORK_DIR>/scaleio-getinfo" (siehe "--work-dir").

• -f, --skip-mdm-login
  Überspringen Sie die Abfrage der Zugangsdaten für PowerFlex MDM. Nützlich, wenn sich der Nutzer bereits manuell angemeldet hat.

• -h, --help
  Hilfemeldung anzeigen und beenden In Kombination mit "--tech" werden auch Technikeroptionen angezeigt.

• -J, --xz
  Verwenden Sie für das erfasste Bundle das Format "tar/xz" anstelle der Standardeinstellung "tar/gz". Wird ignoriert, wenn "tar(1)" des Systems "--use-compress-program" nicht unterstützt 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. Nur nummerierte Protokolldateien der neuesten Generation werden erfasst und ausführbare Komponentendateien oder Bibliotheken sind beim Sammeln von Cores nicht enthalten. Die Verwendung dieser Option verringert die Unterstützbarkeit und ihre Verwendung wird nicht empfohlen.

• -m NUM, --max-traces=NUM
  Erfassen von PowerFlex-Trace-Dateien von jeder Komponente bis zur "NUM"-Ablaufverfolgungsdatei. Standardeinstellung: Alle Dateien

• -N, --skip-space-check
  Die Überprüfung des freien Speicherplatzes vor der Datenerhebung überspringen.

• -P PATH, --collect-path=PATH
  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
  Meldungen bei Standardausgabe unterdrücken.

• -r, --mdm-repository
  Erfassen Sie MDM-Repository-Dateien.

• -s, --skip-sdbg
  Die Erfassung der SDBG-Ausgabe (Diagnose-Debugger) wird übersprungen.

• -S, --pause-core-generation
  Die Core-Generierung von PowerFlex-Komponenten wird während der Datenerhebung angehalten. Die ursprüngliche Konfiguration wird nach Abschluss der Erfassung wiederhergestellt.

• -w WORK_DIR, --work-dir=WORK_DIR
  Verwenden Sie das Verzeichnis "WORK_DIR" für temporäre Dateien. Standardwert: /tmp.

• -x FILE, --output-file=FILE
  Speichern Sie das erfasste Bundle als Datei mit dem Namen "FILE". Das entsprechende Dateinamensuffix (".tgz", ".zip" usw.) wird automatisch hinzugefügt. Wenn "FILE" "-"(Bindestrich) ist, schreiben Sie das Bundle in die Standardausgabe (impliziert "--quiet"). Wenn ein Bundle in die Standardausgabe geschrieben wird, wird keine Bundle-Datei auf der Festplatte erstellt. Standardeinstellung: getInfoDump.

• -z, --zip
  Verwenden Sie das "zip"-Format für das erfasste Bundle anstelle der Standardeinstellung "tar/gz". Wird ignoriert, wenn "zip(1)" nicht auf dem System gefunden wird.

• --mdm-port=PORT
  Stellen Sie über Port "PORT" für SCLI-Befehle eine Verbindung zum MDM her. Standardeinstellung: SCLI-Standardverhalten.

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

• --tech
  Technikeroptionen in die Ausgabe der Hilfemeldung aufnehmen.

MDM-Anmeldeoptionen

Die folgenden Optionen werden an den SCLI-Befehl "--login" übergeben. Ihr Verhalten und ihre Standardwerte werden von SCLI gesteuert.

• -n, --use-nonsecure-communication
  Stellen Sie eine Verbindung zum MDM im nicht sicheren Modus her.

• -p PASSWORD, --password=PASSWORD
  Verwenden Sie "PASSWORD" für die Anmeldung beim PowerFlex-MDM. Standardeinstellung: SCLI-Standardverhalten

• -u USERNAME, --username=USERNAME
  Verwenden Sie "USERNAME" für die Anmeldung beim PowerFlex-MDM. Standardeinstellung: SCLI-Standardverhalten

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

• --management-system-ip=ADDRESS
  Stellen Sie unter "ADDRESS" eine Verbindung zu "SSO/M&O" her, um sich bei PowerFlex anzumelden. Standardeinstellung: SCLI-Standardverhalten

• --p12-password=PASSWORD
  Verschlüsseln Sie die PowerFlex-Anmeldedatei "PKCS#12" mit "PASSWORD". Standardeinstellung: SCLI-Standardverhalten

• --p12-path=FILE
  Speichern Sie die PowerFlex-Anmeldedatei "PKCS#12" als "FILE". Standardeinstellung: SCLI-Standardverhalten

Technikeroptionen

Die folgenden Optionen sind für die Verwendung durch Supporttechniker gedacht und werden in der Hilfemeldung nur angezeigt, wenn "--tech" angegeben ist.

• -c[COMPONENTS], --generate-cores[=COMPONENTS]
  Erzeugen Sie Core-Dateien (mit "gcore(1)") für die laufenden Prozesse der durch Leerzeichen getrennten Liste der "COMPONENTS" von user-land. Standard: alle user-land-Komponenten, impliziert "--collect-executables" und erfordert "gdb" und "gcore".

  Hinweis: Zwischen "-c" und "COMPONENTS" darf kein Leerzeichen stehen. Trennen Sie die lange Form mit "=".

  Beispiele:

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

• -C CORE_FILE, --reference-core-file=CORE_FILE
  Erfassen Sie Produktprotokolle und Cores in Bezug auf die letzte Ä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 in Bezug auf "REF_TIME" anstelle der Startzeit der Ausführung. Akzeptiert jedes Format, das mit "date(1)" verstanden wird. Impliziert "--collect-cores".

• -g[COMPONENTS], --valgrind-cores[=COMPONENTS]
  Erfassen Sie "valgrind"-Core-Speicherabbilder für die angegebenen "COMPONENTS" für das Nutzerland. Standardeinstellung: alle User-Land-Komponenten. Impliziert "--collect-executables".

   

  Hinweis: Zwischen "-b" und "COMPONENTS" darf kein Leerzeichen stehen. Trennen Sie die lange Form mit "="

  Beispiele:

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

• -t MIN, --minutes-before-event=MIN
  Erfassen Sie Produktprotokolle und Cores, die bis zu "MIN" Minuten vor der Referenzzeit generiert wurden. Standardeinstellung: 15

• -T MIN, --minutes-after-event=MIN
  Erfassen Sie Produktprotokolle und Cores, die bis zu "MIN" Minuten nach der Referenzzeit generiert wurden. Standardeinstellung: 5

• -X[COMPONENTS], --collect-executables[=COMPONENTS]
  Erfassen ausführbarer Komponentendateien und ihrer gemeinsam genutzten Bibliotheken für die angegebenen "COMPONENTS" für Nutzerland. Standardeinstellung: Alle Nutzerland-Komponenten

  Hinweis: Zwischen "-b" und "COMPONENTS" darf kein Leerzeichen stehen. Trennen Sie die lange Form mit "="

  Beispiele:

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

• --keep-work-dir
  Behalten Sie das erzeugte temporäre Arbeitsverzeichnis nach der Bundle-Erstellung bei (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 Hostbefehlsausgaben werden in das Unterverzeichnis "server/" verschoben.
  Der Dateiname lautet standardmäßig "<Befehl> + <Argumente> + Suffix (.txt". " Leerzeichen durch "_" ersetzt, nicht-alphanumerische Zeichen entfernt
  Beispiel: server/ip_-s_addr.txt - Ausgabe von "ip -s addr"
• Produktbefehlsausgaben gehen in das Unterverzeichnis der Komponente. "mdm/" für "scli", "sdc/" für "drv_cfg" usw.
  Der Befehlsname ("scli", "drv_cfg" usw.) wird entfernt. Das erste aussagekräftige Argument wird zum Dateinamen. Dateien werden standardmäßig als relevantes Suffix ".txt" zugewiesen.
  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>/logs" usw
  . Aus dem Verzeichnis der Komponente kopiert, 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 an ihrem Dateisystempfad relativ zum Bundle-Stamm platziert.
  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 kopiert, wobei das Präfix "/opt" entfernt wird, wobei die interne Struktur beibehalten wird.
  Beispiel: diag_coll/logs/sar.0 - Kopie von "/opt/diag_coll/logs/sar.0"
• Ausgeblendete Dateien (mit Punktpräfix) werden durch Entfernen des führenden Punktes "eingeblendet".
• Ausführungsprotokoll des Dienstprogramms, get_info_run.log, direkt unter dem Hostnamen>/Root <platziert

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 CORE-DATEIFILTERUNG

Die in diesem Abschnitt beschriebenen Optionen steuern, wie Produktprotokolldateien (auch als Ablaufverfolgungsdateien bezeichnet, z. B. "trc.0", "trc.1", "exp.0") und Core-Speicherabbilddateien für die Aufnahme in das erfasste Bundle ausgewählt werden. 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 (wenn die Core-Erfassung aktiviert ist) alle Core-Speicherabbilddateien erfasst. Die Filteroptionen schränken diese Auswahl schrittweise ein, wie unten beschrieben.

Referenzzeit
Eine Referenzzeit kann entweder mit "-E/--event-time" oder "-C/--reference-core-file" festgelegt werden.

Wenn weder "--event-time" noch "--reference-core-file" angegeben ist, wird keine Zeitfensterfilterung durchgeführt: Die Referenzzeit wird standardmäßig auf die aktuelle Uhrzeit zurückgesetzt und nur für die näherungsbasierte Sortierung verwendet, wenn eine Zählbegrenzung ("-m" oder "-k") wirksam ist (siehe Zählgrenzen unten).

Wenn sowohl "-E" als auch "-C" angezeigt werden, wird das letzte Element in der Befehlszeile wirksam.

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

Beispiel: "-E "2020-03-20 14:30" -t 10 -T 3" erfasst Dateien, die den Zeitraum von 14:20:00 bis 14:33:00 abdecken.

"--minutes-before-event" und "--minutes-after-event" werden ignoriert, wenn weder "--event-time" noch "--reference-core-file" angegeben sind.

Anzahlbegrenzungen
Eine Begrenzung der Dateianzahl kann mit "-m/--max-traces" und "-k/--max-cores" für Protokolldateien bzw. Core-Dateien festgelegt werden. Der Grenzwert wird pro Komponente gemessen.

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

Wenn eine Zählbegrenzung ohne "--event-time" oder "--reference-core-file" verwendet wird, sind alle Dateien Kandidaten (kein Zeitfenster) und die neuesten NUM-Dateien werden ausgewählt.

Filterlogik
Die Dateifilterung gilt zuerst für das Zeitfenster und dann für die Zählgrenze:

1. Ermitteln Sie die Kandidaten. Alle Produktprotokolldateien und/oder Core-Speicherabbilddateien für eine Komponente werden aufgeführt.
2. Ableiten des Inhaltszeitraums. Der Inhalt der Produktprotokolldateien stellt einen Zeitraum dar. Es wird davon ausgegangen, dass der Inhaltszeitraum mit der letzten Modifizierungszeit ("mtime") des Vorgängers oder der UNIX-Epoche beginnt, wenn kein Vorgänger vorhanden ist. Er endet mit der eigenen "mtime" der Datei. Core-Speicherabbilddateien stellen einen Point-in-Time zum "mtime" der Datei dar.
3. Wenden Sie ein Zeitfenster an (wenn "-E" oder "-C" angegeben ist). Dateien, deren Inhalt vollständig außerhalb des Fensters liegt, werden aus der Auswahl ausgeschlossen. Wenn bei Produktprotokolldateien keine Datei innerhalb des Fensters liegt, wird die einzige Datei, die dem Fenster am nächsten liegt, aufbewahrt, sodass das Bundle für eine Komponente nie leer ist. Für Core-Speicherabbilddateien gilt kein solcher Fallback.
4. Wenden Sie die Begrenzung der Anzahl an (wenn "-m" und/oder "-k" angegeben ist). Unter den verbleibenden Dateien wird höchstens "NUM" ausgewählt, wobei diejenigen bevorzugt werden, die der Referenzzeit am nächsten liegen. Dateien, die vor und nach der Referenzzeit liegen, 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 Anschluss überwacht (Standardeinstellung: 6611)

MDM-Anmeldeoptionen werden an den SCLI-Befehl "--login" übergeben und 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" wird angegeben.

Die Anmeldung schlägt fehl , wenn:

• Der Eigentümer des MDM-Prozesses ist nicht in der Liste der autorisierten Nutzer enthalten (Standard: "root") und die sichere Anmeldung ist aktiviert.
• Der SCLI-Befehl "--login" gibt einen Fehler zurück (z. B. falsche Zugangsdaten).

SPEICHERPLATZ

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

Das Dienstprogramm versucht, die temporäre Speicherplatznutzung zu minimieren. Sie ist auf Befehlsausgaben und Kopien der erfassten virtuellen Dateisystemdateien ("/proc" und "/sys") beschränkt.

Das Bundle kann von einem Remotehost mit "--output-file=-" gestreamt werden, um die Speicherplatznutzung auf dem PowerFlex-Host zu minimieren. Die Bundle-Datei wird beim Streaming direkt in die Standardausgabe ("stdout") geschrieben. Er wird nicht auf Festplatte erstellt.

Das Dienstprogramm schätzt den erforderlichen Speicherplatz für das temporäre Arbeitsverzeichnis und das Ausgabepaket vor der Datenerfassung.

Wenn der geschätzte erforderliche Speicherplatz den verfügbaren Speicherplatz auf den relevanten Dateisystemen ü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. Jeder wird unabhängig geprüft.

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

BEENDIGUNGSSTATUS

DATEIEN

UMGEBUNG

Voraussetzungen

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

Parallelität
Es kann jeweils nur eine Instanz von "get_info.sh" ausgeführt werden. Das Dienstprogramm prüft mit "pidof(1)" auf eine vorhandene ausgeführte Instanz und wird beendet, wenn eine Instanz gefunden wird.

Signalbehandlung
Das Dienstprogramm fängt die Signale "INT", "EXIT" und "TERM" während der Datenerfassung ab. Beim Empfang eines Signals:

1. Stellt alle gesicherten Konfigurationsdateien wieder her (z. B. Einstellungen für die Core-Generation).
2. Bereinigt temporäre Verzeichnisse
3. Exits mit Status 1

Das Ausführungsprotokoll wird beibehalten und der Pfad wird als Standardfehler ausgegeben.

Beispiele
Erfassen eines Standardsupportbündels:

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 das Ausfüllen von "/tmp" zu vermeiden:

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 das neueste Core-Speicherabbild nur für die SDS- und MDM-Komponenten:

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

Sammeln Sie Daten, die sich auf die Änderungszeit einer Core-Datei mit einem nutzerdefinierten Zeitfenster konzentrieren:

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