管理解説書

buserver

目的

バックアップ・サーバーを初期化します。

構文

buserver [-database <database directory>] 
         [-cellservdb <cell configuration directory>]
         [-resetdb]  [-noauth]  [-smallht] 
         [-servers <list of ubik database servers>+]  
         [-enable_peer_stats]  [-enable_process_stats]
         [-help]

このコマンドは、AFS コマンド・セットの構文規則に準拠していません。コマンド名およびすべてのオプション名は省略せずにすべて指定してください。

構文

buserver コマンドは、バックアップ・サーバーを初期化します。バックアップ・サーバーは、データベース・サーバー・マシン上で実行され、バックアップ・データベースを保守します。規約構成ではこのバイナリー・ファイルは、ファイル・サーバー・マシンの /usr/afs/bin ディレクトリーにあります。

buserver コマンドは、通常はコマンド・シェル・プロンプトでは発行せず、データベース・サーバー・マシンの /usr/afs/local/BosConfig ファイルに bos create コマンドと一緒に記述します。このコマンドをコマンド・シェル・プロンプトで発行する場合には、発行者はローカルのスーパーユーザー rootとしてログオンしなければなりません。

バックアップ・サーバーは初期化時に、バックアップ・データベースを構成する bdb.DB0 と bdb.DBSYS1 という 2 つのファイルを /usr/afs/db ディレクトリーに作成します (これらのファイルが存在しない場合)。バックアップ・データベースには、ボリューム・セットおよび項目ダンプ階層、磁気テープ・コーディネーター、および以前に実行したダンプ・セットについての情報があります。データベースを管理するには、backup セットのコマンドを使用してください。

バックアップ・サーバーは、/usr/afs/logs/BackupLog ファイルに活動の追跡を記録します。bos getlog コマンドを使用して、ファイルの内容を表示します。

注意

buserver プロセスは、ポート 7021 を予約しています。buserver プロセスの実行中に、別のプロセスがこのポートを予約しようとすると、予期しない振る舞いが発生することがあります。

オプション

-database

バックアップ・データベース・ファイルの代替ディレクトリーのパス名を指定します。最後にスラッシュ (/) を付けてください。この引き数を使用しないと、デフォルトで /usr/afs/db ディレクトリーが使用されます。

-cellservdb

バックアップ・サーバーが CellServDB ファイルの代替バージョンがあるディレクトリーのパス名を指定します。標準の /usr/afs/etc/CellServDB ファイル (バックアップ・サーバーは、この引き数が指定されていない場合にこのファイルを参照します) にリストされている多くのマシンに該当しない、セルのデータベース・サーバー・マシンのサブセットでバックアップ・サーバーを実行する場合に、正常に動作するためにはこの引き数が必須です。他の環境で使うのは適切ではありません。

-resetdb

/usr/afs/db ディレクトリーのバックアップ・データベース・ファイルにある情報をすべて削除します。長さがゼロの情報は削除されません。バックアップ操作員は、バックアップ操作を実行する前に、データベースの構成項目 (ボリューム・セットの場合にはダンプ階層など) を再度作成しなければなりません。

-noauth

コマンドの発行者とバックアップ・サーバーの間に認証されていない接続を確立します。バックアップ・サーバーは、コマンドの発行者を非特権ユーザー anonymous として扱います。これは、データベース・サーバー・マシンの許可検査が使用不可の場合に有効です。通常の環境では、バックアップ・サーバーは、バックアップ・データベースに影響を及ぼしたり、アクセスするコマンドを特権ユーザーだけに許可します。-noauth フラグが指定されていても、このようなアクションの実行は許可しません。

-smallht

このフラグを使用すると、バックアップ・サーバーは、バックアップ・データベースに小規模な内部ハッシュ・テーブルを使用します。これにより、メモリー要件は削減できますが、データのアクセスに時間がかかります。

-servers

バックアップ・サーバーを開始するデータベース・サーバー・マシンを指定します。サブセットのデータベース・サーバー・マシン上でバックアップ・サーバーを実行する場合には、この引き数を使用してください。このサブセットは、 /usr/afs/etc/CellServDB ファイルにリストされたマシンとは異なります。

-enable_peer_stats

Rx 統計集合を活動化し、それらを保管するためのメモリーを割り振ります。別のマシンの特定の UDP ポートとの接続ごとに、送信または受信された RPC の各タイプ (FetchFile、 GetStatus など) のレコードが別々に保持されています。レコードを表示したり、ほかの方法でレコードにアクセスするには、 Rx Monitoring API を使用します。

-enable_process_stats

Rx 統計集合を活動化し、それらを保管するためのメモリーを割り振ります。送信または受信された RPC の各タイプ (FetchFile、GetStatus など) ごとに、レコードが別々に保持され、別のマシンへのすべての接続が集計されます。レコードを表示したり、ほかの方法でレコードにアクセスするには、 Rx Monitoring API を使用します。

-help

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

例

次の例は、bos create コマンドを使用して、 buserver プロセスをファイル・サーバー・マシン fs3.abc.com 上に作成しています。ここでは、読みやすくするために 2 行で表示されています。

   % bos create -server fs3.abc.com -instance buserver  \
                -type simple -cmd /usr/afs/bin/buserver
   

必要となる特権

シェル・プロンプトでコマンドを発行するためには、発行者はファイルのサーバー・マシン上でローカル・スーパーユーザー root としてログインする必要があります。通常は、bos create コマンドを発行して、プロセスの作成および開始を行います。

関連情報

BackupLog

BosConfig

CellServDB (サーバー・バージョン)

bdb.DB0 および bdb.DBSYS1

backup

bos create

bos getlog