管理解説書

backup addvolentry

目的

ボリューム・セットにボリューム項目を定義します。

構文

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 引き数には、次の値を指定します。

1 つのマシンまたは区画の名前
ボリューム・ロケーション・データベース (VLDB) 内の各マシン名または区画名に一致する、メタキャラクター式 .* (ピリオドとアスタリスク)。

-volumes 引き数には、英数字といくつかのメタ文字を組み合わせて指定し、ボリューム名の一部またはすべてをワイルドカードで表現します。使用可能なメタ文字については、オプションセクションを参照してください。

注意

このコマンドは、対話モードで発行してください。このコマンドをシェル・プロンプトで発行する場合には、メタ文字を含む文字列を二重引用符で囲むか、メタ文字を他の区切りでエスケープして、これらの文字がシェルに解釈されないようにしてください。一時ボリューム・セットへのボリューム項目の追加は、ボリューム・セットが作成された対話式セッション内でのみ行うことができます。

オプション

-name

ボリューム項目定義を追加するボリューム・セットの名前を指定します。このボリューム・セットはすでに存在していなければなりません。 (ボリューム・セットを作成する場合には、 backup addvolset コマンドを使用してください。)

-server

ボリューム項目のボリュームを格納する 1 つ以上のファイル・サーバー・セットを定義します。完全修飾のホスト名 (たとえば fs1.abc.com) を指定するか、メタ文字式 .* (ピリオドとアスタリスク ) を使用してください。この式は、VLDB にあるすべてのマシン名に一致します。

-partition

ボリューム項目のボリュームを格納する 1 つ以上の区画セットを定義します。完全修飾の区画名 (たとえば /vicepa) を指定するか、メタ文字式 .* (ピリオドとアスタリスク ) を使用してください。この式は、すべての区画名に一致します。

-volumes

ボリューム項目に含まれる 1 つ以上のボリュームを定義します。ボリューム名で指定することも、正規の英数字と次のメタ文字式のいくつかを組み合わせて指定することもできます。

.: ピリオドは、単一文字に一致します。
*: アスタリスクは、直前の文字の 0 回以上の繰り返しに一致します。これは、他の英数字またはメタ文字を組み合わせて使用することができます。
[ ]: 文字のリストを大括弧で囲むと、そのいずれかの 1 文字に一致します。たとえば、[abc] は、a 、 b、c のいずれか 1 文字に一致し、 d や A には一致しません。この式では、アスタリスクを使用することができます。
^: 大括弧のセットの先頭文字として脱字記号を使用すると、この記号の直後の文字を除く、任意の一文字に一致します。たとえば、[^a] は、 a の小文字以外の任意の一文字に一致します。この式では、アスタリスクを使用することができます。
\: このリストでメタ文字の直前に円記号を付けると、そのメタ文字自身に一致します。たとえば、式 \.。 (円記号とピリオド) は、ピリオド 1 つに一致し、 \* は、アスタリスク 1 つ、\\ は円記号 1 つにそれぞれ一致します。このような式はアスタリスクと一緒に使用することができます (たとえば、 \.* は、任意の数のピリオドに一致します)。

最も一般的なメタ文字式は、ピリオドの後にアスタリスクが続く式 (.*) です。ピリオドは任意の一文字に一致し、アスタリスクは直前の文字の任意の繰り返しに一致するので、この式は、任意の長さの文字列に一致します。ただし、メタ文字式が使用できるのは、 -server 引き数と -partition 引き数だけです。ボリューム定義では、これらの文字は単独で使用するか (この場合、 VLDB にリストされている任意のボリュームに一致します)、あるいは通常の文字と一緒に使用することができます。次の例は、user で始まり、 backup で終了する任意のボリューム名に一致します。

   user.*backup

-localauth

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

-cell

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

-help

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

例

次のコマンドは、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 としてサーバー・マシンにログオンする必要があります。

関連情報

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