WebLogic Server 9.1 アプリケーションのデプロイメント

weblogic.PlanGenerator コマンドラインリファレンス

weblogic.PlanGenerator は、Java ベースのデプロイメントコンフィグレーションツールです。主に、WebLogic Server デプロイメントコンフィグレーションの各部分を XML デプロイメントプランにエクスポートする必要のある開発者向けです。また、weblogic.PlanGenerator を使用すると、J2EE デプロイメント記述子しかないアプリケーション用の基本的な WebLogic Server コンフィグレーションを生成できます。

WebLogic Scripting Tool (WLST) を使用してのデプロイメントコンフィグレーション処理の実行については、『WebLogic Scripting Tool ガイド』も参照してください。

以下の節では、weblogic.PlanGenerator ユーティリティの使い方について説明します。

weblogic.PlanGenerator の概要

weblogic.PlanGenerator は、アプリケーションまたはスタンドアロンモジュールのための WebLogic Server デプロイメントコンフィグレーションファイルを生成します。weblogic.PlanGenerator には、2 つの主要な機能があります。

さまざまなカテゴリの WebLogic Server デプロイメント記述子プロパティを、テンプレートデプロイメントプランの空 (null) の変数にエクスポートする。必要に応じて、コンフィグレーションエクスポートセッションへの入力に既存のデプロイメントプランを使用することができます。テンプレートプランは一般に、さらに変更を加えてからでなければ使用できません。
J2EE アプリケーションから単純な初期デプロイメントプランを生成する。

デフォルトでは、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 に必要な環境

weblogic.PlanGenerator ユーティリティを使用するように環境を設定するには、次の手順に従います。

WebLogic Server の『インストールガイド』の説明に従って、WebLogic Server ソフトウェアをインストールおよびコンフィグレーションします。

CLASSPATH 環境変数に WebLogic Server クラスを追加し、適切な JDK バイナリが PATH で使用可能になっていることを確認します。setWLSEnv.sh または setWLSEnv.cmd スクリプト (WebLogic Server インストールディレクトリの server/bin サブディレクトリにある) を使用して、環境を設定できます。

weblogic.PlanGenerator を呼び出すための構文

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 オプションを説明します。

表 7-2 weblogic.PlanGenerator オプション

オプション	説明
`-debug`	デバッグモードを有効化する。
`-plan` `plan_file`	コンフィグレーションセッションのために作成するプランファイルのパスおよび名前を識別する。
`-useplan` `plan_file`	初期化を行う既存のデプロイメントプランファイルを指定する。アプリケーションのルートディレクトリの指定に `-root` を使用する場合、`weblogic.PlanGenerator` は入力としてルートディレクトリ内の `/plan/plan.xml` ファイルがあればそれを使用する。それ以外の場合、`weblogic.PlanGenerator` は `root` ディレクトリ内にプランを作成する。 weblogic.PlanGenerator は、さらなるエクスポートされたプロパティを入力プランに追加する。既に入力プラン内に存在したエクスポート済みプロパティはすべて、保持される。
`-root` `root_directory`	プランの生成またはエクスポートを実行するアプリケーションルートディレクトリを指定する。
`category`。有効な値は次のとおり。 `-all` `-configurables` `-dependencies` `-declarations` `-dynamics` `-none`	さまざまなカテゴリのデプロイメントコンフィグレーションプロパティのためのテンプレートデプロイメントプラン内に null 変数定義を生成する。 `all` - 編集可能なすべてのプロパティをエクスポートするプランを作成する。 `configurables` - dependencies および declarations 以外の編集可能なすべてのプロパティをエクスポートするプランを作成する。 `dependencies` - 外部リソース参照を解決するすべての WebLogic Server 記述子プロパティをエクスポートするプランを作成する。これがデフォルト値である。 `declarations` - 他のアプリケーションおよびモジュールに対してリソースを宣言するすべてのプロパティをエクスポートするプランを作成する。 `dynamics` - アプリケーションを再デプロイしなくても実行時に変更できるすべてのプロパティをエクスポートするプランを作成する。 `none` - プロパティをエクスポートしないプランを作成する。
`-variables [global \| unique]`	デプロイメントプラン内に作成された変数名が、アプリケーションのすべてのモジュールにまたがって使用可能なのか、それとも特定のモジュール内でのみ使用可能なのかを指定する。たとえばロールの割り当ては、EAR 全体に適用される場合と、EAR 内の単一の Web アプリケーションまたは他のモジュールにのみ適用される場合がある。デフォルトでは、`PlanGenerator` はアプリケーション全体に適用されるグローバル変数を作成する。

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

デプロイメントコンフィグレーションのエクスポートの詳細については、「新しい環境にデプロイするためのアプリケーションのエクスポート」を参照してください。

weblogic.PlanGenerator コマンドライン リファレンス