2 Java Required FilesのカスタムWLSTコマンド

Oracle JRF (Java Required Files)は、Oracleビジネス・アプリケーションおよびアプリケーション・フレームワークに共通の機能を提供するWebLogic Serverインストールに含まれていないコンポーネントで構成されています。この章では、コマンド構文、引数、コマンド例などのJava Required Files (JRF)のカスタムWLSTコマンドについて詳細に説明します。

Oracle JRFは、共通の場所にデプロイされている、個別に開発された多数のライブラリとアプリケーションで構成されています。Java Required Filesの一部とみなされるコンポーネントには、Oracle Application Development Framework、Oracle Fusion Middleware監査フレームワーク、ダイナミック・モニタリング・サービス、Fabric Common、HTTPクライアント、インフラストラクチャ・セキュリティ、Javaオブジェクト・キャッシュ、JMXフレームワーク、JPS、ロギング、MDS、OJSP.Next、Oracle Webサービス、Oracle Web Services Manager、Oracle TopLink、UCP、XDKなどがあります。

Java Required Filesのコマンド

表2-1のコマンドを使用して、Java Required Files (JRF)アプリケーションおよびサービスで、管理対象サーバーまたはクラスタを構成する、または1つの管理対象サーバーまたはクラスタからアプリケーションおよびサービスをコピーし、別の管理対象サーバーまたはクラスタに適用します。

WLST使用列で、オンラインとは、実行中のサーバーに接続している場合にのみ、そのコマンドが使用できることを意味します。オフラインとは、実行中のサーバーに接続していない場合にのみ、そのコマンドが使用できることを意味します。オンラインまたはオフラインとは、どちらの場合にもそのコマンドを使用できることを意味します。

注意:

これらのJRFのカスタムWLSTコマンドを使用するには、Oracle共通ホームからWLSTスクリプトを起動する必要があります。『Oracle Fusion Middlewareの管理』のカスタムWLSTコマンドの使用に関する項を参照してください。

表2-1 JRFコマンド

使用するコマンド	目的	WLST使用
applyJRF	Java Required Filesのアプリケーションおよびサービスで管理対象サーバーまたはクラスタを構成します。	オンラインまたはオフライン
cloneDeployments	管理対象サーバーまたはクラスタからアプリケーションおよびサービスをコピーして、それらを別の管理対象サーバーまたはクラスタに適用します。	オンラインまたはオフライン

applyJRF

WLST使用: オンラインまたはオフライン

説明

Java Required Files (JRF)で管理対象サーバーまたはクラスタを構成します。テンプレート拡張プロセス中に製品テンプレートによって追加される管理対象サーバーは、 JRFでこのコマンドを使用して明示的に構成する必要はありません。

製品テンプレートを使用した最初の拡張後、追加の管理対象サーバーまたはクラスタがドメインに追加される際に、applyJRFコマンドを使用します。applyJRFコマンドは、管理対象サーバーをJRFのみのドメインに追加する場合や、JRF用に構成済の管理対象サーバーを別のOracle製品を含むドメインに追加する場合には常に必要です。

構文

applyJRF(target, [domainDir], [shouldUpdateDomain])

引数	定義
target	JRFアプリケーションおよびサービスで構成される管理対象サーバーまたはクラスタの名前。 targetのアスタリスク(*)の値は、すべてのクラスタおよびスタンドアロンの管理対象サーバーをJRFで構成する必要があることを示します。
domainDir	WebLogic Serverドメインの絶対パス。
shouldUpdateDomain	ドメイン更新の実行方法を制御するオプションのブール・フラグ。true (デフォルト)に設定した場合、関数は暗黙的にオフライン・コマンドreadDomain()およびupdateDomain()、またはオンライン・コマンドedit()、startEdit()、save()および activate()を呼び出します。 falseに設定した場合は、WLSTコマンドをコールしてドメインを更新する必要があります。

引数

定義

target

JRFアプリケーションおよびサービスで構成される管理対象サーバーまたはクラスタの名前。

targetのアスタリスク(*)の値は、すべてのクラスタおよびスタンドアロンの管理対象サーバーをJRFで構成する必要があることを示します。

domainDir

WebLogic Serverドメインの絶対パス。

shouldUpdateDomain

ドメイン更新の実行方法を制御するオプションのブール・フラグ。true (デフォルト)に設定した場合、関数は暗黙的にオフライン・コマンドreadDomain()およびupdateDomain()、またはオンライン・コマンドedit()、startEdit()、save()および activate()を呼び出します。

falseに設定した場合は、WLSTコマンドをコールしてドメインを更新する必要があります。

例

次の例では、JRFで管理対象サーバーserver1を構成します。

wls:/offline> applyJRF('server1', '/my_path/user_templates/domains/my_domain')

cloneDeployments

WLST使用: オンラインまたはオフライン

説明

特定の管理対象サーバーまたはクラスタをターゲットとするすべてのデプロイメントを、2番目の管理サーバーまたはクラスタにレプリケートします。このコマンドは、新しい管理対象サーバーまたはクラスタが既存の管理対象サーバーまたはクラスタと同一のデプロイメントになるように構成するための便利な方法として提供されています。

cloneDeploymentsコマンドでは、新しい管理対象サーバーは作成されず、デプロイメント情報以外のプロパティをターゲット・サーバーにコピーしません。

構文

cloneDeployments(domain, source, target, [shouldUpdateDomain])

引数	定義
domain	WebLogic Serverドメインの絶対パス。ドメインが読込み済またはオンライン・モードで接続されている場合は無視されます。
source	デプロイメントのクローン元である管理対象サーバーまたはクラスタの名前。これは有効な管理対象サーバーまたはクラスタの名前である必要があります。
target	ソース・サーバーのアプリケーションおよびサービスを受信する、ターゲットの管理対象サーバーまたはクラスタ。ターゲットの管理対象サーバーがすでに存在している必要があります。
shouldUpdateDomain	ドメイン更新の実行方法を制御するオプションのブール・フラグ。true (デフォルト)に設定した場合、関数は暗黙的にオフライン・コマンドreadDomain()およびupdateDomain()、またはオンライン・コマンドedit()、startEdit()、save()および activate()を呼び出します。falseに設定した場合は、WLSTコマンドをコールしてドメインを更新する必要があります。

例

次の例では、sourceServerからdestinationServerにデプロイメントをレプリケートします。

wls:/offline> cloneDeployments( '/my_path/user_templates/domains/my_domain',
 'sourceServer','destinationServer', 'false')