Befehl "ctsnap"

Online bearbeiten

Zweck

Erfasst Konfigurations-, Protokoll- und Traceinformationen zu den RSCT-Komponenten (Reliable Scalable Cluster Technology).

Syntax

Ctsnap [ -a ] [ -c Clusternamensmuster ] [ -C Cluster-ID-Muster ] [ -d ausgabeverzeichnis ] [ -D Dämonnamensmuster ] [ -k stackdump_default ] [ -n Knotennamensmuster ] [ -N Knoten-ID-Muster ] [ -p Tage | { -f Von_Datum -t. bis_Datum } ] [ -s Spoolverzeichnis ] [ -S Größe ] [ -x RPMTTR ] [ -h ] [ -z ]

Beschreibung

Der Befehl ctsnap stellt Konfigurations-, Protokoll-und Traceinformationen zu den RSCT-Komponenten zusammen, die mit AIX® oder PowerHA®installiert werden. Dieser Befehl erfasst Daten nur für den lokalen Knoten, auf dem er ausgeführt wird. Je nach installierten Programmen können dazu Informationen zu den folgenden Komponenten gehören:
  • Ressourcenmanager für Prüfprotokolle (IBM.AuditRM)
  • Cluster Security Services (ctsec)
  • Ressourcenmanager für Common Information Model (IBM.CIMRM)
  • Konfigurationsressourcenmanager (IBM.ConfigRM)
  • Ereignismanagement (ha_em)
  • Ressourcenmanager für Ereignisantworten (IBM.ERRM)
  • Ressourcenmanager für Dateisysteme (IBM.FSRM)
  • Erfassung von Fehlerdaten beim ersten Auftreten (ct_ffdc)
  • Gruppenservices (cthags)
  • Hostressourcenmanager (IBM.HostRM)
  • Ressourcenmanager mit geringster Berechtigung (IBM.LPRM)
  • Maschinennahe Anwendungsprogrammierschnittstelle (lapi)
  • Ressourcenmanager für den Verwaltungsbereich ( IBM®.MgmtDomainRM )
  • Ressourcenmanager für Mikrosensoren (IBM.MicroSensorRM)
  • Ressourcenmanager für Wiederherstellung (IBM.RecoveryRM)
  • Ressourcenüberwachung und -steuerung (ctrmc)
  • Ressourcenmanager für Sensoren (IBM.SensorRM)
  • Speicherressourcenmanager (IBM.StorageRM)
  • Topologieservices (cthats)
  • Gemeinsam genutzte virtuelle Platte (vsd) (unter AIX 6.1)
  • Wiederherstellbare gemeinsam genutzte virtuelle Platte (rvsd) (unter AIX 6.1)

Wenn bei einer dieser Komponenten ein Problem auftritt, können Sie diesen Befehl ausführen, um Ihrer Software-Service-Organisation Informationen bereitzustellen.

Die Ausgabe des Befehls ctsnap besteht aus einer komprimierten TAR-Datei (ctsnap.Knotenname.nnnnnnnn.tar.Z) und einer Protokolldatei (ctsnap.Knotenname.nnnnnnnn.log), wobei Knotenname für den Namen des Knotens steht, auf dem ctsnap ausgeführt wurde, und nnnnnnnn für die Zeitmarke der Ausführung des Befehls ctsnap. Stellen Sie Ihrer Software-Service-Organisation beide Dateien bereit. Standardmäßig speichert ctsnap diese Dateien im Verzeichnis /tmp/ctsupt. Mit dem Flag -d können Sie ein anderes Ausgabeverzeichnis angeben.

