N1 Service Provisioning System 4.1 ユーザーガイド

第 5 章 コンポーネント

この章では、コンポーネントオブジェクトモデルについて説明します。 具体的には、コンポーネントの基本概念、コンポーネントのモデリングの方法、N1 Service Provisioning System ソフトウェアでコンポーネントのモデリングを行う場合に使用するコンポーネントスキーマ (XML タグ形式)、コンポーネントを管理するための CLI コマンドを紹介します。

この章の内容は次のとおりです。

コンポーネントの操作

コンポーネントの基本概念

コンポーネントとは、アプリケーションを定義するソース情報 (ファイルやディレクトリ構造、またはその他のコンポーネント) とこれらのソース情報の処理方法を指示する命令群を論理的なグループにまとめたものです。 たとえば、ファイルやディレクトリの集合、EAR (J2EE Enterprise Archive) や COM コンポーネントのような自律的なアーカイブ、BEA WebLogic のような完全なアプリケーション、パッチやサービスパックのようなオペレーティングシステムレベルの更新を「コンポーネント」と呼ぶことができます。 また、コンポーネントは他のコンポーネントを参照することもできます。

N1 Service Provisioning System ソフトウェアは、次のような方法でコンポーネントの管理性を向上させます。

N1 Service Provisioning System ソフトウェアによるコンポーネントとプランの管理の概要については、『「N1 Service Provisioning System ソフトウェア のオブジェクトモデル」』を参照してください。

コンポーネントのモデリング

N1 Service Provisioning System ソフトウェアでは、コンポーネントのモデリングを非常に柔軟に行うことができます。 モデリングするアプリケーションによって、次のいずれかのモデリング方法を選択できます。

完全な自動モデリング

ゴールドサーバーまたはソースコード制御システムでコンポーネントをチェックインし、プロビジョニングソフトウェアにコンポーネントモデルを自動生成させます。その後、このコンポーネントモデルを使ってインストール、構成、比較の作業を行います。 これらの作業中、ユーザーがコンポーネントモデルの XML コンテンツを表示したり編集したりする必要はありません。

Windows 環境では、この方法でコンポーネントのモデリングを行うことをお勧めします。 プロビジョニングソフトウェアの組み込みリソース型を使って、Windows アプリケーションコンポーネントを構成する一般的なリソースを自動的にモデリングすることができます。 リソース型テンプレートには、インストールをはじめとする基本的な操作の手続きがあらかじめ組み込まれています。このため、一般的なリソース型の基本操作なら、プランを作成せずに行うことができます。

すべてのリソース型の一覧については、「組み込みコンポーネント型」を参照してください。

XML オーサリングによる組み込みリソース型の拡張

上記の手順でコンポーネントモデルを自動生成した後、XML を編集して、このコンポーネントモデルをカスタマイズします。 コンポーネントモデルの XML を編集するには、コンポーネントの「Component」>「Details」ページの「Advanced Edit」機能を使用します。XML をローカルシステムにダウンロードし、Turbo XML などの XML スキーマ検査エディタを使って編集する方法もあります。

XML の編集後は、次の作業が可能になります。

XML でのコンポーネントモデルのオーサリング

XML エディタとこの章で紹介するコンポーネントスキーマを使って、コンポーネントモデルをゼロから作成することもできます。 ただし、作成したコンポーネントモデルを使用可能な状態にするためには、コンポーネントの XML ファイルとリソースをリポジトリにチェックインする必要があります。

コンポーネントのモデリングの概要

表 5–1 に、HTML ユーザーインタフェースを使用する場合と CLI を使用する場合のコンポーネントのモデリングの手順を示します。 これらの手順の詳細については、この章の「手続き」を参照してください。

表 5–1 コンポーネントの作成手順の概要

HTML ユーザーインタフェース 

コマンド行インタフェース 

  1. 「Components」ページで新しいコンポーネントを作成します。

  2. 「Component」>「Details」ページで、このコンポーネントを構成するコンポーネント群の参照を追加します。すでにチェックインされているコンポーネントは既存のコンポーネントとして追加します。まだチェックインしていなければ、新しいコンポーネントとして追加します。

  3. コンポーネントを保存します。 コンポーネントの保存が完了すると、特定の名前とバージョン番号を持つ新しいバージョンのコンポーネントが作成されます。 この新しいバージョンのコンポーネントは、それを構成する特定のバージョンのリソース群に関連付けられています。

  1. cdb.c.lo コマンドを実行して、管理対象のコンポーネントを構成するリソース群を一覧表示します。

  2. Turbo XML などの XML エディタを使って、コンポーネントの XML 定義を作成します。

  3. cdb.rsrc.ci コマンドを実行して、管理対象のコンポーネントを構成するリソース群をチェックインします。

コンポーネントの構築

有効なコンポーネントを作成するためには、コンポーネントを構築する必要があります。

構築が完了すると、そのコンポーネント内で使用されるリソースのバージョンが選択されます。 また、コンポーネントにバージョン番号が割り当てられます。したがって、特定のバージョンのコンポーネントは、常に特定のバージョンのリソースに関連付けられることになります。

コンポーネントには、次の属性があります。

HTML ユーザーインタフェースを使ってコンポーネントを定義する場合、コンポーネントは保存と同時に自動的に構築されます。

構築済みのコンポーネントは、次のいずれかの作業時に配備できます。

プランについては、第 6 章「プラン」を参照してください。

手続き

コンポーネント手続きには、コンポーネントのインストール、アンインストール、制御の方法を示すロジックが含まれています。 1 つのコンポーネントに定義できる手続きの数に制限はありません。 たとえば、コンポーネントのインストールやアンインストールの方法を何通りか定義してもかまいません。 制御手続きの 1 例として、サーバーを起動 / 停止するロジックがあります。

手続きのインストール、アンインストール、および制御は、HTML ユーザーインタフェースの「Advanced Edit」機能を使って行います。CLI の XML チェックインプロセスを使用する方法もあります。

複合コンポーネントを作成すると、このコンポーネントは、デフォルトで、デフォルトのインストール手順とデフォルトのアンインストール手順を継承します。 一般に、コンポーネントはそのコンポーネント型から手続きを継承します。 継承の詳細については、「コンポーネントの継承」を参照してください。

コンポーネントの継承

何かほかのものから特定の属性を取得することを「継承」と言います。 たとえばコンポーネントを作成すると、このコンポーネントは、デフォルトで、そのコンポーネント型の変数、スナップショット、手続きなどを継承 (取得) します。

この特性は、コンポーネントモデルの強度と柔軟性の向上に役立ちます。 たとえば、IIS アプリケーションコンポーネント型を拡張するコンポーネントが 1,000 個あるとします。これらのコンポーネントに機能を追加する場合、追加処理を 1,000 回繰り返す必要はありません。これらのコンポーネントが拡張する基本コンポーネント型に、必要な機能を 1 回追加するだけでよいのです。 1000 個のコンポーネントすべてがコンポーネント型から変更を継承します。

アクセスモードと修飾子

アクセスモードと修飾子は、コンポーネントの属性の使用方法や使用者を制御します。 また、組み込み型コンポーネント、コンポーネント変数、手続き、およびソースデータに影響を及ぼします。

基本的には、公開、非公開、パス、保護の 4 つのアクセスモードがあります。 すべての属性に適用されるものもあれば、そうでないものもあります。 修飾子は、final と abstract の 2 種類です。


注 –

「継承」、「アクセスモードと修飾子」の 2 つの概念は、どちらも Java 言語のそれと同様に機能します。 これらの概念についての詳細は、Java における継承、アクセスモード、修飾子の解説書と、『Plan and Component Language Specification』を参照してください。


コンポーネントのアクセスモードと修飾子

コンポーネントのアクセス属性は、コンポーネントの配備方法を制御します。 「パス」と「公開」の 2 つのモードがあります。 「パス」に設定した場合、このコンポーネントは同じパス内のコンポーネントからしか参照できません。また、ユーザーがこのコンポーネントを直接インストールすることはできません。 「公開」に設定した場合、この制限はありません。 コンポーネントは、パスとは関係なく、ほかのどのコンポーネントからでも参照可能です。また、ユーザーはこのコンポーネントを直接配備することができます。 コンポーネントのデフォルトのアクセスモードは「公開」です。

コンポーネントの修飾子、abstract と final は、配備オプションを指定します。 修飾子を abstract に設定した場合、コンポーネントはインストールされず、 その他のコンポーネントの拡張の基本コンポーネントとして機能します。 abstract 子要素を宣言できるのは、abstract コンポーネントだけです。 修飾子を final に設定した場合、このコンポーネントはほかのコンポーネントによって拡張できません。 修飾子を省略した場合、コンポーネントの拡張とインストールが可能になります。

コンポーネント変数のアクセスモードと修飾子

コンポーネント変数のアクセス属性は、その変数にアクセスできるものを制御します。 アクセスモードは、公開、非公開、パス、保護の 4 つです。 アクセスモードを「公開」に設定した場合、変数へのアクセスは制限されません。 「保護」に設定した場合、変数にアクセスできるのは同じパス内の派生コンポーネントとエンティティだけです。 「パス」に設定した場合、変数にアクセスできるのは同じパス内のエンティティだけになります。 「非公開」に設定した場合、変数にアクセスできるのはその変数を含むコンポーネントだけになります。 コンポーネントのデフォルトのアクセスモードは「公開」です。

コンポーネント変数の修飾子、abstract と final は、コンポーネント変数のデフォルト値と優先指定を指定します。 修飾子を abstract に設定した場合、変数のデフォルトの属性は無視されます。この値は、非 abstract の派生コンポーネントで指定する必要があります。 変数を abstract と宣言できるのは、コンポーネントが abstract と宣言されている場合のみです。 abstract 変数は非公開にはできません。 非 abstract 変数はデフォルト値を宣言する必要があります。 修飾子を final に設定した場合、変数を派生コンポーネントで上書きすることはできません。 修飾子を省略した場合、変数を上書きするかどうかは派生コンポーネント側で選択します。

コンポーネントソースのアクセスモードと修飾子

コンポーネントソースのアクセス属性はサポートされていません。したがって、「公開」となります。

コンポーネントソースの修飾子、abstract と final は、コンポーネントソースの場所の優先指定を指定します。 修飾子を abstract に設定した場合、ソースの場所は無視されます。この値は、非 abstract の派生コンポーネントで指定する必要があります。 コンポーネントのソースの場所を abstract と宣言できるのは、コンポーネントが abstract と宣言されている場合のみです。 ソースの場所が non-abstract と宣言されている場合は、ソースの場所を指定する必要があります。 修飾子を final に設定した場合、ソースの場所を派生コンポーネントで無効にすることはできません。 修飾子を省略した場合、ソースデータの場所を上書きするかどうかは派生コンポーネント側で選択します。

コンポーネントスキーマ

<component> タグ

<component> タグは、コンポーネントを定義するための基本タグです。 <component> を使って、コンポーネント名とバージョン番号を指定します。このコンポーネントでモデル化されたアプリケーションの作成元ソフトウェアベンダーなど、その他の情報を含めることもできます。

その他のコンポーネントタグ

コンポーネントの XML ファイルの <component> タグと </component> タグの間には、次のようなタグを挿入できます。

コンポーネントの XML 定義を編集して、次のようなタグを追加できます。

表 5–2 に、コンポーネントの修正や拡張に使用できる XML タグを示します。

表 5–2 コンポーネントスキーマの XML タグ

スキーマタグ 

必須/任意 

説明 

resourceList 

必須 

コンポーネントを構成するリソースの一覧。 ユーザーインタフェースを使ってコンポーネントを定義した場合、この一覧には、コンポーネントに追加した個々のリソースが含まれる。 

varList 

任意 

