# 管理解説書

## backup volrestore

目的

1 つ以上のボリュームを復元します。

構文

    backup volrestore -server <destination machine>
                      -partition <destination partition>
                      -volume <volume(s) to restore>+
                      [-extension <new volume name extension>]
                      [-date <date from which to restore>+]
                      [-portoffset <TC port offsets>+]  [-n]
                      [-localauth]  [-cell <cell name>]  [-help]

    backup volr -s <destination machine>  -pa <destination partition>
                -v <volume(s) to restore>+  [-e <new volume name extension>]
                [-d <date from which to restore>+]  [-po <TC port offsets>+]
                [-n]  [-l]  [-c <cell name>]  [-h]

構文

backup volrestore コマンドは、 1 つ以上のボリュームの内容を -server および -partition 引き数で指定されたボリュームに復元します。このコマンドを使用すると、復元されたデータを持つ既存のボリュームの内容を上書きすることも、既存のボリュームを保存して新規のボリュームを作成することもできます。指定されたサイトは、このボリュームの現行サイトであってはなりません。

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

コマンドの引き数は、次のように組み合わせることができます。

- ボリュームの現在の内容を保存し、新規のボリュームを作成して復元する場合には、 -extension 引き数を使用してください。バックアップ・システムは、 -server および -partition 引き数に指定されたサーバーおよび区画上に新規ボリュームを作成し、それに現在のボリュームと同じ名前を割り当て、指定された拡張子を追加します。さらに、そのボリュームのボリューム・ロケーション・データベース (VLDB) 項目を新規に作成します。新しいボリュームを作成すると、管理者が 2 つのバージョンを比較できるようになります。
- ボリュームの既存の内容を上書きして復元する場合には、 -extension 引き数を省略し、次のようにサイトを指定してください。
  - 現在のサイトを保存する場合には、 -server および -partition 引き数を指定してください。
  - ボリュームを上書きするときに別のサイトに移動させる場合には、 -server 引き数または -partition 引き数 (あるいはその両方) を使用して、新しいサイトを指定してください。バックアップ・システムは、指定されたサイトに新しいボリュームを作成し、既存のボリュームを削除して、そのボリュームの VLDB 項目のサイト情報を更新します。ボリュームのバックアップ・バージョンがある場合、それが元のサイトから自動的に除去されることはありません。 vos remove コマンドでそれを除去した後、 vos backup コマンドで新規サイトにバックアップ・バージョンを作成します。
- ファイル・システムに存在していないボリュームを復元する場合には、 -volume 引き数にその名前を指定し、 -server および -partition 引き数を使用して、ボリュームの復元先を指定してください。バックアップ・システムは、新しいボリュームを作成し、その VLDB 項目を作成します。

いずれの場合も、ボリュームの復元日時がボリュームの作成日に設定されます。この作成日は、vos examine および vos listvol コマンドの出力の `Creation` フィールドに表示されます。

1 つの区画にあるすべてのボリュームを復元する場合には、 backup diskrestore コマンドのほうが効率的です。複数のボリュームを異なるサイトに復元する場合には、 backup volsetrestore コマンドのほうが有効です。

デフォルトでは、backup volrestore コマンドは、各ボリュームの最新のフル・ダンプとそれ以降のインクリメンタル・ダンプを復元するので、復元後のボリュームは、可能な限り最新の状態になります。ボリュームを最新ではない状態に復元する場合には、 -date 引き数を使用してください。バックアップ・システムは、ダンプに含まれるボリュームの複製日 が、指定された日付と時刻よりも前の最新のフル・ダンプおよび連続したインクリメンタル・ダンプを復元します (複製日のタイム・スタンプは、 backup volinfo コマンド出力の `clone date` フィールドに表示されます)。バックアップおよび読み取り専用ボリュームの場合、複製日は、読み取り / 書き込みのソースからボリュームを複製した時刻です。読み取り / 書き込みボリュームの場合は、親ダンプに組み込むためにボリュームをロックした時刻を表します。指定された時刻での実際の状態と復元されるボリュームとの類似性は、最新の適格ダンプのボリューム複製日から指定された時刻までの経過時間によって異なります。