Bei Bedarf können Sie ctsnap verwenden, um Informationen zu Spool-Trace-Dateien zu erfassen. Verwenden Sie die Flags -c, -C, -D, -f, -n, -N, -p, -s, -S und -t, wenn Sie nur einen Teil der Traceinformationen erfassen möchten. Mit dem Befehl ctsnap -k stackdump_default können Sie einen Stackauszug für die folgenden RSCT-Subsysteme erstellen:
  • Ressourcenmanager für Prüfprotokolle (IBM.AuditRM)
  • Ressourcenmanager für Common Information Model (IBM.CIMRM)
  • Configuration Resource Manager (IBM.ConfigRM)
  • Ressourcenmanager für Ereignisantworten (IBM.ERRM)
  • Ressourcenmanager für Dateisysteme (IBM.FSRM)
  • Generischer Ressourcenmanager (IBM.GblResRM)
  • Gruppenservices (cthags)
  • Least-Privilege Resource Manager (IBM.LPRM)
  • Ressourcenmanager für Mikrosensoren (IBM.MicroSensorRM)
  • Ressourcenmanager für Wiederherstellung (IBM.RecoveryRM)
  • Ressourcenüberwachung und -steuerung (ctrmc)
  • Ressourcenmanager für Sensoren (IBM.SensorRM)
  • Speicherressourcenmanager (IBM.StorageRM)
  • Topologieservices (cthats)

Verwenden Sie das Flag -x, um die Tracedateiinhalte aller RSCT-Ressourcenmanager zu formatieren.

Sie können mit dem Befehl ctsnap auch das Stammverzeichnis für Traceerstellung und Protokollierung aus der Konfigurationsdatei für RSCT-Dateien ( ctfile.cfg) abrufen.

Flags

