# 管理解説書

## backup scantape

目的

磁気テープからダンプ情報を抽出します。

構文

    backup scantape [-dbadd]  [-portoffset <TC port offset>]
                    [-localauth]  [-cell <cell name>]  [-help]

    backup sc [-d]  [-p <TC port offset>]  [-l]  [-c <cell name>]  [-help]

構文

backup scantape コマンドは、 -portoffset 引き数で指定されたテープ・コーディネーターの装置にある磁気テープのダンプ・ラベルおよびボリューム・ヘッダーから情報を抽出します。テープ・コーディネーターは、各ボリュームの情報を抽出するとすぐに、その情報をウィンドウに表示します。(磁気テープ全体の走査が終わるまで待ちません。)

(指定されたポート・オフセットの /usr/afs/backup/CFG_device_name ファイルに FILE YES 命令がある場合、 backup scantape コマンドは、磁気テープからではなく、テープ・コーディネーターの /usr/afs/backup/tapeconfig ファイルのポート・オフセットの項目で指定されているバックアップ・データ・ファイルからダンプ情報を抽出します。説明を分かりやすくするために、以下では磁気テープ装置の場合について説明しますが、バックアップ・データ・ファイルの取り扱いは磁気テープ装置の場合とほとんど同じです。)

-dbadd フラグが指定されると、 backup scantape コマンドは、走査した情報についてバックアップ・データベースにダンプ・レコードおよびボリューム・レコードを新規に作成します。ただし、同じダンプのレコードがすでにデータベースにある場合には、スキャン操作を終了します。

スキャン操作は、ボリューム・データのある磁気テープに対してのみ実行可能です。磁気テープにバックアップ・データベースのコピー (backup savedb コマンドで作成されたか、 AFS 磁気テープ名 Ubik_db_dump.1 を持っています) があると、このコマンドは失敗し、エラー・メッセージが表示されます。

このコマンドを実行すると、デフォルトでは、テープ・コーディネーターは、 CFG_device_name ファイルの MOUNT 命令を呼び出して、最初の磁気テープにアクセスします。MOUNT 命令がない場合には、磁気テープの挿入をバックアップ操作員に要求します。ただし、 CFG_device_name ファイルに AUTOQUERY NO 命令があるか、あるいは butc コマンドが -noautoquery フラグ付きで発行されている場合には、テープ・コーディネーターは、磁気テープがすでに装置に挿入されているとみなします。そうでない場合、テープ・コーディネーターは MOUNT 命令を呼び出すか、操作員にプロンプトを出します。

対話モードで磁気テープのスキャン操作を終了する場合には、 (backup) kill コマンドを出します。非対話モードでは、唯一の選択は、 <Ctrl-c> などの終了信号によって、磁気テープ・ コーディネーターを完全に終了することです。

注意

スキャン操作は、必ずしもダンプ・セットの最初の磁気テープから開始する必要はありませんが、バックアップ・システムは、最初の磁気テープから順番に、磁気テープを処理していきます。テープ・コーディネーターは、ローカル /usr/afs/backup/CFG_device_name ファイルの MOUNT 命令を呼び出すか、 MOUNT 命令がない場合には操作員にプロンプトを表示し、次の磁気テープを自動的に要求します。

破壊されたり、損傷を受けている磁気テープの走査が完了するかどうかは、損傷を受けたエクステントや破壊されているデータのタイプによって異なります。多くの場合、損傷を受けた時点まで磁気テープの走査を行うことができます。損傷の度合いが低い場合には、テープ・コーディネーターはその部分をスキップして、残りの磁気テープの走査を行いますが、損傷が大きい場合には、そこで走査を終了します。スキャン操作は、ダンプ・セット内のどの磁気テープからでも開始できるので、 1 つの磁気テープが損傷を受けていても、ダンプ・セットの残りの磁気テープの走査が停止することはありません。ただし、損傷を受けている磁気テープの前のテープまたはその後のテープのいずれかを走査することはできますが、両方ともスキャンすることはできません。

磁気テープのラベルが、 backup labeltape コマンドで再作成されている場合には、バックアップ・データベースの再構築ができなくなるので、その磁気テープからデータを回復できなくなります。

