Oracle® Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ 11g リリース1(10.3.5) B60988-03 |
|
前 |
次 |
weblogic.PlanGenerator
は、WebLogic Serverデプロイメント構成の各部分をデプロイメント・プランにエクスポートする開発者向けに設計されたJavaベースのデプロイメント構成ツールです。
注意: WebLogic Scripting Tool (WLST)を使用し、デプロイメント構成操作を実行するための情報については、「Oracle WebLogic Scripting Tool」も参照してください。 |
次の項では、weblogic.PlanGenerator
ユーティリティの使用方法について説明します。
weblogic.PlanGenerator
は、アプリケーションまたはスタンドアロン・モジュールのWebLogic Serverデプロイメント構成ファイルを生成します。weblogic.PlanGenerator
には、2つのプライマリな機能があります。
様々なカテゴリのWebLogic Serverデプロイメント記述子プロパティを、テンプレート・デプロイメント・プランの空(null)の変数にエクスポートします。必要に応じて、構成エクスポート・セッションへの入力に既存のデプロイメント・プランを使用することができます。テンプレート・プランは一般に、さらに変更を加えてからでなければ使用できません。「新しい環境にデプロイするためのアプリケーションのエクスポート」を参照してください。
J2EEアプリケーションから単純な初期デプロイメント・プランを生成します。詳細は、「weblogic.PlanGeneratorを使用したテンプレート・デプロイメント・プランの生成」を参照してください。
デフォルトでは、weblogic.PlanGenerator
はアプリケーションのデプロイメント・プランをアプリケーションのルート・ディレクトリにあるplan.xml
という名前のファイルに書き込みます。アプリケーションがアプリケーションのルート・ディレクトリにない場合、weblogic.PlanGenerator
はplan.xml
を<
your_dir
>/config/deployments/<
user
>/<
application_name
>/plan
に書き込みます。各文字列の意味は以下のとおりです。
your_dir
は、プロパティjava.io.tmpdir
で指定されている場合は、TEMP
ディレクトリ。プロパティjava.io.tmpdir
が指定されていなければ、your_dir
はWebLogic Serverのドメイン・ディレクトリです。
user
はユーザー名。
application
は、アプリケーションの名前。
weblogic.PlanGenerator
ユーティリティを使用するように環境を設定するには:
『Oracle WebLogic Serverインストール・ガイド』の説明にしたがって、WebLogic Serverソフトウェアをインストールおよび構成します。
CLASSPATH
環境変数にWebLogic Serverクラスを追加し、適切なJDKバイナリがPATH
で使用可能になっていることを確認します。WebLogic Serverインストール・ディレクトリのserver/bin
サブディレクトリにあるsetWLSEnv.sh
またはsetWLSEnv.cmd
スクリプトを使用して、環境を設定できます。
java weblogic.PlanGenerator [Options] [filespec]
filespec
としては、次のいずれかを指定できます。
アーカイブ・ファイルへのフルパスまたは相対パス
展開されたアーカイブ・ディレクトリへのフルパスまたは相対パス
以下のことをお薦めします。
アプリケーションをインストール・ルート・ディレクトリに格納すること。
weblogic.PlanGeneratorコマンド発行時に、「オプション」で説明する-root
オプションを付けてアプリケーションのインストール・ルート・ディレクトリを指定すること。
すべての場合において、filespec
で識別されるアプリケーションには、有効なJ2EEデプロイメント記述子ファイルが含まれている必要があります。
アプリケーション・ルート・ディレクトリを-root
オプションで指定しなかった場合、またはデプロイメント・プランのパスおよび名前を-plan
オプションで指定しなかった場合、デフォルトではweblogic.PlanGenerator
はアプリケーションのデプロイメント・プランをアプリケーションのルート・ディレクトリにあるplan.xml
という名前のファイルに書き込みます。アプリケーションのルート・ディレクトリが見つからない場合、weblogic.PlanGenerator
はplan.xml
を<
your_dir
>/config/deployments/<
user
>/<
application_name
>/plan
に書き込みます。各文字列の意味は次のとおりです。
your_dir
は、プロパティjava.io.tmpdir
で指定されている場合は、TEMP
ディレクトリ。プロパティjava.io.tmpdir
が指定されていなければ、your_dir
はWebLogic Serverのドメイン・ディレクトリです。
user
はユーザー名。
application
は、アプリケーションの名前。
次の表では、各weblogic.PlanGenerator
オプションを説明します。
表B-1 weblogic.PlanGeneratorのオプション
オプション | 説明 |
---|---|
-debug |
デバッグ・モードを有効化します。 |
-plan plan_file
|
構成セッションのために作成するプラン・ファイルのパスおよび名前を識別します。 |
-useplan plan_file
|
初期化を行う既存のデプロイメント・プラン・ファイル。アプリケーションのルート・ディレクトリの指定に weblogic.PlanGeneratorは、さらなるエクスポートされたプロパティを入力プランに追加します。すでに入力プラン内に存在したエクスポート済みプロパティは、すべて保持されます。 |
-root root_directory
|
プランの生成またはエクスポートを実行するアプリケーション・ルート・ディレクトリ。 |
|
様々なカテゴリのデプロイメント構成プロパティのためのテンプレート・デプロイメント・プラン内にnull変数定義を生成します。
|
-variables [global | unique] |
デプロイメント・プラン内に作成された変数名が、アプリケーションのすべてのモジュールにまたがって使用可能なのか、それとも特定のモジュール内でのみ使用可能なのかを指定します。たとえばロールの割当ては、EAR全体に適用される場合と、EAR内の単一のWebアプリケーションまたは他のモジュールにのみ適用される場合があります。デフォルトでは、 |
次の項では、一般的な構成およびエクスポートのタスクを、weblogic.PlanGenerator
構文の例とともに説明します。
インストール・ルート・ディレクトリを使用してアプリケーションを格納する場合、ルート・ディレクトリを-root
オプションで指定していると、生成されたデプロイメント・プラン・ファイルは、ルート・ディレクトリのplan
サブディレクトリに自動的に格納されます。
java weblogic.PlanGenerator -root /appRelease/MyApplication
上の例では、plan.xml
ファイルは自動的に/appRelease/MyApplication/plan
に格納されます。
次のコマンドでは、既存のプランを入力として使用し、アプリケーション・ルート・ディレクトリの/plan
サブディレクトリに新しいプランを生成します。
java weblogic.PlanGenerator -useplan /plans/MyApplication_template.xml -root /appRelease/MyApplication
テンプレート・デプロイメント・プランへエクスポートされるWebLogic Serverデプロイメント記述子コンポーネントの指定には、-all
、-configurables
、-dependencies
、-declarations
、-dynamics
、および-none
の各オプションを使用できます。次のコマンドでは、構成可能なすべてのプロパティを、テンプレート・デプロイメント・プラン内のnull変数にエクスポートします。
java weblogic.PlanGenerator -root /appRelease/MyApplication -all
デプロイメント構成のエクスポートの詳細は、「新しい環境にデプロイするためのアプリケーションのエクスポート」を参照してください。