管理解説書

vos delentry

目的

VLDB からボリューム項目を削除します。

構文

vos delentry [-id <volume name or ID>+]
             [-prefix <prefix of volume whose VLDB entry is to be deleted>] 
             [-server <machine name>]  [-partition <partition name>]  
             [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]
     
vos de [-i <volume name or ID>+]
       [-pr <prefix of volume whose VLDB entry is to be deleted>]  
       [-s <machine name>]  [-pa <partition name>]  [-c <cell name>] 
       [-n]  [-l]  [-v]  [-h]

構文

vos delentry コマンドは、指定されたボリュームの項目をボリューム・ロケーション・データベース (VLDB) から削除します。指定されるボリュームは、3 つのタイプ (読み取り / 書き込み、読み取り専用、またはバックアップ) を取り得ますが、そのタイプに関係なく、項目全体が削除されます。このコマンドを実行しても、ファイル・サーバー・マシンに実際にあるボリュームには影響を及ぼしません。

ボリュームを削除しても VLDB が更新されず (vos zap コマンドが使用された可能性があるため)、システム管理者が vos syncserv および vos syncvldb コマンドを使用して、ファイル・サーバー・マシン全体の同期化を行う必要がある場合に、このコマンドは有効です。

単一ボリュームの項目を VLDB から削除する場合には、 -id 引き数を使用してください。ボリュームのグループを削除する場合には、 -prefix、-server、および -partition 引き数を組み合わせて使用してください。次のリストでは、指示されたグループのボリュームについて、VLDB 項目を削除する方法を説明します。

• 名前が特定の文字列 (たとえば、sys. または user. など) で始まるすべてのボリュームの場合。 -prefix 引き数を使用します。
• VLDB で特定のファイル・サーバー・マシン上のサイトがリストされているすべてのボリューム。 -server 引き数でファイル・サーバーの名前を指定します。
• VLDB で同じ名前の区画 (たとえば、任意のファイル・サーバー・マシンの /vicepa 区画) のサイトがリストされているすべてのボリューム。 -partition 引き数で区画名を指定します。
• VLDB で 1 つのファイル・サーバー・マシンの特定の区画にあるサイトがリストされているすべてのボリューム。 -server 引き数と -partition 引き数の両方を指定します。
• 名前が特定の接頭部で始まり、VLDB でファイル・サーバー・マシンのサイトがリストされているすべてのボリューム。 -prefix および -server 引き数を組み合わせます。 -prefix 引き数を -partition 引き数と組み合わせたり、 -server および -partition の両方の引き数と組み合わせて、特定のボリューム・グループを削除することができます。

注意

通常の状況では、このコマンドを使用してボリュームを削除しないでください。このコマンドは、ファイル・サーバー・マシンからボリュームを削除しないので、サーバー・マシンのボリュームの状況と VLDB が一致しなくなる可能性があります。ボリュームおよびボリュームの VLDB 項目の両方を削除する場合には、vos remove コマンドを使用してください。

オプション

-id

VLDB から項目を削除するボリュームの完全名およびボリューム ID 番号を指定します。このコマンドは、読み取り / 書き込み、読み取り専用、またはバックアップ・バージョンのいずれが指定されているのかにかかわらず、項目全体を削除します。この引き数は、-prefix、-server、および -partition 引き数と組み合わせて使用することができます。

-prefix

任意の長さの文字列を指定します。名前がこの文字列で始まるボリュームの項目が VLDB から削除されます。必要であれば、フィールド区切り記号 (ピリオドなど) を入れてください。この引き数は、 -server 引き数または -partition 引き数 (あるいはその両方) と一緒に使用してください。

-server

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

この引き数は、-prefix 引き数または -partition 引き数 (あるいはその両方) と一緒に使用してください。

-partition

区画を指定します。ボリュームの VLDB 項目に、この区画のサイトがリストされていると、この項目が削除されます。名前の前にスラッシュを付けて完全な区画名を指定するか (たとえば、/vicepa)、または使用可能な 3 つの省略形のいずれかを使用してください。詳細については、vos コマンド・セットの解説ページを参照してください。

この引き数は、-prefix 引き数または -server 引き数 (あるいはその両方) と一緒に使用してください。

-cell

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

-noauth

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

-localauth

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

-verbose

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

-help

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

出力

次のメッセージにより、削除された VLDB 項目数が示され、コマンドが成功したことが確認できます。

   Deleted number VLDB entries
   

例

次のコマンドは、ボリューム user.temp の項目を VLDB から削除しています。

   % vos delentry user.temp
   

次のコマンドは、VLDB でファイル・サーバー・マシン fs3.abc.com のサイトがリストされ、名前が test で始まるボリュームの項目を VLDB から削除しています。

   % vos delentry -prefix test -server fs3.abc.com
   

必要となる特権

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

関連情報

vos

vos remove

vos syncserv

vos syncvldb

vos zap