Workshop for WebLogic 伝播ツールの使用

この章では、Workshop for WebLogic 伝播ツールを使用して、WebLogic Portal を伝播する方法を説明します。Workshop for WebLogic は、ポータルインベントリのダウンロードとアップロード、ポータルインベントリのマージ、スコープとポリシーの設定、および最終インベントリのコミットのプロセスをガイドする伝播ツールを提供します。伝播について、よりプログラム化され自動化されたアプローチを探求する場合は、「伝播 Ant タスクの使用」を参照してください。

概要

Workshop for WebLogic は、完全なポータル伝播を実行できるツールのセットを提供します。Workshop for WebLogic Propagation に用意されたツールを使用すると、次のことが可能になります。

Workshop for WebLogic では、インベントリファイルをマージし、このマージ済みインベントリをグラフィカルに表示して、マージ時に追加、削除、または更新された情報を強調表示することができます。次に、このマージ済みインベントリを調整して、最終インベントリファイルを生成することもできます。また、この最終インベントリファイルは、送り先サーバにアップロードできます。

Workshop for WebLogic を使ったポータルの伝播は次の主要な手順に従います。各手順については、この章で説明されています。

インポート機能を使って、ソースおよび送り先システムからポータルインベントリファイルをダウンロードします。
伝播セッションウィザードを使って、伝播プロジェクトを作成し、ソースおよび送り先インベントリファイルをインポートして、マージ済みインベントリファイルを作成します。
伝播パースペクティブを使用して、マージ済みインベントリファイルを表示して調整します。このパースペクティブでは、マージ済みインベントリがグラフィカルに表示され、追加、削除、および更新された内容が強調表示されます。このパースペクティブを使用して、最終的なマージ済みインベントリを生成する前にマージ済みインベントリに変更を加えることができます。
最終的なマージ済みインベントリファイルを作成します。
最終的なマージ済みインベントリファイルを送り先サーバにアップロードしてコミットします。

伝播パースペクティブの概要

Workshop for WebLogic には、インベントリファイルを表示および編集するためのビューを表示する伝播パースペクティブが用意されています。この節では、伝播パースペクティブについて説明します。

図 7-1 は、伝播パースペクティブの例を示しています。番号が付いている部分については、図の下に簡単な説明があります。

1. [ナビゲーター] - ソースおよび送り先ファイル、マージ済みインベントリファイル、プロパティファイルなどの伝播セッションのコンテンツを表示します。

2. [マージ済みインベントリ] - このビューでは、マージ済みインベントリファイルと、ソースおよび送り先インベントリの間で階層表示を切り替えることができます。この 2 つの表示を切り替えるには、ビューの下部にある [マージ済み] タブまたは [インベントリ] タブをクリックします。

3. [伝播の影響] - このビューには、マージ済みインベントリファイルを変更したときに影響を受けるインベントリノードが表示されます。たとえば、マージ済みインベントリ内のノードを選択解除して、当該ノードを伝播スコープから削除すると、[伝播の影響] ビューで、削除されたノードに依存しているノードが強調表示されます。

4. [アウトライン] - このビューでは、ポータルインベントリを表示およびナビゲートできます。

5. [プロパティー] - [プロパティー] ビューは選択したインベントリノードに関する情報を表示します。このビューは、ノードに適用するポリシーと、ポリシーが適用される場合に必要となる手動の変更を一覧表示します。

6. [伝播依存関係] - このビューには、選択した資産の依存対象となる資産が表示されます。依存資産のいずれかを削除すると、選択した資産が無効になります。

7. [伝播の従属ノード] - このビューには、選択した資産に依存する資産が表示されます。選択した資産を削除すると、これらの依存資産が無効になります。

インベントリファイルのダウンロード

この節では、サーバからポータルインベントリファイルをダウンロードする方法について説明します。ポータルを伝播するには、ソースインベントリと送り先インベントリをダウンロードして結合した後、最終的な結合インベントリをアップロードし、コミットする必要があります。

[ファイル｜インポート] を選択します。
[インポート - 選択] ダイアログで、図 7-2 に示すように、[その他｜サーバからの伝播インベントリ] を選択し、[次へ] をクリックします。

