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

weblogic.PlanGenerator は、WebLogic Server デプロイメントコンフィグレーションの各部分をデプロイメントプランにエクスポートする開発者向けに設計された Java ベースのデプロイメントコンフィグレーションツールです。

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

weblogic.PlanGenerator の概要

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

デフォルトでは、weblogic.PlanGenerator はアプリケーションのデプロイメントプランをアプリケーションのルートディレクトリにある plan.xml という名前のファイルに書き込みます。アプリケーションがアプリケーションのルートディレクトリにない場合、weblogic.PlanGenerator は plan.xml を <your_dir>/config/deployments/<user>/<application_name>/plan に書き込みます。各文字列の意味は以下のとおりです。

weblogic.PlanGenerator に必要な環境

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

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

すべての場合において、filespec で識別されるアプリケーションには、有効な J2EE デプロイメント記述子ファイルが含まれている必要があります。

アプリケーションルートディレクトリを -root オプションで指定しなかった場合、またはデプロイメントプランのパスおよび名前を -plan オプションで指定しなかった場合、デフォルトでは weblogic.PlanGenerator はアプリケーションのデプロイメントプランをアプリケーションのルートディレクトリにある plan.xml という名前のファイルに書き込みます。アプリケーションのルートディレクトリが見つからない場合、weblogic.PlanGenerator は plan.xml を <your_dir>/config/deployments/<user>/<application_name>/plan に書き込みます。各文字列の意味は次のとおりです。

オプション

次の表では、各 weblogic.PlanGenerator オプションを説明します。

表 B-1 weblogic.PlanGenerator のオプション
オプション	説明
`-debug`	デバッグモードを有効化する。
`-plan` `plan_file`	コンフィグレーションセッションのために作成するプランファイルのパスおよび名前を識別する。
`-useplan` `plan_file`	初期化を行う既存のデプロイメントプランファイル。アプリケーションのルートディレクトリの指定に `-root` を使用する場合、`weblogic.PlanGenerator` は入力としてルートディレクトリ内の `/plan/plan.xml` ファイルがあればそれを使用する。それ以外の場合、`weblogic.PlanGenerator` は `root` ディレクトリ内にプランを作成する。 weblogic.PlanGenerator は、さらなるエクスポートされたプロパティを入力プランに追加する。すでに入力プラン内に存在したエクスポート済みプロパティは、すべて保持される。
`-root` `root_directory`	プランの生成またはエクスポートを実行するアプリケーションルートディレクトリ。
`category`。`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 サブディレクトリに自動的に格納されます。

上の例では、plan.xml ファイルは自動的に /appRelease/MyApplication/plan に格納されます。

既存のプランに基づく新しいデプロイメントプランの作成

次のコマンドでは、既存のプランを入力として使用し、アプリケーションルートディレクトリの /plan サブディレクトリに新しいプランを生成します。

デプロイメントプランへエクスポートされるコンポーネントの制御

テンプレートデプロイメントプランへエクスポートされる WebLogic Server デプロイメント記述子コンポーネントの指定には、-all、-configurables、-dependencies、-declarations、-dynamics、および -none の各オプションを使用できます。次のコマンドでは、コンフィグレーション可能なすべてのプロパティを、テンプレートデプロイメントプラン内の null 変数にエクスポートします。

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

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