# 管理解説書

## scout

目的

ファイル・サーバー・プロセスをモニターします。

構文

    scout [initcmd]  -server <FileServer name(s) to monitor>+
          [-basename <base server name>]
          [-frequency <poll frequency, in seconds>]  [-host]
          [-attention <specify attention (highlighting) level>+]
          [-debug <turn debugging output on to the named file>]  [-help]

    scout [i]  -s <FileServer name(s) to monitor>+
          [-b <base server name>] [-f <poll frequency, in seconds>]
          [-ho]  [-a <specify attention (highlighting) level>+]
          [-d <turn debugging output on to the named file>]  [-he]

構文

scout コマンドは、 -server 引き数に指定された各マシンで実行中のファイル・サーバー・プロセスから集められた統計を表示します。 出力節では、統計の意味を説明し、コマンド・シェルにどのように示されるのかについて記述しています。これは、ウィンドウ・マネージャー・プログラムにより管理されるウィンドウであることが望ましいです。

注意

scout プログラムは、統計を表示するために使用する、curses グラフィックス・パッケージにアクセスできなければなりません。配布されている多くの UNIX には、標準ユーティリティーとして curses があります。

端末をエミュレートするダム端末およびウィンドウ・システムの両方に、 scout プログラムの統計を表示することができます。表示画面は、反転表示およびカーソル・アドレス指定を使用しているので、表示環境では最適の表示機能がサポートされていなければなりません。また、TERM 環境変数に正しい端末タイプ、または実際のものに類似する特性を設定してください。AIX オペレーティング・システムを稼動するマシンで、端末の特性が類似する場合は、TERM の推奨値は、vt100 です。他のオペレーティング・システムの場合は、xterm、xterms、vt100、vt200、および wyse85 の中から選択することできます。

オプション

initcmd
  コマンドの AFS コマンド・パーサーの使用状況を調べます。これはオプションです。

-server
  モニターするファイル・サーバー・プロセスを実行しているファイル・サーバー・マシンを指定します。-basename 引き数が使用されない場合は、各マシンの完全修飾ホスト名を指定してください。この場合は、すべての名前に共通なドメイン名サフィックス (基本名) を省略して、マシンに固有な部分のみを指定します。他のマシンとホスト名を区別する、ホスト名の最短省略フォームを使用することもできますが、レゾリューションが成功するかどうかは、コマンドが発行されるときに、ネーム・レゾリューション・サービス (ドメイン・ネーム・サービスまたはローカル・ホスト・テーブル) が使用可能かどうかによって決まります。

-basename
  -server 引き数で指定されたファイル・サーバー・マシン名すべてに共通の基本名 (ドメイン名) サフィックスを指定します。これは、自動的に追加されます。この引き数は通常、マシンが所属するセルの名前になります。各ファイル・サーバー・マシン名の識別部分とこのサフィックスを分離しているピリオドは不要ですが、サフィックス内にあるピリオドは指定してください。たとえば、 Example Corporation のセルの場合、正しい値は .example.com でなく、example.com です。

-frequency
  ファイル・サーバー・プロセスにプローブする頻度を指定します。 0 (ゼロ) より大きな値を秒数で指定します。デフォルトは 60 秒です。

-host
  表示画面のバナー行で scout プログラムを実行しているマシン名を表示します。

-attention
  それぞれ統計値としきい値の対から成る項目のリストを定義します。指定されたしきい値を統計値が超えると、画面上、強調表示 (反転表示) されます。ペアは任意の順序でリストします。許容値は以下のとおりです。
  - conn connections。統計を強調表示するクライアント・プロセスとのオープン接続数を示します。しきい値以下の値に戻ると、通常の表示に戻ります。デフォルトのしきい値はありません。

    許容値の例は、conn 300 です。

  - disk。次のいずれかのタイプの値を取ります。
    - disk blocks_free。強調表示される残りの空き KB ブロック数を示します。統計値は、この値が再びしきい値以下になると、通常の表示に戻ります。デフォルトのしきい値はありません。

      許容値の例は、disk 5000 です。

    - disk percent_full%。強調表示されるディスク使用量をパーセンテージで示します。しきい値以下の値に戻ると、通常の表示に戻ります。デフォルトしきい値は 95% です。許容値は、 0 から 99 までの範囲の整数で、その後にパーセント記号 (%) が続き、上記で説明した値とこのタイプの値を区別します。

      たとえば disk 90% です。

  - fetch fetch_RPCs。強調表示されるクライアント・プロセスからの RPC の取り出し累積数を示します。この統計値は、ファイル・サーバー・プロセスが再始動し、その時点で値がゼロに戻って初めて、通常の表示に戻ります。デフォルトのしきい値はありません。

    許容値の例: fetch 6000000

  - store store_RPCs。強調表示されるクライアント・プロセスからの RPC の保存累積数を示します。この統計値は、ファイル・サーバー・プロセスが再始動し、その時点で値がゼロに戻って初めて、通常の表示に戻ります。デフォルトのしきい値はありません。

    許容値の例: store 200000

  - ws active_client_machines。強調表示されるアクティブ・オープン接続のクライアント・マシン数を示します。アクティブ接続は、ファイル・サーバーおよびクライアントが最近の 15 分で通信をしている間に定義されます。しきい値以下の値に戻ると、通常の表示に戻ります。デフォルトのしきい値はありません。

    許容値の例: ws 65

-debug
  デバッグ・トレースを書き込むファイルのパス名を指定します。部分的なパス名を指定すると、現行作業ディレクトリーとの相対位置で解釈されます。

