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

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 を使ったポータルの伝播は次の主要な手順に従います。各手順については、この章で説明されています。

セキュリティ情報と伝播

特定の伝播操作を実行する前に、伝播するサーバに対して特定のセキュリティ権限を持っている必要があります。これらの操作には、オンライン Ant タスクおよびサーバへの伝播インベントリのエクスポート、およびサーバからの伝播インベントリのインポートの Workshop for WebLogic における操作が含まれます。

ユーザは伝播するアーティファクトへの委託管理特権を付与されている必要があります。ほとんどの場合において、伝播時に管理者ロールのメンバーになっておくことをお勧めします。伝播ツールはアプリケーションのコンフィグレーション全体を表示できるので、このロールによって、すべてのアーティファクトをアプリケーションに伝播でき、このアプローチが最も安全な伝播方法といえます。

ユーザが PortalSystemAdministrator ロールのメンバーになるために以下のタスクが必要です。

OnlineCommitTask および OnlineDownloadTask の場合、すべてのリソースが読み込みと変更できることを確認するために、ユーザが管理者ロールになることをお勧めします。ユーザが管理者ロールにいないと、OnlineCommitTask および OnlineDownloadTask はデフォルトで失敗になります。タスクを呼び出す場合、ユーザは、allowNonAdminUser 修飾子を true に明示的に設定します。

特定の伝播操作は、ファイルを InventoryManagementServlet に送信する必要があります。伝播のユーザが管理者ロールに存在しない場合、ユーザはサーバへのファイル アップロード権限を持っている必要があります。この特権は、サーバにファイルが送信されるすべての操作に必要です。これは、OnlineCheckMutexTask、OnlineCommitTask、OnlineDownloadTask、OnlineMaintenanceModeTask、OnlineUploadTask のタスクに適用されます。

ドメインのファイル アップロードのセキュリティ ポリシー の管理の詳細については、e-docs にある WebLogic Server ドキュメントを参照してください。

ただし、伝播がアプリケーションの特定領域を対象としている場合の使用例であるため、上述のアドバイスは当てはまりません。たとえば、コンテンツ管理者はコンテンツ項目の単一のフォルダを伝播する場合があります。このユーザは、どのポータル フレームワーク資産に対しても、委託管理特権を持たない可能性がありますが、この使用例では問題とはなりません。

このような場合、アプリケーションへのすべての委託管理特権を持たなくても、伝播を実行することができます。送り先に存在する項目を追加する場合、こうすることでエラーが発生することもありますが、委託管理特権を持たないのでユーザにはエラーは表示されません。すでに存在しているために追加できずに衝突したアーティファクトについては、コンソールにエラーが表示されることがあります。

委託管理の詳細については、「WebLogic Portal のセキュリティ ガイド」を参照してください。

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

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

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

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

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

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

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

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

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

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

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

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

伝播プロジェクトの作成

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

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

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

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

伝播セッションの開始

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

伝播セッションを開始するには、次の手順を実行します。

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

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

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

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

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

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

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

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

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

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

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

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

propSessionName.merged.zip

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

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

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

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

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

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

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

インベントリの調整とは、インベントリ ツリーのノードを手動で選択または選択解除することを示しています。リソースは更新選択に設定すれば、XML のソース バージョンは最終的なマージ済みインベントリになります。選択解除すれば、XML の送り先バージョンは最終的なマージ済みインベントリになります。つまり、すでに送り先にあるものは受け入れられます。

変更を追加選択に設定する場合に選択解除すれば、リソースが最終インベントリから除外されます。図 7-13 には、追加されたものはデスクトップから選択解除して、最終インベントリから除外されることを示します。

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

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

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

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

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

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

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

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

EAR ファイルのデプロイ

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

詳細については、「J2EE アプリケーション (EAR) のデプロイ」を参照してください。

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

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

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

詳細ロギングの有効化

詳細ロギングは、伝播に問題が発生するイベントで役立ちます。

次の手順により、Workshop for WebLogic で詳細ロギングを有効にするように選択できます。