第 3 章 組み込みコンポーネントタイプ

組み込みコンポーネントタイプを使用すると、WebLogic、Microsoft Windows、および J2EE アプリケーションの一般的なコンポーネントをすばやくモデル化できます。これらのコンポーネントタイプにより、インストール、アンインストール、エクスポート、スナップショットなどの動作を、特定のコンポーネントと自動的に関連付けることができます。

基本製品の一部として、次のコンポーネントタイプを利用できます。

• 「コンポーネントタイプ: system#file」

• 「コンポーネントタイプ: system#directory」

• 「コンポーネントタイプ: system#symbolic link」

• 「コンポーネントタイプ: system#container」

• 「コンポーネントタイプ: untyped」

WebLogic や Microsoft Windows のアプリケーションなどのコンポーネントタイプは、プラグインにより利用可能です。詳細については、http://docs.sun.com/app/docs/coll/1329.1を参照してください。

コンポーネントタイプ: system#file

コンポーネントタイプ system#file は、ターゲットサーバーから取得した単一ファイルを意味します。プロビジョニングシステムは、特別な後処理を行わなくても、ファイルを直接配備します。コンポーネントタイプ system#file には、インストール、アンインストール、およびスナップショット手続きが含まれています。

コンポーネントタイプ system#file では、次の変数を定義します。

• installName – インストールしたリソースに使用する名前。デフォルト値はコンポーネント名です。

• installPath – リソースをインストールするパス。デフォルト値は、コンテナコンポーネントの installPath 変数の値です。

• installPermissions – インストールしたリソースに割り当てるアクセス許可。chmod(1M) のマニュアルページを参照してください。デフォルト値は空です。

• installUser – このリソースをインストールしたときの所有者。デフォルト値は空です。

• installGroup – このリソースをインストールしたときに割り当てるグループ。デフォルト値は空です。

• installDiffDeploy – リソースを差分配備モードで配備するかどうかを指定します。デフォルト値は TRUE です。

• overrideRsrcInstallPath – リソースをインストールする絶対パス。未定義の場合、installPath によって指定されたパスにインストールされます。この値は通常使用しません。installPath を使用すると、コンポーネントとリソースの両方について、インストールするパスを指定できるからです。

• installDeployMode – ファイルをディレクトリに追加する (ADD_TO) か、ディレクトリのファイルを置き換える (REPLACE) かを指定します。変数と値は、このタイプで REPLACE に固定されます。

ブラウズ

拡張制御手続き

コンポーネントタイプ system#file には次の手続きが定義されています。

• default install block – 変数の状態に基づいて包含ファイルを配備します。スナップショットは取得されません。

• markOnly install block – 新しいバージョンのコンポーネントがインストールされたことを明確にします。リソースの転送もスナップショットの取得も行われません。

• default uninstall block – 包含ファイルの配備を解除して、最初に配備されていた場所に戻します。

• markOnly uninstall block – 現在のバージョンのコンポーネントがアンインストールされたことを明確にします。コンポーネントのリソースがターゲットホストから実際に削除されるわけではありません。

• default snapshot block – 配備されたファイルのスナップショットを取得します。デフォルトインストールブロックは、デフォルトではファイルをキャプチャしないので、スナップショットが必要な場合はコンテナコンポーネントでこのルーチンを明示的に呼び出す必要があります。

コンポーネントタイプ: system#directory

プロビジョニングシステムは任意の数のコンポーネントを収容し、ユーザーが作成する任意のディレクトリ構造にそれらを配置することができます。作成可能なコンポーネントの数は、マスターサーバー上のファイルシステムによってのみ制限されます。各ファイルシステムは作成可能なファイルの数を制限します。単一のディレクトリに作成するファイルの数が多過ぎると、ファイルシステムの制限を超える可能性があります。コンポーネントとファイルの間の関係は、必ずしも同比率ではありません。たとえば、あるコンポーネントに 100,000 個のファイルが含まれる場合、そのコンポーネントはファイルシステムの制限を超えることもありますが、ファイルを含むコンポーネントがない場合、 100,000 個のコンポーネントでもファイルシステムの制限に収まることもあります。