-volume 引き数にボリューム名の基本 (読み取り / 書き込み) 形式が指定されている場合、バックアップ・システムは、読み取り / 書き込みまたはバックアップのいずれかのダンプがある最新のダンプ・セットをバックアップ・データベースから検索します。バックアップ・システムは、最新のフル・ダンプから順番に、そのバージョンのボリューム・ダンプを復元します。逆に、ボリューム名に .backup または .readonly という拡張子が明示的に付いていると、バックアップ・システムは、対応するボリューム・バージョンのダンプだけを復元します。

バックアップ・システムが復元操作に必要とする磁気テープのリストを、実際にその操作を実行しないで生成するには、実際のコマンドで使用されるオプションと一緒に -n フラグを付けてコマンドを発行してください。

関連するボリュームのすべてのフル・ダンプおよびインクリメンタル・ダンプが、 1 つのテープ・コーディネーターで読み取り可能なタイプの磁気テープに書き込まれている場合には、 -portoffset 引き数を使用すると、複数のポート・オフセット番号を磁気テープが必要とされる順序で表示することができます (最初に、フル・ダンプのポート・オフセット番号が、次に、レベル 1 のインクリメンタル・ダンプのポート・オフセット番号、というように表示されます)。複数のボリュームを復元する場合には、すべてのボリュームに、同じポート・オフセットの順序リストを使用しなければなりません。そうでない場合には、このコマンドをボリュームごとに発行するか、互換性のある磁気テープ・タイプにダンプされたボリューム・グループを定義してから vos volsetrestore コマンドを発行してください。詳細については、AFS 管理の手引き を参照してください。

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

オプション

-server
  各ボリュームを復元するファイル・サーバー・マシンの名前を指定します。この引き数と -partition 引き数には、各ボリュームの現在のサイト以外のサイトを指定します。この場合、-extension 引き数は指定しません。バックアップ・システムは、現在のサイトから既存のボリュームを削除し、指定されたサイトにボリュームを復元し、そのボリュームの VLDB 項目のサイト情報を変更します。

-partition
  各ボリュームを復元する区画の名前を指定します。この引き数と -server 引き数が、各ボリュームの現在のサイト以外のサイトを指定しており、 -extension 引き数が指定されていない場合、バックアップ・システムは、現在のサイトから既存のボリュームを削除し、指定されたサイトにボリュームを復元し、そのボリュームの VLDB 項目のサイト情報を変更します。

-volume
  復元するボリュームの名前を指定します。ここには、バックアップ・データベースに登録されているボリューム名を指定します。各ボリュームの基本 (読み取り / 書き込み) 名を指定して、バックアップ・システムが、読み取り / 書き込みまたはバックアップのいずれかのダンプがあるバックアップ・データベースから最新のダンプ・セットを検索するようにします。さらに、最新のフル・ダンプから順番に、そのバージョンのボリュームのダンプを復元します。逆に、ボリューム名に .backup または .readonly という拡張子が明示的に付いていると、バックアップ・システムは、対応するボリューム・バージョンのダンプだけを復元します。

-extension
  新規のボリュームを作成し、復元したデータを格納します。このときこのボリュームには、-volume 引き数で指定された各ボリュームに、指定された文字列を追加して作られた名前が付けられます。バックアップ・システムは、そのボリュームの VLDB 項目を新規に作成します。 .readonly または .backup 以外の文字列も使用できますが、既存のボリューム名と拡張子の組み合わせは、22 文字よりも長くすることはできません。ピリオドを名前と拡張子の区切り文字に使用するときは、それを文字列の最初の文字に指定します (たとえば、 .rst)。