このコマンドに -dbadd フラグが指定されている場合には、磁気テープのスキャン操作が完了する前に、 (対話モードで (backup) kill コマンドを発行して) 終了しないようにしてください。バックアップ・システムは、磁気テープ上の関連情報を走査すると即時に、新規レコードをダンプごとにバックアップ・データベースに書き込みます。したがって、おそらく新規のレコードがすでに書き込まれている可能性があります。スキャン操作を再実行したい場合には、操作員が終了操作で作成されたレコードを検出して、削除しなければなりません。作成するデータが存在していると、次のスキャン操作は自動的に終了します。

-dbadd フラグが指定され、指定された最初の磁気テープがダンプ・セット内の最初の磁気テープでない場合には、次の制約があります。

- 磁気テープ上の最初のデータが、ダンプ・セットの前の (未走査の) 磁気テープから始まっているボリュームの続きである場合、バックアップ・システムは、そのボリュームのレコードをバックアップ・データベースに追加しません。
- ボリュームのレコードをデータベースに追加するには、バックアップ・システムは、付加ダンプの開始を示すマーカーを読み取る必要があります。磁気テープの最初のボリュームが付加ダンプに属していても、そのボリュームが付加ダンプ・マーカーの直後になければ、バックアップ・システムは、そのボリュームのレコードをバックアップ・データベースに作成しません。また、その付加ダンプの後続のボリュームのレコードも作成しません。

オプション

-dbadd
  磁気テープから抽出した情報をバックアップ・データベースに追加します。 (ただし、同じダンプ ID 番号の項目がデータベースにない場合)

-portoffset
  この操作で磁気テープを処理するテープ・コーディネーターのポート・オフセット番号を指定します。

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

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

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

出力

磁気テープ上のダンプごとに、 backup scantape コマンドは、そのダンプのダンプ・ラベルと各ボリュームの見出しを [テープ・コーディネーター] ウィンドウに表示します。ダンプが複数の磁気テープに分散している場合、後続の磁気テープの先頭にダンプ・ラベルはありません。

ダンプ・ラベルには、次のフィールドがあります。これは、 backup readlabel コマンドの出力と同じです。

`tape name```
  backup labeltape コマンドの -pname 引き数で割り当てられた永続名。この名前はこの引き数が再度使用されるまで磁気テープに残ります。磁気テープが再利用された回数やラベルの変更回数には関係ありません。磁気テープに永続名がない場合には、このフィールドに `<NULL>` が表示されます。

`AFS tape name`
  磁気テープ名。次のいずれかの形式で表示されます。バックアップ・システムは、backup dump 操作の一部として、該当する AFS 磁気テープ名をラベルに自動的に書き込みます。操作員は、この名前に、-name 引き数を付けて backup labeltape コマンドを発行しても割り当てることができます。
  - 磁気テープにボリューム・データがある場合には、 volume_set_name.dump_level_name.tape _index。 volume_set_name は、この磁気テープを含むダンプ・セットに初期ダンプを作成するときにダンプされたボリューム・セットの名前です。 dump_level_name は、初期ダンプがバックアップされたダンプ・レベルのパス名の最後の要素です。 tape_index は、ダンプ・セット内での磁気テープの位置を数値で表しています。
  - 磁気テープに AFS 磁気テープ名がない場合には、 `<NULL>` が表示されます。最後に -name 引き数なしで backup labeltape コマンドがこの磁気テープに使用されてからデータが更新されていなければ、これは正常です。

`creationTime`
  バックアップ・システムがダンプ操作を開始し、初期ダンプを作成した時刻。

`cell`
  ダンプ・セットが作成されたセル。このセルのバックアップ・データベースに、ダンプ・セットのレコードが格納されています。

`size`
  ラベルに記録された磁気テープの容量。 KB 単位で表示されます。これは、磁気テープ上のデータ量ではありません。この値は、backup labeltape コマンドの -size 引き数で割り当てられた値か、テープ・コーディネーター・マシンにある /usr/afs/backup/tapeconfig ファイルに指定されている値です。磁気テープを実際に測定した値ではありません。

