# 管理解説書

## 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 つの許容値のいずれかを指定します。
  - フル・ダンプを作成する場合には、0 (ゼロ) を指定してください。
  - 日付を指定して、その日の午前 (12:00 a.m) 以降の修正タイム・スタンプを持つファイルおよびディレクトリーだけを含む増分ダンプを作成する場合には、 mm/dd/yyyy (月、日、および年) の形式で日付を指定してください。年に指定できる値は、1970 から 2037 までの範囲です。ただし、 UNIX の標準表記では 2038 年までしか表現できないため、これより高い値は無効になります。コマンド・インタープリターは、最大値から 1 を引いた値を自動的に割り当てます。たとえば、01/13/1999 と指定してください。
  - 日付と時刻を指定して、その時間以降の修正タイム・スタンプを持つファイルおよびディレクトリーだけを含む増分ダンプを作成する場合には、 "mm/dd/yyyy hh: MM" の形式で日付と時刻を指定してください。日付の形式は、日付のみの場合と同じです。時刻は、時と分を hh:MM で、24 時間形式で指定してください。 (たとえば、午後 8 時 30 分は 20:30 になります。) 式の中にスペースがあるので、式全体を二重引用符で囲んでください。たとえば、"01/13/1999 22:30" と指定してください。

-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/example.com/common/dumps/terry.dump に書き込みます。

       % vos dump -id user.terry -time 0 -file /afs/example.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