# 管理解説書

## butc

目的

磁気テープ・コーディネーター・プロセスを初期化します。

構文

    butc [-port <port offset>]  [-debuglevel < 0 | 1 | 2 >]
         [-cell <cell name>]  [-noautoquery]
         [-localauth]  [-help]

    butc [-p <port offset>]  [-d < 0 | 1 | 2 >]
         [-c <cell name>]  [-n]  [-l]  [-h]

構文

butc コマンドは、磁気テープ・コーディネーター・マシン上で磁気テープ・コーディネーター・プロセスを初期化します。これにより、操作員は、バックアップ・システムの要求を、関連付けられた磁気テープ装置またはバックアップ・データ・ファイルに送信することができます。 (磁気テープ・コーディネーターは、FILE YES 命令が /usr/afs/backup/tapeconfig ファイルの磁気テープ・コーディネーターの項目に対応する /usr/afs/backup/CFG_device_name ファイルにある場合に、バックアップ・データを制御します。説明を簡単にするために、以下では磁気テープ装置について説明します。)

従来は、フォアグラウンドでテープ・コーディネーターを開始し、実行していました。このような場合、独自の接続で実行されます。この接続は、ほかには使用できず、テープ・コーディネーターがバックアップ要求を受け入れている間およびその要求を実行している間は、いつでもオープンしたままにしておかなければなりません。 (ウィンドウ・マネージャーを使用している場合には、この接続は別のコマンド・シェル・ウィンドウに対応します。) テープ・コーディネーターがオペレーターにプロンプトを出す必要がないように、 CFG_device_name ファイルが構成されている場合は、テープ・コーディネーターはバックグラウンドで実行することができます。フォアグラウンドおよびバックグラウンドのどちらでも、テープ・コーディネーターは、開始に使用された接続の標準出力ストリームに、オペレーション・トレースおよびほかの出力を書き込みます。表示される情報量を制御する場合には、-debuglevel 引き数を使用してください。また、磁気テープ・コーディネーターは、ローカルの /usr/afs/backup ディレクトリーの以下の 2 つのファイルに追跡メッセージとエラー・メッセージを書き込みます。

- TE_device_name ファイルは、磁気テープ・コーディネーターがバックアップ・オペレーティングを実行中に検出した問題を記録します。
- The TL_device_name ファイルは、TE_device_name ファイルに書き込まれたのと同じエラーと操作の追跡を記録します。

磁気テープ・コーディネーターは、初期設定時に自動的にこれらのファイルを作成します。既存ファイルがある場合は、磁気テープ・コーディネーターはそれらのファイルの拡張子を .old で置き換え、既存の .old ファイルが存在する場合はそれを上書きします。ファイル名の device_name の部分は、装置名の /dev/ 接頭部を削除して、残りのスラッシュを下線に置換して生成します。たとえば、/dev/rmt/4m という装置のファイル名は、TE_rmt_4m および TL_rmt_4m になります。

デフォルトでは、各オペレーションの開始時に、テープ・コーディネーターは、最初のテープをドライブに挿入して、 <Return> を押すよう、オペレーターにプロンプトを出します。このプロンプトを抑制するには、コマンド行に -noautoquery フラグを組み込むか、 /usr/afs/backup/CFG_device_name ファイルに命令 AUTOQUERY NO を組み込みます。プロンプトを抑制する場合には、 backup コマンドを発行する前に、最初に要求されるテープをドライブに挿入しておかなければなりません。以降のテープについては、テープ・コーディネーターは、通常のテープ獲得ルーチンを使用します。 /usr/afs/backup/CFG_device_name ファイルに MOUNT 命令を組み込む場合には、テープ・コーディネーターは指示されたコマンドを呼び出します。そうでない場合には、次のテープを求めるプロンプトがオペレーターに出されます。

テープ・コーディネーター・プロセスを停止するには、専用接続を介して (コマンド・シェル・ウィンドウで) <Ctrl-c> などの割り込みシグナルを入力します。

テープを呼び出す backup オペレーションを開始する前に、このオペレーションを取り消すには (最初のテープ・プロンプトが抑制されなかったことを想定している)、最初のテープを求めるテープ・コーディネーターのプロンプトで、文字 a (abort の) を入力し、 <Return> を押します。

テープ・コーディネーター・オペレーションは、以下のリストで説明するように、一定のファイルの正しい構成によって異なります。

