# 管理解説書

## vos examine

目的

ボリュームのボリューム・ヘッダーおよび VLDB 項目の情報を表示します。

構文

    vos examine -id <volume name or ID>  [-extended]  [-cell <cell name>]
                [-noauth]  [-localauth]  [-verbose]  [-help]

    vos e -i <volume name or ID>  [-e]  [-c <cell name>]  [-n]  [-l]  [-v]  [-h]

    vos volinfo -i <volume name or ID>  [-e]  [-c <cell name>]
                [-n]  [-l]  [-v]  [-h]

    vos v -i <volume name or ID>  [-e]  [-c <cell name>]  [-n]  [-l]  [-v]  [-h]

構文

vos examine コマンドは、 -id 引き数に指定されたボリュームのボリューム・ロケーション・データベース (VLDB) 項目およびボリューム・ヘッダーを書式設定して表示します。

ボリューム・ヘッダーだけを表示する場合には、vos listvol コマンドを使用してください。VLDB 項目だけを使用する場合には、 vos listvldb コマンドを使用してください。

オプション

-id
  読み取り / 書き込み、読み取り専用、またはバックアップであるボリュームの完全名またはボリューム ID 番号のいずれかを指定します。

-extended
  ボリューム内のファイルおよびディレクトリーについての読み取りおよび書き込み操作に関する統計を表示します。

-cell
  コマンドを実行するセルを指定します。この引き数は、 -localauth フラグと一緒に使用してはなりません。詳細については、vos の解説ページを参照してください。

-noauth
  コマンドの発行側に非特権 ID anonymous を割り当てます。このフラグは -localauth フラグと一緒に使用してはなりません。詳細については、vos の解説ページを参照してください。

-localauth
  ローカルの /usr/afs/etc/KeyFile ファイルのキーを使用して、サーバー・チケットを構成します。相互認証の間、vos コマンド・インタープリターは、ボリューム・サーバーおよびボリューム・ロケーション・サーバーに、このチケットを提供します。このフラグは、-cell 引き数、または -noauth フラグと一緒に使用してはなりません。詳細については、vos の解説ページを参照してください。

-verbose
  標準出力ストリームに、コマンド実行の詳細なトレースを出力します。この引き数を省略すると、警告およびエラー・メッセージだけが表示されます。

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

出力

出力の最初の 7 行にはボリューム・ヘッダーの情報が、残りの行には VLDB の情報が表示されます。次のリストの各項目は、ボリューム・ヘッダーから派生した出力の行に対応します。

- 指定されたボリュームの基本情報 (単一行に表示) は以下のとおりです。
  - 名前
  - ボリューム ID 番号
  - タイプ (このフラグは、読み取り / 書き込みの場合は `RW`、読み取り専用の場合は `RO`、バックアップの場合は `BK`)
  - サイズ (KB 単位) (`1024` はメガバイトと等しい)
  - -extended フラグが指定されている場合は、ボリューム内のファイル数
  - ファイル・サーバー・マシン上の状況。これは以下のいずれかです。

    `On-line`
      キャッシュ・マネージャーは、このボリュームに完全にアクセス可能です。

    `Off-line`
      キャッシュ・マネージャーは、このボリュームにアクセスできませんが、ボリュームは破壊されていないようです。この状況は、たとえば、ボリュームのダンプ処理中に現れます。

    `Off-line**needs salvage**`
      キャッシュ・マネージャーは、このボリュームにアクセスできません。ボリュームは破壊されているようです。 bos salvage または salvager コマンドを使用して、破壊を修復します。
- VLDB またはボリューム・ヘッダーから派生するのではなく、コマンド実行と同様にコマンド・インタープリターにより判別される、ボリュームを含むファイル・サーバー・マシンおよび区画。
- 以下の各種バージョンのボリュームに関連するボリューム ID 番号。読み取り / 書き込み (`RWrite`)、読み取り専用 (`ROnly`)、バックアップ (`Backup`)、および ReleaseClone (`RClone`)。これらのボリューム ID のいずれかが、ボリュームの出力の第 1 行に表示されるボリューム ID 番号と一致します。 `RWrite`、`ROnly`、または `Backup` フィールドが `0` (ゼロ) である場合、該当するタイプのボリュームはありません。現在、ReleaseClone がない場合は、`RClone` フィールドは全く表示されません。
- ボリュームの読み取り / 書き込みコピーに割り当てられた最大割り当て量は、`MaxQuota` フィールドに KB ブロック単位で表示されます。
- `Creation` フィールドのボリュームが作成された日時。ボリュームが backup diskrestore、 backup volrestore、vos restore コマンドで復元されていると、これは復元時刻を表します。
- `Last Update` フィールドのボリュームの内容が最後に変更された日時。読み取り専用およびバックアップ・ボリュームの場合、 `Creation` フィールドのタイム・スタンプと一致します。
- 次の 2 つの時刻のうち遅い時刻以降の、取り出しまたは保管操作の場合のボリュームに対するアクセス回数です。
  - コマンドが発行された日の 午前 12 時 00 分
  - ボリュームのロケーションが最後に変更された時刻

-extended フラグを組み込むと、次の 2 つの表が表示されます。

- `Raw Read/Write Stats` 表には、指定されたボリュームに対する読み取り (フェッチ) 回数および書き込み (格納) 回数が表示されます。
- `Writes Affecting Authorship` 表には、指定されたボリュームにあるファイルおよびディレクトリーに対する書き込み操作についての情報が表示されます。

次のメッセージが、既にリストされている情報の代わりに表示される場合、クローンが作成されているなどのため、キャッシュ・マネージャーまたは vos コマンド・インタープリターがボリュームにアクセスできないことを示します。

       **** ボリューム volume_ID は使用中です ****

