Oracle Fusion Middleware Oracle WebLogic Server アプリケーションのデプロイメント 11g リリース 1 (10.3.1) B55511-01 |
|
![]() 戻る |
weblogic.PlanGenerator
は、WebLogic Server デプロイメント コンフィグレーションの各部分をデプロイメント プランにエクスポートする開発者向けに設計された Java ベースのデプロイメント コンフィグレーション ツールです。
注意 : WebLogic Scripting Tool (WLST) を使用してのデプロイメント コンフィグレーション処理の実行については、『Oracle Fusion Middleware 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 Fusion Middleware Oracle WebLogic Server インストール ガイド』の説明に従って、WebLogic Server ソフトウェアをインストールおよびコンフィグレーションします。
CLASSPATH
環境変数に WebLogic Server クラスを追加し、適切な JDK バイナリが PATH
で使用可能になっていることを確認します。setWLSEnv.sh
または setWLSEnv.cmd
スクリプト (WebLogic Server インストール ディレクトリの server/bin
サブディレクトリにある) を使用して、環境を設定できます。
java weblogic.PlanGenerator [オプション] [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
デプロイメント コンフィグレーションのエクスポートの詳細については、「新しい環境にデプロイするためのアプリケーションのエクスポート」を参照してください。