- ローカルの /usr/afs/backup/tapeconfig ファイルには、情報の中でも特に、装置名やポート・オフセット番号を指定した磁気テープ・コーディネーターの項目が含まれていなければなりません。詳細については、tapeconfig の解説ページを参照してください。
- バックアップ・データベースのテープ・コーディネーターの項目に記録されるポート・オフセット番号は、 tapeconfig ファイルにある番号と同じでなければなりません。 backup addhost コマンドを使用して、バックアップ・データベース項目を作成してください。
- オプションの /usr/afs/backup/CFG_device_name ファイルには、磁気テープのマウントとアンマウントを自動で行ったり (たとえば、テープ・スタッカーまたはジュークボックスを使用する場合)、またはバックアップ・プロセスの他の過程を自動化するための命令を組み込むことができます。名前の device_name 部分は、以前に説明したように、 TE_device_name ファイルおよび TL_device_name ファイル用に派生されます。

注意

磁気テープ・コーディネーター・マシンが AIX マシンの場合、 SMIT ユーティリティーを使用して、装置のブロック・サイズを 0 (ゼロ)に設定してください。これは、可変ブロック・サイズを意味します。そうでない場合、他のオペレーティング・システムが稼動しているマシンに接続している磁気テープ装置では、AIX マシン上で書き込まれた磁気テープが読み込めない場合があります。詳しい説明は、バックアップ・システムの構成に関する AFS 管理の手引き の章を参照してください。

オプション

-port
  初期化する磁気テープ・コーディネーターのポート・オフセット番号を指定します。

-debuglevel
  磁気テープ・コーディネーターが標準出力ストリームに表示するメッセージの量とタイプを制御します。3 つの許容値のうち 1 つを指定してください。
  - 0 を指定すると、磁気テープ・コーディネーターの操作の説明に最低限必要な詳細が表示されます。たとえば、磁気テープをドライブに挿入するためのプロンプト、操作の開始および終了を示すメッセージ、それにエラー・メッセージなどです。これはデフォルト値です。
  - 1 を指定すると、ダンプあるいは復元されるボリューム名とレベル 0 で表示される情報が表示されます。
  - 2 を指定すると、TL_device_name ログ・ファイルに書き込まれているすべてのメッセージが表示されます。

-cell
  磁気テープ・コーディネーターが操作するセル名 (影響するボリュームのあるファイル・サーバー・マシンが所属するセル) を指定します。この引き数を省略すると、コマンドは、ローカルの /usr/vice/etc/ThisCell ファイルの定義通りに、ローカル・セルで実行されます。このフラグは、-localauth 引き数と一緒に使用しないでください。

-noautoquery
  この引き数を使用すると、操作に必要な最初の磁気テープを要求する磁気テープ・コーディネーター・プロンプトが表示されません。操作員は、操作を初期化する backup コマンドを発行する前に、磁気テープをドライブに挿入しなければなりません。

-localauth
  ローカルの /usr/afs/etc/KeyFile ファイルにある最高のキー・バージョン番号をもつサーバー暗号化鍵を使用して、サーバー・チケットを構成します。 butc コマンド・インタープリターは、相互認証で使用するためのボリューム・サーバーおよびボリューム・ロケーション・サーバーに、無期限のチケットを提供します。

  この引き数を -cell フラグと組み合わせて使用しないでください。この引き数を使用するのは、ローカルのスーパーユーザー root としてサーバー・マシンにログオンした場合だけにしてください。クライアント・マシンには /usr/afs/etc/KeyFile ファイルはありません。

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

例

次のコマンドは、ポート・オフセット 7 の 磁気テープ・コーディネーターをデバッグ・レベル 1 で開始します。これは、磁気テープ・コーディネーターがダンプまたは復元しているボリューム名が表示されます。

       % butc -port 7 -debuglevel 1

必要となる特権

コマンドの発行者は、バックアップ・サーバーまたはボリューム・ロケーション (VL) サーバーが稼動しているすべてのマシンおよびバックアップされるボリュームのあるファイル・サーバー・マシン上の /usr/afs/etc/UserList ファイルにリストされていなければなりません。 -localauth フラグがある場合、コマンドの発行者は、ローカル・スーパーユーザー root として磁気テープ・コーディネーター・マシンにログオンしている必要があります。また、コマンドの発行者はローカル /usr/afs/backup ディレクトリーのログ・ファイルおよび構成ファイルに対して、読み込みおよび書き込みが可能でなければなりません。

関連情報

CFG_device_name

KeyFile

TE_device_name

ThisCell (クライアント・バージョン)

TL_device_name

UserList

tapeconfig

backup addhost

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

(C) IBM Corporation 2000. All Rights Reserved