WebLogic Server 9.1 アプリケーションのデプロイメント
![]() |
![]() |
![]() |
![]() |
以下の節では、アプリケーションの 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
cp -r c:\dev\myApplication c:\exportapps\myApplication\app
アプリケーションをエクスポートする際に、インストール ディレクトリを使用しないことを選択した場合は、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_root
category
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 オンライン ヘルプの「アプリケーションおよびモジュールのインストール」に記載の手順に従い、デプロイメント プランに新しいチューニング プロパティを追加します。
Administration Console を使用してアプリケーションのデプロイメント コンフィグレーションを変更する場合、デプロイメント プロパティに対する変更は、WebLogic Server デプロイメント プランや、生成された WebLogic Server デプロイメント記述子ファイルに格納されます。アプリケーションのデプロイメント プラン内の変数として定義済みのデプロイメント プロパティだけを変更した場合、変更は新しいバージョンのプラン ファイルに書き戻されます。デプロイメント プランで指定されていなかったデプロイメント プロパティを変更した場合、新しい変数がプランに追加されます。
インストール ディレクトリからインストールされたアプリケーションをコンフィグレーションした場合、デフォルトでは Administration Console は生成されたコンフィグレーション ファイルを plan
サブディレクトリに格納します。
場合によっては、テキスト エディタを使用して手動でカスタム デプロイメント プランを編集する必要があります。これが必要となるのは、以下の理由がある場合です。
注意 : Administration Console を使って、変数定義をデプロイメント プランから削除したり、デプロイメント プロパティに対して null 値を割り当てたりすることはできません。
デプロイメント プランのエントリを手動で編集する前に、「デプロイメント プラン スキーマ」を参照してください。
デプロイメント プラン内の 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 値を設定したりすることはできない。これらのタスクを完了させる必要がある場合は、テキスト エディタを使用します。
![]() ![]() |
![]() |
![]() |