ファイルシステムの制限を超えても、ファイルの作成時には直接エラーが生じない場合があります。ただし、問題は別の機会に、パフォーマンス劣化の深刻化や、予測不可能な障害の発生といった形で生じる可能性があります。

1 つのディレクトリがサポートできるファイルの数に対する制限はファイルシステムにより異なり、またオペレーティングシステムの構成方法の影響を受ける可能性があります。使用するファイルシステムの制限を理解し、単一の大きなディレクトリではなく小さな複数のサブディレクトリにコンポーネントを配置することで、ディレクトリの負荷超過を回避できます。コンポーネントを作成する際に使用する安全な方法としては、1 つのディレクトリに配置するファイル数を 30,000 以下にします。

コンポーネントタイプ system#directory は、ターゲットサーバーから取得されたファイルとフォルダの集まりを表します。コンポーネントタイプ system#directory には、インストール、アンインストール、およびスナップショット手続きが含まれています。

コンポーネントタイプ system#directory では次の変数を定義します。

• installName – インストールしたリソースに使用する名前。デフォルト値はコンポーネント名です。

• installPath – リソースをインストールするパス。デフォルト値は、コンテナコンポーネントの installPath 変数の値です。

• installPermissions – インストールしたリソースに割り当てるアクセス許可。chmod(1M) のマニュアルページを参照してください。デフォルト値は空です。

• installUser – このリソースをインストールしたときの所有者。デフォルト値は空です。

• installGroup – このリソースをインストールしたときに割り当てるグループ。デフォルト値は空です。

• installDiffDeploy – リソースを差分配備モードで配備するかどうかを指定します。デフォルト値は TRUE です。

• overrideRsrcInstallPath – リソースをインストールする絶対パス。未定義の場合、installPath によって指定されたパスにインストールされます。この値は通常使用しません。installPath を使用すると、コンポーネントとリソースの両方について、インストールするパスを指定できるからです。

• installDeployMode – ファイルをディレクトリに追加する (ADD_TO) か、ディレクトリのファイルを置き換える (REPLACE) かを指定します。デフォルト値は REPLACE です。

ブラウズ

拡張制御手続き

コンポーネントタイプ system#directory には次の手続きが定義されています。

• default install block – 変数の状態に基づいて包含ファイルを配備します。スナップショットは取得されません。

• markOnly install block – 新しいバージョンのコンポーネントがインストールされたことを明確にします。リソースの転送もスナップショットの取得も行われません。

• default uninstall block – 包含ファイルの配備を解除して、最初に配備されていた場所に戻します。

• markOnly uninstall block – 現在のバージョンのコンポーネントがアンインストールされたことを明確にします。コンポーネントのリソースがターゲットホストから実際に削除されるわけではありません。

• default snapshot block – 配備されたファイルのスナップショットを取得します。デフォルトインストールブロックは、デフォルトではファイルをキャプチャしないので、スナップショットが必要な場合はコンテナコンポーネントでこのルーチンを明示的に呼び出す必要があります。

コンポーネントタイプ: system#symbolic link

コンポーネントタイプ system#symbolic link は、ターゲットサーバーから取得した単一のシンボリックリンクを表します。プロビジョニングシステムは、ターゲットサーバー上に新しいリンクを作成することによって、シンボリックリンクを配備します。シンボリックリンクが示すファイルは、symlinkTarget 変数の値に基づきます。リンクのインストール位置にファイルが存在している場合は、新しいシンボリックリンクを作成する前に、それらのファイルが削除されます。

コンポーネントタイプ system#symbolic link には、インストール、アンインストール、およびスナップショット手続きが含まれています。アンインストール手続きは、結合先のファイルではなく、シンボリックリンクを削除します。スナップショット手続きも同様に、ファイルそのものではなく、シンボリックリンクが示すファイルの名前を取得します。

コンポーネントタイプ system#symbolic link では、次の変数を定義します。

• installName – インストールしたリソースに使用する名前。デフォルト値はコンポーネント名です。

• installPath – リソースをインストールするパス。デフォルト値は、コンテナコンポーネントの installPath 変数の値です。

