|
|
以下の節では、アプリケーションの WebLogic Server デプロイメント コンフィグレーションをカスタム デプロイメント プランにエクスポートする方法について説明します。これにより、管理者はアプリケーションを簡単に非開発環境にデプロイできるようになります。
アプリケーションのデプロイメント コンフィグレーションの「エクスポート」とは、アプリケーションを新しい WebLogic Server 環境にデプロイするために、カスタム デプロイメント プランを作成するプロセスです。このプロセスが完了したら、アプリケーションを環境に合わせてコンフィグレーションするための青写真としてデプロイメント プランを使用するデプロイヤ (たとえば、テスト管理者、ステージング管理者、またはプロダクション管理者) に、アプリケーション デプロイメント ファイルとカスタム デプロイメント プランの双方を配布します。
管理者は、アプリケーションおよびカスタム デプロイメント プランの双方を、Administration Console を使用してインストールできます。Administration Console では、デプロイメント プランを検証し、特定のデプロイメントに必要なコンフィグレーション プロパティを更新できます。
デプロイメント プランの詳細については、「デプロイメント プランの内容について」を参照してください。
デプロイメント コンフィグレーションをエクスポートするにあたっての主な目標は、次のとおりです。
BEA WebLogic Server では、アプリケーションのデプロイメント コンフィグレーションのエクスポートを支援するための以下のツールを用意しています。
weblogic.PlanGenerator。WebLogic Server デプロイメント記述子の選択されたカテゴリについて、null 変数を備えるテンプレート デプロイメント プランを作成します。エクスポート プロセスを開始しているところであり、デプロイメント記述子のクラス全体に対して null 変数を備えるテンプレート デプロイメント プランを作成する必要がある場合は、このツールの使用をお勧めします (「デプロイメント プロパティの分類について」を参照)。通常は、余分な変数定義を削除したり、個々のプロパティのための変数を追加したりするために、手動または Administration Console で weblogic.PlanGenerator が作成したデプロイメント プランを手動で変更する必要があります。weblogic.PlanGenerator よりも高い柔軟性があります。
(すべての J2EE モジュール記述子、ならびに JDBC、JMS、および WLDF アプリケーション モジュールのための) 各 WebLogic Server デプロイメント記述子プロパティは、次の 4 つのカテゴリのうちの 1 つに分類できます。
ejb-name プロパティの値を変更すると、EJB アプリケーション コードの変更も必要になるので、このプロパティはコンフィグレーション不可に分類されます。
これらのカテゴリは、デプロイメント プランにおいて変数としてエクスポーズするプロパティを選択するために、コンフィグレーション エクスポート プロセス中に使用します。たとえば、アプリケーションの WebLogic Server デプロイメント記述子内で「dependencies」としてタグ付けされたすべてのプロパティの変数定義を含む、新しいデプロイメント プランを生成できます。変数はその後、別のリソース名を持つ環境へアプリケーションをデプロイしている管理者によって簡単に変更できます。
変更可能な記述子プロパティ (依存関係、宣言、およびコンフィグレーション可能プロパティ) はすべて、動的プロパティまたは非動的プロパティとしてさらに分類されます。動的プロパティはデプロイされたアプリケーション内で変更でき、その変更を有効化するのに再デプロイは必要ありません。非動的プロパティは変更できますが、変更を有効化するのに再デプロイメントが必要です。Administration Console は、非動的プロパティを、再デプロイメントが必要であるときにそれを通知するものとして識別します。
アプリケーションのデプロイメント コンフィグレーションをエクスポートするには通常、以下の手順を実行します。
デプロイメント コンフィグレーションをエクスポートする前に、アプリケーション ファイルをアプリケーション インストール ディレクトリに入れておくことをお勧めします。インストール ディレクトリを使用すると、デプロイメント プランなどの生成されたコンフィグレーション ファイルが、エクスポート中に自動的に \plan サブディレクトリへコピーされます。
アプリケーションのインストール ディレクトリを作成するには、次の手順に従います。
mkdir c:\exportapps\myApplication
mkdir c:\exportapps\myApplication\app
mkdir c:\exportapps\myApplication\plan
\app サブディレクトリへコピーします。アプリケーションはアーカイブ形式でも、展開されたアーカイブ形式でもかまいません。cp -r c:\dev\myApplication c:\exportapps\myApplication\app
\app ディレクトリには、配布された完全なアプリケーションが格納されている必要があります。また、開発環境へのデプロイメントに使用する WebLogic Server 記述子ファイルを格納することができます。
アプリケーションをエクスポートする際に、インストール ディレクトリを使用しないことを選択した場合は、weblogic.PlanGenerator に対して -plan オプションを使用し、生成されたプランの場所とファイル名を指定することをお勧めします。デフォルトでは、weblogic.PlanGenerator は生成されたファイルを TEMP/weblogic-install/application_name/config ディレクトリに格納します。TEMP は環境における一時ディレクトリです。Windows プラットフォームの場合、これは生成されたコンフィグレーション ファイルが C:\Documents and Settings\username\Local Settings\Temp\weblogic\install\myApplication.ear\config に格納されることを意味します。生成されたファイルを既知の場所に置くには、-plan オプションを使用します。
weblogic.PlanGenerator ツールは、デプロイメント記述子のカテゴリ全体に対する null 変数 (宣言、コンフィグレーションな可能プロパティなど) を備えたテンプレート デプロイメント プランを迅速かつ簡単に生成する方法を提供します。アプリケーションのすべての依存関係について null 変数を備える新しいデプロイメント プランを生成するためには、weblogic.PlanGenerator の使用をお勧めします。これにより、アプリケーションに必要なすべてのグローバル リソースが、アプリケーションを新しい環境にデプロイする必要がある管理者によって、簡単にコンフィグレーションできるようになります。
インストール ルート ディレクトリ内でステージングされるアプリケーションを使用する場合、weblogic.PlanGenerator を使用するための基本的な構文は、次のとおりです。
java weblogic.PlanGenerator -rootinstall_rootcategory
install_root は、アプリケーションおよびプランのルート ディレクトリの完全修飾名を指定します。
category は、変数を作成する WebLogic Server デプロイメント記述子のカテゴリを指定します (各カテゴリの説明は、「デプロイメント プロパティの分類について」を参照)。テンプレート デプロイメント プランを生成するためには通常、デフォルトのオプションである -dependencies オプションのみを使用します。そうすることで、アプリケーションで必要とされる外部リソースに対する変数が制限されるからです。
| 注意 : | -dependencies オプションは、可能性のあるすべての動的にコンフィグレーション可能なデプロイメント プロパティに対して null 変数を作成します。そのため、アプリケーションには不要であるかもしれない多数の変数定義が作成される場合があります。-declarations オプションは通常、必須ではありません。宣言プロパティは一般に、アプリケーションの基本機能と関連付けられており、新しい環境へのデプロイメントの前に変更されるべきではないからです。 |
java weblogic.PlanGenerator -root c:\exportapps\myApplication -dependencies
java weblogic.PlanGenerator -root c:\exportapps\myApplication
-dependencies がデフォルトのオプションであるため weblogic.PlanGenerator コマンドで指定する必要がなく、したがって同義である上記のコマンドの場合、weblogic.PlanGenerator は選択されたアプリケーション内のすべての J2EE デプロイメント記述子を検査し、アプリケーションに対する外部リソースをコンフィグレーションするすべての関連 WebLogic Server デプロイメント プロパティについて、null 変数を備えるデプロイメント プランを作成します。Administration Console を使用している管理者は、アプリケーションがデプロイできるようになる前に、このテンプレート デプロイメント プランを使って各 null 変数に有効なリソース名とチューニング プロパティを割り当てるよう指示されます。
「weblogic.PlanGenerator を使用したテンプレート デプロイメント プランの生成」で生成されたテンプレート デプロイメント プランには、アプリケーションの外部の依存関係を解決するデプロイメント プロパティのみが格納されています。テンプレート プランを全般的にカスタマイズして、アプリケーションの 1 つまたは複数の WebLogic Server チューニング プロパティを追加します。Admnistration Console を使用すると、必要に応じて、個々のデプロイメント記述子プロパティのデプロイメント プラン変数を簡単に追加できます。Administration Console を使用してデプロイメント プランをカスタマイズするには、次の手順を実行します。
Administration Console を使用してデプロイメント コンフィグレーションを変更するには、まず「アプリケーションのインストール ディレクトリを作成する手順」の説明に従って、アプリケーションおよび既存のデプロイメント プランをインストールする必要があります。
エクスポートされたアプリケーションをインストール後、Administration Console オンライン ヘルプの「アプリケーションおよびモジュールのインストール」に記載の手順に従い、デプロイメント プランに新しいチューニング プロパティを追加します。
Administration Console を使用してアプリケーションのデプロイメント コンフィグレーションを変更する場合、デプロイメント プロパティに対する変更は、WebLogic Server デプロイメント プランや、生成された WebLogic Server デプロイメント記述子ファイルに格納されます。アプリケーションのデプロイメント プラン内の変数として定義されているデプロイメント プロパティを変更した場合、変更は新しいバージョンのプラン ファイルに書き戻されます。インストール ディレクトリからインストールされたアプリケーションの場合、デフォルトでは Administration Console は生成されたコンフィグレーション ファイルを plan サブディレクトリに格納します。
場合によっては、テキスト エディタを使用して手動でカスタム デプロイメント プランを編集する必要があります。これが必要となるのは、以下の理由がある場合です。
| 注意 : | Administration Console を使って、変数定義をデプロイメント プランから削除したり、デプロイメント プロパティに対して null 値を割り当てたりすることはできません。 |
デプロイメント プランのエントリを手動で編集する前に、http://www.bea.com/ns/weblogic/90/weblogic-deployment-plan.xsd および「デプロイメント プランの内容について」を参照してください。
デプロイメント プラン内の variable-definition スタンザは、WebLogic Server デプロイメント記述子プロパティのオーバーライドに使用される変数の名前と値を定義します。module-override 要素には、所定のデプロイメント記述子に変数がどこで適用されるのかを定義する variable-assignment 要素を 1 つまたは複数、含めることができます。デプロイメント プランから変数を削除するには、テキスト エディタを使用して以下を削除します。
既存の変数定義に null 値を割り当てるには、単に variable 要素内の value 下位要素の中にある任意のテキスト値を、<value xsi:nil="true"></value> に変更します。この場合 xsi ネームスペースは、xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" と定義されています。次に例を示します。
...
<variable-definition>
<variable>
<name>SessionDescriptor_InvalidationIntervalSecs_11029744771850</name>
<value>80</value>
</variable>
</variable-definition>
...
...
<variable-definition>
<variable>
<name>SessionDescriptor_InvalidationIntervalSecs_11029744771850</name>
<value xsi:nil="true"></value>
</variable>
</variable-definition>
...
Administration Console は、新しくインストールされたアプリケーションまたはモジュールのデプロイメント コンフィグレーションを自動的に検証します。エクスポート プロセス中に作成したカスタム デプロイメント プランを検証するには、次の手順に従います。
plan サブディレクトリ内に plan.xml という名前のデプロイメント プランがあれば、それを自動的に使用します。
アプリケーションのデプロイメント コンフィグレーションをエクスポートする際には、以下のベスト プラクティスに留意してください。
weblogic.PlanGenerator は、リソースの依存関係のエクスポートにのみ使用すること。一般に、デプロイメント記述子プロパティの他のカテゴリをエクスポートするのに weblogic.PlanGenerator を使用すると、デプロイメント プラン内に生じる変数が過多になります。weblogic.PlanGenerator でも、プランから変数を削除したり、変数に対して null 値を設定したりすることはできない。これらのタスクを完了させる必要がある場合は、テキスト エディタを使用します。
  
|