-help
  このコマンドのオンライン・ヘルプを出力します。これ以外の有効なオプションはすべて無視されます。

出力

scout プログラムは、ウィンドウ操作環境が利用不能であれば、指示されたウィンドウまたは通常の画面のいずれかに統計を表示することができます。最適な結果を得るためには、ウィンドウまたは画面に反転表示による出力機能が必要です。

scout 画面には、バナー行、統計表示領域、メッセージ/プローブ行の 3 つの主要領域があります。

バナー行

デフォルトでは、文字列 `Scout` は、ウィンドウまたは画面の上部のバナー行に表示されます。 2 つのオプション引き数は、以下のように、バナー行に追加情報を表示します。

- -host フラグは、 scout プログラムが実行しているマシン名を表示します。上記のように、これは、複数のマシンで scout プログラムを実行中であるが、単一のマシンで結果を表示するときに役に立ちます。

  たとえば、 -host フラグを組み込んでいて、 scout プログラムがマシン client1.example.com で実行しているときは、バナー行には以下のように表示されます。

         [client1.example.com] Scout

- -basename 引き数は、バナー行に指示されたベース名を表示します。たとえば、-basename example.com 引き数を組み込んだ結果が、バナー行に以下のように表示されます。

         Scout for example.com

統計表示領域

この領域はウィンドウの大半を占めており、 scout プロセスが各ファイル・サーバーから収集した統計が表示されます。各プロセスが 1 行で表示されます。

領域は 6 列から構成され、それぞれ以下の情報が表示されます。

- `Conn`: 1 番目の列では、ファイル・サーバーおよびクライアント・マシン間でオープンしている RPC 接続数を表示します。この数は、`Ws` 列の数と等しいかそれ以上です (下記の 4 番目の項目を参照)。マシン上の各ユーザーごとに、同時にオープンしている複数の別接続をもつことが可能で、 1 つのクライアント・マシンで複数のユーザーを処理できるためです。
- `Fetch`: 2 列目には、クライアント・マシンが、最新の開始以降、ファイル・サーバー・プロセスに作成した、フェッチ・タイプの RPC (フェッチ・データ、フェッチ・アクセス・リスト、およびフェッチ状況) の数が表示されます。この値は、ファイル・サーバーが再始動する度にゼロにリセットされます。
- `Store`: 3 列目には、クライアント・マシンが、最新の開始以降、ファイル・サーバー・プロセスに作成した、保管タイプの RPC (保管データ、保管アクセス・リスト、および保管状況) の数が表示されます。この値は、ファイル・サーバーが再始動する度にゼロにリセットされます。
- `Ws`: 4 列目には、最新の 15 分以内でファイル・サーバー・プロセスと通信しているクライアント・マシン数が表示されます (`Ws` は、ワークステーションのことです。このようなマシンを 活動状態の と言います)。この数値は、単一クライアント・マシンが 1 つのファイル・サーバーと複数の接続をオープンできるため、1 番目 (`Conn`) の列の数値より小さくなる場合があります。
- 5 番目のラベルがない列には、ファイル・サーバー・プロセスが実行されているファイル・サーバー・マシンの名前を表示します。 12 文字以内の名前は、すべて表示されます。これより長い名前は切り捨てられ、名前の最後の文字としてアスタリスク (`*`) が表示されます。-basename 引き数の使用は、切り捨てを回避するために有効な手段ですが、すべてのマシン名が共通文字列で終わる場合に限ります。
- `Disk attn`: 6 番目の列では、ファイル・サーバー・マシン上の各 AFS ディスク区画で使用可能な KB ブロック数を表示します。 各区画は以下のフォームで表示されます。

         x:free_blocks

  `x` は、区画名を示します。たとえば、`a:8949` は、/vicepa 区画に 8,949 個の 1 KB ブロックの空き領域があることを示します。使用可能なスペースは、最大 26 区画まで表示することができます。ウィンドウの幅が、1 行にすべての区画項目が表示できるほど広くない場合は、 scout プロセスにより、自動的に複数行作成され、 6 列目の下位区分列に区画項目をスタックします。

  `Disk` `attn` 列のラベルは、強調表示される列項目のしきい値を示します。デフォルトのラベルは、次のとおりです。

         Disk attn: > 95% used

  デフォルトで、scout プログラムは、 95% 以上一杯になった区画の項目を強調表示します。

5 列目 (ファイル・サーバー・マシン名) を除くすべての列の場合、ある値を超えたことを示すために、列内の項目が強調表示されるように、オプションの -attention 引き数に値が設定されています。 5 列目および `Disk attn` 列の値だけは、デフォルトですでに強調表示されています。

scout プログラムがアクセスできないか、区画に関する情報を取得している場合、以下の例のようなメッセージを生成します。

       サーバー fs1.example.com の区画 /vicepa の情報が取得できませんでした

メッセージ / プローブ行

scout 画面の最終行に、 scout プログラムが統計を取るためにファイル・サーバー・プロセスをプローブした回数が表示されています。最後のプローブで収集された統計は、統計表示領域に表示されます。 -frequency 引き数を使用すると、60 秒のデフォルトのプローブ頻度を変更することができます。

例

AFS 管理の手引き の監視ツールについての章を参照してください。ここでは、オプションのさまざまな組み合わせによる結果の表示を例示しています。

必要となる特権

なし。

関連情報

afsmonitor

fstrace

[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]

(C) IBM Corporation 2000. All Rights Reserved