-date
  日付と時刻 (オプション) を指定します。復元後のボリュームには、この日付より前に実行されたダンプのデータだけが入ります。この値は、mm/dd/yyyy [hh:MM] の形式で指定してください。 mm/dd/yyyy は必須部分で、月 (mm)、日 (dd)、年 (yyyy) を指定します。hh:MM はオプションで、時と分を 24 時間形式で指定します。 (たとえば、午後 2 時 36 分は 14:36 と指定します。) この値を省略すると、デフォルトで、午前 0 時 0 分 59 秒 (00:00:59) が使用されます。

  年に指定できる値は、 1970 から 2037 までです。 UNIX の標準表記では 2038 年 2 月までしか表現できないので、 2037 より大きな値は無効になります。コマンド・インタープリターは、それ以降の日付を自動的に最大値に変更します。

  この引き数を省略すると、バックアップ・システムは、最後に作成されたダンプを含めて、可能なダンプをすべて復元します。

  注: | コマンドの構文ステートメントは、二重引用符や他の区切り記号で囲む必要のない複数語の値を受け入れるため、その中にあるこの引き数には、正符号 (+) が付きます。このステートメントが複数日付を受け入れるからではありません。日付 (任意選択で、時刻) 定義は、1 つだけ指定してください。

-portoffset
  1 つまたは複数のポート・オフセット番号 (最大 128 まで) を指定します。これらは、それぞれ操作で使用するテープ・コーディネーターに対応します。複数の値がある場合は、バックアップ・システムは、各ボリュームのフル・ダンプを回復する場合には最初の値、各ボリュームのレベル 1 のインクリメンタル・ダンプを回復する場合には 2 番目の値、というように指定値を使用します。バックアップ・システムは、ダンプ階層の対応する深さと、それよりも下位のレベルにあるすべてのダンプを回復するときにリスト内の最後の値を使用します。

  すべてのダンプにデフォルトの 0 (ゼロ) が必要でない限り、この引き数を指定してください。 0 がリスト内の値の 1 つにすぎない場合は、正しい順序で明示的に指定してください。

-n
  復元操作に必要なダンプのある磁気テープのリストを表示します。実際の操作は行われません。

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

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

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

出力

このコマンドが -n フラグ付きで発行されると、まず次の文字列が表示され、次に復元操作に必要な磁気テープのリストが表示されます。

       Tapes needed:

例

次のコマンドは、マシン fs5.abc.com の区画 /vicepa にボリューム user.pat を復元しています。

       % backup volrestore -server fs5.abc.com -partition a -volume user.pat

次のコマンドは、ボリューム user.smith および user.terry をマシン fs4.abc.com の区画 /vicepb に復元しています。このコマンドでは、各ボリューム名に拡張子 .rst を追加して、既存の user.smith および user.terry ボリュームを保存しています。ここでは、1998 年 1 月 31 日午後 5 時 00 分以前に作成されたダンプだけを復元しています。 (ここで示したコマンドは、読みやすくするために複数行で表示されています。)

       % backup volrestore -server fs4.abc.com -partition b  \
                           -volume user.smith user.terry  \
                           -extension .rst -date 1/31/1998 17:00

次のコマンドは、マシン fs4.abc.com の区画 /vicepb に、ボリューム user.pat を復元しています。ポート・オフセット 1 のテープ・コーディネーターがフル・ダンプのある磁気テープを処理し、ポート・オフセット 0 のテープ・コーディネーターがインクリメンタル・ダンプのあるすべての磁気テープを処理しています。 (ここで示したコマンドは、読みやすくするために 2 行で表示されています。)

       % backup volrestore -server fs5.abc.com -partition a  \
                           -volume user.pat -portoffset 1 0

必要となる特権

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

関連情報

backup

backup dump

backup diskrestore

backup volsetrestore

butc

vos backup

vos remove

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

(C) IBM Corporation 2000. All Rights Reserved