目的
磁気テープ上に磁気的なラベルを作成します。
構文
backup labeltape [-name <AFS tape name, defaults to NULL>]
[-size <tape size in Kbytes, defaults to size in tapeconfig>]
[-portoffset <TC port offset>]
[-pname <permanent tape name>]
[-localauth] [-cell <cell name>] [-help]
backup la [-n <AFS tape name, defaults to NULL>]
[-s <tape size in Kbytes, defaults to size in tapeconfig>]
[-po <TC port offset>] [-pn <permanent tape name>]
[-l] [-c <cell name>] [-h]
構文
backup labeltape コマンドは、磁気テープの先頭に、バックアップ・システムが読み取り可能な形式で磁気的なラベルを作成します。このラベルには、磁気テープの名前 (永続名、または磁気テープの内容を表す AFS 磁気テープ名が特定の形式で書き込まれます) とその容量が記録されます。
(指定されたポート・オフセットのテープ・コーディネーター・マシンにある /usr/afs/backup/CFG_device_name ファイルに FILE YES 命令がある場合、 backup コマンドを実行すると、磁気テープの先頭ではなく、テープ・コーディネーターの /usr/afs/backup/tapeconfig ファイルのポート・オフセットに対してリストされているバックアップ・データ・ファイルの最初の 16 KB にラベル情報が書き込まれます。説明を分かりやすくするために、以下では磁気テープ装置の場合について説明しますが、バックアップ・データ・ファイルの取り扱いは磁気テープ装置の場合とほとんど同じです。)
すでに AFS バックアップ・データのある磁気テープのラベルを作成し直すと、磁気テープ内の完全なダンプ・セットのレコードがバックアップ・データベースから削除されるため、データは使用不能になります。このコマンドを使用すると、実際には必要のない期限切れのダンプのある磁気テープが再利用できるようになります。
ラベルに永続名を書き込む場合には、 -pname 引き数に 32 文字までの文字列を指定してください。 backup labeltape コマンドに -pname 引き数が指定されない限り、永続名は変更されません。磁気テープの内容や磁気テープ・ラベルの作成回数、磁気テープの再利用回数には関係ありません。この引き数は、-name 引き数とは一緒に使用できません。この引き数を指定すると、AFS 磁気テープ名は <NULL> に設定されます。この引き数が省略されており、永続名が存在していない場合は、永続名は <NULL> に設定されます。
発行者は、セル内で AFS のバックアップに使用している磁気テープと永続名が重複しないように検査しなければなりません。 backup コマンドは、永続名が重複している磁気テープがあるかどうか検査しません。磁気テープに永続名があると、バックアップ・システムは、プロンプトや backup コマンドの出力で AFS 磁気テープ名ではなく永続名を使用します。永続名は、backup readlabel コマンド出力の tape name フィールドに表示されます。
ラベルに AFS 磁気テープ名を書き込むには、 [オプション]セクションで解説されている要求形式で、 -name 引き数に値を指定してください。 -name 引き数は、 -pname 引き数と一緒に使用できません。この引き数を省略すると、AFS 磁気テープ名は <NULL> に設定されますが、この磁気テープが後で backup dump または backup savedb 操作で使用されると、バックアップ・システムはこの磁気テープに適切な名前を自動的に割り当てます。 AFS 磁気テープ名は、backup readlabel および backup scantape コマンド出力の AFS tape name フィールドに表示されます。
磁気テープに永続名があると、 backup コマンド・インタープリターは -name 引き数を受け付けません。磁気テープの永続名を削除する場合には、 -pname 引き数にヌル値を指定して、次のコマンドを発行してください。
% backup labeltape -pname ""
ラベルに磁気テープの容量を記録する場合には、 -size 引き数に数値を KB 単位で指定してください。磁気テープに最初にラベルを作成するときに、この引き数を省略すると、バックアップ・システムは、テープ・コーディネーター・マシンの /usr/afs/backup/tapeconfig ファイルに指定されているポート・オフセットのデフォルトに設定されている磁気テープ容量を記録します。次に -size 引き数を指定して backup labeltape コマンドを発行するまで、 size フィールドの値は保存されます。
backup dump または backup savedb 操作実行中に、磁気テープに書き込むことのできるデータ量を決定するために、テープ・コーディネーターは、磁気テープ・ラベルに記録されている容量を読み取ります (または、磁気テープにラベルがない場合には、 /usr/afs/backup/tapeconfig ファイルに指定されているポート・オフセットに関連付けられている値を使用します)。詳しくは、 backup dump の解説ページを参照してください。
このコマンドを実行すると、デフォルトでは、テープ・コーディネーターは、ローカルの /usr/afs/backup/CFG_device_name ファイルの MOUNT 命令を呼び出して、最初の磁気テープにアクセスします。MOUNT 命令がない場合には、磁気テープの挿入をバックアップ操作員に要求します。ただし、 CFG_device_name ファイルに AUTOQUERY NO 命令があるか、あるいは butc コマンドが -noautoquery フラグ付きで発行されている場合には、テープ・コーディネーターは、磁気テープがすでに装置に挿入されているとみなします。そうでない場合、テープ・コーディネーターは MOUNT 命令を呼び出すか、操作員にプロンプトを出します。
オプション
volume_set_name.dump_level_name.tape_index
backup dump 操作で将来使用可能な磁気テープの場合、 volume_set_name は、磁気テープの作成された初期ダンプのボリューム・セット名と一致し、 dump_level_name が、ボリューム・セットがダンプされたダンプ・レベルのパス名の最後の要素と一致していなければなりません。また、tape_index は、ダンプ・セット内での磁気テープの順序を示しています (索引は 1 から開始します)。このタイプの名前の検査を使用禁止にするには、 CFG_device_name ファイルに NAME_CHECK NO 命令を組み込みます。
将来 backup savedb 操作で使用できる磁気テープの場合には、 -name 引き数を次の形式で指定しなければなりません。
Ubik_db_dump.tape_index
ここで、tape_index はバックアップ・データベースのダンプを格納している磁気テープ・ セットの順番を示します。
磁気テープに最初にラベルを作成するときに、この引き数を省略すると、バックアップ・システムは、テープ・コーディネーター・マシンの /usr/afs/backup/tapeconfig ファイルに指定されているポート・オフセットの設定されている磁気テープ容量を記録します。最初に記録された値は、次に -size 引き数を指定してコマンドを発行するまで保存されます。
この引き数は、-name 引き数とは一緒に使用できません。この引き数を指定すると、AFS 磁気テープ名は <NULL> に設定されます。この引き数を省略すると、既存の永続名が保存されます。
例
次のコマンドは、ポート・オフセット 3 の装置にある磁気テープのラベルに AFS 磁気テープ名 user.monthly.1 を記録しています。
% backup labeltape -name user.monthly.1 -portoffset 3
次の 3 つのコマンドは同じ結果になります。これらのコマンドはすべて、ポート・オフセット 4 の装置にある磁気テープのラベルに、 2 GB の容量を記録します。また、AFS 磁気テープ名を <NULL> に設定し、永続名を変更していません。
% backup labeltape -size 2g -portoffset 4 % backup labeltape -size 2048M -portoffset 4 % backup labeltape -size 2097152 -portoffset 4
必要となる特権
コマンドの発行者は、バックアップ・サーバーが実行されているすべてのマシン上の /usr/afs/etc/UserList ファイルにリストされていなければなりません。また、-localauth フラグを使用する場合は、ローカル・スーパーユーザー root としてサーバー・マシンにログオンする必要があります。
関連情報