管理解説書

vos dump

目的

ボリュームを 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 コマンドを使用して) 複製が作成された時刻を指定しなければなりません。親ダンプは、フル・ダンプの場合も、他の増分ダンプの場合もあります。

オプション

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

-time
フル・ダンプか増分ダンプかを指定します。この引き数を省略してフル・ダンプを作成するか、以下の 3 つの許容値のいずれかを指定します。

-file
ダンプを書き込むファイルのパス名を指定します。ファイルはAFS の中が可能ですが、ダンプを取っているボリュームは不可能です。部分的なパス名を指定すると、現行作業ディレクトリーとの相対位置で解釈されます。この引き数を省略すると、ダンプは標準出力ストリームに送信されます。

-server
ボリュームが常駐するファイル・サーバー・マシンを指定します。この引き数と一緒に -partition 引き数を指定します。

-partition
ボリュームが常駐する区画を指定します。この引き数と一緒に -server 引き数を指定します。

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

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

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

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

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

次のコマンドは、ボリューム 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 引き数を使用する場合、コマンドの発行側には、ファイルのあるディレクトリーに対する挿入および書き込みアクセス権が必要になります。

関連情報

vos

vos examine

vos listvldb

vos restore


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



(C) IBM Corporation 2000. All Rights Reserved