管理解説書

vos addsite

目的

ボリュームの VLDB 項目に読み取り専用サイトの定義を追加します。

構文

vos addsite -server <machine name for new site>
            -partition <partition name for new site>
            -id <volume name or ID>  [-cell <cell name>]  
            [-noauth]  [-localauth]  [-verbose]  [-help]
   
vos ad -s <machine name for new site>  -p <partition name for new site>
       -i <volume name or ID>  [-c <cell name>]  [-n]  [-l]  [-v]  [-h]

構文

vos addsite コマンドは、新規の読み取り専用サイト (-server および -partition 引き数で指定された、ファイル・サーバー・マシン上の区画) を -id 引き数で指定された、読み取り / 書き込みボリュームのボリューム・ロケーション・データベース (VLDB) 項目に定義します。次に、読み取り / 書き込みボリュームに対して vos release コマンドが発行されると、その読み取り専用コピーがすべての読み取り専用サイトに配布されます。このコピーは、新しく定義したサイトにも配布されます。

注意

ボリュームの VLDB 項目には、AFS リリース情報 で定義されている、最大数のサイト定義が含まれます。ボリュームの読み取り / 書き込みバージョンとバックアップ・バージョンを含むサイトは 1 つのサイトとして数え、それぞれの読み取り専用サイトは、追加サイトとして数えます (読み取り / 書き込みサイトと同じファイル・サーバー・マシンおよび区画で定義された読み取り専用サイトも別サイトとして数えます)。事実上、VLDB 項目の上限により、 AFS クライアントで使用可能なボリュームのコピーの最大数が決定します。

このコマンドで追加サイトを作成しようとすると、エラーで失敗します。

オプション

-server

読み取り専用ボリュームが常駐するファイル・サーバー・マシンを指定します。マシンの IP アドレスまたはホスト名 (完全修飾名またはあいまいでない省略形) を指定します。詳細については、vos コマンド・セットの解説ページを参照してください。

-partition

-server 引き数で指定されたファイル・サーバー・マシン上で、読み取り専用ボリュームが常駐する区画を指定します。名前の前にスラッシュを付けて完全な区画名を指定するか (たとえば、/vicepa)、または使用可能な 3 つの省略形のいずれかを使用してください。詳細については、vos コマンド・セットの解説ページを参照してください。

-id

読み取り / 書き込みボリュームの完全名またはボリューム ID 番号のいずれかを指定します。

-cell

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

-noauth

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

-localauth

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

-verbose

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

-help

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

例

次の State University セルで適切な例では、そのセルの root.afs ボリュームに読み取り専用サイトを定義します。

   % vos addsite -server sv7.stateu.edu -partition /vicepb -id root.afs
   

必要となる特権

コマンドの発行側は、-server 引き数に指定されたマシン、および各データベース・サーバー・マシン上の /usr/afs/etc/UserList ファイルにリストされていなければなりません。-localauth フラグを使用する場合には、コマンドの発行側が、ローカル・スーパーユーザー root として、サーバー・マシンにログオンする必要があります。

関連情報

vos

vos examine

vos release