Befehl "snap"

Zweck

Erfasst Systemkonfigurationsinformationen.

Syntax

snap [-@] [ -a ][-z "product_name=prd_name,..." | "class=myclass,.." | ALL][-M Timeout][ -A ] [ -b ] [ -B ] [ -c ] [ -C ] [ -D ] [ -f ] [ -F] [ -g ] [ -G ] [ -i ] [ -k ] [ -l ] [ -L ][ -n ] [ -N ] [ -p ] [ -r ] [ -R ] [ -s ] [ -S ] [ -t ] [ -T Dateiname ][-u user1,....] [ -w ] [ -X ] [ -Y ][ -o OutputDevice ] [ -d Dir ] [ -v Component ] [ ' -O FileSplitSize ] [ -P Files ] [ script1 script2... | All | file:filepath ][-U]

snap -e [ -m Knotenliste ] [ -d Verzeichnis

snap -z ADD ["product_name=prod_name" "class=myclass" "/tmp/myprod_myscript -a"]

snap -z DELETE ["product_name = prod_name" ]

Beschreibung

Verwenden Sie den Befehl snap -o /dev/rfd0, um das komprimierte Image auf eine Diskette zu kopieren. Verwenden Sie den Befehl snap -o /dev/rmt0, um das Image auf ein Band zu kopieren.

Der Befehl snap -g erfasst allgemeine Systeminformationen, einschließlich der folgenden:

• Fehlerbericht
• Kopie der angepassten ODM-Datenbank (Object Data Manager)
• Tracedatei
• Benutzerumgebung
• Physischer Hauptspeicher und Paging-Bereich
• Einheiten- und Attributinformationen
• Sicherheitsbenutzerinformationen
• Konfigurations- und Optimierungsparameter des Systems

Die Ausgabe des Befehls snap -g wird in die Datei /tmp/ibmsupt/general/general.snap geschrieben.

Der Befehl snap überprüft den verfügbaren Speicherplatz im Verzeichnis /tmp/ibmsupt, dem Standardverzeichnis für die Ausgabe des Befehls snap. Sie können die Ausgabe in ein anderes Verzeichnis schreiben, indem Sie das Flag -d verwenden. Wenn nicht genügend Speicherplatz vorhanden ist, um die Ausgabe des Befehls snap zu speichern, müssen Sie das Dateisystem erweitern.

Bei jeder Ausführung des Befehls snap werden Informationen in den zuvor erstellten Dateien angefügt. Verwenden Sie das Flag -r, um zuvor erfasste und gespeicherte Informationen zu entfernen.

Flags

Parameter

Argumente

Die Namen der auszuführenden Scripts anderer Anbieter werden als Parameter für snapangegeben. Ein Parameter kann ein einzelnes Wort oder eine in Anführungszeichen eingeschlossene Liste von Wörtern sein. Wenn Parameter in Anführungszeichen eingeschlossen sind, steht der erste Parameter in der Liste für den Namen des Scripts und die nachfolgenden Wörter sind die Argumente, die an das Script übergeben werden.

Wenn All als Parameter angegeben ist, werden alle Scripts im Script-Repository ausgeführt. In diesem Fall können keine Scriptparameter übergeben werden.

Wenn das Schlüsselwort file: verwendet wird und unmittelbar gefolgt von einem Pfad zu einer Datei, wird diese Datei gelesen, um die auszuführenden Scripts abzurufen. Jede Zeile in der Datei enthält ein Script und die optionalen Parameter für das Script.

snap-Scripts

Ein Script eines anderen Anbieters muss in /usr/lib/ras/snapscriptsausführbar sein und die unten beschriebenen Richtlinien befolgen. Wenn ein Script während Arbeitsgang 1 aufgerufen wird, muss es seine Größenschätzung an snapzurückgeben. In Arbeitsgang 2 werden die Daten erfasst und wie in snapangegeben gespeichert.

Das Script muss die Umgebungsvariablen SNAPDIR, PASSNO, SCRIPTSIZE und SCRIPTLOG lesen und verwenden.

Die Scripts oder Befehle können auch die Variable SNAPDEBUGDATA verwenden, um mehr über die vom snap-Script erfassten Debugdaten zu erfahren. Diese Variable enthält eine durch Kommas getrennte Liste mit Namen von Produkten, für die der Befehl snap die Daten während der Ausführung erfasst.

Alle Ausgabedateien müssen in $SNAPDIR geschrieben werden. Dies ist das Verzeichnis, in dem das Script seine Ausgabe speichern soll. Die PASSNO-Variable enthält die snap -Phase, in der das Script aufgerufen wird. Während des ersten Durchlaufs muss das Script eine Größenschätzung für die Daten erstellen, die während des zweiten Durchlaufs geschrieben werden. Anschließend schreibt das Script diese numerische Schätzung dann in die Datei, auf die $SCRIPTSIZE verweist. Der in der Datei gespeicherte Wert muss ein Dezimalwert sein. snap übergibt den Pfad an eine Protokolldatei, in der alle Debugdaten für das Script gespeichert werden sollen. Standard Out und Standard Error sollten nicht vom Skript umgeleitet werden, da ' snap Standard Out und Standard Error in $SNAPDIR/ 'SkriptName '.aus bzw. $SNAPDIR/ 'SkriptName '.err speichert.

#!/usr/bin/ksh


if [ "$PASSNO" = 1 ]
then
         (( size=99999 ))
        .... 
        # this is where code to do the size estimation should go.
        ....
        echo $size > $SCRIPTSIZE

else if [ "$PASSNO" = 2 ]
then
        # debug information should go to $SCRIPTLOG
        echo "Debug Data" >> $SCRIPTLOG

        # .....where the work to collect the data takes place
        # ...

        # The data collected should be written to $SNAPDIR        .
        touch $SNAPDIR/foo_output1
        touch $SNAPDIR/foo_output2
fi
fi

Aufteilung der snap-Ausgabe

Wenn sie aufgeteilt ist, könnte die Ausgabe von snap wie folgt aussehen:

% ls -l
total 112048
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xaa
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xab
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xac
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xad
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xae
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xaf
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xag
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xah
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xai
-rw-r--r--   1 lmic     adm          744518 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xaj

Scripts anderer Anbieter ausführen

Ein Befehl oder ein Script für die Erfassung der Debugdaten externer Produkte ist eine eigenständige ausführbare Datei. Das Script wird beim snap-Framework registriert, bevor es zum Erfassen benutzerdefinierter Debugdaten verwendet werden kann. Die Registrierung dieser Scripts kann nach Ermessen des Benutzers aufgehoben werden.

Im Folgenden sehen Sie eine im System definierte ODM-Klasse.

#define DEFAULTSIZE 256
#define DATA_VALUESIZE 1024

class snap_config {
        char product_name[DEFAULTSIZE]; key
        char class[DEFAULTSIZE];key
        char command_path[DATA_VALUESIZE];
        vchar sc_reserved1[DATA_VALUESIZE];
        vchar sc_reserved2[DATA_VALUESIZE];
}

Registrierung von Debug-Scripts anderer Anbieter beim snap-Framework

Registrierung von Debug-Scripts anderer Anbieter beim snap-Framework aufheben

Beispiele

1. Geben Sie den folgenden Befehl ein, um alle Systemkonfigurationsinformationen zu erfassen:

   snap -a

   Die Ausgabe dieses Befehls wird in das Verzeichnis /tmp /ibmsupt geschrieben.
2. Geben Sie den folgenden Befehl ein, um ein pax-Image aller Dateien im Verzeichnis /tmp/ibmsupt zu erstellen:

   snap -c

3. Geben Sie den folgenden Befehl ein, um allgemeine Systemkonfigurationsinformationen zu erfassen, einschließlich der Ausgabe des Befehls lslpp -hac:

   snap -g -o /dev/rfd0

   Die Ausgabe wird in die Dateien /tmp/ibmsupt/general/lslpp.hac und /tmp/ibmsupt/general/general.snap geschrieben. Dieser Befehl schreibt die Systeminformationen auch auf eine austauschbare Diskette.
4. Geben Sie den folgenden Befehl ein, um HACMP -spezifische Informationen von Knoten node1 und node2 zu erfassen, die zu einem einzelnen Cluster gehören:

   snap -e -m node1,node2

   Die Ausgabe wird in das Verzeichnis /tmp/ibmsupt/hacmp geschrieben.
5. Geben Sie Folgendes ein, um die Scripts "foo1", "foo2" und "foo3" auszuführen, wobei foo1 keine Argumente akzeptiert, foo2 drei Argumente und foo3 ein Argument akzeptiert:

   snap  foo1 "foo2 -x -y 3" "foo3 6"

   Die Ausgabe wird in /tmp/ibmsupt/snapscripts/foo1, /tmp/ibmsupt/snapscripts/foo2 und /tmp/ibmsupt/snapscripts/foo3 geschrieben, vorausgesetzt, das Zielverzeichnis ist das Standardverzeichnis /tmp/ibmsupt.
6. Geben Sie Folgendes ein, um den Parameter All für die Ausführung aller Scripts festzulegen:

   snap All

   Hinweis: In diesem Fall werden keine Parameter übergeben.
7. Geben Sie Folgendes ein, um den Pfad zu einer Datei anzugeben, die den Namen und die optionale Parameterliste der auszuführenden Scripts enthält:

   snap file:/tmp/scriptnames

   Im Folgenden sehen Sie eine Beispieleingabedatei zum Ausführen der Scripts aus Beispiel 5:

   foo1 
   foo2 -x -y 3
   foo6

8. Wenn die Ausgabe von snap in 4MB Dateien aufgeteilt werden soll, geben Sie Folgendes ein:

   snap -a -c -O 4

9. Geben Sie den folgenden Befehl ein, um nur die HACMP snap -e -Daten von Knoten node1 und node2zu übergeben:

   snap -e -m node1,node2
   snap -c

   Senden Sie die Datei <paxpax.zgemäß den Anweisungen des Kundendienstmitarbeiters an IBM.

10. Geben Sie die folgenden Befehle ein, um alle snap -Daten von Knoten node1 und node2zu übergeben:

    snap -e -m node1,node2
    snap -a
    snap -c 

    Senden Sie die Datei <paxpax.zgemäß den Anweisungen des Kundendienstmitarbeiters an IBM.

11. Geben Sie den folgenden Befehl ein, um ein Debug-Script im Verzeichnis /usr/lpp/abc/debug_abc des Produkts abc in der Klasse storage zu registrieren:

    snap -z ADD "product_name=abc" "class=storage" "command_path=/usr/lpp/abc/debug_abc -a"

12. Geben Sie den folgenden Befehl ein, um ein Debug-Script des Produkts abc zu registrieren:

    snap -z DELETE "product_name=abc"

13. Geben Sie den folgenden Befehl ein, um Debugdaten mehrerer Produkte zu erfassen:

    snap -z "product_name=abc, product_name=def"

Dateien