コンポーネントの設定変数の一覧を含む。 各変数には、名前とデフォルト値 (任意) が割り当てられる。 

installList 

必須。 

インストール命令のブロックを含む installSteps タグを 1 つ以上含む。 デフォルトでは、単一のコマンドを含む installSteps ブロックを 1 つだけ含む。 deployAllResources 

uninstallList 

必須 

コンポーネントのアンインストール (削除) 命令のブロックを含む uinstallSteps タグを 1 つ以上含む。 デフォルトでは、単一のコマンドを含む installSteps ブロックを 1 つだけ含む。 deployAllResources 

controlList 

任意 

コンポーネントを制御するために呼び出される、より高度な手続き (起動、停止など) を 1 つ以上定義する。 

snapShotList 

任意 

スナップショットに含める内容を定義する。 スナップショットには、スナップショット名、このスナップショットに含まれるファイルの一覧、スナップショットの作成前または作成後に実行する操作 (コンソールコマンドなど) を割り当てることができる。 

diff 

任意 

スナップショットの作成時に除外する内容を定義する。 

これらのタグの詳細については、『N1 Service Provisioning System 4.1 リファレンスガイド』を参照してください。

コンポーネント変数

コンポーネントは、変数の使用をサポートします。 変数とは、配備時に使用される値の格納先となるユーザー定義可能なコンテナです。 コンポーネント変数は、コンポーネントの各部へのアクセスを可能にし、これらの部分をコンポーネントの外部から設定できるようにするために使用されます。 たとえば、あるコンポーネントに、各コンポーネントのインストール先を定義する installPath という変数 (ホスト単位で無効化可能) を持たせることができます。

コンポーネント変数の値として、その他のコンポーネントの変数、たとえばそのコンポーネントのコンテナで定義された変数を参照させることもできます。 コンテナコンポーネントに入れ子のコンポーネントを追加すると、HTML ユーザーインタフェースにより、コンテナ内に参照変数が定義されているかどうかが検証されます。 コンテナコンポーネント内に参照変数が定義されていない場合、必要な参照変数がコンテナの変数リストに自動的に追加されます。 たとえば、単純コンポーネントの installPath 変数は、しばしばコンテナコンポーネントの installPath 変数を持つように定義されます。 この場合、参照変数の構文は :[container:installPath] のようになります。 変数の置換の詳細については、『N1 Service Provisioning System 4.1 リファレンスガイド』の第 16 章を参照してください。

コンポーネント変数は、コンポーネントの配備時に評価され、値を割り当てられます。 これらを使って、ホスト名、IP アドレス、パス、配備に必要なその他の情報を定義することができます。

変数セット

変数セットとは、デフォルト値を上書きする 1 個以上の変数の代替値を持つコンポーネント変数の一覧です。 使用する変数セットによって、コンポーネント変数に異なった値を指定することができます。

たとえば、2 つの異なった環境 (本稼働環境と開発環境など) にコンポーネントを配備したいとします。 このコンポーネント内に環境の違いの影響を受ける変数が定義されている場合は、コンポーネントのインストール先に合わせて異なった変数セットを使用します。 この場合、ユーザーは、プラン実行時にコンポーネントのインストール先の環境に合った変数セットを選択するだけで済みます。

変数の優先指定

変数の優先指定を設定できるのは、複合コンポーネントだけです。単純コンポーネントには設定できません。

コンポーネントにその他のコンポーネント (子コンポーネント) が含まれている場合、トップレベルの親コンポーネントだけが変数セットの影響を受けます。 すべての子コンポーネントは、デフォルトの変数値を使用します。

子コンポーネントのデフォルト値を上書きしたい場合は、この子コンポーネントの親コンポーネントの作成時に「変数の優先指定」変数を設定します。 ほかのコンポーネントから参照される各コンポーネントには、変数の優先指定のセットが割り当てられます。

コンポーネントレポート

N1 Service Provisioning System ソフトウェアでは、コンポーネント関連の有用な情報を一覧できます。 具体的には、特定のコンポーネントがインストールされている場所、特定のコンポーネントに含まれているリソース、特定のコンポーネントの全バージョン (バージョン履歴) などを一覧できます。

コンポーネントユーザーインタフェース

「Components」ページ

「Components」ページでは、コンポーネントの一覧、詳細表示、作成、および編集が可能です。 このページには、コンポーネントの一覧のフィルタリングや並べ替え基準の選択に使用するコントロールがあります。 コンポーネントの一覧の並べ替え基準を変更するには、見出し領域の矢印ボタンを使用します。 昇順または降順の矢印をクリックすると、その列の並び順が変更されます。

「Path」

コンポーネントの検索先または格納先を指定します。 異なったパスを指定するには、「Change Path」をクリックします。

「Show」

コンポーネントまたはプランを一覧表示します。 プランを選択すると、HTML ユーザーインタフェースに「Plans」ページが表示されます。画面左側のナビゲーションメニューの「Plans」オプションをクリックしても同じことができます。

「Category」プルダウンメニューから「Category」を選択して、一覧に表示する情報を絞り込むこともできます。

(チェックボックス)

チェックマークが付いたコンポーネントは、「Actions for Checked Components」領域のアクションをクリックしたとき、そのアクションの実行対象となります。 「Actions for Checked Components」をクリックすると、コンポーネントの削除、チェックイン、または分類が行われます。

「Component 」

コンポーネントオブジェクトを指定するユーザー定義可能なテキスト文字列。 デフォルトでは、コンポーネントはアルファベット順に一覧表示されます。 列の見出し領域の矢印ボタンをクリックすることにより、この列の項目に従ってコンポーネントの一覧を並べ替えることができます。 昇順または降順の矢印をクリックすると、この列の並び順が変更されます。

「Type」

リソースの処理方法を制御するユーザー定義可能なオブジェクト。

コンポーネント型の詳細については、「コンポーネントの構築」を参照してください。

「Version」

コンポーネントのリビジョン番号を表示します。 コンポーネントの変更のたびに、バージョン番号が大きくなります。

列の見出し領域の矢印ボタンをクリックすることにより、この列の項目に従ってコンポーネントの一覧を並べ替えることができます。 昇順または降順の矢印をクリックすると、この列の並び順が変更されます。

「Label」

コンポーネントをさらにグループ化するために使用するユーザー定義可能な任意のテキスト文字列。

列の見出し領域の矢印ボタンをクリックすることにより、この列の項目に従ってコンポーネントの一覧を並べ替えることができます。 昇順または降順の矢印をクリックすると、この列の並び順が変更されます。

「Description」

コンポーネントオブジェクトについて説明するユーザー定義可能な任意のテキスト文字列。 この属性はプロビジョニングソフトウェアでは使用されませんが、ユーザーにとって有用な情報を提供するという点で重要です。

「Action」

新しいコンポーネントの作成、特定のコンポーネントの詳細情報の表示、コンポーネントの編集などの目的でその他のコンポーネント関連ページにジャンプするリンク。

「Actions for Checked Component」

この領域から、チェックマークのついたコンポーネントの削除、チェックイン、カテゴリの割り当てを行うことができます。

「Components Details」ページ

「Component Details」ページには、コンポーネントの情報と属性が表示されます。 このページは、一般的な情報や機能別にセクション分けされています。また、ページ上の各種ボタンを使って、アンインストールするコンポーネントの場所の指定、コンポーネントの削除、「Component Edit」ページへの移動、XML ファイルのダウンロードなどを実行することができます。

一般情報

このセクションには、コンポーネントの一般情報が表示されます。

「Component」

コンポーネントの名前。 デフォルトでは、コンポーネントはアルファベット順に一覧表示されます。 矢印ボタンをクリックすることにより、この列の項目に従ってコンポーネントの一覧を並べ替えることができます。

「Type」

コンポーネント型の名前。

リソースの処理方法を制御するユーザー定義可能なオブジェクト。

コンポーネント型の詳細については、「コンポーネントの構築」を参照してください。

「Version」

コンポーネントのリビジョン番号を表示します。

「Platform」

コンポーネントの配備先として適切なオペレーティングシステムを表示します。

「Checked In」

コンポーネントがチェックインされた日付と時刻を表示します。 That is, created or modified.

「Checked In By」

コンポーネントをチェックインしたユーザーのユーザー ID を表示します。 問題や不整合のトラブルシューティングを行う際、この情報を監査トレールとして使用できます。

「Label」

「Components」ページの項目の並び順を制御するユーザー定義可能なテキスト文字列。

「Category」

コンポーネントの一覧のフィルタリングに使用するユーザー定義可能なオブジェクト。 カテゴリは、「Administrative」ページからカテゴリのページにアクセスして作成します。 カテゴリの適用は、「Components」ページで行います。 「Apply Categories...」リンクをクリックしてカテゴリを作成する方法もあります。

「Description」

コンポーネントオブジェクトについて説明するユーザー定義可能な任意のテキスト文字列。 この属性はプロビジョニングソフトウェアでは使用されませんが、ユーザーにとって有用な情報を提供するという点で重要です。

ファイル / ディレクトリ情報

このセクションは、コンポーネント型が「ファイル」の場合にのみ表示され、そのファイルに関する一般情報を提供します。 ディレクトリのセクションは、ラベルが付いている点を除いて、このセクションと同じです。

「File Name」

コンポーネント型を指定するテキスト文字列。 このフィールドをディレクトリの「ディレクトリ名」と呼びます。

「Time Stamp」

ファイルまたはディレクトリが作成された日付と時刻。

「Total Size」

ファイルまたはディレクトリを格納するために必要な合計ディスク容量。

「User」

ファイルまたはディレクトリの所有者。

「Group」

このファイルまたはディレクトリのグループ関係。

「Permissions」

ユーザー、グループ、ならびにユーザーのカテゴリにもグループのカテゴリにも属さないユーザーの読み取り権、書き込み権、実行権を示します。 最初の 3 文字は、ユーザーすなわち所有者の読み取り権 (R)、書き込み権 (W)、実行権 (X) を表しています。 次の 3 文字は、グループの読み取り権 (R)、書き込み権 (W)、実行権 (X) を表します。 最後の 3 文字は、所有者でもグループ内のユーザーでもないユーザーのアクセス権を表します。

「Options」

コンポーネントの作成時にチェックマークを付けたオプションを表示します。

参照されるコンポーネント

このセクションには、親コンポーネントから参照されるコンポーネントの情報が表示されます。

「Resource [tree]」

親コンポーネント (リソースオブジェクト) の子となるコンポーネントの型を指定するユーザー定義可能なテキスト文字列。

「Type」

子コンポーネントのコンポーネント型を示します。

「Version」

リソースのリビジョン番号を表示します。 リソース定義の変更のたびに、バージョン番号が大きくなります。

「Source」

子コンポーネント (リソース) のソースパスを示します。

「Action」

コンポーネントに新しいリソースを定義 (チェックイン) したり、既存のリソースの一覧からリソースを選択したりできます。

コンポーネント変数

このセクションには、コンポーネント変数関連の情報が表示されます。

「Variable」

配備のカスタマイズに使用するユーザー定義可能な変数。

「Value」

コンポーネント変数の値。この値はユーザーが指定します。

コンポーネント手続き

このセクションには、コンポーネント手続き関連の情報が表示されます。

チェックボックス

プランに含める手続きにチェックマークをつけます。

「Procedure」

このコンポーネント内に定義されている手続きを一覧表示します。

「Actions」

チェックマークのついた手続きを含めるプランを生成します。

ボタン

このセクションには、コンポーネント手続き関連の情報が表示されます。

「Edit」

コンポーネント情報を変更する「Component Edit」ページへジャンプします。

「Advanced Edit」

コンポーネント情報とコンポーネント機能をコードレベルで変更する「XML Edit」ページへジャンプします。

