B weblogic.PlanGeneratorコマンド行リファレンス
weblogic.PlanGenerator
ユーティリティの使用方法を学習します。これは、WebLogic Serverデプロイメント構成の各部分をデプロイメント・プランにエクスポートする開発者向けに設計されたJavaベースのデプロイメント構成ツールです。ノート:
WebLogic Scripting Tool (WLST)を使用したデプロイメント構成操作の実行については、『WebLogic Scripting Toolの理解』も参照してください。
この付録の内容は次のとおりです。
weblogic.PlanGeneratorの概要
weblogic.PlanGenerator
ユーティリティは、アプリケーションまたはスタンドアロン・モジュールのWebLogic Serverデプロイメント構成ファイルを生成します。
weblogic.PlanGenerator
には、次の2つの主要な機能があります。
-
様々なカテゴリのWebLogic Serverデプロイメント記述子プロパティを、テンプレート・デプロイメント・プランの空(null)の変数にエクスポートします。必要に応じて、構成エクスポート・セッションへの入力に既存のデプロイメント・プランを使用することができます。テンプレート・プランは一般に、さらに変更を加えてからでなければ使用できません。「新しい環境にデプロイするためのアプリケーションのエクスポート」を参照してください。
-
Java EEアプリケーションから単純な初期デプロイメント・プランを生成します。詳細は、「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を呼び出すための構文
java weblogic.PlanGenerator [Options] [filespec]
filespec
としては、次のいずれかを指定できます。
-
アーカイブ・ファイルへのフルパスまたは相対パス
-
展開されたアーカイブ・ディレクトリへのフルパスまたは相対パス
以下のことをお薦めします。
-
アプリケーションをインストール・ルート・ディレクトリに格納します。
-
weblogic.PlanGeneratorコマンド発行時に、
「オプション」
で説明する-rootオプションを付けてアプリケーションのインストール・ルート・ディレクトリを指定すること。
すべての場合において、filespec
で識別されるアプリケーションには、有効なJava EEデプロイメント記述子ファイルが含まれている必要があります。
アプリケーション・ルート・ディレクトリを-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のオプション
オプション | 説明 |
---|---|
|
デバッグ・モードを有効化します。 |
|
構成セッションのために作成するプラン・ファイルのパスおよび名前を識別します。 |
|
初期化を行う既存のデプロイメント・プラン・ファイル。アプリケーションのルート・ディレクトリの指定に weblogic.PlanGeneratorは、さらなるエクスポートされたプロパティを入力プランに追加します。すでに入力プラン内に存在したエクスポート済みプロパティは、すべて保持されます。 |
|
プランの生成またはエクスポートを実行するアプリケーション・ルート・ディレクトリ。 |
|
様々なカテゴリのデプロイメント構成プロパティのためのテンプレート・デプロイメント・プラン内にnull変数定義を生成します。
|
|
デプロイメント・プラン内に作成された変数名が、アプリケーションのすべてのモジュールにまたがって使用可能なのか、それとも特定のモジュール内でのみ使用可能なのかを指定します。たとえばロールの割当ては、EAR全体に適用される場合と、EAR内の単一のWebアプリケーションまたは他のモジュールにのみ適用される場合があります。デフォルトでは、 |
|
終了ではなく例外が発生します。 |
|
モジュールのみに対するプランを作成します。 |
|
マージするライブラリをカンマ区切りで指定します。 |
|
マージするライブラリのディレクトリの場所です。 |
一般的なweblogic.PlanGeneratorタスク
一般的な構成およびエクスポート・タスクを調べます。
次の各項では、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
デプロイメント構成のエクスポートの詳細は、「新しい環境にデプロイするためのアプリケーションのエクスポート」を参照してください。