snap コマンド

目的

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

構文

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 Filename ][-u user1,...] [ -w ] [ -X ] [ -Y ][ -o OutputDevice ] [ -d Dir ] [ -v Component ] [ -O FileSplitSize ] [ -P Files ] [ script1 script2 ... | All | file:filepath ] [-U]

snap -e [ -m Nodelist ] [ -d Dir ]

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

snap -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/ScriptName .out と $SNAPDIR/ScriptName .err にそれぞれ保存するため、スクリプトで標準出力と標準エラーをリダイレクトすることはできません。

#!/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. 1 つのクラスターに属するノード 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. HACMP snap -e データのみをノード node1 と node2 から実行依頼するには、次のコマンドを入力します。

   snap -e -m node1,node2
   snap -c

   サービス担当員の指示に従って、<pax.z> ファイルを IBM に実行依頼します。

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

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

    サービス担当員の指示に従って、<pax.z> ファイルを IBM に実行依頼します。

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

    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"

ファイル