「Delete」

このコンポーネントを削除します。 このコンポーネントを参照しているオブジェクトがある場合、HTML ユーザーインタフェースにメッセージが表示され、このコンポーネントの削除は許可されません。

「Done」

「Components」ページに戻ります。

「Download」

テキストファイルにコンポーネントの XML コードをエクスポートします。

「Variable Settings」

変数のデフォルト値を上書きします。

「Where Installed」

コンポーネントがインストールされている場所を表示します。

「Components Edit」ページ

「Component Edit」ページでは、コンポーネントの情報と属性を変更できます。 ただし、一部変更が許可されていないフィールドもあります。

「Component Edit」ページのフィールドは、表示するコンポーネント型によって異なります。これは、「Component Details」ページと共通の特徴です。 たとえば、ファイルのフィールドは IIS アプリケーションのフィールドとは異なります。 以下では、変更可能なフィールドのみを紹介します。

「Component Edit」ページは、一般情報や機能別にセクション分けされています。この点も、「Component Details」ページと共通しています。 以下では、個々のセクションについて説明します。

一般情報

「Components Edit」ページの最初のセクションです。コンポーネントの一般情報が表示されます。

「Component」

コンポーネントオブジェクトの名前を表示します。 このフィールドはコンポーネントの作成時に設定されます。変更することはできません。

「Type」

コンポーネント型の名前を表示します。 このフィールドはコンポーネントの作成時に設定されます。変更することはできません。

「Version」

コンポーネントのリビジョン番号を表示します。 コンポーネントの変更のたびに、バージョン番号が大きくなります。 バージョン番号をユーザーが変更することはできません。

「Platform」

コンポーネントの配備先として適切なオペレーティングシステムを変更できます。 これはプルダウンメニューから選択することによって行えます。

「Checked In」

コンポーネントがチェックインされた日付と時刻を表示します。 このフィールドはプロビジョニングソフトウェアによって自動的に設定されます。ユーザーが変更することはできません。

「Checked In By」

コンポーネントをチェックインしたユーザーのユーザー ID を表示します。 このフィールドはプロビジョニングソフトウェアによって制御されています。ユーザーが変更することはできません。

「Label」

ラベルを入力または変更するためのテキストフィールド。

「Category」

コンポーネントのカテゴリを表示します。 このフィールドはコンポーネントの作成時に設定されます。変更することはできません。

「Description」

コンポーネントの説明を入力または変更するためのテキストフィールド。

ファイル / ディレクトリ情報

このセクションは、コンポーネント型が「ファイル」の場合にのみ表示され、そのファイルに関する一般情報を提供します。 ディレクトリのセクションは、ラベルが付いている点を除いて、このセクションと同じです。 このセクションのフィールドは変更できません。

含まれるリソース

このセクションには、コンポーネントのリソース関連の情報が表示されます。 変更できるフィールドと変更できないフィールドがあります。

「Resource [tree]」

リソースコンポーネントのパスを表示します。

「Type」

プルダウンメニューから新しい型フォームを選択することにより、リソースコンポーネントを変更できます。

「Version」

リソースのリビジョン番号を表示します。 このフィールドは プロビジョニングソフトウェア によって制御されています。ユーザーが変更することはできません。

「Source」

リソースのソースを示します。

「Action」

コンポーネントに新しいリソースを定義 (チェックイン) したり、既存のリソースの一覧からリソースを選択したりできます。

チェックボックス

チェックマークが付いたリソースは、「Actions for Checked Resources」領域のアクションをクリックしたとき、そのアクションの実行対象となります。 「Actions for Checked Resources」をクリックすると、リソースのチェックイン、リソースの削除、上下のリソースへの移動、または最新のリソースへのバージョンの割り当てが行われます。

コンポーネント変数

このセクションには、コンポーネントの変数関連の情報が表示されます。

「Variable」

このフィールドでは、新しい変数を作成できます。 ここには、既存の変数も一覧されます。

「Value」

このフィールドでは、新しい変数の値を設定できます。 ここには、既存のすべての変数の値も一覧されます。

チェックボックス

チェックマークが付いたコンポーネント変数は、「Actions for Checked Variables」領域のアクションをクリックしたとき、そのアクションの実行対象となります。 「Actions for Checked Variables」をクリックすると、上下の変数への移動、または変数の削除が行われます。

ボタン

このセクションには、コンポーネント手続き関連の情報が表示されます。

「Check in」

変更されたコンポーネントをチェックインし、リビジョン番号を大きくします。

「Check in as」

変更されたコンポーネントを別の名前でチェックインし、適切なリビジョン番号を設定します。

「Cancel」

変更内容を保存しないで「Components Details」ページへ戻ります。

Procedureコンポーネントの一覧を表示する

手順
  1. 画面左側のナビゲーションメニュー内の「Components」をクリックします。

    HTML ユーザーインタフェースに、すでにデータベースにチェックインされているコンポーネントを一覧する「Components」ページが表示されます。

Procedureコンポーネントの詳細情報を表示する

手順
  1. 画面左側のナビゲーションメニュー内の「Components」をクリックします。

    HTML ユーザーインタフェースに、すでにデータベースにチェックインされているコンポーネントを一覧する「Components」ページが表示されます。

  2. 詳細情報を表示したいコンポーネントの列を探して、「Details」をクリックします。

    HTML ユーザーインタフェースに、そのコンポーネントの「Components Details」ページが表示されます。

Procedureコンポーネントのインストールを表示する

手順
  1. 画面左側のナビゲーションメニュー内の「Components」をクリックします。

    HTML ユーザーインタフェースに、すでにデータベースにチェックインされているコンポーネントを一覧する「Components」ページが表示されます。

  2. 情報を表示したいコンポーネントの列を探して、「Where Installed」をクリックします。

    HTML ユーザーインタフェースに、そのコンポーネントの「Where Installed」ページが表示されます。

Procedureコンポーネントを作成する

手順
  1. 画面左側のナビゲーションメニュー内の「Components」をクリックします。

    HTML ユーザーインタフェースに、すでにデータベースにチェックインされているコンポーネントを一覧する「Components」ページが表示されます。

  2. コンポーネントの一覧表の一番上の行の「Component」フィールドに新しいコンポーネントの名前を入力し、「Create」をクリックします。

    HTML ユーザーインタフェースに、新しいコンポーネントの「Components Details Edit」ページが表示されます。 このページは、名前と型を変更できるという点で、前出の「Component Edit」ページとは異なっています。

  3. このページのコントロールを使って、コンポーネントを構成するために必要な情報を指定します。

    • 必要な場合は、「Component」フィールドの名前を変更します。 コンポーネントのチェックイン後は、名前の変更はできません。

    • プルダウンメニューから型を選択します。 ここで選択したコンポーネント型に応じて、「Component Edit」ページのフィールドの値が変更されます。

    • プルダウンメニューからプラットフォームを選択します。

    • 「Label」フィールドにラベルを入力します。

    • 「Description」フィールドに説明を入力します。

    • その他の必要な情報を入力します。 必要な情報は、選択したコンポーネント型によって異なります。

    • 完了したら「Check in」をクリックします。

    HTML ユーザーインタフェースに、コンポーネントをバージョン 1.0 としてチェックインすることを報告するウィンドウが表示されます。

  4. 「Continue」をクリックして、その他のコンポーネントをチェックインします。

Procedureコンポーネントを編集する

手順
  1. 画面左側のナビゲーションメニュー内の「Components」をクリックします。

    HTML ユーザーインタフェースに、すでにデータベースにチェックインされているコンポーネントを一覧する「Components」ページが表示されます。

  2. 詳細情報を表示したいコンポーネントの列を探して、「Details」をクリックします。

    HTML ユーザーインタフェースに、そのコンポーネントの「Components Details」ページが表示されます。

  3. 「Edit」ボタンをクリックします。

    HTML ユーザーインタフェースに、そのコンポーネントの「Components Details Edit」ページが表示されます。

  4. 「Components Edit 」ページのコントロールを使って、コンポーネントの設定を変更します。

  5. 変更が完了したら、「Check in」をクリックします。

  6. コンポーネントのリソースがすべて一覧表示されたら、「Check in」をクリックします。

    HTML ユーザーインタフェースに、コンポーネントをバージョン n (n は次の増分値) としてチェックインすることを報告するウィンドウが表示されます。

  7. 「Continue」をクリックして、その他のコンポーネントをチェックインします。

N1 Service Provisioning System ソフトウェアから報告される情報の場所

次の表に、N1 Service Provisioning System ソフトウェアから報告される情報の場所をまとめます。

内容 

探したい場所 . . 

探し方 . . 

コンポーネント 

特定のコンポーネントがインストールされている場所 

  • 「Components」ページを開く。

  • 必要なコンポーネントが表示されている行を探す。

    「Where Installed」をクリックする。

特定のコンポーネントに含まれるリソースの一覧 

  • 「Components」ページを開く。

  • 必要なコンポーネントが表示されている行を探す。

  • 「Details」をクリックする。

特定のコンポーネントの全バージョンの一覧 (コンポーネントのバージョン履歴) 

  • 「Components」ページを開く。

  • 必要なコンポーネントが表示されている行を探す。

  • 「Details」をクリックする。 「Components Details」ページの「Version History」をクリックする。

コンポーネントの CLI コマンドの概要

cdb.c コマンドは、コンポーネントを管理する汎用コントロールを提供します。

表 5–3 コンポーネント管理のための CLI コマンド

コマンド 

説明 

cdb.c.ci 

ブラウズできないコンポーネントおよびコンポーネントモデルをチェックインする。 

cdb.c.co 

コンポーネントをチェックアウトする。 

cdb.c.la 

すべてのコンポーネントのすべてのバージョンを一覧表示する。 

cdb.c.lo 

コンポーネントの詳細情報を一覧表示する。 

cdb.c.lv 

あるコンポーネントの全バージョンを一覧表示する。 

cdb.c.mod 

コンポーネントを変更する。 

cdb.c.sc 

コンポーネントに 1 個以上のカテゴリを適用する。 

cdb.c.sh 

コンポーネントの表示 / 非表示を切り替える。 

cdb.c.del 

コンポーネントを削除する。 

cdb.ic コマンドは、ホストにインストールされているコンポーネントに関する情報を取得します。

表 5–4 インストール済みコンポーネントの管理のための CLI コマンド

コマンド 

説明 

cdb.ic.lbc 

あるコンポーネントがインストールされている全ホストを一覧表示する。 

cdb.ic.lbh 

あるホストにインストールされている全コンポーネントを一覧表示する。 

cdb.ic.vs.lo 

生成された変数設定オブジェクトを指定して、その詳細情報を一覧表示する。 

cdb.vs コマンドは、コンポーネントの変数設定を管理します。

表 5–5 変数設定の管理のための CLI コマンド

コマンド 

説明 

cdb.vs.add 

新しい変数設定オブジェクトを追加する。 

cdb.vs.del 

変数設定オブジェクトを削除する。 

cdb.vs.imp 

別のコンポーネントから変数設定オブジェクトをインポートする。 

cdb.vs.la 

特定のコンポーネントに関連付けられているすべての変数設定オブジェクトを一覧表示する。 

cdb.vs.lo 

特定の変数設定オブジェクトの詳細情報を一覧表示する。 

cdb.vs.mod 

変数設定オブジェクトを変更する。 

コンポーネント型の操作

はじめに

コンポーネント型は、コンポーネントによって参照されるソース項目の処理方法を制御する、ユーザー定義可能なオブジェクトです。 コンポーネント型オブジェクトは、ファイル、ディレクトリ、設定などのソース項目の収集ならびに配備を管理する、もう 1 つのコンポーネントです。

