snap コマンド

目的

システム構成情報を収集します。

構文

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

スナップ -e [ -m Nodelist ] [-d ディレクトリー ]

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

スナップ -z DELETE ["product_name = prod_name" ]

説明

圧縮されたイメージをディスケットにコピーするには、snap -o /dev/rfd0 コマンドを使用してください。 イメージをテープにコピーするには、snap -o /dev/rmt0 コマンドを使用してください。

snap -g コマンドは、以下の情報を含む一般システム情報を収集します。

• エラー報告
• カスタマイズされたオブジェクト・データ・マネージャー (ODM) データベースのコピー
• トレース・ファイル
• ユーザー環境
• 物理メモリーおよびページング・スペースの量
• デバイスおよび属性情報
• セキュリティー・ユーザー情報
• システムの構成およびチューニング・パラメーター情報

snap -g コマンドの出力は、/tmp/ibmsupt/general/general.snap ファイルに書き込まれます。

snap コマンドは、 snap コマンドの出力用のデフォルト・ディレクトリーである /tmp/ibmsupt ディレクトリー内で使用可能なスペースを検査します。 -d フラグを使用して、出力を別のディレクトリーに書き込むことができます。 snap コマンドの出力を入れる十分なスペースがない場合は、ファイルシステムを拡張しなければなりません。

snap コマンドを実行するたびに、情報が以前作成されたファイルに追加されます。 それまでに集めて保管されている情報を除去するには、-r フラグを使用してください。

フラグ

パラメーター

引数

実行するサード・パーティー・スクリプトの名前は、 snapに対するパラメーターとして指定されます。 パラメーターは、単一のワードの場合と、引用符で囲んだワードのリストの場合があります。 パラメーターを引用符で囲んだ場合、リスト内の最初のパラメーターはスクリプトの名前を表し、後続のワードはスクリプトに渡される引数を表します。

All をパラメーターとして指定すると、スクリプト・リポジトリー内のすべてのスクリプトが実行されます。 この場合は、スクリプト・パラメーターが渡されない場合があります。

file: キーワードが使用され、その直後にファイルへのパスがある場合、そのファイルが読み取られて、実行するスクリプトが取得されます。 ファイルの各行は、スクリプトと、そのスクリプトに対するオプション・パラメーターを表します。

snap スクリプト

サード・パーティー・スクリプトは、 /usr/lib/ras/snapscriptsで実行可能でなければならず、以下に示すガイドラインに従う必要があります。 パス 1 の間に呼び出された場合、スクリプトはそのサイズ見積もりを snapに返す必要があります。 パス 2 では、データを収集し、 snapの指定に従って保存します。

スクリプトは、環境変数 SNAPDIR、PASSNO、SCRIPTSIZE、および SCRIPTLOG を読み取って使用する必要があります。

スクリプトまたはコマンドは、SNAPDEBUGDATA 変数を使用して、スナップ・スクリプトによって収集されたデバッグ・データを認識することもできます。 この変数は、snap コマンドの実行時のデータ収集に使用する製品のコンマで区切られた名前を含みます。

出力ファイルはすべて $SNAPDIR に書き込む必要があります。 これはスクリプトがその出力を保管するディレクトリーです。 PASSNO 変数には、スクリプトが呼び出される snap フェーズが含まれます。 最初のパスのときに、スクリプトは 2 度目のパスの間に書き込むデータの推定サイズを計算します。 次に、スクリプトは、$SCRIPTSIZE が指すファイルにその推定数値を書き込みます。 ファイルに 保存される値は 10 進数でなければなりません。 snap は、スクリプトのすべてのデバッグ・データを保存する必要があるログ・ファイルにパスを渡します。 なぜなら、'snap標準出力と標準エラーをそれぞれ$SNAPDIR/'スクリプト名'.アウトと$SNAPDIR/'スクリプト名'.エラー'に保存するからである。

#!/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

snap 出力の分割

分割されている場合、 snap の出力は次のようになります。

% 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

サード・パーティー・スクリプトの実行

外部製品のデバッグ・データ収集のコマンドまたはスクリプトは、スタンドアロン実行可能プログラムです。 このスクリプトは、ユーザー定義のデバッグ・データの収集に使用できるようにするために、スナップ・フレームワークに登録されます。 これらのスクリプトは、ユーザーの自由裁量により登録を解除することができます。

システムで定義されている ODM クラスを以下に示します。

#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];
}

サード・パーティー・デバッグ・スクリプトのスナップ・フレームワークへの登録

サード・パーティー・デバッグ・スクリプトのスナップ・フレームワークからの登録解除

例

1. システム構成情報をすべて収集するには、次のコマンドを入力します。

   snap -a

   このコマンドの出力は、/tmp/ibmsupt ディレクトリーに書き込まれます。
2. /tmp/ibmsupt ディレクトリーに入っているすべてのファイルの pax イメージを作成するには、次のコマンドを入力します。

   snap -c

3. lslpp -hac コマンドの出力を含む一般的なシステム構成情報を収集するには、次のコマンドを入力します。

   snap -g -o /dev/rfd0

   出力は、/tmp/ibmsupt/general/lslpp.hac および /tmp/ibmsupt/general/general.snap ファイルに書き込まれます。 また、このコマンドは、システム情報を取り外し可能ディスケットにも書き込みます。
4. 以下のコマンドを入力して、単一クラスターに属するノード node1 および node2 から HACMP 固有の情報を収集します。

   snap -e -m node1,node2

   出力は /tmp/ibmsupt/hacmp ディレクトリーに書き込まれます。
5. スクリプト foo1、foo2、および foo3 があって、foo1 は引数をとらず、foo2 は 3 つの引数をとり、foo3 は 1 つの引数を取るとき、これらのスクリプトを実行するには、次のように入力します。

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

   出力は、宛先ディレクトリーがデフォルトの /tmp/ibmsuptであると想定して、 /tmp/ibmsupt/snapscripts/foo1、 /tmp/ibmsupt/snapscripts/foo2 、および /tmp/ibmsupt/snapscripts/foo3 に書き込まれます。
6. All パラメーターを指定してすべてのスクリプトを実行するには、次のように入力します。

   snap All

   注: この場合、パラメーターは渡されません。
7. 実行するスクリプトの名前とオプション・パラメーター・リストが入っているファイルへのパスを指定するには、次のように入力します。

   snap file:/tmp/scriptnames

   例 5 からスクリプトを実行するサンプル入力ファイルは、以下のとおりです。

   foo1 
   foo2 -x -y 3
   foo6

8. snap 出力を 4MB ファイルに分割する必要がある場合は、次のように入力します。

   snap -a -c -O 4

9. ノード node1 および node2から HACMP snap -e データのみを実行依頼するには、次のコマンドを入力します。

   snap -e -m node1,node2
   snap -c

   サービス担当者の指示に従って、<paxpax.zファイルをIBMに提出してください。

10. ノード node1 および node2からすべての snap データを実行依頼するには、以下のコマンドを入力します。

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

    サービス担当者の指示に従って、<paxpax.zファイルをIBMに提出してください。

11. 製品 abcの /usr/lpp/abc/debug_abc ディレクトリーにあるデバッグ・スクリプトをクラス storage に登録するには、次のコマンドを入力します。

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

12. 製品 abc のデバッグ・スクリプトの登録を解除するには、次のコマンドを入力します。

    snap -z DELETE "product_name=abc"

13. 複数の製品のデバッグ・データを収集するには、次のコマンドを入力します。

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

ファイル