`dump` `path`
  ダンプ・セットにある初期ダンプのダンプ・レベル。

`dump` `id`
  ダンプ・セットにある初期ダンプのダンプ ID 番号。バックアップ・データベースに記録されています。

`useCount`
  磁気テープにダンプが書き込まれた回数。または、磁気テープのラベルが変更された回数。

ボリューム・ヘッダーには、次のフィールドがあります。

`volume` `name`
  ボリューム名。最後に `.backup` または `.readonly` という拡張子が付いています。

`volume` `ID`
  ボリュームのボリューム ID。

`dumpSetName`
  ボリュームが所属するダンプ。ダンプ名は、volume_set_name.dump_level_name という形式で、ダンプ・ラベルに表示される名前に一致します。

`dumpID`
  `dumpSetName` フィールドで指定されているダンプのダンプ ID。

`level`
  ダンプの作成に使用するダンプ・レベルのダンプ階層内での値。 `0` はフル・ダンプです。 `1` 以上の値の場合、階層内で指定されたレベルで、インクリメンタル・ダンプが作成されています。表示される値はボリューム全体の値で、ボリューム自体の値とは限りません。たとえば、以前のダンプからボリュームが削除されている場合には、個々のボリュームのフル・ダンプを含むダンプがインクリメンタル・レベルで作成される可能性があります。

`parentID`
  `dumpSetName` の親ダンプのダンプ ID 番号。 `level` フィールドの値が `0` の場合には、`0` になります。

`endTime`
  この値は常に `0` です。これは、内部使用用に予約されています。

`cloneDate`
  ボリュームが作成された日時。バックアップまたは読み取り専用ボリュームの場合は、そのボリュームが読み取り / 書き込み送信元から複製された時刻を表します。読み取り / 書き込みボリュームの場合には、 `dumpSetName` フィールドで指定されているダンプに追加するために、バックアップ・システムがボリュームをロックした時刻になります。

出力が完了すると、`Scantape: 完了` というメッセージが表示されます。

通常では、磁気テープの最後にボリュームを追加したり、次の磁気テープにボリュームを続ける場合に、バックアップ・システムはマーカーを書き込みます。ただし、バックアップ操作が異常終了すると (たとえば、操作員が処理中に <Ctrl-c> によってテープ・コーディネーターを終了した場合など)、このようなマーカーは書き込まれません。バックアップ・システムのバージョンがかなり古い場合には、このようなマーカーは書き込みません。磁気テープが最後に予期したマーカーがないと、テープ・コーディネーターは、ダンプ・セット内で後続の磁気テープがあるかどうか判別できないため、次のメッセージをウィンドウに表示します。

    磁気テープを追加しますか? (y/n)

例

次の例は、ポート・オフセット 0 の装置にある磁気テープの最初の 2 つのボリュームを示しています。

       % backup scantape
       Dump label
       ----------
       tape name = monthly_guest
       AFS tape name = guests.monthly.3
       creationTime =  Mon Feb  1 04:06:40 1999
       cell = example.com
       size = 2150000 Kbytes
       dump path = /monthly
       dump id = 917860000
       useCount = 44
       -- End of dump label --
       -- volume --
       volume name: user.guest10.backup
       volume ID 1937573829
       dumpSetName: guests.monthly
       dumpID 917860000
       level 0
       parentID 0
       endTime 0
       clonedate Mon Feb  1 03:03:23 1999
       -- volume --
       volume name: user.guest11.backup
       volume ID 1938519386
       dumpSetName: guests.monthly
       dumpID 917860000
       level 0
       parentID 0
       endTime 0
       clonedate Mon Feb  1 03:05:15 1999

必要となる特権

コマンドの発行者は、バックアップ・サーバーが実行されているすべてのマシン上の /usr/afs/etc/UserList ファイルにリストされていなければなりません。また、-localauth フラグを使用する場合は、ローカル・スーパーユーザー root としてサーバー・マシンにログオンする必要があります。

関連情報

backup

backup dump

backup dumpinfo

butc

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

(C) IBM Corporation 2000. All Rights Reserved