図 7-2 [インポート - 選択] ダイアログ

[インポート - 選択] ダイアログ

[サーバからのインベントリのインポート] ダイアログで、[サーバ URL]、[ユーザ名]、および [パスワード] の各フィールドに値を入力します。サーバ URL は、対象サーバ上にデプロイする伝播サーブレットの URL です。この URL は次のように構成されています。

http://servername:portnumber/earProjectNamePropagation/inventorymanagement

ここで、earProjectName は、伝播するポータルアプリケーションを含む EAR プロジェクトの名前です。たとえば、myEARProjectPropagation です次に例を示します。

http://localhost:7001/myEARProjectPropagation/inventorymanagement

ヒント :

デフォルトでは、すべての WebLogic Portal EAR プロジェクトに伝播サーブレットがデプロイされます。このサーブレットにより、Workshop for WebLogic 伝播ツールや伝播 Ant タスクなどのリモート伝播クライアントとの通信が可能になります。このサーブレットを使用すると、WebLogic Portal インベントリのダウンロード、アップロード、コミットなどのオンライン操作をリモートクライアントから実行できます。

[サーバからのインベントリのインポート] ダイアログの例は、図 7-3 に表示されています。

図 7-3 サーバパラメータからのインポート

サーバパラメータからのインポート

[次へ] をクリックします。[インベントリファイルの選択] ダイアログが表示されます。
図 7-4 に示されているように、[インベントリファイルの選択] ダイアログで、インベントリファイルを配置するフォルダを選択し、ファイルの名前を入力します。

図 7-4 [インベントリファイルの選択] ダイアログ

[インベントリファイルの選択] ダイアログ

伝播プロジェクトの作成

この節では、[伝播セッション] ウィザードを使用して、Workshop for WebLogic に伝播プロジェクトを設定する方法を説明します。この節では、次のタスクについて説明します。

単純なプロジェクトの作成

伝播プロジェクトはプロジェクトフォルダ内に配置する必要があります。現在、伝播プロジェクトを配置するプロジェクトフォルダが存在していない場合は、最初にプロジェクトフォルダを作成する必要があります。このため、この最初のタスクでは単純なプロジェクトを作成します。

単純なプロジェクトを作成するには、次の手順を実行します。

Workshop for WebLogic を起動します。
[ファイル｜新規｜プロジェクト] を選択します。
[新規プロジェクト – ウィザードを選択] ダイアログで、[一般] フォルダを開き、[プロジェクト] を選択して、[次へ] をクリックします。
[新規プロジェクト] ダイアログで、プロジェクトの名前を入力して、[終了] をクリックします。図 7-5 に示すように、パッケージエクスプローラにプロジェクトが表示されます。

図 7-5 新しい単純なプロジェクトのフォルダ

新しい単純なプロジェクトのフォルダ

伝播セッションの開始

伝播セッションには、インベントリファイルのインポート、表示、およびマージのプロセスを手順を追って処理するためのウィザードが用意されています。

[ファイル｜新規｜その他] を選択します。
[新規 – ウィザードを選択] ダイアログで、WebLogic Portal フォルダを開き、[伝播セッション] を選択して、[次へ] をクリックします。
[新しい伝播セッション] ダイアログで、親フォルダを選択し、セッションの名前を入力します。親フォルダは、以前に作成した単純なプロジェクトフォルダのように、任意のプロジェクトフォルダにすることができます。
[次へ] をクリックします。[新しい伝播セッション - ソースインベントリファイルの選択] ダイアログが表示されます。

チェックポイント : 次の作業では、ソースおよび送り先インベントリファイルをインポートします。Workshop for WebLogic を使用して、これらのファイルを表示し、スコープとポリシーを調整し、ファイルをマージして、送り先サーバにアップロードしてコミットできる最終的なマージ済みインベントリファイルを作成します。

インベントリファイルのインポート

伝播ツールは、WebLogic Portal インベントリファイルのペア、つまり、ソースファイルと送り先ファイルに対して使用します。このタスクでは、前にダウンロードしたソースインベントリファイルをプロジェクトにインポートします。