次のメッセージが、既にリストされている情報の代わりに表示される場合、ファイル・サーバーがボリュームに接続できないことを示します。ボリュームがひどく破壊されている可能性があるためです。ファイル・サーバー・マシンの /usr/afs/logs ディレクトリーの FileLog および VolserLog ログ・ファイルは、可能な限り追加情報を提供します。この追加情報を表示するには、bos getlog コマンドを使用します。

       **** ボリューム volume_ID に接続できませんでした ****

ブランク行の後に、VLDB 項目の情報が表示されます。このリストの各項目は、出力の別の行と対応します。

- 基本 (読み取り / 書き込み) ボリューム名。読み取り専用およびバックアップ・バージョンの名前は同じで、拡張子は、それぞれ .readonly と .backup です。
- ボリューム ID 番号は、実際に存在するボリュームのバージョンに割り当てられます。読み取り / 書き込みの場合は `RWrite`、読み取り専用の場合は `ROnly`、バックアップの場合は `Backup`、 ReleaseClone の場合は `RClone` というフィールドに設定されます。 (フィールドが表示されない場合、対応するバージョンのボリュームは存在しません。) 通常、`RClone` フィールドが現れると、解放操作が正常終了しなかったことを示します。 `Old release` および `New release` フラグは、すぐ後で説明するサイト定義行の 1 行または複数行に表示される場合もよくあります。
- ボリュームの読み取り / 書き込みコピーまたは読み取り専用コピーを含むサイト数。文字列 `サイト数 ->` の後に続きます。
- ボリュームの読み取り / 書き込みコピーまたは読み取り専用コピーを含む各サイトの 1 行。ファイル・サーバー・マシン、区画、およびボリュームのタイプ (読み取り / 書き込みの場合は `RW`、読み取り専用の場合は、`RO`) を指定します。バックアップ・バージョンが存在する場合、読み取り / 書き込みサイトを共用することができます。複数のフラグが、以下のサイト定義と一緒に表示できます。

  `Not released`
    vos addsite コマンドを使用して、読み取り専用サイトを定義して以来、 vos release コマンドが発行されていないことを示します。

  `Old release`
    vos release コマンドが正常終了せず、このサイトに以前の廃止されたバージョンのボリュームが残っていることを示します。

  `New release`
    vos release コマンドは正常終了しませんでしたが、このサイトは適切な新規バージョンのボリュームを受け取ったことを示します。
- VLDB 項目がロックされている場合は、文字列`ボリュームは現在ロックされています`となります。

`New release` および `Old release` フラグの詳細な説明については、 vos release コマンドの解説ページを参照してください。

例

次の例は、 2 つの 読み取り専用の複写サイトを持つ usr という名前の Example Corporation ボリュームの出力を示しています。(このボリュームは、 /afs/example.com/usr ディレクトリーにマウントされています。) 説明を簡単にするために、この出力では、ボリュームがロックされている状態になっています。

       % vos examine usr
       usr                           536870981 RW   3459 K On-line
            fs2.example.com /vicepb
            RWrite 5360870981   ROnly 536870982   Backup 536870983
            MaxQuota      40000 K
            Creation    Mon Jun 12 15:22:06 1989
            Last Update Fri Jun 16 09:34:35 1989
            5719 accesses in the past day (i.e., vnode references)
            RWrite: 5360870981   ROnly: 536870982   Backup: 536870983
            number of sites -> 3
               server fs1.example.com partition /vicepa RO Site
               server fs3.example.com partition /vicepa RO Site
               server fs2.example.com partition /vicepb RW Site
            Volume is currently LOCKED

次の例は、-extended フラグを使用した場合のボリューム user.terry の出力を示しています。このボリュームには、読み取り専用の複写サイトはありません。

       % vos examine -id user.terry -extended
       user.terry         354287190 RW    2302 K used 119 files On-line
           fs4.example.com /vicepc
           RWrite 354287190 ROnly          0 Backup 354287192
           MaxQuota       5000 K
           Creation    Wed Nov 25 17:38:57 1992
           Last Update Tue Dec 15 10:46:20 1992
           598 accesses in the past day (i.e., vnode references)
                          Raw Read/Write Stats
                 |-------------------------------------------|
                 |    Same Network     |    Diff Network     |
                 |----------|----------|----------|----------|
                 |  Total   |   Auth   |   Total  |   Auth   |
                 |----------|----------|----------|----------|
       Reads     |       55 |       55 |       38 |       38 |
       Writes    |       95 |       95 |        0 |        0 |
                 |-------------------------------------------|
                       Writes Affecting Authorship
                 |-------------------------------------------|
                 |   File Authorship   | Directory Authorship|
                 |----------|----------|----------|----------|
                 |   Same   |   Diff   |    Same  |   Diff   |
                 |----------|----------|----------|----------|
       0-60 sec  |       38 |        0 |       21 |        1 |
       1-10 min  |        2 |        0 |        7 |        0 |
       10min-1hr |        0 |        0 |        1 |        0 |
       1hr-1day  |        1 |        0 |        5 |        1 |
       1day-1wk  |        0 |        0 |        0 |        0 |
       > 1wk     |        0 |        0 |        0 |        0 |
                 |-------------------------------------------|
        RWrite: 354287190    Backup: 354287192
        number of sites -> 1
           server fs4.example.com partition /vicepc RW Site

必要となる特権

なし。

関連情報

backup diskrestore

backup volrestore

bos getlog

bos salvage

salvager

vos

vos listvol

vos listvldb

vos release

vos restore

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

(C) IBM Corporation 2000. All Rights Reserved