すべてのコンポーネントのコンポーネント型属性に、何らかのコンポーネント型を設定する必要があります。 定義済みのコンポーネント型を持たないコンポーネントのコンポーネント型は、untyped になります。

単純コンポーネントによって参照されるファイル、ディレクトリ、その他のツリー構造は、コンポーネント内の別々の部分として管理されます。 たとえば、プロビジョニングソフトウェアが参照ソース項目として管理する IIS アプリケーションがあるとします。このアプリケーションには、次の項目が含まれます。

ファイルやディレクトリといった、コンポーネントによって参照される項目の一部は、ゴールドサーバーまたはデータソースから簡単にコピーできます。 一方、IIS Web サイト設定や Windows レジストリエントリなどは、データソースからきちんとした方法で抽出する必要があります。そうしないと、独立した管理可能エンティティとして操作することはできません。 プロビジョニングソフトウェアは、組み込み型のコンポーネント型から、J2EE アプリケーションや Windows アプリケーションで使用される一般的なソース項目を識別し、コンポーネントのソースとして使用したいデータをスマートかつ確実に抽出することができます。さらに、こうしたコンポーネントソースをリポジトリに格納し、ソース項目を正しい場所にインストールすることができます。

コンポーネントに手続きが含まれる場合、その手続きは「Components Details」ページに表示されます。たとえば、Web サーバーが稼動しているかどうかをテストする手続きなどがあります。

プロビジョニングソフトウェアには、一般的なコンポーネント型が多数組み込まれています。 組み込みコンポーネント型の詳細については、「組み込みコンポーネント型」を参照してください。

コンポーネント型のチェックイン

リソースのチェックインとは、特定の場所 (ゴールドサーバー上のディレクトリなど) からソフトウェアの特定部分をコピーし、特定の名前、バージョン番号、リソース型でリポジトリに格納する処理のことを指します。

リソース型はリソースの形式、多くの場合リソースの機能を表します。 リソース型の例として、ファイル、ディレクトリ、IIS Web サイト設定、COM+ アプリケーションなどがあります。 リソース型の一覧は、「組み込みコンポーネント型」を参照してください。

リソースリポジトリは、階層型の名前空間を使用します。 この名前空間内では、個々のリソースは一意のリソース名とバージョン番号で識別されます。

cdb.rsrc.ci は、リソースをチェックインする CLI コマンドです。 cdb.rsrc.ci を使ってリソースをチェックインするときは、リソースのソースの場所、リポジトリ内のリソースの格納先 (階層型の名前)、リソース型を指定します。リソースのソースの場所は -src 引数、リポジトリ内のリソースの格納先は -dst 引数、リソース型は -type 引数で指定します。

1 つのリソースを複数のコンポーネントで使用することもあります。 cdb.rsrc.ci でチェックインしたリソースには、特定のコンポーネントは関連付けられません。

拡張制御サービス

リソースまたはコンポーネント関連のソフトウェア操作を実行する手続きを「拡張制御サービス」と呼びます。 汎用制御サービスについては、「汎用拡張制御サービス」を参照してください。

組み込みコンポーネント型

組み込みコンポーネント型を使用すると、WebLogic、Windows、J2EE などの一般的なアプリケーションコンポーネントの多くを簡単にモデリングできます。また、インストール、アンインストール、エクスポート、スナップショットなどの操作を特定のリソースに自動的に関連付けることができます。

表 5–6 組み込みコンポーネント型の一覧

すべての WebLogic 

WebLogic Enterprise アプリケーション 

WebLogic Web アプリケーション 

WebLogic EJB 

すべての IIS 

IIS アプリケーション 

IIS Web サイトまたは仮想ディレクトリ設定 

IIS グローバル設定 

グローバル ISAPI フィルタ設定 

Web サイト ISAPI フィルタ設定 

すべての Windows 

COM+ アプリケーション 

COM オブジェクト 

レジストリキー 

Windows レジストリファイル 

データソース名 

Windows Installer ファイル (.msi) 

Windows バッチファイル 

Windows スクリプティングホストスクリプト 

すべての UNIX 

Symbolic Link 

RPM ファイル 

ファイル 

ディレクトリ 

コンテナ 

型なし (untyped) 

コンポーネント型: ファイル

ターゲットマシンから取得した untyped の単一のファイルを表します。 プロビジョニングソフトウェアは、ファイルを直接配備します。特別な事後処理はありません。 ファイルにもシステムコンポーネントがありますが、インストール、スナップショット、アンインストールの機能はシステムに組み込まれており、コンポーネント XML では表現されません。

ブラウズ (Browsing)

表 5–7 ファイルのブラウズ操作

 

Unix 

ウィンドウ 

ルートパス 

"/” 

ホストまたはドライブ文字にマップされたネットワーク共有上の物理ドライブの一覧。 リムーバブルメディア (フロッピーディスク、CD、Zip など) は含まれない 

区切り記号 

"/” 

"\” 

順序 

アルファベット順 (ディレクトリが先) 

選択型 

チェックインするファイルを 1 回選択。 ディレクトリをダブルクリックするとその内容が表示される 

サンプルパス 

/foo/foo.txt 

C:\foo\foo.txt 

フィルタ 

なし 

特記事項 

リンクはローカル名とポイント先の場所を表示する 

例: "foo->/usr/bar” 

 

拡張制御手続き

表 5–8 ファイル拡張制御手続き

名前 

パラメータ 

説明 

削除 (Delete) 

path: ディスク上のファイルの完全パス 

ファイルシステムからファイルを削除する。 プラットフォームに依存せずにファイルを削除できる 

コンポーネント型: ディレクトリ

ターゲットマシンから取得した untyped のファイルやフォルダの集合を表します。 ディレクトリにもシステムコンポーネントがありますが、インストール、スナップショット、アンインストールの機能はシステムに組み込まれており、コンポーネント XML では表現されません。

ブラウズ

表 5–9 ディレクトリのブラウズ操作

 

Unix 

ウィンドウ 

ルートパス 

"/” 

ホストまたはドライブ文字にマップされたネットワーク共有上の物理ドライブの一覧。 リムーバブルメディア (フロッピーディスク、CD、Zip など) は含まれない 

区切り記号 

"/” 

"\” 

順序 

アルファベット順 (ディレクトリが先) 

選択型 

チェックインするディレクトリを 1 回選択。 ディレクトリをダブルクリックするとその内容が表示される 

サンプルパス 

/foo/foo 

C:\foo\foo 

フィルタ 

なし 

特記事項 

リンクはローカル名とポイント先の場所を表示する 

例: "foo/->/usr/bar/” 

 

拡張制御手続き

表 5–10 ディレクトリ拡張制御手続き

名前 

パラメータ 

説明 

削除 (Delete) 

path: ディスク上のディレクトリの完全パス 

ファイルシステムからディレクトリを削除する。子ディレクトリも再帰的に削除される。 プラットフォームに依存せずにディレクトリを削除できる 

IIS 型の基本情報

次の 4 つの IIS 型の実装は共通しています。 いずれも、IIS メタベースへのデータのエクスポート、インストール、同メタベースからのデータの削除を行います。 結果的に、これらの機能、形式、エラーは共通のものとなります。

エクスポートされたファイル形式と内部ファイル形式

4 つの IIS 型はいずれも、メタベースのセクションを XML 形式で保存します。 現在の XML 形式は NTACL 型のメタベースプロパティ (AdminACL など) をサポートしていません。これらのプロパティは、メタベースの読み取り / 書き込み時に無視されます。 IPSec 型のプロパティ (IPSecurity) は直列化オブジェクトとして書き出されます。したがって、直接参照する方法でも、差分を参照する方法でも、その内容をユーザーの目で読み取ることはできません。

M-I 差分

スナップショットを作成すると、メタベースの現在の状態が XML ファイルにエクスポートされます。 M-I 差分を実行すると、メタベースの状態が再エクスポートされ、元の XML ファイルと比較されます。 これらのファイルの差分生成には、標準 XML 差分生成ツールが使用されます。

エラー条件

表 5–11 IIS 型の基本的なエラー条件

操作 

条件 

結果 

インストール / エクスポート 

IIS が存在しないか、バージョンが不正 

インストール / エクスポートに失敗 

インストール / アンインストール 

リモートエージェントに管理者特権がない 

インストール / アンインストールに失敗 

IIS Web サイトまたは仮想ディレクトリ設定

IIS Web サイトまたは仮想ディレクトリの設定を表します。 このリソース型に含まれるのは、Web サイトまたは仮想ディレクトリの設定だけです。 Web サイトのコンテンツは別のリソースとしてチェックインする必要があります。

ブラウズ

表 5–12 IIS 型の基本的なブラウズ操作

ルートパス 

ターゲットシステム上の Web サイトの一覧 

区切り記号 

"\” 

順序 

Web サイトと仮想ディレクトリはメタベース内と同じ順序で表示される。 この順序は IIS コントロールパネルの表示順に一致しており、アルファベット順ではない 

選択型 

Web サイトまたは仮想ディレクトリを 1 回選択。 Web サイトの選択は再帰的に行われる。 Web サイトをダブルクリックすると、その Web サイトの下の仮想ディレクトリの一覧が表示される 

サンプルパス 

Website1\VirturalDir2 

フィルタ 

なし 

インストール

インストールは、XML ファイルを読み取り、ターゲットシステムのメタベースにインポートすることで行われます。 同じ名前の Web サイトが存在する場合、既存の名前は新しい名前で上書きされます。 システム上に同じ名前の Web サイトが複数存在する場合、最初に検出されたものが削除され、上書きされます。

特殊な例として、untyped のキー、untyped のノード (詳細は下記参照)、SSL 証明書があります。これらは配備されません。 ターゲット上の IIS 内に SSL 証明書の設定 (SSLCertHash と SSLStoreName) が存在する場合、配備時に保護されます。これらが存在しない場合は、追加されません。

配備 (または再配備) 後にセキュアサイトを使用するには、IIS を再起動する必要があります。

アンインストール

ターゲットシステムから Web サイト全体を削除します。 Web サイトの下のすべての仮想ディレクトリは、プロビジョニングソフトウェアでインストールされたかどうかに関係なく削除されます。 設定を使用する仮想ディレクトリが 1 つしかない場合、このディレクトリだけが削除されます。このディレクトリの上位のサイトは削除されません。 アンインストールのマッチングは名前で行われます。したがって、システム上で最初に検出された同じ名前の Web サイトがアンインストールされます。 この処理が完了すると、インストール時に使用された XML ファイルは削除されます。

コンポーネント型: IIS グローバルフィルタ設定

グローバル ISAP フィルタ設定を表すリソース型です。 このリソース型に含まれるのは、IIS グローバルフィルタの設定だけです。 フィルタを実際に実装する DLL は別途インストールする必要があります。

ブラウズ

表 5–13 IIS グローバルフィルタ設定のブラウズ操作

ルートパス 

ターゲットシステム上のグローバルファイルのフラットな一覧 

区切り記号 

なし 

順序 

フィルタは、メタベース内と同じ順序で表示される。 この順序は「IIS Control」パネルに表示される順序に対応する。 アルファベット順ではない。 

選択型 

フィルタを 1 回選択。 フィルタは展開できない 

サンプルパス 

Filter1 

フィルタ 

なし 

インストール

インストールは、XML ファイルを読み取り、ターゲットシステムのメタベースにインポートすることで行われます。 ターゲットマシン上に同じ名前のフィルタ設定が存在する場合、既存の名前は新しい名前で上書きされます。

アンインストール

ターゲットシステムからフィルタ設定が削除されたあと、インストール時に使用された XML ファイルが削除されます。

コンポーネント型: IIS Web サイトフィルタ設定

このリソース型に含まれるのは、Web サイトフィルタの設定だけです。 フィルタを実際に実装する DLL は別途インストールする必要があります。