このインポートされたインベントリファイルは、そのシステムについて、データベースに格納されているエンタープライズアプリケーション環境全体を示します。ソースインベントリファイルは、XML ファイル形式で、単一の ZIP ファイルにまとめて格納されます。

図 7-6 に示すように、[新しい伝播セッション - ソースインベントリファイルの選択] ダイアログで、[クリックしてファイルをインポートします] リンクを選択します。[インポート - 選択] ダイアログが表示されます。

図 7-6 [ソースインベントリファイルの選択] ダイアログ

[ソースインベントリファイルの選択] ダイアログ

[インポート - 選択] ダイアログで、図 7-7 に示すように、[一般｜ファイルシステム] を選択し、[次へ] をクリックします。

ヒント :

[サーバからの伝播インベントリ] オプションを選択すると、ウィザードの指示に従って、サーバから直接インベントリをインポートできます。このパスを選択した場合、基本的な手順は「インベントリファイルのダウンロード」に示されている手順と同じものになります。

図 7-7 [インポート - 選択] ダイアログ

[インポート - 選択] ダイアログ

図 7-8 に示すように、[インポート – ファイル・システム] ダイアログで、[参照] をクリックして、インポートするインベントリ (複数も可) を含むフォルダを検索し、リストボックスからインベントリファイルを選択します。

図 7-8 [インポート - ファイル・システム] ダイアログ

[インポート - ファイル・システム] ダイアログ

Into フォルダのフィールドには、インベントリのインポート先の伝播セッションフォルダを入力 (または [参照] ボタンで選択) します。
[終了] をクリックします。[新しい伝播セッション - ソースインベントリファイルの選択] ダイアログに戻ります。このダイアログは、次の節で引き続き使用するため、閉じないでください。
必要に応じてこの手順を繰り返して送り先インベントリファイルをダウンロードします。

チェックポイント : この時点で、伝播プロジェクトへのソースおよび送り先インベントリファイルのインポートが完了しました。次に、ソースファイルと送り先ファイルからマージ済みインベントリファイルを作成します。

マージ済みインベントリファイルの作成

このタスクでは、ソースおよび送り先インベントリファイルを選択して、結合インベントリファイルを作成します。結合インベントリファイルには、ソースファイルと送り先ファイルの結合に使用されるすべての情報が含まれます。この結合インベントリファイルは作成後、最終インベントリファイルを作成する前に表示して調整することができます。

ファイルを結合する際には、次のような一連のルールを使用します。

これらのルールの詳細については、「伝播に関するトピック」を参照してください。この章の例では、デフォルトのルールが使用されています。

ソースインベントリファイルの選択

図 7-9 に示されているように、[ソースインベントリファイルの選択] ダイアログで、ソースインベントリファイルを選択し、[次へ] をクリックします。

図 7-9 [ソースインベントリファイルの選択] ダイアログ

[ソースインベントリファイルの選択] ダイアログ

送り先インベントリファイルの選択

図 7-10 に示されているように、[ソースインベントリファイルの選択] ダイアログで送り先インベントリファイルを選択します。

図 7-10 選択された送り先インベントリファイル

選択された送り先インベントリファイル

[終了] をクリックします。 [関連付けられたパースペクティブを開く] ダイアログが表示されます。

ヒント :

[終了] をクリックして、伝播セッションウィザードの残りのダイアログを省き、すべてのデフォルト値を受け入れます。これらのオプションの詳細については、「伝播に関するトピック」を参照してください。

関連付けられたパースペクティブを開くダイアログで、[はい] をクリックします。この操作によって、伝播パースペクティブが開きます。このパースペクティブを使用して、結合インベントリファイルを表示し、必要に応じて変更を加えることができます。

暫定的な結合インベントリファイルが作成されます。デフォルトでは、このファイルの名前は次のとおりです。

ここで propSessionName は、以前に作成した伝播セッションファイルの名前です。

チェックポイント : この時点で、伝播セッションへのソースおよび送り先インベントリファイルのインポート、およびソースファイルと送り先ファイルのコンテンツが結合された結合インベントリファイルの作成が完了しました。次に、マージ済みインベントリファイルを表示および調整します。

マージ済みインベントリの表示および調整