• symlinkTarget – このリンクによって結合されるファイルの絶対パス。デフォルト値は、ファイルが本来リンクされていたファイルです。

コンポーネントタイプ system#symbolic link には次の手続きが定義されています。

• defaultinstall block – インストールパスにすでに存在していたファイルを削除して、symlinkTarget 変数の値にリンクするシンボリックリンクに置き換えます。スナップショットは取得されません。

• defaultuninstall block – リンク先のファイルを削除しないで、配備されたリンクを削除します。

• default snapshot block – 配備されたリンクのスナップショットを取得します。デフォルトインストールブロックは、デフォルトではファイルをキャプチャしないので、スナップショットが必要な場合はコンテナコンポーネントでこのルーチンを明示的に呼び出す必要があります。シンボリックリンクのスナップショットを要求すると、そのシンボリックリンクが示すパスが取得されます。

ブラウズ

エクスポート/内部ファイル形式

シンボリックリンクには、シンボリックプレースホルダの役割を果たすリソースが含まれます。シンボリックリンクデータは変数セットとして、名前と場所ごとに 1 つずつコンポーネントに格納されます。

コンポーネントタイプ: system#container

コンポーネントをグループにまとめ、1 つのコンポーネントとしてインストールしなければならない場合は、必ず、コンポーネントタイプ system#container を使用します。コンテナコンポーネントにはインストールブロック、アンインストールブロック、およびスナップショットブロックがあります。これらのブロックは子コンポーネントを自動的に呼び出します。このような呼び出しによって、コンテナコンポーネントの XML を編集しなくても、コンテナは Component Builder ユーザーインタフェースを使用することによって、子コンポーネントを直接追加できます。

ブラウズ

コンテナコンポーネントタイプは複合コンポーネントであり、ブラウズできません。

モデルとインストールの差分

この比較では、任意ですべての子コンポーネントのスナップショットを得ます。

default スナップショットブロックは、各子コンポーネントの default スナップショットブロックを使用し、installMode=“NESTED” が設定されているすべての子コンポーネントのスナップショットを取得します。

拡張制御手続き

コンポーネントタイプ system#container には次の手続きが定義されています。

• default install block – installMode=“NESTED” が設定されている子コンポーネントだけをインストールします。

• markOnly install block – すべての入れ子になった子コンポーネントの markOnly インストールブロックを呼び出し、このコンポーネントにインストール済みのマークを付けます。

• default uninstall block – installMode=“NESTED” が設定されている子コンポーネントだけをアンインストールします。

• markOnly uninstall block – すべての入れ子になった子コンポーネントの markOnly アンインストールブロックを呼び出し、このコンポーネントにアンインストール済みのマークを付けます。

• default snapshot block – createSnapshot が true に設定されている場合は、すべての子コンポーネントのスナップショットを取得します。installMode=“NESTED” が設定されている子コンポーネントだけがインストールされます。createSnapshot はデフォルトで false に設定されます。

スナップショットは常に有効なわけではありません。別のコンポーネントの入れ子コンポーネントとして配備されているコンポーネントは、createSnapshot=“false” を設定して配備してください。すべての包含コンポーネントが配備されたあとで、コンテナコンポーネントがこのコンポーネントのスナップショットを取得するからです。最上位コンポーネントとして配備されているコンポーネントは、createSnapshot=“true” を設定することによってスナップショットが使用可能になります。

コンポーネントがコンテナコンポーネントに含まれている場合、スナップショットは取得されません。このコンポーネントのあとでほかの包含コンポーネントが配備されると、このコンポーネントのインストール状態に影響を及ぼす可能性があります。したがって、スナップショットは上位レベルのインストールが完了してから取得します。

コンポーネントタイプ: untyped

untyped タイプのコンポーネントの拡張はベースコンポーネントなしに行われるため、デフォルト動作はありません。このタイプのコンポーネントは、カスタムタイプや XML をコンポーネントに追加する場合で組み込みタイプのデフォルト動作のどれもが関連性を持っていないときに、高度な編集を行うためのものです。