ブラウズ

表 5–14 IIS Web サイトフィルタ設定のブラウズ操作

ルートパス 

システム上の Web サイトの一覧 

区切り記号 

順序 

フィルタは、メタベース内と同じ順序で表示される。 この順序は「IIS Control」パネルに表示される順序に対応する。 アルファベット順ではない。 

選択型 

Web サイトのフィルタの一覧を表示するには、まず Web サイトを展開する必要がある。 チェックインの対象としては、すべての Web サイトフィルタまたは個々のフィルタを選択可能 

サンプルパス 

Website1\filter1 

フィルタ 

なし 

インストール

インストールは、XML ファイルを読み取り、ターゲットシステムのメタベースにインポートすることで行われます。 ターゲットマシン上に同じ名前のフィルタ設定が存在する場合、既存の名前は新しい名前で上書きされます。

アンインストール

ターゲットシステムのメタベースからフィルタ設定が削除されたあと、インストール時に使用された XML ファイルが削除されます。

コンポーネント型: IIS グローバル設定

グローバル IIS 設定を表すリソース型です。

ブラウズ (Browsing)

表 5–15 IIS グローバル設定のブラウズ操作

ルートパス 

ターゲットシステム上のグローバル設定の一覧 

区切り記号 

なし 

順序 

設定は、メタベース内と同じ順序で表示される 

選択型 

チェックインする設定を個別に 1 回だけ選択。 子設定は存在しないので、設定の展開はできない 

サンプルパス 

AspCacheSize 

フィルタ 

なし 

インストール

インストールは、XML ファイルを読み取り、ターゲットシステムのメタベースにインポートすることで行われます。 ターゲットシステム上の設定は上書きされます。

アンインストール

グローバル設定はアンインストールできません。 アンインストールを実行しても、インストール時に使用された *.XML ファイルが削除されるだけで、ターゲットシステムに何ら影響はありません。

コンポーネント型: COM+ アプリケーション

COM+ アプリケーションを表すリソース型です。 COM+ アプリケーションはモノリシックな単位として扱われます。 設定およびコンテンツはグループとしてインストールされます。

ブラウズ (Browsing)

表 5–16 COM+ アプリケーションのブラウズ操作

ルートパス 

システム上の COM+ アプリケーションの一覧 

区切り記号 

なし 

順序 

アルファベット順 

選択型 

チェックインする COM+ アプリケーションを 1 回選択。 COM+ アプリケーションは子アプリケーションを持たないので展開はできない 

サンプルパス 

FM Stocks 

フィルタ 

なし 

エクスポートされたファイル形式と内部ファイル形式

COM+ アプリケーションは、COM+ Admin SDK を使用して Windows Installer File (*.MSI) にエクスポートされます。

M-I 差分

COM+ アプリケーションは MSI ファイルとしてターゲットシステムに再エクスポートされ、アプリケーションのインストール時に使用した MSI ファイルと比較されます。 M-I 差分は、差異が存在すること、つまり 2 つのバイナリファイルの内容が異なっていることを示すだけです。差異の内容が具体的に示されるわけではありません。

インストール

アンインストール

COM+ アプリケーションをアンインストールするには、このアプリケーションのインストール時に使用した MSI を使用します。具体的には、次のコマンドを実行します。


msiexec /qn /x <path to msi file>

コマンドの実行が完了すると、ターゲットシステムから msi ファイルが削除されます。

エラー条件

表 5–17 COM+ アプリケーションのエラー条件

操作 

条件 

結果 

インストール (Install) 

同じ名前の COM+ アプリケーションが存在しており、サービスまたは依存サービスを停止できない 

インストールに失敗 

アンインストール (Uninstall) 

インストールに使用した MSI ファイルを使用できない 

アンインストールに失敗 

インストール / アンインストール 

リモートエージェントに管理者特権がない 

インストール / アンインストールに失敗 

拡張制御手続き

表 5–18 COM+ アプリケーション拡張制御手続き

名前 

パラメータ 

説明 

startApp 

appName: COM+ アプリケーションの完全名 

サービスとして実行される COM+ アプリケーションを起動 

stopApp 

appName: 停止する COM+ アプリケーションの完全名 

COM+ アプリケーションとすべての依存サービスを停止 

stopRouter 

なし 

COM+ ルーティングサービスを停止 

startRouter 

なし 

COM+ ルーティングサービスを開始 

installAsUser 

rsrcSrcPath: COM+ アプリケーションの名前 

rsrcInstallPath: アプリケーションを表す msi ファイルのパス 

userID: アプリケーションを実行するユーザー 

password: そのユーザーのパスワード 

特定のユーザーとして実行される COM+ アプリケーションのインストールを許可 

コンポーネント型: COM コンポーネント

COM コンポーネントを表すリソース型です。

ブラウズ (Browsing)

表 5–19 COM コンポーネントのブラウズ操作

ルートパス 

標準のファイルブラウザを使用 

区切り記号 

順序 

選択型 

サンプルパス 

フィルタ 

*.ocx. *.dll 

エクスポートされたファイル形式と内部ファイル形式

COM コンポーネントはネイティブ形式のファイルとして格納されます。

M-I 差分

COM コンポーネントは、バイナリファイルとして、インストール時に使用したファイルと比較されます。 M-I 差分は、差異が存在すること、つまり 2 つのバイナリファイルの内容が異なっていることを示すだけです。差異の内容が具体的に示されるわけではありません。

インストール

dll に COM コンポーネントを登録するには、次のコマンド行呼び出しで Regsvr32 を呼び出します。


regsvr32.exe /s <file path>   

アンインストール (Uninstall)

dll に COM コンポーネントを登録解除するには、次のコマンド行呼び出しで Regsvr32 を呼び出します。


regsvr32.exe /s /u <file path>   

登録解除後、dll はターゲットシステムから削除されます。

エラー条件

表 5–20 COM コンポーネントのエラー条件

操作 

条件 

結果 

インストール (Install) 

.dll または .ocx に COM コンポーネントが含まれていない 

インストールに失敗 

アンインストール (Uninstall) 

.dll または .ocx に COM コンポーネントが含まれていない 

アンインストールに失敗 

コンポーネント型: レジストリキー

このリソース型は、レジストリキーとその値を表します。

ブラウズ (Browsing)

表 5–21 レジストリキーのブラウズ操作

ルートパス 

5 つのメインレジストリルートの一覧: 

HKEY_LOCAL_MACHINE 

HKEY_CLASSES_ROOT 

HKEY_CURRENT_USER HKEY_USERS 

HKEY_CURRENT_CONFIG 

区切り記号 

順序 

設定はレジストリナイト同じ順序で表示される 

選択型 

チェックインする個々のキーを 1 回だけ選択。 選択したキーとその子全部がチェックインされる キーをダブルクリックすると、値が見つかるまでレジストリの下位が再帰的にチェックされる。 値の名前は表示されるが値の内容は表示されない。 値は個別にエクスポート可能 

サンプルパス 

HKEY_LOCAL_MACHINE\Software\Example\Key 

フィルタ 

なし 

エクスポートされたファイル形式と内部ファイル形式

レジストリキーは XML ファイルにエクスポートされます。

M-I 差分

スナップショットを作成すると、レジストリキー (とその子) の現在の状態が XML ファイルにエクスポートされます。 M-I 差分を実行すると、レジストリキーの状態が再エクスポートされ、元の XML ファイルと比較されます。 標準 XML diff comparator はこれらのファイル間の差分を生成するのに使用されます。

インストール

レジストリを表す XML ファイルは、execJava によって読み取られ、ターゲットシステムにインポートされます。 ターゲットシステム上の既存のキーと値はすべて上書きされます。

アンインストール

execJava 実装は、エクスポートされたキーのルートの下にあるすべてのキーと値を削除します。 ルートが値の場合、この値が削除されます。

エラー条件

表 5–22 レジストリキーのエラー条件

操作 

条件 

結果 

インストール / アンインストール 

リモートエージェントに管理者特権がない 

インストール / アンインストールに失敗 

コンポーネント型: レジストリファイル

レジストリファイルは Regedit によって生成され、メタベースへのエクスポートを表します。 *.reg ファイルはテキスト形式で、レジストリに追加またはレジストリから削除するキーおよび値を指定します。

ブラウズ (Browsing)

表 5–23 レジストリファイルのブラウズ操作

ルートパス 

 

 

標準のファイルブラウザを使用 

区切り記号 

順序 

選択型 

サンプルパス 

フィルタ 

*.reg 

エクスポートされたファイル形式と内部ファイル形式

COM コンポーネントは、ファイルとして格納されます。ファイルの形式は、ネイティブのテキストファイル形式になります。

M-I 差分

*.reg ファイルの M-I 差分機能はサポートされていません。 インストール時にスナップショットは作成されません。したがって、M-I 差分の実行時に差分は生成されません。 レジストリの変更の差分を取りたい場合は、組み込みのレジストリキー型を使用することをお勧めします。

インストール

*.reg ファイルの変更内容をレジストリに書き込むには、Regedit /s <file path> を呼び出します。

アンインストール

アンインストールを実行しても、削除されるのはインストール時に使用した *.reg ファイルだけです。 reg ファイル内のレジストリキーに影響はありません。 レジストリのアンインストールを行いたい場合は、組み込みのレジストリキー型を使用することをお勧めします。

エラー条件

表 5–24 レジストリファイルのエラー条件

操作 

条件 

結果 

インストール (Install) 

*.reg ファイルの regedit の形式が不正 

インストールに失敗 

インストール (Install) 

エージェントが、*.reg ファイルで指定されたレジストリセクションに対する書き込み権を持っていない 

インストールに失敗 

コンポーネント型: データソース名

DSN エントリは、データベース接続を確立するための ODBC 設定を表します。 この設定は、「Data Source Administrator」コントロールパネルから編集可能です。 実際の設定は、レジストリ内の特定の場所に格納されます。 したがって、「データソース名」リソース型は「レジストリキー」リソース型の上に構築されます。 DSN のインストール、エクスポート、アンインストールは、レジストリキーリソースハンドらの機能を直接利用して行われます。 「Data Source Administrator」コントロールパネルにより近い使用感を実現するため、DSN ブラウザにはレジストリブラウザがラップされています。

ブラウズ (Browsing)

表 5–25 データソース名のブラウズ操作

ルートパス 

2 つの DSN ルートの一覧: 

ユーザー 

システム 

区切り記号 

順序 

アルファベット順 

選択型 

「システム」と「ユーザー」のルートをダブルクリックすると、その下の DSN エントリが一覧表示される。 ここから、チェックインするエントリを 1 つ選択する 

サンプルパス 

User/Oracle8 

フィルタ 

なし 

エクスポートされたファイル形式と内部ファイル形式

エクスポートの際、ブラウザは、すべての DSN 設定を含むキーと、レジストリ階層内の同じレベルにある「ODBC Data Sources」キー内の同じ名前の値をエクスポートします。

アンインストール

DSN のアンインストールは、レジストリのアンインストールに基づいて行われます。事前に、削除対象のパスが、使用可能な DSN 設定を表示するために DSN GUI が使用するキーではなく、DSN 設定を含むキーであるという警告が表示されます。 このキーを削除する特別なロジックがあります。 このロジックのセマンティクスは、レジストリのアンインストールのセマンティクスとは若干異なりますが、実行ツールは同じです。

エラー条件

DSN システムコンポーネントは、レジストリシステムコンポーネントのインストールメソッドを直接呼び出します。 実装とエラー内容の詳細については、本書のレジストリキーの説明を参照してください。

コンポーネント型: Windows Installer ファイル (*.msi)

サイレント MSI ファイルを表すリソース型です。

