目的
ボリューム・セットにボリューム項目を定義します。
構文
backup addvolentry -name <volume set name> -server <machine name> -partition <partition name> -volumes <volume name (regular expression)> [-localauth] [-cell <cell name>] [-help] backup addvole -n <volume set name> -s <machine name> -p <partition name> -v <volume name (regular expression)> [-l] [-c <cell name>] [-h]
構文
backup addvolentry コマンドは、 -name 引き数に指定された既存のボリューム・セットに、ボリューム項目定義を追加します。 -server, -partition、および -volumes 引き数の組み合わせによっては、 1 つのボリューム項目定義を複数のボリュームに一致させることができます。
-server および -partition 引き数には、次の値を指定します。
-volumes 引き数には、英数字といくつかのメタ文字を組み合わせて指定し、ボリューム名の一部またはすべてをワイルドカードで表現します。使用可能なメタ文字については、オプションセクションを参照してください。
注意
このコマンドは、対話モードで発行してください。このコマンドをシェル・プロンプトで発行する場合には、メタ文字を含む文字列を二重引用符で囲むか、メタ文字を他の区切りでエスケープして、これらの文字がシェルに解釈されないようにしてください。一時ボリューム・セットへのボリューム項目の追加は、ボリューム・セットが作成された対話式セッション内でのみ行うことができます。
オプション
最も一般的なメタ文字式は、ピリオドの後にアスタリスクが続く式 (.*) です。ピリオドは任意の一文字に一致し、アスタリスクは直前の文字の任意の繰り返しに一致するので、この式は、任意の長さの文字列に一致します。ただし、メタ文字式が使用できるのは、 -server 引き数と -partition 引き数だけです。ボリューム定義では、これらの文字は単独で使用するか (この場合、 VLDB にリストされている任意のボリュームに一致します)、あるいは通常の文字と一緒に使用することができます。次の例は、user で始まり、 backup で終了する任意のボリューム名に一致します。
user.*backup
例
次のコマンドは、sys という名前のボリューム・セットにボリューム項目を追加しています。この項目は、sun4x_56 という文字列で始まり、ピリオドが続く名前を持っているマシンまたは区画上のすべてのボリュームに一致します。
backup> addvolentry sys .* .* sun4x_56\..*
ファイル・サーバー・マシン fs2.abc.com の /vicepb 区画上のすべてのボリュームに一致するように、次のコマンドは、fs2 という名前のボリューム・セットにボリューム項目を追加しています。これはシェル・プロンプトで発行されているので、 -volumes 引き数のメタ文字が二重引用符で囲まれています。 (ここで示したコマンドは、読みやすくするために 2 行で表示されています。)
% backup addvolentry -name fs2 -server fs2.abc.com \ -partition /vicepb -volumes ".*"
AFS 管理の手引き の AFS バックアップ・システムの構成に関する章にはこれに関する例と、ボリュームのグループ化に関するアドバイスが解説されています。
必要となる特権
コマンドの発行者は、バックアップ・サーバーが実行されているすべてのマシン上の /usr/afs/etc/UserList ファイルにリストされていなければなりません。また、-localauth フラグを使用する場合は、ローカル・スーパーユーザー root としてサーバー・マシンにログオンする必要があります。
関連情報