-a
Erfasst Informationen, die nur für HACMP-Cluster ( High Availability Cluster Multi-Processing (HACMP) unter dem Betriebssystem Linux® relevant sind.
-c Muster_für_Clusternamen
Gibt ein Auswahlmuster an, das die Traceerfassung auf bestimmte Clusternamen beschränkt. Das Muster wird als regulärer Ausdruck der Perl-Sprache interpretiert.
-C Muster_für_Cluster-IDs
Gibt ein Auswahlmuster an, das die Traceerfassung auf bestimmte Cluster-IDs beschränkt. Das Muster wird als regulärer Ausdruck der Perl-Sprache interpretiert.
-d Ausgabeverzeichnis
Gibt das Ausgabeverzeichnis an. Das Standardverzeichnis ist /tmp/ctsupt.
-D Muster_für_Dämonnamen
Gibt ein Auswahlmuster an, das die Traceerfassung auf bestimmte Dämonprozesse beschränkt. Das Muster wird als regulärer Ausdruck der Perl-Sprache interpretiert.
-f Anfangsdatum
Gibt das Datum an, ab dem Informationen erfasst werden sollen. Der Parameter Anfangsdatum hat das folgende Format:
yyyy-mm-dd[.hh[:mm[:ss]]]
Hinweis: Verwenden Sie -f in Verbindung mit dem Flag -t .
-k stackdump_default
Erstellt einen Stack Dump für diese RSCT-Subsysteme: cthags, cthats, ctrmc, IBM.AuditRM, IBM.CIMRM, IBM.ConfigRM, IBM.ERRM, IBM.FSRM, IBM.GblResRM, IBM.LPRM, IBM.MicroSensorRM, IBM.RecoveryRM, IBM.SensorRM und IBM.StorageRM.
-n Muster_für_Knotennamen
Gibt ein Auswahlmuster an, das die Traceerfassung auf bestimmte Knotennamen beschränkt. Das Muster wird als regulärer Ausdruck der Perl-Sprache interpretiert.
-N Muster_für_Knoten-IDs
Gibt ein Auswahlmuster an, das die Traceerfassung auf bestimmte Knoten-IDs beschränkt. Das Muster wird als regulärer Ausdruck der Perl-Sprache interpretiert.
-p Tage
Gibt an, wie viele Tage rückwirkend Traceinformationen erfasst werden sollen.
-s Spoolverzeichnis
Erfasst Tracedateien für das angegebene Spoolverzeichnis.
-S Größe
Gibt die maximale kumulative Größe aller zu erfassenden Tracedateien (in Megabyte) an.
-t Enddatum
Gibt das Datum an, bis zu dem Informationen erfasst werden sollen. Der Parameter Enddatum hat das folgende Format:
yyyy-mm-dd[.hh[:mm[:ss]]]
Hinweis: Verwenden Sie -t zusammen mit dem Flag -f .
-x runrpttr
Formatiert die Tracedateiinhalte aller RSCT-Ressourcenmanager.

Wenn Sie dieses Flag verwenden, nimmt die Größe der ctsnap-Ausgabedateien zu. Daher müssen Sie möglicherweise die Größe des Dateisystems erhöhen, das das Ausgabeverzeichnis enthält.

-h
Schreibt den Verwendungshinweis für den Befehl in die Standardausgabe.
-z
Verhindert die Erfassung der snap caa -Informationen auch in einer CAA-Umgebung (Cluster Aware AIX ).

Sicherheit

Nur root -Benutzer können diesen Befehl ausführen.

Exitstatus

0
Der Befehl wurde erfolgreich ausgeführt.
1
Der Befehl war nicht erfolgreich.

Standardausgabe

Wenn das Flag -h angegeben ist, wird der Verwendungshinweis für diesen Befehl in die Standardausgabe geschrieben.

Standardfehlerausgabe

Fehlernachrichten werden in die Standardfehlerausgabe (und in die Datei ctsnap.Hostname.nnnnnnnn.log ) geschrieben.

Implementierungsspezifikationen

Dieser Befehl ist Teil der Dateigruppe rsct.core.utils für das Betriebssystem AIX®.

Beispiele

  1. Geben Sie Folgendes ein, um Informationen zur RSCT-Unterstützung zu erfassen:
    ctsnap
  2. Geben Sie Folgendes ein, um RSCT-Unterstützungsinformationen zusammenzustellen und im Verzeichnis /tmp/mydir zu speichern:
    ctsnap -d /tmp/mydir
  3. Geben Sie Folgendes ein, um alle Tracedateien für das Verzeichnis /opt/traces zu erfassen:
    ctsnap -s /opt/traces
  4. Geben Sie Folgendes ein, um alle Tracedateien für die /opt/traces-Verzeichnisse der Dämonprozesse des Ressourcenmanagers für Konfigurationen zu erfassen:
    ctsnap -s /opt/traces -D '.*ConfigRM.*'
  5. Geben Sie Folgendes ein, um alle Tracedateien für das Verzeichnis /opt/traces für den Datumsbereich 08-28-2008 bis 08-29-2008 zu erfassen:
    ctsnap -s /opt/traces -f 08-28-2008 -t 08-29-2008
  6. Geben Sie Folgendes ein, um alle Tracedateien für das Verzeichnis /opt/traces für die letzten vier Tage zu erfassen:
    ctsnap -s /opt/traces -p 4
  7. Geben Sie Folgendes ein, um alle Tracedateien für das Verzeichnis /opt/traces für die letzten 50 MB an Traceinformationen zu erfassen:
    ctsnap -s /opt/traces -S 50

Position

/opt/rsct/bin/ctsnap
Enthält den Befehl ctsnap

Dateien

/tmp/ctsupt
Position des Standardverzeichnisses, das die Ausgabedateien enthält.
/tmp/ctsupt/ctsnap.Hostname.nnnnnnnn.log
Position der Protokolldatei zur Befehlsausführung, wobei nnnnnnnn für eine Zeitmarke und Hostname für den Namen des Hosts, auf dem der Befehl ausgeführt wurde, steht.
tmp/ctsupt/ctsnap.Hostname.nnnnnnnn.tar.Z
Position der komprimierten TAR-Datei, die die erfassten Daten enthält, wobei nnnnnnnn für eine Zeitmarke und Hostname für den Namen des Hosts, auf dem der Befehl ausgeführt wurde, steht.