ブラウズ (Browsing)

表 5–26 Windows Installer ファイルのブラウズ操作

ルートパス 

 

 

標準のファイルブラウザを使用 

区切り記号 

順序 

選択型 

サンプルパス 

フィルタ 

*.msi 

エクスポートされたファイル形式と内部ファイル形式

MSI ファイルはネイティブ形式のファイルとして格納されます。

M-I 差分

Windows Installer ファイルの M-I 差分機能はサポートされていません。 インストール時にスナップショットは作成されません。したがって、M-I 差分の実行時に差分は生成されません。 ROX はインストーラ実行時のアクションを直接認識しません。したがって、何をキャプチャする必要があるのか特定することはできません。

インストール

Windows Installer サービスをターゲットシステムにインポートするには、msi ファイルを指定して次のコマンドを実行します。


misexec /qn /i <file path>  

アンインストール

パッケージをアンインストールするには、インストール時に使用した msi ファイルを指定して、Windows Installer サービスのアンインストールを呼び出します。次のコマンドを使用します。


msiexec /qn /x <file path>  

msiexec の呼び出しが完了すると、msi ファイルは削除されます。

エラー条件

表 5–27 Windows Installer ファイルのエラー条件

操作 

条件 

結果 

インストール (Install) 

*.msi が Windows Installer ファイルとして不正 

インストールに失敗 

インストール (Install) 

エージェントがインストールの実行に必要なアクセス権を持っていない 

インストールに失敗 

アンインストール (Uninstall) 

パッケージがすでにアンインストールされている 

アンインストールに失敗 

コンポーネント型: Windows バッチファイル

*.bat ファイルと *.cmd ファイルを表すリソース型です。

ブラウズ (Browsing)

表 5–28 Windows バッチファイルのブラウズ操作

ルートパス 

 

 

標準のファイルブラウザを使用 

区切り記号 

順序 

選択型 

サンプルパス 

フィルタ 

*.cmd、*.bat 

エクスポートされたファイル形式と内部ファイル形式

Windows バッチファイルは、ファイルとして格納されます。ファイルの形式は、ネイティブのテキストファイル形式になります。

M-I 差分

Windows バッチファイルの M-I 差分機能はサポートされていません。 インストール時にスナップショットは作成されません。したがって、M-I 差分の実行時に差分は生成されません。

インストール

インストール時にバッチファイルが実行されます。

アンインストール

アンインストール時にターゲットシステムから *.bat ファイルが削除されます。

エラー条件

表 5–29 Windows バッチファイルのエラー条件

操作 

条件 

結果 

インストール (Install) 

バッチファイルが有効でないか、エラーが含まれている 

インストールに失敗 

コンポーネント型: Windows スクリプティングホストスクリプト

Windows スクリプティングホスト (WSH) スクリプトはテキストファイルです。vbscript (*.vbs) または jscript (*.js) の形式になっているか、XML プロジェクトファイル内に格納されています (*.wsf)。

ブラウズ (Browsing)

表 5–30 Windows スクリプティングホストスクリプトのブラウズ操作

ルートパス 

 

 

標準のファイルブラウザを使用 

区切り記号 

順序 

選択型 

サンプルパス 

フィルタ 

*.js、*.vbs、*.wsf 

エクスポートされたファイル形式と内部ファイル形式

ファイルとして格納されます。ファイル形式はネイティブのテキスト形式です。

M-I 差分

WSH ファイルの M-I 差分機能はサポートされていません。 インストール時にスナップショットは作成されません。したがって、M-I 差分の実行時に差分は生成されません。

インストール

WSH スクリプトは、次のように cscript.exe によって実行されます。


cscript <file path>  

アンインストール

アンインストール時にターゲットホストからスクリプトファイルが削除されます。

エラー条件

表 5–31 Windows スクリプティングホストスクリプトのエラー条件

操作 

条件 

結果 

インストール (Install) 

ファイルが有効な wsf ファイルでないか、エラーが含まれている 

インストールに失敗 

コンポーネント型: IIS Web サイト (IIS 仮想ディレクトリ)

ブラウズ (Browsing)

IIS Web サイト設定ブラウザを使用します。

エクスポートされたファイル形式と内部ファイル形式

複合コンポーネント: IIS Web サイト / VDir 設定、IIS 仮想ディレクトリセット、IIS Web サイトフィルタセット、ディレクトリ

作成時に含まれるエンティティ (上記) が作成され、それぞれ適切にリンクされます。

コンポーネント型: IIS Web サイトフィルタ

ブラウズ (Browsing)

IIS Web サイトフィルタ設定ブラウザを使用します。

エクスポートされたファイル形式と内部ファイル形式

複合コンポーネント: IIS Web サイトフィルタ設定、COM オブジェクト

作成時に含まれるエンティティ (上記) が作成され、それぞれ適切にリンクされます。

コンポーネント型: シンボリックリンク

ブラウズ (Browsing)

標準ファイルブラウザ (エクスポート規則に制限あり) を使用します。

エクスポートされたファイル形式と内部ファイル形式

シンボリックリンクは、リソースを含まないという点で、単純コンポーネント型の中でも特異な存在です。 シンボリックリンクのデータは、変数セット (名前と場所に対して 1 つずつ) としてコンポーネント内に格納されます。

コンポーネント型: WebLogic WAR ファイル

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic Web アプリケーションブラウザを使用する必要があります。

エクスポートされたファイル形式と内部ファイル形式

このコンポーネントには 2 つの性質があります。 .war アーカイブか、そのアーカイブの展開バージョンです。 したがって、ファイル形式は、.war アーカイブの場合はネイティブのアーカイブファイル形式、アーカイブの分解バージョンの場合はパッケージになります。

M-I 差分

標準ファイル / ディレクトリ MI 差分生成方式を使用します。

インストール

直接インストールすることはできません。 WebLogic Web アプリケーションコンテナの一部としてインストールする必要があります。 ファイルやディレクトリは、インストールパスに基づいてファイルシステムにコピーされ、その後 WL 管理サーバーに登録されます。

アンインストール

直接アンインストールすることはできません。 このファイルまたはディレクトリを削除するには、これらを含む WebLogic Web アプリケーションコンテナをアンインストールする必要があります。

エラー条件

「エラー条件」を参照してください。

コンポーネント型: WebLogic Web アプリケーション設定

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic Web アプリケーションブラウザを使用する必要があります。

エクスポートされたファイル形式と内部ファイル形式

エクスポート時に管理サーバーからこの Web アプリケーションの設定が読み取られ、カスタム設定ファイルとして格納されます。

M-I 差分

アプリケーションの設定がファイルにインストールされ、配備時に設定を追加したファイルと比較されます。

インストール

直接インストールすることはできません。 WebLogic Web アプリケーションコンテナの一部としてインストールする必要があります。 インストールを実行すると、事前設定済みファイルが読み取られ、すべての設定が管理サーバーに適用されます。

アンインストール

直接アンインストールすることはできません。 このファイルと WebLogic 内の Web アプリケーションの関連設定を削除するには、これらを含む WebLogic Web アプリケーションコンテナをアンインストールする必要があります。 Web アプリケーションに固有の設定以外は削除されません。

エラー条件

表 5–34 を参照してください。

コンポーネント型: WebLogic Web アプリケーション

ブラウズ (Browsing)

2 つのブラウザがサポートされます。 1 つは管理サーバーブラウザです。このブラウザでは、インストールされているアプリケーションとその設定を選択できます。もう 1 つはファイルシステムブラウザです。このブラウザでは、設定を作成せずに WAR ファイルとコンポーネントを選択できます。

管理サーバーブラウザ:

表 5–32 WebLogic Web アプリケーションのブラウズ操作 (管理サーバー)

ルートパス 

管理サーバー上の Web アプリケーションの一覧 

区切り記号 

なし 

順序 

アルファベット順 

選択型 

単一の独立した Web アプリケーション。 

一覧に表示されるのはスタンドアロンの Web アプリケーションのみ。 EAR ファイルの一部になっている Web アプリケーションは表示されない。したがって、一覧から選択することはできない 

サンプルパス 

JChart 

フィルタ 

なし 

ファイルシステムブラウザ:

表 5–33 WebLogic Web アプリケーションのブラウズ操作 (ファイルシステム)

ルートパス 

標準ファイルブラウザを使用 (ディレクトリは有効な選択肢) 

区切り記号 

順序 

選択型 

サンプルパス 

フィルタ 

*.war 

エクスポートされたファイル形式と内部ファイル形式

複合コンポーネント: WebLogic Web アプリケーションコンテナ

インストール

ターゲットにコンポーネントをインストールしたり、含まれる reg コンポーネントをターゲットの管理サーバーにインストールしたりする WL ターゲット (サーバー / クラスタ) をターゲットにする必要があります。

アンインストール

ターゲットから Web アプリケーションを除外し、現在それ以外のターゲットが存在しない場合は、管理サーバーから 登録コンポーネントを削除します。

エラー条件

表 5–34 WebLogic Web アプリケーションのエラー条件

操作 

条件 

結果 

インストール (Install) 

トポロジの設定が正しくない (ターゲットホストが正しいドメインホストをポイントしていない) 

ターゲットに失敗 

インストール (Install) 

ターゲットホストが有効な WL ターゲットでない 

インストールの禁止 

ブラウズ (Browsing) / インストール (Install) / アンインストール (Uninstall) 

資格情報の設定が不正 

操作に失敗 

ブラウズ (Browsing) 

ドメインホスト内のパスの設定が正しくない 

ブラウズに失敗 

コンポーネント型: WebLogic JAR ファイル

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic EJB ブラウザを使ってブラウズします。

エクスポートされたファイル形式と内部ファイル形式

このコンポーネントには 2 つの性質があります。 .jar アーカイブか、そのアーカイブの展開バージョンです。 したがって、ファイル形式は、ネイティブ形式のアーカイブファイルかパッケージになります。

M-I 差分

標準ファイル / ディレクトリ MI 差分生成方式を使用します。

インストール

直接インストールすることはできません。 WebLogic EJB コンテナの一部としてインストールする必要があります。 ファイルやディレクトリは、インストールパスに基づいてファイルシステムにコピーされ、その後 WL 管理サーバーに登録されます。

アンインストール

直接アンインストールすることはできません。 このファイルまたはディレクトリを削除するには、これらを含む WebLogic EJB コンテナをアンインストールする必要があります。

エラー条件

「コンポーネント型: WebLogic EJB」を参照してください。.

コンポーネント型: WebLogic EJB 設定

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic EJB ブラウザを使ってブラウズします。

エクスポートされたファイル形式と内部ファイル形式

エクスポート時に管理サーバーからこの EJB の設定が読み取られ、カスタム設定ファイルとして格納されます。

M-I 差分

EJB の設定がファイルにインストールされ、配備時に設定を追加したファイルと比較されます。

インストール

直接インストールすることはできません。 WebLogic Web アプリケーションコンテナの一部としてインストールする必要があります。インストールを実行すると、事前設定済みファイルが読み取られ、すべての設定が管理サーバーに適用されます。

アンインストール

直接アンインストールすることはできません。 このファイルと WebLogic 内の Web アプリケーションの関連設定を削除するには、これらを含む WebLogic Web アプリケーションコンテナをアンインストールする必要があります。 Web アプリケーションに固有の設定以外は削除されません。

エラー条件

「コンポーネント型: WebLogic EJB」を参照してください。

コンポーネント型: WebLogic EJB コンテナ

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic EJB ブラウザを使ってブラウズします。

エクスポートされたファイル形式と内部ファイル形式

複合コンポーネント: WebLogic JAR ファイル、WebLogic EJB コンテナ

インストール

