Oracle® Fusion Middleware Oracle WebLogic Scripting Tool 12c リリース1 (12.1.1) B65932-01 |
|
前 |
次 |
この章では、オフラインでWebLogic Scripting Tool (WLST)を使用して、WebLogicドメインを作成および構成する方法について説明します。WLSTでは、実行中のWebLogic Serverに接続しないで(つまり、WLSTオフラインを使用して)、構成ウィザードと同じ機能をサポートしながら、新しいWebLogicドメインを作成し、既存のWebLogicドメインを更新できます。
この章の内容は以下のとおりです。
WebLogicドメインの作成に使用できるサンプル・スクリプトについては、「WLSTオフライン・サンプル・スクリプト」を参照してください。
構成ウィザードの詳細は、「構成ウィザードによるドメインの作成」を参照してください。
ドメイン・テンプレートは、ドメインの構成ドキュメント、アプリケーション、セキュリティ・データ、起動スクリプト、およびWebLogicドメインの作成に必要なその他の情報が含まれたJARファイルです。ドメイン・テンプレートを作成および使用するには、表3-1に示す手順を実行します。
注意: WLSTによるドメインの作成や更新に時間がかかるような場合、CONFIG_JVM_ARGS 環境変数を次の値に設定することにより、時間を短縮できます:
|
表3-1 ドメイン・テンプレートを作成する手順(オフライン)
次を行うには... | このコマンドを使用します... | 詳細については、以下を参照 |
---|---|---|
既存のWebLogicドメインまたはテンプレートを開く |
|
WebLogic Scripting Toolコマンド・リファレンスのreadDomainおよびreadTemplate |
WebLogicドメインを修正する(オプション) |
参照コマンドおよび編集コマンド |
|
未設定の場合に、デフォルト・ユーザーのパスワードを設定する ドメイン・テンプレートに書き込むには、先にデフォルトのユーザー名およびパスワードを設定する必要があります。 |
|
|
ドメイン・テンプレートにドメイン構成情報を書き込む |
|
WebLogic Scripting Toolコマンド・リファレンスのwriteTemplate |
テンプレートを使用してドメインを作成する |
注意: 構成ウィザードでもドメイン・テンプレートを使用できます。『構成ウィザードによるドメインの作成』を参照してください。 |
WebLogic Scripting Toolコマンド・リファレンスのcreateDomain |
WLSTオフラインでは、ンプレート・ビルダーを使用して作成したドメイン・テンプレートJAR内、またはWebLogicドメインのconfig
ディレクトリ内に永続化されている構成データへの読み書きアクセスが可能です。このデータは、XMLドキュメントの集合であり、管理オブジェクトの階層構造を表します。WebLogicドメインの構成ドキュメントを定義するスキーマは、次の場所に格納されています。
http://xmlns.oracle.com/weblogic/weblogic-diagnostics/1.0/weblogic-diagnostics.xsd
WL_HOME
/server/lib/schema
内のJARファイル。WL_HOME
はWebLogic Serverのインストール・ディレクトリです。このディレクトリ内では、以下のドキュメントが表現されています。このディレクトリには次が含まれます。
domain.xsd
ドキュメント。パス名META-INF/schemas/schema-0.xsd
のweblogic-domain-binding.jar
で表現されます。
security.xsd
ドキュメント。パス名META-INF/schemas/schema-1.xsd
のweblogic-domain-binding.jar
で表現されます。
weblogic-diagnostics.xsd
ドキュメント。パス名META-INF/schemas/schema-0.xsd
のdiagnostics-binding.jar
で表現されます。
WLSTでは、この階層はファイルシステムとして表されます。ファイルシステムのルートが、WebLogicドメインを表す管理オブジェクトです。ドメイン・ディレクトリの下には管理対象オブジェクト・タイプのディレクトリ群があります。このオブジェクト・タイプの各インスタンスがタイプ・ディレクトリの下位ディレクトリであり、各管理属性および操作がディレクトリ内のファイルです。インスタンス・ディレクトリの名前は、管理オブジェクトのName
属性の値と一致します。管理オブジェクトにName
属性がない場合、NO_NAME_
number
の形式でディレクトリ名が生成されます。ここで、number
は0(ゼロ)から始まり、追加のインスタンスごとに1ずつ増分します。
階層をナビゲートするには、UNIXまたはWindowsのコマンド・シェルでファイル・システムをナビゲートするのと同様に、cd
、ls
、pwd
などのWLSTコマンドを使用します(表3-2を参照)。
注意: WebLogic Serverのデフォルト値のほとんどは、パフォーマンスを最適化するため、ドメインの構成ファイルには保持されていません。この最適化が原因で、WLSTオフラインでは管理オブジェクト全体を表示できない場合があります(WebLogic Serverでは対応するXML要素をドメインの構成ファイルに書き込んでいないため)。たとえば、WebLogicドメインがアクティブであるときにドメインのロギングのデフォルト重大度レベルを変更しなかった場合、WLSTオフラインではドメインのLog 管理オブジェクトは表示されません。
WLSTオフラインで表示されない管理オブジェクトの属性のデフォルト値を変更する場合、最初に |
表3-2 WebLogicドメイン構成情報の表示(オフライン)
次を行うには... | このコマンドを使用します... | 詳細は、WebLogic Scripting Toolコマンド・リファレンスの次の項を参照 |
---|---|---|
管理オブジェクトの階層をナビゲートする |
|
「cd」 |
現在の管理オブジェクトの子の属性または管理オブジェクトをリストする |
|
「ls」 |
プロンプトで管理オブジェクトのナビゲーション・パス情報表示を切り替える |
|
「prompt」 |
構成階層内の現在の場所を表示する |
|
「pwd」 |
WLSTで使用されるすべての変数を表示する |
|
「dumpVariables」 |
WLSTアクションの実行中に発生した最近の例外のスタック・トレースを表示する |
|
「dumpStack」 |
WLSTオフラインを使用してWebLogicドメインを編集するには、次の表で定義されているタスクのいずれかを実行します。
注意: WLSTによるドメインの作成や更新に時間がかかるような場合、CONFIG_JVM_ARGS 環境変数を次の値に設定することにより、時間を短縮できます:
|
表3-3 WebLogicドメインの編集
次を行うには... | このコマンドを使用します... | 詳細は、WebLogic Scripting Toolコマンド・リファレンスの次の項を参照 |
---|---|---|
アプリケーションをWebLogicドメインに追加する |
|
「addTemplate」 |
リソースを1つまたは複数の宛先に割り当てる(クラスタへのサーバーの割り当てなど) |
|
「assign」 |
リソースの割当てを解除する |
|
「unassign」 |
管理オブジェクトを作成および削除する |
|
「create」 「delete」 |
属性値を取得および設定する |
|
「get」 「set」 |
構成オプションを設定する |
|
「setOption」 |
SQLファイルをデータベースにロードする |
|
「loadDB」 |
WLSTには、既存のWebLogicドメインを読み込み、WebLogicドメインの再作成が可能なWLSTスクリプトを出力するconfigToScript
というコマンドがあります。WebLogic Scripting Toolコマンド・リファレンスのconfigToScriptに関する項を参照してください。
ドメイン・テンプレートの作成や使用とは異なり、configToScript
コマンドは、一緒に使用する必要のある複数のファイルを作成します(ドメイン・テンプレートは単一のJARファイル)。また、configToScript
コマンドが作成するスクリプトには、次の特徴があります。
WLSTでのみ実行できます。
ドメイン・テンプレートは、WLSTまたは構成ウィザードで使用できます。
WebLogic Serverインスタンスが実行されている必要があります。サーバーが実行されていない場合、このスクリプトによってサーバーが起動されます。
WLSTオフラインまたは構成ウィザードでは、ドメイン・テンプレートを使用して、サーバー・インスタンスを起動せずにWebLogicドメインを作成できます。
アプリケーションおよびその他のリソースへの参照のみが含まれます。生成されたスクリプトを実行するとき、アプリケーションおよびリソースは、ファイルシステムを介してWebLogicドメインにアクセスできる必要があります。
WebLogicドメイン・テンプレートは、WebLogicドメインの作成に必要なすべてのアプリケーションおよびリソースが含まれたJARファイルです。ドメイン・テンプレートは自己完結型であるため、ドメイン・テンプレートを使用すると、ファイルシステムを共有しない別のシステムにWebLogicドメインを作成できます。
WLSTオフラインで、アプリケーション・スコープのJDBCやJMSリソース、またはその両方が含まれるアプリケーションを備えたテンプレートを使用してクラスタWebLogicドメインを作成または拡張した場合、ドメインの作成または拡張後に、アプリケーションとそのアプリケーション・スコープのリソースが確実にターゲット指定され、クラスタ環境に適切にデプロイされるために、追加の手順の実行が必要な場合があります。アプリケーション・スコープのモジュールのターゲット指定とデプロイメントの詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』の「weblogic.deployerによるアプリケーションおよびモジュールのデプロイ」を参照してください。
JDBCリソースを使用してデータベースに接続する場合、データベース・ベンダーの要件に従って環境を変更します。通常、そのためには、ドライバ・クラスをCLASSPATH
変数に追加し、ベンダー固有のディレクトリをPATH
変数に追加します。SDKをPATH
変数に追加し、WebLogic ServerクラスをCLASSPATH
変数に追加するだけでなく、サンプルDerbyデータベースで必要な環境を設定するには、次のスクリプトを呼び出します。
WL_HOME
\samples\domains\wl_server\setExamplesEnv.cmd
(Windowsの場合)
WL_HOME
/samples/domains/wl_server/setExamplesEnv.sh
(UNIXの場合)