目的
ボリュームを ASCII 形式に変換し、ファイルに書き込みます。
構文
vos dump -id <volume name or ID> [-time <dump from time>] [-file <dump file>] [-server <server>] [-partition <partition>] [-cell <cell name>] [-noauth] [-localauth] [-verbose] [-help] vos du -i <volume name or ID> [-t <dump from time>] [-f <dump file>] [-s <server>] [-p <partition>] [-c <cell name>] [-n] [-l] [-v] [-h]
構文
vos dump コマンドは、指定されたボリューム (読み取り / 書き込み、読み取り専用、バックアップ) の内容を ASCII 形式に変換します。ボリューム・サーバーは、変換された内容を、 -file 引き数に指定されたファイルに書き込みます。この引き数が指定されていない場合には、標準出力ストリームに出力します。後者の場合、サード・パーティー製のバックアップ・ユーティリティーで操作できるように、名前付きパイプに出力をダイレクトすることができます。
ボリューム全体のダンプを取る (フル・ダンプ を作成する) には、 -time 引き数を省略するか、この引き数に値 0 (ゼロ) を指定します。ボリュームに、特定の時刻以降の修正タイム・スタンプがあるファイルおよびディレクトリーだけを含む増分ダンプ を作成するには、 -time 引き数の値として日時を指定します。
デフォルトでは、vos コマンド・インタープリターは、ボリューム・ロケーション・データベース (VLDB) を参照し、ボリュームの位置を解釈します。そのため、-server および -partition 引き数は必要ありません。 -id 引き数で、複数サイトにある読み取り専用ボリュームを識別すると、コマンドは、ボリュームのうちの 1 つだけ (通常は、vos examine または vos listvldb コマンドで報告されるときに、ボリュームの VLDB 項目で最初にリストされているボリューム) からバージョンをダンプします。特定のサイトからで読み取り専用バージョンをダンプするには、 -server および -partition 引き数を使用して、サイトを指定します。 VLDB 索引全体をう回するには、-server および -partition 引き数と一緒に、 -id 引き数の値として、(ボリューム名ではなく)、ボリューム ID 番号を指定します。これにより、VLDB 項目のないボリュームをダンプすることができます。
ダンプ操作中、キャッシュ・マネージャーおよび他のボリューム操作は、そのボリュームにアクセスできなくなります。そうしないと、ボリュームのダンプによって、区画の状況または VLDB 項目が更新されなくなります。
ダンプされたボリュームを AFS に復元するには、vos restore コマンドを使用します。
注意
増分ダンプがサポートされているので、サード・パーティー製のバックアップ・ユーティリティーも使用することができます。vos dump コマンドには、実際のバックアップ・システムのような管理機能はありません。したがって、管理者は、ダンプ時刻のレコードおよびボリュームのフル・ダンプと増分ダンプの関係を手操作で保守しなければなりません。増分ダンプの復元後にボリュームの内容の整合性を保つには、そのボリュームの直前のダンプ作成時間と、増分ダンプを作成する vos dump コマンドの -time 引き数の値との間にギャップがあってはいけません。特に、読み取り / 書き込みボリュームの場合は、 -time 引き数は、前のダンプが実行された時刻を指定し、読み取り専用ボリュームの場合は、ダンプの前に (vos release コマンドを使用して) 最後に解放された時刻、または (vos backup または vos backupsys コマンドを使用して) 複製が作成された時刻を指定しなければなりません。親ダンプは、フル・ダンプの場合も、他の増分ダンプの場合もあります。
オプション
例
次のコマンドは、ボリューム user.terry のフル・ダンプをファイル /afs/abc.com/common/dumps/terry.dump に書き込みます。
% vos dump -id user.terry -time 0 -file /afs/abc.com/common/dumps/terry.dump
次のコマンドは、ボリューム user.smith の増分ダンプを現行作業ディレクトリーのファイル smith.990131.dump に書き込みます。ボリュームの中でダンプされるファイルは、1999 年 1 月 31 日午後 6 時 00 分以降の修正タイム・スタンプを持つファイルです。
% vos dump -id user.smith -time "01/31/1999 18:00" -file smith.990131.dump
必要となる特権
コマンドの発行側は、-server 引き数に指定されたマシン、および各データベース・サーバー・マシン上の /usr/afs/etc/UserList ファイルにリストされていなければなりません。-localauth フラグを使用する場合には、コマンドの発行側が、ローカル・スーパーユーザー root として、サーバー・マシンにログオンする必要があります。
-file 引き数を使用する場合、コマンドの発行側には、ファイルのあるディレクトリーに対する挿入および書き込みアクセス権が必要になります。
関連情報