WL ドメインホストをターゲットにする必要があります。 入れ子のコンポーネントをインストールし、EJB を WebLogic に登録します。 WebLogic EJB のインストール時に再ターゲットの一部としてインストールできます。

アンインストール

WebLogic から EJB を削除し、入れ子のコンポーネントをアンインストールします。

エラー条件

表 5–35 WebLogic EJB コンテナのエラー条件

操作 

条件 

結果 

アンインストール (Uninstall) 

依存 WebLogic EJB がまだインストールされている 

アンインストールに失敗 (依存関係を示すエラーメッセージが表示される) 

コンポーネント型: WebLogic EJB

ブラウズ (Browsing)

2 つのブラウザがサポートされます。 1 つは管理サーバーブラウザです。このブラウザでは、インストールされているアプリケーションとその設定を選択できます。もう 1 つはファイルシステムブラウザです。このブラウザでは、設定を作成せずに JAR ファイルとコンポーネントを選択できます。

管理サーバーブラウザ:

表 5–36 WebLogic EJB のブラウズ操作 (管理サーバー)

ルートパス 

管理サーバー上の EJB の一覧 

区切り記号 

なし 

順序 

アルファベット順 

選択型 

単一の独立した Web アプリケーション。 

一覧に表示されるのはスタンドアロンの EJB のみ。 EAR ファイルの一部になっている EJB は表示されない。したがって、一覧から選択することはできない 

サンプルパス 

companyStoreEJBs 

フィルタ 

なし 

ファイルシステムブラウザ:

表 5–37 WebLogic EJB のブラウズ操作 (ファイルシステム)

ルートパス 

 

 

標準ファイルブラウザを使用 (ディレクトリは有効な選択肢) 

区切り記号 

順序 

選択型 

サンプルパス 

フィルタ 

*.jar 

複合コンポーネント: WebLogic EJB コンテナ

インストール

ターゲットにコンポーネントをインストールしたり、含まれる reg コンポーネントをターゲットの管理サーバーにインストールしたりする WL ターゲット (サーバー / クラスタ) をターゲットにする必要があります。

アンインストール

ターゲットから EJB を除外し、現在それ以外のターゲットが存在しない場合は、管理サーバーから 登録コンポーネントを削除します。

エラー条件

表 5–38 WebLogic EJB コンテナのエラー条件

操作 

条件 

結果 

インストール (Install) 

トポロジの設定が正しくない (ターゲットホストが正しいドメインホストをポイントしていない) 

ターゲットに失敗 

インストール (Install) 

ターゲットホストが有効な WL ターゲットでない 

インストールの禁止 

ブラウズ (Browsing) / インストール (Install) / アンインストール (Uninstall) 

資格情報の設定が不正 

操作に失敗 

ブラウズ (Browsing) 

ドメインホスト内のパスの設定が正しくない 

ブラウズに失敗 

コンポーネント型: WebLogic EAR ファイル

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic エンタープライズアプリケーションブラウザを使用する必要があります。

エクスポートされたファイル形式と内部ファイル形式

このコンポーネントには 2 つの性質があります。 .EAR アーカイブか、そのアーカイブの展開バージョンです。 したがって、ファイル形式は、ネイティブ形式のアーカイブファイルかパッケージになります。

M-I 差分

標準ファイル / ディレクトリ MI 差分生成方式を使用します。

インストール

直接インストールすることはできません。 WebLogic エンタープライズアプリケーションコンテナの一部としてインストールする必要があります。 ファイルやディレクトリは、インストールパスに基づいてファイルシステムにコピーされ、その後 WL 管理サーバーに登録されます。

アンインストール

直接アンインストールすることはできません。 このファイルまたはディレクトリを削除するには、これらを含む WebLogic EJB コンテナをアンインストールする必要があります。

エラー条件

表 5–34 を参照してください。

コンポーネント型: WebLogic エンタープライズアプリケーション設定

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic エンタープライズアプリケーションブラウザを使用する必要があります。

エクスポートされたファイル形式と内部ファイル形式

エクスポート時に管理サーバーからこのアプリケーションの設定が読み取られ、カスタム設定ファイルとして格納されます。

M-I 差分

アプリケーションの設定がファイルにインストールされ、配備時に設定を追加したファイルと比較されます。

インストール

直接インストールすることはできません。 WebLogic エンタープライズアプリケーションコンテナの一部としてインストールする必要があります。 インストールを実行すると、事前設定済みファイルが読み取られ、すべての設定が管理サーバーに適用されます。

アンインストール

直接アンインストールすることはできません。 このファイルと WebLogic 内の Web アプリケーションの関連設定を削除するには、これらを含む WebLogic エンタープライズアプリケーションコンテナをアンインストールする必要があります。 Web アプリケーションに固有の設定以外は削除されません。

エラー条件

表 5–34 を参照してください。

コンポーネント型: WebLogic エンタープライズアプリケーションコンテナ

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic エンタープライズアプリケーションブラウザを使用する必要があります。

エクスポートされたファイル形式と内部ファイル形式

WebLogic EAR ファイル、WebLogic エンタープライズアプリケーションコンテナ、WebLogic リスト

インストール

WL ドメインホストをターゲットにする必要があります。 入れ子のコンポーネントをインストールし、エンタープライズアプリケーションを WebLogic に登録します。 WebLogic エンタープライズアプリケーションまたは含まれる WebLogic モジュールのインストール時に再ターゲットの一部としてインストールできます。

アンインストール

WebLogic からエンタープライズアプリケーションを削除し、入れ子のコンポーネントをアンインストールします。

エラー条件

表 5–39 WebLogic エンタープライズアプリケーションコンテナのエラー条件

操作 

条件 

結果 

アンインストール (Uninstall) 

依存 WebLogic エンタープライズアプリケーションまたは含まれる WebLogic モジュールがまだインストールされている 

アンインストールに失敗 (依存関係を示すエラーメッセージが表示される) 

コンポーネント型: WebLogic Enterprise アプリケーション

ブラウズ (Browsing)

2 つのブラウザがサポートされます。 1 つは管理サーバーブラウザです。このブラウザでは、インストールされているアプリケーションとその設定を選択できます。もう 1 つはファイルシステムブラウザです。このブラウザでは、設定を作成せずに EAR ファイルとコンポーネントを選択できます。

管理サーバーブラウザ:

表 5–40 WebLogic エンタープライズアプリケーションのブラウズ操作 (管理サーバー)

ルートパス 

管理サーバー上のエンタープライズアプリケーションの一覧 

区切り記号 

なし 

順序 

アルファベット順 

選択型 

単一の独立したエンタープライズアプリケーション 

サンプルパス 

companyStoreAdmin 

フィルタ 

なし 

ファイルシステムブラウザ:

表 5–41 WebLogic エンタープライズアプリケーションのブラウズ操作 (ファイルシステム)

ルートパス 

 

 

標準ファイルブラウザを使用 (ディレクトリは有効な選択肢) 

区切り記号 

順序 

選択型 

サンプルパス 

フィルタ 

*.ear 

エクスポートされたファイル形式と内部ファイル形式

複合コンポーネント: WebLogic エンタープライズアプリケーションコンテナ

インストール

ターゲットにコンポーネントをインストールしたり、含まれる reg コンポーネントをターゲットの管理サーバーにインストールしたりする WL ターゲット (サーバー / クラスタ) をターゲットにする必要があります。

アンインストール

ターゲットからエンタープライズアプリケーションを除外し、現在それ以外のターゲットが存在しない場合は、管理サーバーから 登録コンポーネントを削除します。

エラー条件

表 5–42 WebLogic エンタープライズアプリケーションのエラー条件

操作 

条件 

結果 

インストール (Install) 

トポロジの設定が正しくない (ターゲットホストが正しいドメインホストをポイントしていない) 

ターゲットに失敗 

インストール (Install) 

ターゲットホストが有効な WL ターゲットでない 

インストールの禁止 

ブラウズ (Browsing) / インストール (Install) / アンインストール (Uninstall) 

資格情報の設定が不正 

操作に失敗 

ブラウズ (Browsing) 

ドメインホスト内のパスの設定が正しくない 

ブラウズに失敗 

コンポーネント型: WebLogic リスト

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic エンタープライズアプリケーションブラウザを使用する必要があります。

エクスポートされたファイル形式と内部ファイル形式

いくつかのカスタムインストール / アンインストール / スナップショットブロックを持つコンテナコンポーネントです。 それ以外の点は、一般的なコンテナコンポーネントと同じです。

インストール

直接インストールすることはできません。

アンインストール

直接アンインストールすることはできません。

エラー条件

含まれる WebLogic モジュール型を参照してください。

コンポーネント型: 含まれる WebLogic Web アプリケーションコンテナ

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic エンタープライズアプリケーションブラウザを使用する必要があります。

エクスポートされたファイル形式と内部ファイル形式

複合コンポーネント:

final の WebLogic WAR ファイルスタブコンポーネントと、デフォルトで WeLogic Web アプリケーション設定コンポーネント (非 final のスタブコンポーネント) を含みます。

このコンポーネントを含む WebLogic リストは、WebLogic エンタープライズアプリケーションに含まれています。この WebLogic エンタープライズアプリケーションには、WebLogic エンタープライズアプリケーションコンテナコンポーネントへの final の compRef も含まれます。

インストール

WLドメインホストにインストールできます。 その結果、WebLogic エンタープライズアプリケーションコンテナもインストールされます。

アンインストール

WebLogic エンタープライズアプリケーションコンテナをアンインストールします。

エラー条件

表 5–43 含まれる WebLogic Web アプリケーションコンテナのエラー条件

操作 

条件 

結果 

アンインストール (Uninstall) 

含まれる依存 WebLogic Web アプリケーションがインストールされている 

アンインストールに失敗 (依存関係を示すエラーメッセージが表示される) 

コンポーネント型: 含まれる WebLogic Web アプリケーション

final の含まれる WebLogic Web アプリケーションコンテナを含む点以外は WebLogic Web アプリケーションと同じです。

コンポーネント型: 含まれる WebLogic EJB コンテナ

ブラウズ (Browsing)

直接ブラウズすることはできません。 WebLogic エンタープライズアプリケーションブラウザを使用する必要があります。

エクスポートされたファイル形式と内部ファイル形式

複合コンポーネント:

final の WebLogic JAR ファイルスタブコンポーネントと、デフォルトで WeLogic Web アプリケーション設定コンポーネント (非 final のスタブコンポーネント) を含みます。

このコンポーネントを含む WebLogic リストは、WebLogic エンタープライズアプリケーションに含まれています。この WebLogic エンタープライズアプリケーションには、WebLogic エンタープライズアプリケーションコンテナコンポーネントへの final の compRef も含まれます。

インストール

WLドメインホストにインストールできます。 その結果、WebLogic エンタープライズアプリケーションコンテナもインストールされます。

アンインストール

WebLogic エンタープライズアプリケーションコンテナをアンインストールします。

エラー条件

表 5–44 含まれる WebLogic EJB コンテナのエラー条件

操作 

条件 

結果 

アンインストール (Uninstall) 

含まれる依存 WebLogic Web アプリケーション 

アンインストールに失敗 (依存関係を示すエラーメッセージが表示される) 

コンポーネント型: 含まれる WebLogic EJB

final の含まれる WebLogic Web アプリケーションコンテナを含む点以外は WebLogic EJB と同じです。

システムコンポーネント

上記のコンポーネント型以外に、システムコンポーネントがあります。システムコンポーネントも、高度なプランやコンポーネントオーサリング向けの機能を提供します。 追加機能を持つコンポーネントは次のとおりです。

Windows システムサービス

Windows システムコンポーネントは、上記のような特定のコンポーネント型のユーティリティ以外に、異なった Windows システムと対話するためのユーティリティを提供します。

制御手続き