図 7-11 に示されているように、マージ済みインベントリファイルを生成すると、マージ済みインベントリツリービューにそれが表示されます。

このツリービューでは、マージ済みインベントリファイルのコンテンツが階層的に示されます。

結合インベントリツリーを展開することにより、追加、削除、または更新されたアーティファクトを含む、インベントリの詳細なコンテンツを表示できます。図 7-12 では、インベントリビューが展開されて、追加したアーティファクトが + (プラス) アイコンおよび変更タイプカラムの記号により示されています。

マージ済みインベントリファイルは、色と特別なアイコンの図柄の組み合わせにより、各ノードの状態をグラフィカルに表示します。これらの視覚的な表示は次のとおりです。

表 7-1 マージ済みインベントリのデフォルトの色とアイコンバッジ
アイコンバッジ	デフォルトの色	意味
+ (プラス記号)	緑	アーティファクトがソースには存在するが、送り先には存在しない。アーティファクトが送り先に追加される。
- (マイナス記号)	赤	アーティファクトが送り先には存在するが、ソースには存在しない。アーティファクトが送り先から削除される。
[ ] (角括弧)	青	アーティファクトがソースと送り先に存在する。アーティファクトがソースで変更済みで、送り先でも更新される予定である。
標準 Eclipse エラーバッジ	赤	エラー。おそらく依存関係の衝突のために、変更が不可能であることを示す。また、問題ビューにメッセージが表示される。
標準 Eclipse 警告バッジ	黄	警告。手動の変更が必要なことを示す。また、問題ビューにメッセージが表示される。
なし	緑	暗黙の変更。

インベントリの調整とは、インベントリツリーのノードを手動で選択または選択解除することを示しています。ノードを選択解除すると、当該ノードとその依存ノードすべてが、最終的なマージ済みインベントリファイルに含まれなくなります。多くのアーティファクトが他の複数のアーティファクトに依存しているため、1 つのアーティファクトの選択を解除すると、多くの場合、自動的に他の複数のアーティファクトが選択解除されます。ポータルアーティファクト間の依存関係は複雑であることが多いので、マージ済みインベントリの変更についての説明は、この節で扱う内容の対象外になります。インベントリの編集の詳細については、「伝播に関するトピック」を参照してください。

特定のノードが変更できない場合、チェックボックスはグレー表示されます (変更不可能)。変更できないノードに子がある場合、ノードラベルがグレーテキストで表示されます。変更できないノードに子がある場合、テキストは通常色で表示されます。

表 7-1 に表示されているデフォルトの色は、Eclipse IDE で変更できます。変更できないノードの名前に割り当てられた色を変更するには、または表 7-1 に示す色を変更するには、以下の手順を実行します。

[ウィンドウ｜設定] を選択します。
[設定] ダイアログで、[一般｜外観｜色とフォント] を選択します。
ダイアログの [色とフォント] で [WebLogic Portal｜Propagation Tool] を選択します。
変えたい色を選択して変更します。(非アクティブ変更とは、変更できないノードのテキストに割り当てた色です)。

チェックポイント : マージ済みインベントリを表示して変更したら、最終的なマージ済みインベントリファイルを作成できます。

最終的なマージ済みインベントリファイルの作成

暫定的なマージ済みインベントリの状態に問題がなければ、次にマージ済みファイルの最終バージョンを作成する必要があります。この時点で、暫定ファイルに対して行ったすべての変更が実行され、最終的なマージ済みインベントリファイルが作成されます。最終インベントリファイルは、常に暫定ファイルよりも小さいサイズになります。これは、暫定ファイルが、ソースファイルと送り先ファイルの結合に使用されるアーティファクトすべてを保持する必要があるのに対して、最終ファイルは 2 つのファイルのマージ済みのコンテンツのみを保持するためです。

[ファイル｜エクスポート] を選択します。[エクスポート – 選択] ダイアログが表示されます。
[エクスポート - 選択] ダイアログで、図 7-13 に示すように、[その他｜インベントリへの伝播セッション] を選択し、[次へ] をクリックします。

図 7-13 [エクスポート - 選択] ダイアログ

[エクスポート - 選択] ダイアログ

