リソース記述子ファイルの概念

resource descriptor fileは、単純コンポーネントのリソースを構成するファイルとディレクトリに使用する、所有者、グループ、およびアクセス許可の設定を指定します。このリソース記述子は XML ファイルです。このファイルの XML スキーマの詳細については、『Sun N1 Service Provisioning System 5.1 XML スキーマリファレンスガイド』の第 5 章「リソース記述子スキーマ」を参照してください。リソース記述子ファイルを使用することで、コンポーネントのチェックイン時に決定されるアクセス許可を上書きできます。

リソース記述子ファイルを使用しない場合、リソースはチェックイン時の所有者、グループ、およびアクセス許可の設定を使用します。これは、UNIX システムでチェックインを実行する場合のデフォルトです。Windows システムでコンポーネントをチェックインする場合、デフォルト設定は、リソース記述子ファイルの各設定に :NONE: 値を使用したかのようになります。

リソース記述子ファイルを使用する場合、リソースは、リソース記述子により指定される所有者、グループ、およびアクセス許可の設定を使用します。リソースに対して <entry> 要素が指定されている場合、設定はそのエントリから取得されます。そのエントリが設定の一部を指定していない場合、存在しない設定値は <defaultEntry> から取得されます (存在する場合)。これらの設定値が <defaultEntry> で指定されていない場合、リソースはチェックイン時の設定値を使用します。

リソースに対して <entry> 要素が指定されていない場合、リソースは <defaultEntry> で指定されてる設定を使用します (存在する場合)。<defaultEntry> が存在しない場合、リソースはチェックイン時の設定を使用します。

コンポーネントが配備されるファイルシステムのデフォルト設定を使用するようプロビジョニングシステムに通知するには、:NONE: 値を使用します。リソースの <defaultEntry> ブロックまたは <entry> で指定されている設定には :NONE: 値を指定できます。

リソース記述子ファイルが使用されるのは、UNIX システムにコンポーネントを配備する場合のみです。コンポーネントを Windows システムに配備する場合、リソース記述子ファイルは無視されます。そのため、Windows システムにだけコンポーネントを適用する場合には、リソース記述子ファイルを作成しないでください。

リソース記述子ファイルは、system#file および system#directory コンポーネントタイプを拡張する単純コンポーネントで使用できます。またリソース記述子ファイルは、Linux プラグインの一部である com.sun.linux#rpm コンポーネントタイプを拡張するコンポーネントで使用することもできます。

コンポーネントをチェックインすると同時に、リソース記述ファイルもチェックインします。最後のチェックインにリソース記述子ファイルを使用したコンポーネントに対して checkin-current を試みる場合、プロビジョニングシステムは、元のチェックイン場所でリソース記述子が見つかると想定します。そのため、そのファイルを別の場所に移動し、コンポーネントに対して checkin-current を試みると、チェックイン処理は失敗します。

チェックインされた単純コンポーネントのリソース記述子をダウンロードすると、コンポーネントのリソースの一部であるあらゆるファイルの設定を確認できます。

このダウンロード機能を使用すると、ファイルを更新し、コンポーネントの更新バージョンをチェックインできます。まず、リソース記述子ファイルをダウンロードしてから、関連付けられたコンポーネントのリソースをチェックアウトします。続いて、リソース記述子ファイルを変更し、それを使用してコンポーネントの新しいバージョンをチェックインします。

ダウンロードするリソース記述子は、コンポーネントのチェックインに使用したリソース記述子とは異なる場合があります。違いが生じるのは、コンポーネントのチェックインに使用する記述子には、リソース内のあらゆるファイルに関する情報を持つ必要がなく、またあらゆるエントリに関する完全な情報を持つ必要がないためです。ダウンロードしたリソース記述子ファイルには <defaultEntry> ブロックが出現しないことに注意してください。その代わりに、どのファイルもそのファイルの <entry> 内で記述されています。