表 5–45 含まれる WebLogic EJB 制御手続き (Windows)

名前 

パラメータ 

説明 

stopIIS 

なし 

IIS プロセスを停止 

startIIS 

なし 

IIS が実行されていない場合は再起動 

stopService 

serviceName: 停止するサービスの名前 

サービスを停止 

startService 

serviceName: 開始するサービスの名前 

Windows サービスを開始 

WebLogic ターゲット

WebLogic ターゲットコンポーネントは、WebLogic 管理のサーバーならびにクラスタと対話するためのユーティリティを提供します。

手続き

表 5–46 含まれる WebLogic EJB 制御手続き (WebLogic)

名前 

パラメータ 

説明 

Start 

なし 

ターゲットを起動 

停止 

なし 

ターゲットを停止 

Restart 

ブール再起動 

再起動フラグの値に従ってターゲットを再起動 

コンポーネント型ユーザーインタフェース

コンポーネント型ユーザーインタフェースでは、コンポーネント型を管理できます。 たとえば、コンポーネント型のチェックイン、すべてのコンポーネント型の一覧表示、コンポーネント型のバージョンの表示などが可能です。 コンポーネントがどのホストにインストールされているか、またどのプランがコンポーネントをインストールしたかなど、コンポーネン型のインストール情報もユーザーは表示できます。

一部のコンポーネント型は、HTML ユーザーインタフェースでもブラウズできます。 この機能を利用して、リモートチェックインするコンポーネントを選択できます。

「Component Type」ページ

「Component Type」ページでは、コンポーネント型の一覧表示、コンポーネント型の詳細情報の表示、コンポーネント型の作成などを行うことができます。 このページのコントロールを使って、コンポーネント型の一覧にフィルタを適用したり、並べ替えの基準を選択することもできます。 コンポーネント型の並べ替え基準を変更するには、見出し領域の矢印ボタンをクリックします。 昇順または降順の矢印をクリックすると、その列の並び順が変更されます。

「Component Types」

コンポーネントオブジェクトを指定するユーザー定義可能なテキスト文字列。 デフォルトでは、コンポーネントはアルファベット順に一覧表示されます。 列の見出し領域の矢印ボタンをクリックすることにより、コンポーネント型を名前の順に並べ替えることができます。 昇順または降順の矢印をクリックすると、この列の並び順が変更されます。

「Menu Group」

「Componennt Type」メニューは、複数のセクションまたはグループに分かれています。 このフィールドから、コンポーネント型がプルダウンメニューのどのセクションまたはグループに含まれているかがわかります。 注: 非表示のメニューグループ以外では、このフィールドはもっぱら並べ替え基準として使用されます。メニューリストには影響を及ぼしません。 非表示のメニューグループにコンポーネント型を割り当てると、メニューの表示順が上書きされ、コンポーネント型がメニューに表示されなくなります。

「Menu Order」

このフィールドは、コンポーネント型名をコンポーネント型メニューのどの位置に表示するかを制御します。 プロビジョニングソフトウェアは、このフィールドの内容に従って、メニューリストをアルファベット順に並べ替えます。 このフィールドでは、数字と文字の両方を使用できます。 ただし、プロビジョニングソフトウェアは慣習上数字だけを使用します。 データを編成しやすくするため、プロビジョニングソフトウェアには次の番号規則が採用されています。

コンポーネント型を「すべての WebLogic」メニューグループに割り当てた場合、メニュー内のコンポーネント型の表示位置に影響はありません。 ただし、プロビジョニングソフトウェアで設定された任意の規則に従うと、「すべての WebLogic」メニューグループに所属するコンポーネント型を割り当てた場合、000100-xxxxxx-xxxxxx がメニュー内の正しい位置に挿入されます。

「Indent Level」

メニュー項目の右側の 2 つ分の空白を何単位インデントするかを定義します。

「Description」

コンポーネントオブジェクトについて説明するユーザー定義可能な任意のテキスト文字列。 この属性は プロビジョニングソフトウェア によっては使用されませんが、ユーザーに有意義な情報を提供できます。

「Defining Component」

このコンポーネント型を定義するコンポーネントを表示します。

「Version」

コンポーネントのリビジョン番号を表示します。 コンポーネントの変更のたびに、バージョン番号が大きくなります。

列の見出し領域の矢印ボタンをクリックすることにより、コンポーネント型をバージョン番号の順に並べ替えることができます。 昇順または降順の矢印をクリックすると、この列の並び順が変更されます。

「Action」

新しいコンポーネント型の作成、特定のコンポーネント型の詳細情報の表示、コンポーネント型の編集などの目的でその他のコンポーネント型関連ページにジャンプするリンク。

「Component Type Details」ページ

「Component Types Details」ページには、コンポーネント型の情報と属性が表示されます。 このページのフィールドの内容は変更できません。

「Component Type」

コンポーネント型の名前を表示します。

「Menu Group」

メニューグループの名前を表示します。

「Menu Order」

このコンポーネント型をメニュー内のどの位置に表示するかを制御する 18 文字のコードを表示します。

「Indent Level」

このメニュー項目を空白文字何個分インデントするかを表示します。

「Description」

コンポーネント型の説明を表示します。

「Defining Component」

このコンポーネント型を定義するコンポーネントを表示します。

「Version」

このコンポーネント型のバージョン番号を表示します。

「Edit」ボタン

「Component Types Edit」ページにジャンプするリンク。

「Done」ボタン

「Component Types」pw-時にジャンプするリンク。

「New Component Type Edit」ページ

「コンポーネントの操作」は、コンポーネント作成時の「Component Edit」ページです。 この編集ページは、既存のコンポーネントの編集ページとは異なっています。

「Component Type」

コンポーネント型の名前を表示します。 この情報は変更できません。

「Menu Group」

このコンポーネント型のメニューグループ名を変更するテキストフィールド。 変更できるのは、事前定義済みのメニューグループ名だけです。

「Menu Order」

メニュー内のこのコンポーネント型の位置を変更するテキストフィールド。 このフィールドには、任意の英数字を入力できます。

「Indent Level」

このコンポーネント型のメニューのインデントを変更するテキストフィールド。 このフィールドには、0 から 10 の数値を入力できます。

「Description」

このコンポーネント型の説明を変更するテキストフィールド。

「Defining Component」

このコンポーネント型を定義するコンポーネントを表示します。「View Component」リンクから、「Component Details」ページにジャンプしてコンポーネントを定義することができます。

「Save」ボタン

編集ページの内容を保存し、バージョン番号を大きくします。

「Cancel」ボタン

「Component Types」ページにジャンプするリンク。

Procedureコンポーネント型を表示する

手順
  1. 画面左側のナビゲーションメニュー内の「Administrative」をクリックします。

    HTML ユーザーインタフェースに「Administrative」ページが表示されます。このページでは、4 つの管理機能のうち 1 つを選択できます。

  2. 「Administrative」ページの「Component Types」リンクをクリックします。

    HTML ユーザーインタフェースにコンポーネント型が一覧表示されます。

Procedureコンポーネント型の詳細情報を表示する

手順
  1. 画面左側のナビゲーションメニュー内の「Administrative」をクリックします。

    HTML ユーザーインタフェースに「Administrative」ページが表示されます。このページでは、4 つの管理機能のうち 1 つを選択できます。

  2. 「Administrative」ページの「Component Types」リンクをクリックします。

    HTML ユーザーインタフェースにコンポーネント型が一覧表示されます。

  3. 詳細情報を表示したいコンポーネント型の列を探して、「Details」をクリックします。

    HTML ユーザーインタフェースに、そのコンポーネント型の「Components Types Details」ページが表示されます。

Procedureコンポーネント型を作成する

手順
  1. 画面左側のナビゲーションメニュー内の「Administrative」をクリックします。

    HTML ユーザーインタフェースに「Administrative」ページが表示されます。このページでは、4 つの管理機能のうち 1 つを選択できます。

  2. 「Administrative」ページの「Component Types」リンクをクリックします。

    HTML ユーザーインタフェースにコンポーネント型が一覧表示されます。

  3. コンポーネント型の一覧表の一番上の行の「Component Types」フィールドに新しいコンポーネント型の名前を入力し、「Create」をクリックします。

    HTML ユーザーインタフェースに、新しいコンポーネント型の「Components Types Details Edit」ページが表示されます。

  4. このページのコントロールを使って、コンポーネント型を構成するために必要な情報を指定します。

    1. 必要な場合は、「Component」フィールドの名前を変更します。 コンポーネントのチェックイン後は、名前の変更はできません。

    2. メニューグループ名を入力します。

    3. 18 桁の数字を入力して、メニューの表示順を定義します。

    4. インデントレベルを指定します。

    5. 「Description」フィールドに説明を入力します。

    6. 必要に応じて説明を入力します。

    7. 定義するコンポーネントを選択します。

    8. 完了したら「Save」をクリックします。

Procedureコンポーネント型を編集する

手順
  1. 画面左側のナビゲーションメニュー内の「Administrative」をクリックします。

    HTML ユーザーインタフェースに「Administrative」ページが表示されます。このページでは、4 つの管理機能のうち 1 つを選択できます。

  2. 「Administrative」ページの「Component Types」リンクをクリックします。

    HTML ユーザーインタフェースにコンポーネント型が一覧表示されます。

  3. 詳細情報を表示したいコンポーネント型の列を探して、「Details」をクリックします。

    HTML ユーザーインタフェースに、そのコンポーネント型の「Components Types Details」ページが表示されます。

  4. ページ下部の「Edit」ボタンをクリックします。

    HTML ユーザーインタフェースに、そのコンポーネント型の「Components Types Details Edit」ページが表示されます。

  5. このページのコントロールを使って、情報を変更できます。

    • メニューグループ名を入力します。

    • 18 桁の数字を入力して、メニューの表示順を定義します。

    • インデントレベルを指定します。

    • 「Description」フィールドに説明を入力します。

    • 必要に応じて説明を入力します。

    • 定義するコンポーネントを選択します。

    • 完了したら「Save」をクリックします。

汎用拡張制御サービス

リソースまたはコンポーネント関連のソフトウェア操作を実行する手続きを「拡張制御サービス」と呼びます。 拡張制御サービスには、Microsoft IIS Web サーバーを起動 / 停止するサービスや、特定の Windows サービスを起動 / 停止するサービスが含まれます。 プロビジョニングソフトウェアには、個々のリソース型に依存しない拡張制御サービスのセットが 2 セット含まれています。

汎用制御サービスには、Windows サービスを開始または停止する機能があります。 これらの制御サービスは、あらゆるコンポーネント、あらゆるプランから呼び出すことができます。

リソース型固有の制御サービスの一例として、COM+ アプリケーションリソース型に含まれる startRouter 手続きを挙げることができます。 COM+ ルーティングサービスを開始するのは、この手続きです。 この手続きは、COM+ アプリケーションリソース型のリソースのみを対象としています。

IIS の拡張制御サービス

表 5–47 に、プロビジョニングソフトウェアに組み込まれている IIS 制御手続きを示します。

表 5–47 組み込み型の IIS 制御手続き

名前 

パラメータ 

説明 

stopIIS 

なし 

IIS プロセスを停止 

startIIS 

なし 

Restarts IIS if it is not running 

Windows サービスの拡張制御サービス

コンポーネントやプランには、特定の Windows サービスを開始または停止する手順が含まれていることがあります。

表 5–48 に、プロビジョニングソフトウェアに組み込まれている Windows サービス制御手続きを示します。

表 5–48 組み込み型の Windows サービス制御手続き

名前 

パラメータ 

説明 

stopService 

serviceName: 停止するサービスの名前 

サービスを停止 

startService 

serviceName: 開始するサービスの名前 

Windows サービスを開始