[伝播セッションの選択] ダイアログで、現在作業中の伝播セッションに対する伝播セッションファイルを選択します。このためには、図 7-14 に示すように、プロジェクトフォルダを開いて、伝播セッションファイルを選択する必要があります。伝播ファイルを選択したら、[次へ] をクリックします。

図 7-14 [伝播セッションの選択] ダイアログ

[伝播セッションの選択] ダイアログ

[インベントリファイルの選択] ダイアログで、最終インベントリファイルを配置するフォルダを選択し、ファイルの名前を入力して、[終了] をクリックします。

図 7-15 に示すように、最終インベントリファイルが、指定したフォルダ内のパッケージエクスプローラに表示されます。

図 7-15 最終インベントリファイル

最終インベントリファイル

サーバへの最終インベントリのアップロード

この節では、最終的なインベントリを送り先サーバにアップロードする方法について説明します。

EAR ファイルのデプロイ

最終インベントリをアップロードする前に、ソースアプリケーションの EAR ファイルを送り先サーバにデプロイする必要があります。つまり、ステージング環境からプロダクション環境へアプリケーションを伝播する場合は、インベントリをアップロードする前にステージングからプロダクションへ EAR をデプロイする必要があります。

最終インベントリの送り先サーバへの伝播

インベントリをサーバに伝播すると、以前に割り当てたスコープと選択したポリシーに従って、Workshop for WebLogic によって最終インベントリファイルのデータベース資産がプロダクションサーバに伝播されます。

[ファイル｜エクスポート] を選択します。 [エクスポート - 選択] ダイアログで、図 7-16 に示すように、[その他｜サーバへの伝播インベントリ] を選択し、[次へ] をクリックします。

図 7-16 サーバへの伝播インベントリのエクスポートの選択

サーバへの伝播インベントリのエクスポートの選択

図 7-17 に示されているように、[伝播インベントリの選択] ダイアログで最終マージ済みインベントリファイルを選択し、[次へ] をクリックします。

図 7-17 [伝播インベントリの選択] ダイアログ

[伝播インベントリの選択] ダイアログ

図 7-18 に示すように、[サーバパラメータへのエクスポート] ダイアログで、対象 Web アプリケーションで実行されている伝播サーブレットの URL、および必須のユーザ名とパスワードの情報を入力し、[終了] をクリックします。

サーブレットの URL は次のとおりです。

http://servername:portnumber/earProjectNamePropagation/inventorymanagement

http://localhost:7001/myEARProjectPropagation/inventorymanagement

Workshop for WebLogic によって、マージ済みインベントリファイルが、サーバにデプロイされます。

詳細ロギングの有効化

詳細ロギングは、伝播に問題が発生するイベントで役立ちます。次の手順により、Workshop for WebLogic で詳細ロギングを有効にするように選択できます。

Workshop for WebLogic を終了します。
次のファイルをエディタで開きます。

BEA_HOME\workshop_10.0\workshop4WP\workshop4WP.ini

次のプロパティを workshop4WP.ini ファイルに追加します。

-Dcom.bea.wlp.eclipse.proptool.verbosefolder=D:\propagation\elogs

ここで、D:\propagation\elogs は、詳細ログを保存するディレクトリです。

Workshop for WebLogic を再起動します。

プロダクション業務ガイド

Workshop for WebLogic 伝播ツールの使用

概要

伝播パースペクティブの概要

インベントリ ファイルのダウンロード

伝播プロジェクトの作成

単純なプロジェクトの作成

伝播セッションの開始

インベントリ ファイルのインポート

マージ済みインベントリ ファイルの作成

ソース インベントリ ファイルの選択

送り先インベントリ ファイルの選択

マージ済みインベントリの表示および調整

最終的なマージ済みインベントリ ファイルの作成

サーバへの最終インベントリのアップロード

EAR ファイルのデプロイ

最終インベントリの送り先サーバへの伝播

詳細ロギングの有効化

インベントリファイルのダウンロード

インベントリファイルのインポート

マージ済みインベントリファイルの作成

ソースインベントリファイルの選択

送り先インベントリファイルの選択

最終的なマージ済みインベントリファイルの作成