目的
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 ファイルのポート・オフセットにリストされているバックアップ・データ・ファイルからデータを復元します。説明を分かりやすくするために、以下では磁気テープ装置の場合について説明しますが、バックアップ・データ・ファイルの取り扱いは磁気テープ装置の場合とほとんど同じです。)
コマンドの引き数は、次のように組み合わせることができます。
いずれの場合も、ボリュームの復元日時がボリュームの作成日に設定されます。この作成日は、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 命令を呼び出すか、バックアップ操作員にプロンプトを出します。この場合、操作員は、必要な磁気テープを挿入しなければなりません。
オプション
年に指定できる値は、 1970 から 2037 までです。 UNIX の標準表記では 2038 年 2 月までしか表現できないので、 2037 より大きな値は無効になります。コマンド・インタープリターは、それ以降の日付を自動的に最大値に変更します。
この引き数を省略すると、バックアップ・システムは、最後に作成されたダンプを含めて、可能なダンプをすべて復元します。
| 注: | コマンドの構文ステートメントは、二重引用符や他の区切り記号で囲む必要のない複数語の値を受け入れるため、その中にあるこの引き数には、正符号 (+) が付きます。このステートメントが複数日付を受け入れるからではありません。日付 (任意選択で、時刻) 定義は、1 つだけ指定してください。 |
すべてのダンプにデフォルトの 0 (ゼロ) が必要でない限り、この引き数を指定してください。 0 がリスト内の値の 1 つにすぎない場合は、正しい順序で明示的に指定してください。
出力
このコマンドが -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 として、サーバー・マシンにログオンする必要があります。
関連情報