| Oracle Containers for J2EEデプロイメント・ガイド 10g（10.1.3.4.0） B50868-01 |
|
 戻る |
 次へ |
OC4Jで提供される一連のAntタスクでは、特定のOC4Jインスタンス、またはグループ内のすべてのOC4Jインスタンスで同時にデプロイ関連操作を実行できます。 Oracle Application Server 10gリリース3（10.1.3.4.0）では、グループとは、同じクラスタ・トポロジに属する一連の同期的なOC4Jインスタンスを指し、クラスタ・トポロジは緩やかに接続された2つ以上のOracle Application Serverノードを指します。
この章では、Antタスクについて説明し、タスクをアプリケーション・ビルド・プロセスに統合するためのガイドラインを示します。 OC4J Antタスクでは、OC4JインスタンスまたはOC4Jインスタンス・グループに対して次の操作を実行できます。
アプリケーション（EAR）、スタンドアロンWebモジュール（WAR）、スタンドアロンEJBモジュール（EJB JAR）またはスタンドアロン・リソース・アダプタ（RAR）をデプロイする。
アプリケーション、Webモジュール、EJBモジュールまたはリソース・アダプタをアンデプロイする。
デプロイ済EJBモジュールを変更されたクラスで増分更新する。
アプリケーションに対する共有ライブラリを作成、変更または削除する。
アプリケーションを起動、再起動または停止する。
OC4Jインスタンスやインスタンス・グループを再起動または停止する。
データソースとデータソース接続プールを追加、テストおよび削除する。
JMS接続プールとJMS宛先を追加および削除する。
表10-1はOC4J Antタスクをその参照先とともに示します。
表10-1 OC4J Antタスク
| Antタスク名 | 説明 |
|---|---|
|
addDataSourceConnectionPool |
|
|
addDestination |
|
|
addJMSConnectionFactory |
|
|
addManagedDataSource |
|
|
addNativeDataSource |
|
|
bindWebApp |
「Webサイトへの特定のWebモジュールのバインドとコンテキスト・ルートの設定」 |
|
bindAllWebApps |
「1つのWebサイトへのすべてのWebモジュールのバインド」 |
|
compileJsp |
『Oracle Containers for J2EE JavaServer Pages開発者ガイド』のAntタスクを使用したJSPのプリコンパイルに関する項 |
|
deploy |
|
|
getDataSourcesDescriptor |
|
|
getDestinations |
|
|
getJMSConnectionFactories |
|
|
publishSharedLibrary |
|
|
modifySharedLibrary |
|
|
redeploy |
|
|
removeDataSourceConnectionPool |
|
|
removeDestination |
|
|
removeJMSConnectionFactory |
|
|
removeManagedDataSource |
|
|
removeNativeDataSource |
|
|
removeSharedLibrary |
|
|
restartServer |
|
|
shutdownServer |
|
|
start |
|
|
stop |
|
|
testDatabaseConnection |
|
|
testDataSource |
|
|
testDataSourceConnectionPool |
|
|
undeploy |
|
|
updateEJBModule |
|
Application Server Controlまたはadmin_client.jarコマンドライン・ユーティリティで同様のデプロイ・タスクを実行できます。 第9章「デプロイに対するApplication Server Controlの使用方法」では、デプロイに対するApplication Server Controlの使用方法を説明します。第11章「デプロイに対するadmin_client.jarユーティリティの使用方法」では、デプロイ・タスクに対するadmin_client.jarの使用方法を説明します。
次の項目について説明します。
|
注意: この章で説明するOC4J Antタスクは、Apache Antバージョン1.6.5での使用を目的としています。Apache Ant製品の最新のドキュメントを入手するには、次のリンクを参照してください。 http://ant.apache.org/manual/ |
「EclipseによるOC4J管理クライアントのAntタスクの使用方法」の説明にあるとおり、EclipseからのWebアプリケーションのデプロイにOC4J Antタスクを使用することもできます。
この項では、OC4J Antタスクを使用するための前提条件とガイドラインを示します。次の項目について説明します。
このドキュメントで説明されているデプロイ関連のOC4J Antタスクを使用するには、次の前提条件が必要です。
1.6.5以上のAntバージョン
Ant 1.6.5は、OC4JのORACLE_HOME/antディレクトリ構造にインストールされます。
OC4Jがインストールされたディレクトリに設定されているORACLE_HOME環境変数
Java2 Standard Edition SDKの場所に設定されているJAVA_HOME環境変数
環境変数の設定の詳細は、『Oracle Containers for J2EE構成および管理ガイド』を参照してください。
OC4JのインストールではAnt 1.6.5とOC4J Antタスク用のファイルが含まれます。Antタスクを使用する前に、これらを環境に組み込む必要があります。
ant-oracle.jarファイルは、デフォルトでORACLE_HOME/ant/libディレクトリにインストールされます。次のAnt関連ファイルは、OC4JのORACLE_HOME/j2ee/utilitiesディレクトリにインストールされます。
ant-oracle-classes.jar
コンパイル済Antタスク・クラスを含むJARファイル
Antタスクの実行プロパティを指定するため編集可能なプロパティ・ファイルのant-oracle.properties
ant-oracle.xml
Ant <import>タスクを使用して、Antビルド・ファイル（build.xml）にインポートできるXMLファイル。 これが必要になるのは、ant-oracle.jarがORACLE_HOME/ant/libディレクトリにインストールされていない場合のみです。
OC4JのORACLE_HOME/ant（デフォルト）にインストールされたAnt 1.6.5実装を使用するためのビルド環境を設定するには、次の手順を実行します。
ORACLE_HOME/ant/binをシステムPATH環境変数に追加します。
Antビルド・ファイル（build.xml）の<project>要素でoracleネームスペースを宣言します。OC4J Antタスクは、build.xmlでこのネームスペースを使用して参照されます。次に例を示します。
<project name="test" default="all" basedir="." xmlns:oracle="antlib:oracle">
（オプション）ORACLE_HOME/j2ee/utilitiesディレクトリのant-oracle.propertiesファイルを、ビルド・ファイル（build.xml）があるディレクトリにコピーします。
ORACLE_HOME/j2ee/utilitiesでファイルを変更し、そのファイルをビルド・スクリプトから参照することもできますが、元のファイルはテンプレートとして保存することをお薦めします。
（オプション）Antタスクに渡す引数の値をant-oracle.propertiesファイルで設定します。
ファイル内のプロパティは、OC4Jのデフォルト値に設定されます。このファイルには、ORACLE_HOMEやJAVA_HOMEなどの環境変数設定も読み込まれています。必要に応じて、ターゲットのOC4Jインスタンスの構成を反映するように、これらのプロパティを編集できます。
（オプション）ant-oracle.propertiesファイルをビルド・ディレクトリにコピーした場合、コピーしたファイルをビルド・スクリプト（build.xml）内で参照する必要があります。次に例を示します。
<property file="ant-oracle.properties"/>
この項では、OC4J外部のAnt 1.6.5実装を使用するようにビルド環境を設定する手順を説明します。
ANT_HOME/ant/binをシステムPATH環境変数に追加します。
ANT_HOME環境変数をインストール済Antを示すように設定し、JAVA_HOME環境変数をJava2 Standard Edition SDKの場所を示すように設定します。
共通のANTインストール・ディレクトリはORACLE_HOME/antです。
Antビルド・ファイル（build.xml）の<project>要素でoracleネームスペースを宣言します。OC4J Antタスクは、build.xmlでこのネームスペースを使用して参照されます。
<project name="test" default="all" basedir="." xmlns:oracle="antlib:oracle">
ORACLE_HOME/j2ee/utilitiesディレクトリのant-oracle.propertiesファイルを、ビルド・ファイル（build.xml）があるディレクトリにコピーします。
ORACLE_HOME/j2ee/utilitiesでファイルを変更し、そのファイルをビルド・スクリプトから参照することもできますが、元のファイルはテンプレートとして保存することをお薦めします。
Antタスクに渡す引数の値をant-oracle.propertiesファイルで設定します。
ファイル内のプロパティは、OC4Jのデフォルト値に設定されます。 このファイルには、ORACLE_HOMEやJAVA_HOMEなどの環境変数設定も読み込まれています。必要に応じて、ターゲットのOC4Jインスタンスの構成を反映するように、これらのプロパティを編集できます。
ORACLE_HOME/j2ee/utilitiesディレクトリのant-oracle.xmlファイルを、ビルド・ファイル（build.xml）があるディレクトリにコピーします。
ビルド・ファイルの最上位レベルにこの<import>要素を追加します。
<import file="ant-oracle.xml"/>
管理クライアント・ユーティリティにより、構成およびデプロイにOC4J Antタスクを使用できます。
管理クライアント・ユーティリティでAnt 1.6.5を使用するOC4J Antタスクを組み込む手順:
Oracle Technology Networkの次の場所からoc4j_admin_client_101340.zipファイルをダウンロードします。
http://www.oracle.com/technology/software/products/ias/htdocs/utilsoft.html
管理クライアント・ユーティリティとその使用方法の詳細は、「リモート管理クライアントのダウンロードと抽出」を参照してください。
oc4j_admin_client_101340.zipの内容を任意のローカル・ディレクトリ（oc4j_admin_clientなど）に抽出します。
ORACLE_HOME/ant/lib/ant-oracle.jarファイルをOracle Application Server 10g（10.1.3.4.0）のホーム・ディレクトリからoc4j_admin_client_101340.zipの内容を抽出したローカル・ディレクトリのOC4J_ADMIN_CLIENT_DIR\ant\libにコピーします。
ORACLE_HOME環境変数をOC4J_ADMIN_CLIENT_DIRディレクトリに設定します。
ANT_HOME/ant/binをシステムPATH環境変数に追加します。
ANT_HOME環境変数をインストール済Antを示すように設定し、JAVA_HOME環境変数をJava 2 Standard Edition SDKの場所を示すように設定します。
共通のANTインストール・ディレクトリはORACLE_HOME/antです。
次のように、Antビルド・ファイル（build.xml）の<project>要素でoracleネームスペースを宣言します。
<project name="test" default="all" basedir="." xmlns:oracle="antlib:oracle">
build.xmlでのOC4J Antタスクに対する参照では、このネームスペースが使用されます。
ORACLE_HOME/j2ee/utilitiesディレクトリのant-oracle.propertiesファイルを、ビルド・ファイル（build.xml）があるディレクトリにコピーします。
ORACLE_HOME/j2ee/utilitiesでファイルを変更し、そのファイルをビルド・スクリプトから参照することもできますが、元のファイルはテンプレートとして保存することをお薦めします。
Antタスクに渡す引数の値をant-oracle.propertiesファイルで設定します。
このファイル内のプロパティは、OC4Jのデフォルト値に設定されます。このファイルには、ORACLE_HOMEやJAVA_HOMEなどの環境変数設定も読み込まれています。必要に応じて、ターゲットのOC4Jインスタンスの構成を反映するように、これらのプロパティを編集できます。
ORACLE_HOME/j2ee/utilitiesディレクトリのant-oracle.xmlファイルを、ビルド・ファイル（build.xml）があるディレクトリにコピーします。
ビルド・ファイルの最上位レベルにこの<import>要素を追加します。
<import file="ant-oracle.xml"/>
Antタスクに渡される主要属性は、deployerUriであり、この属性でタスクのOC4Jターゲットを指定します。 URIの構文は、ターゲットによって異なります。
このURIの書式は、次の項目を参照してください。
グループ内のすべてのOC4Jインスタンスをデプロイ・ターゲットとして指定する場合は、次のURIを使用します。グループは、同じクラスタ・トポロジに属するOC4Jインスタンスの同期的なセットです。たとえば、クラスタ内のデフォルト・グループ（default_group）に属する、すべてのOC4Jインスタンスで同時にデプロイ操作を実行するターゲットとして、default_groupを指定できます。
このURIでは、OPMNベースのクラスタリング・フレームワークが使用されます。クラスタ内のOracle Application Serverノードに対するホスト名と、オプションでOPMNリクエスト・ポートのみを指定する必要があります。これによってアプリケーションは、クラスタ内の他のノードすべてに対するホスト名およびOPMNポートを取得することが可能になります。
URIの構文は次のとおりです。
deployer:cluster:[rmis]:opmn://host[:opmnPort]/groupName
次に例を示します。
deployer:cluster:opmn://node1/default_group
表10-2 ターゲットがグループの場合のURIパラメータ
| パラメータ | 説明 |
|---|---|
|
|
オプション。ターゲットでORMI over SSL（ORMIS）を利用している場合に指定します。 |
|
|
必須。クラスタ内のOracle Application Serverノードのホスト名。任意のノードを指定できます。クラスタの他のノードのリストは、このノードから取得されます。 |
|
|
オプション。 |
|
|
必須。ターゲットOC4Jインスタンスが属するグループの名前。 |
クラスタ内のインスタンスを含めた、特定のOPMN管理のOC4Jインスタンスをターゲットとする場合は、次のURIを使用します。URIの接頭辞では、clusterがoc4jで置き換えられます。
インスタンスのホストとして機能するOracle Application Serverノードのホスト名を指定します。ノードのホスト名またはポートが不明な場合は、クラスタ内の別のノードのホスト名とOracle Application Serverインスタンスの名前を指定することができます。アプリケーションはOPMNクラスタリング・フレームワークを使用して、Oracle Application Serverインスタンスのホストとして機能するノードを見つけます。
URIの構文は次のとおりです。
deployer:oc4j:[rmis]:opmn://host[:opmnPort]/[iASInstanceName] /oc4jInstanceName
次に例を示します。
deployer:oc4j:opmn://server.company.com:6015/instance2/oc4j_2
表10-3 ターゲットが特定インスタンスの場合のURIパラメータ
| パラメータ | 説明 |
|---|---|
|
|
オプション。ターゲットでORMI over SSL（ORMIS）を利用している場合に指定します。 |
|
|
必須。ターゲットとするクラスタ内のOracle Application Serverノードのホスト名。 |
|
|
オプション。 |
|
|
オプション。ターゲットとするOracle Application Serverインスタンスの名前（ |
|
|
必須。ターゲットOC4Jインスタンスの名前。 |
Javaロギングを有効にすると、Antタスクの実行中に発生するエラーのトラブルシューティングに役立ちます。ログ・メッセージはコンソールに出力されます。
ロギングを有効化する手順は、次のとおりです。
ANT_OPTS環境変数を作成し、値を-Djava.util.logging.config.file=logging.propertiesに設定してから、Antタスクを実行します。
次の1行を含むlogging.propertiesファイルを作成します。
oracle.oc4j.admin.jmx.client.CoreRemoteMBeanServer.level=INFO
このファイルをORACLE_HOME/ant/bin以外の場所に作成した場合は、ANT_OPTS環境変数にこのファイルのパスを指定する必要があります。
logging.propertiesファイルの値は、表10-5内のいずれかのJavaログ・レベル値に設定できます。
表10-5 Javaログ・レベル
| Javaログ・レベル | 説明 |
|---|---|
SEVERE |
システム管理者の注意を要するシステム・エラーをロギングします。 |
WARNING |
確認の必要があり、エラーが発生する前に処理が必要になる可能性がある操作や条件の検出をロギングします。 |
INFO |
通常の操作またはイベントをロギングします。これには、ログイン完了などのユーザー操作や、ログ・ファイルのローテーションなどの自動処理が該当します。 |
CONFIG |
構成に関連するメッセージまたは問題をロギングします。 |
FINE |
デバッグやパフォーマンス監視に使用されるトレース・メッセージまたはデバッグ・メッセージをロギングします。通常、詳しいイベント・データが含まれます。 |
FINER |
非常に詳細なトレース・メッセージまたはデバッグ・メッセージをロギングします。 |
FINEST |
さらに詳細なトレース・メッセージまたはデバッグ・メッセージをロギングします。 |
次に例を示します。
oracle.oc4j.admin.jmx.client.CoreRemoteMBeanServer.level=FINE
OC4J 10g（10.1.3.4.0）では、ログ出力用のログ・レベルをApplication Server Controlで次のように設定できます。
OC4Jのホームページで「管理」をクリックします。
管理タスクから、「ログ出力の構成」ページに表示する「ログ出力の構成」を選択します。
「すべてを開く」をクリックして、現在OC4Jにロードされているすべてのログ出力リストを表示します。
ページに表示されている任意のログ出力のログ・レベルを選択します。
OC4Jで提供されたデプロイ関連のAntタスクを、ビルド・ファイル（build.xml）で起動します。 各タスクは、ビルド・ファイルの<target>要素のサブ要素に、<oracle:taskName. ... />という書式で指定されます。 サブ要素でoracleはOC4J Antタスクの参照に使用するネームスペースを表します。
次のサンプルbuild.xmlファイルには1つのデプロイ・タスクが含まれています。このタスクによって、指定したEARがスタンドアロンOC4Jサーバーにデプロイされます。
<project name="test" default="deploy" basedir="." xmlns:oracle="antlib:oracle">
<property name="lib.dir" value="/scratch//temp"/>
<property name="app.name" value="hello-planet"/>
<property name="deployer.uri" value="deployer:oc4j:localhost:23791"/>
<property name="oc4j.admin.user" value="oc4jadmin"/>
<property name="oc4j.admin.password" value="password"/>
...
<target name="deploy-ear" depends="setup,check-oc4j-available>
<echo message="-----> Deploying the application module deployment (ear) file"/>
<oracle:deploy deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
file="${lib.dir}/${app.name}.ear"
deploymentName="${app.name}"
bindAllWebApps="default-web-site"
logfile="${log.dir}/deploy-ear.log"/> </target>
...
</project>
次の項ではdeployタスクの起動方法を説明します。
deployタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループに、EARファイルにパッケージされたJ2EEアプリケーションをデプロイします。 EARファイルをデプロイするために通常指定する属性を、次に示します。
<oracle:deploy
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
file="${lib.dir}/${app.name}.ear"
deploymentName="${app.name}"
bindAllWebApps="default-web-site"
deploymentPlan="localPath/filename"
logfile="${log.dir}/deploy-ear.log"/>
表10-6に、EARファイルをデプロイするときdeployタスクに設定できる属性の一覧を示します。
表10-6 EARデプロイのためのdeployタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のユーザー名。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のパスワード。 |
|
|
必須。デプロイするアーカイブのパスとファイル名。 |
|
|
必須。ユーザー定義のアプリケーション・デプロイ名。OC4J内でのアプリケーションの識別に使用されます。 |
|
|
オプション。すべてのWebモジュールを指定のWebサイトにバインドします。Webサイトを構成する |
|
|
オプション。アプリケーションに適用するデプロイ・プランのパスとファイル名。プランは、以前のデプロイ時にXMLファイルとして保存されている場合があります。このファイルはローカル・ホストに存在する必要があります。 |
|
|
オプション。このアプリケーションの親アプリケーション。デフォルトは、グローバル・アプリケーションすなわち |
|
|
オプション。EARのデプロイ先のディレクトリ。指定しない場合、EARはデフォルトで デプロイ済EARファイルもこのディレクトリにコピーされます。連続してデプロイを行うと、毎回このEARファイルが上書きされます。 |
|
|
オプション。OC4J固有のデプロイメント・ディスクリプタと生成されるファイル（コンパイル済JSPクラスやEJBラッパー・クラスなど）を含むディレクトリ。 デフォルト・ディレクトリは |
|
|
オプション。 IIOPクライアント・スタブをOC4Jサーバーで生成するときに指定します。 すべてのEJBモジュールに対して生成されたアプリケーションレベルのスタブは、 この機能を使用するには、 |
|
|
オプション。 IIOPクライアント・スタブを出力するJARのパスとファイル名。 すべてのEJBモジュールに対して生成されたアプリケーションレベルのスタブは、 また、個別のEJBモジュールに対するスタブは、 この機能を使用するには、 |
|
|
オプション。 グループ内の各OC4Jインスタンスに順にアーカイブをデプロイする場合に指定します。 各ターゲットOC4Jインスタンスへのデプロイが完了しなければ、次のターゲット・インスタンスへのデプロイは開始されません。 OC4JインスタンスにEARがデプロイされている間は、リクエストはそのインスタンスにルーティングされません。
この属性を指定しない場合、デフォルトでターゲット・グループ内のすべてのOC4Jインスタンスにアーカイブが同時にデプロイされます。 この属性は、Oracle Application Server環境でのみ有効です。スタンドアロンOC4Jでは無効です。 |
|
|
オプション。 アプリケーション・クラスタを実行中の異なるOC4Jインスタンスに対する順次デプロイ間の秒数を指定します。 |
|
|
オプション。 デプロイで生成されるログのパスとファイル名。 |
deployタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループに、WARファイルにパッケージされたスタンドアロンWebモジュールをデプロイします。次に例を示します。
<oracle:deploy
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
file="${lib.dir}/${app.name}.war"
deploymentName="${app.name}"
contextRoot="/myapp"
bindAllWebApps="default-web-site"
logfile="${log.dir}/deploy-war.log"/>
表10-7に、WARファイルをデプロイするときdeployタスクに設定できるWAR固有属性の一覧を示します。
表10-7 スタンドアロンWARデプロイのためのdeployタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のユーザー名。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のパスワード。 |
|
|
必須。デプロイするアーカイブのパスとファイル名。 |
|
|
必須。ユーザー定義のモジュール・デプロイ名。OC4J内でのモジュールの識別に使用されます。 |
|
|
必須。Webモジュールを指定のWebサイトにバインドします。Webサイトを構成する |
|
|
必須。 Webモジュールのコンテキスト・ルート。Webブラウザを介してアプリケーションにアクセスするときに、URLの最後に付加されます。 たとえば、コンテキスト・ルートとして
|
|
|
オプション。このモジュールの親アプリケーション。デフォルトは、グローバル・アプリケーションすなわち |
|
|
オプション。アーカイブのデプロイ先のディレクトリ。指定しない場合、アーカイブはデフォルトで デプロイ済アーカイブ・ファイルもこのディレクトリにコピーされます。連続してデプロイを行うと、毎回このファイルが上書きされます。 |
|
|
オプション。OC4J固有のデプロイメント・ディスクリプタと生成されるファイル（コンパイル済JSPクラスやEJBラッパー・クラスなど）を含むディレクトリ。 デフォルト・ディレクトリは |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
deployタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループに、アーカイブにパッケージされたスタンドアロン・リソース・アダプタをデプロイします。 スタンドアロンRARファイルをデプロイするために通常指定する属性を、次に示します。
<oracle:deploy
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
file="${lib.dir}/${app.name}.rar"
deploymentName="${app.name}"
grantAllPermissions="true"
logfile="${log.dir}/deploy-rar.log"/>
表10-8に、RARファイルをデプロイするときdeployタスクに設定できる属性の一覧を示します。
表10-8 スタンドアロンRARデプロイのためのdeployタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のユーザー名。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のパスワード。 |
|
|
必須。デプロイするアーカイブのパスとファイル名。 |
|
|
必須。ユーザー定義のコネクタ名。OC4J内でのコネクタの識別に使用されます。 |
|
|
リソース・アダプタにランタイム権限が必要な場合は必須。必要であれば、指定して |
|
|
オプション。アプリケーションに適用するデプロイ・プランのパスとファイル名。プランは、以前のデプロイ時にXMLファイルとして保存されている場合があります。このファイルはローカル・ホストに存在する必要があります。 |
|
|
オプション。RARファイル内のネイティブ・ライブラリ（DLLなど）を含むディレクトリのパス。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
OC4JにデプロイするすべてのWebモジュールは、アクセスに使用されるWebサイトにバインドする必要があります。
通常、Webモジュールをバインドするのは、EARファイルまたはWARファイルがdeployタスクのbindAllWebApps属性を使用してデプロイされるときです。 ただし、EARまたはWARがデプロイされるときにbindAllWebApps属性が指定されなかった場合は、デプロイ後にモジュールをWebサイトにバインドすることができます。次の項目で詳しく説明します。
bindAllWebAppsタスクを使用して、以前にデプロイしたEAR内のWebモジュールを指定のWebサイトにバインドします。次に例を示します。
<oracle:bindAllWebApps
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
deploymentName="${app.name}"
webSiteName="${oc4j.binding.module}"/>
表10-9に、bindAllWebAppsタスクに設定できる属性の一覧を示します。
bindWebAppタスクを使用して、J2EEアプリケーション内の特定のWebモジュールを、指定したWebサイトまたはdefault Webサイトにバインドします。 Webモジュールへのアクセスに使用するコンテキスト・ルートを指定することもできます。次に例を示します。
<oracle:bindWebApp
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
deploymentName="${app.name}"
webModule="${web.name}"
webSiteName="${oc4j.binding.module}"
contextRoot="/${context.root}"/>
表10-10に、bindWebAppタスクに設定できる属性の一覧を示します。
表10-10 bindWebAppタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。ターゲットOC4Jインスタンスの管理者のユーザー名。 |
|
|
必須。ターゲットOC4Jインスタンスの管理者のパスワード。 |
|
|
必須。Webモジュールが含まれるアプリケーションのユーザー定義名。アプリケーションがデプロイされたときに設定された名前です。 |
|
|
必須。WebサイトにバインドするWebモジュールの名前。EARファイルに含まれるWARファイルの名前から |
|
|
必須。 Webサイト構成を含む |
|
|
必須。 Webモジュールのコンテキスト・ルート（ |
redeployタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループに、以前デプロイされたアーカイブを再デプロイします。 スタンドアロン・リソース・アダプタ（RAR）を再デプロイする場合は、isConnector="true"属性を指定する必要があります。以前のバージョンのアーカイブは、このプロセスの中でアンデプロイされます。次に例を示します。
<oracle:redeploy
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
file="${lib.dir}/${app.name}.archiveType"
deploymentName="${app.name}"
keepsettings="true"
sequential="true"
logfile="${log.dir}/deploy-ear.log"/>
表10-11に、redeployタスクに設定できる属性の一覧を示します。
表10-11 redeployタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のユーザー名。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のパスワード。 |
|
|
必須。再デプロイするアーカイブのパスとファイル名。 |
|
|
必須。ユーザー定義のアプリケーション・デプロイ名。OC4J内でのアプリケーションの識別に使用されます。 この値は、サーバー上の既存のアプリケーションの名前と一致する必要があります。 |
|
|
スタンドアロンRARに対しては必須。 スタンドアロンRARを再デプロイする場合は、指定して |
|
|
オプション。 この属性を指定すると、再デプロイされたアプリケーションが、以前のデプロイのデプロイ・プランをフェッチして使用します。アーカイブにパッケージされているデプロイメント・ディスクリプタに設定された値は無視されます。 この属性を指定しない場合、アーカイブにパッケージされたデプロイメント・ディスクリプタの値が設定されます。 |
|
|
オプション。 OC4Jインスタンス・グループ内の各OC4Jインスタンスに順にアーカイブを再デプロイする場合に指定します。 各ターゲットOC4Jインスタンスへの再デプロイが完了しなければ、次のターゲット・インスタンスへの再デプロイは開始されません。 OC4Jインスタンスにアーカイブが再デプロイされている間は、リクエストはそのインスタンスにルーティングされません。
この属性を指定しない場合、デフォルトでグループ内のすべてのOC4Jインスタンスにアーカイブが同時にデプロイされます。 このオプションはクラスタ環境のみで有効です。スタンドアロンOC4Jでは無効です。 |
|
|
オプション。 アプリケーション・クラスタを実行中の異なるOC4Jインスタンスに対する順次再デプロイ間の秒数を指定します。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
redeploy Antタスクのsequential属性に基づいてグループにアプリケーションを再デプロイする場合、再デプロイ操作は順番に実行されます。再デプロイは、一度に1つのOC4Jインスタンスに対して実行されるため、デプロイされるアプリケーションが完全に停止状態になることはありません。 順次再デプロイでは、現在のインスタンスに対する再デプロイ操作が完了すると、デプロイメント・マネージャにより、アプリケーション・クラスタのメンバーを実行している次のOC4Jインスタンスに対する再デプロイが即座に開始されます。 この結果、次の再デプロイが開始される前に新規アプリケーション・インスタンスを完全にアクティブにするために、システムの安定性が失われる可能性があります。これにより、次の副次的影響が発生する可能性があります。
あるOC4Jインスタンス上でアプリケーションが停止されている間、アプリケーションが他のインスタンスで使用可能であるとmod_oc4jに通知されるまで、アプリケーションにアクセスできなくなる可能性があります。
セッション・レプリケーション・アクティビティは、実行の機会を失う可能性があります。
一部の環境では、redeployタスクでクラスタにアプリケーションを再デプロイする場合に、sequentialおよびkeepsettings属性を指定していてもアプリケーションのセッション状態が失われることがあります。
OC4J 10g（10.1.3.4.0）では、redeployタスクのsequentialDelay属性を使用して、アプリケーション・クラスタを実行中の異なるOC4Jインスタンスに対する各再デプロイ間の秒数を指定できます。 この遅延により、セッション状態のレプリケーションに十分な時間を確保できます。
オプションのsequentialDelay属性が指定されると、デプロイメント・マネージャは、グループ内のOC4Jインスタンスに対する各再デプロイ操作間において指定の秒数待機します。 この遅延により、システムでは、グループ全体にわたる再デプロイ操作の発生時に安定性を保つことが可能となり、アプリケーションにアクセスできなくなる可能性やセッション状態が失われる可能性が低減します。
sequentialDelay属性の設定されたredeploy Antタスクの例は、次のとおりです。
<oracle:redeploy
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
file="${lib.dir}/${app.name}.archiveType"
deploymentName="${app.name}"
keepsettings="true"
sequential="true"
sequentialDelay="15"
logfile="${log.dir}/deploy-ear.log"/>
sequentialDelayオプションは、deploy Antタスクにも適用されます。
undeployタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループから、アプリケーションまたはモジュールを削除します。 スタンドアロン・リソース・アダプタ（RAR）をアンデプロイする場合は、isConnector="true"属性を指定する必要があります。次に例を示します。
<oracle:undeploy
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
deploymentName="${app.name}"
logfile="${log.dir}/filename.log"/>
表10-12に、undeployタスクに設定できる属性の一覧を示します。
表10-12 undeployタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のユーザー名。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のパスワード。 |
|
|
必須。アンデプロイするアプリケーションまたはモジュールのユーザー定義名。これは、アーカイブのデプロイ時に設定した名前です。 |
|
|
スタンドアロンRARに対しては必須。スタンドアロンRARをアンデプロイする場合は、指定して |
|
|
オプション。 アンデプロイで生成されるログ・ファイルのパスと名前。 |
updateEJBModuleタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループで実行するアプリケーション内のEJBモジュールの増分再デプロイ、つまり部分的な再デプロイを行います。この機能により、EJB JAR内の変更されたBeanのみを再デプロイすることが可能になります。モジュール全体を再デプロイする必要はありません。次に例を示します。
<oracle:updateEJBModule
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
deploymentName="${app.name}"
ejbModuleName="${ejb.jar}"
file="${new.ejb.jar}"
logfile="${log.dir}/filename.log"/>
|
注意: CMPまたはBMPエンティティBeanについては、増分再デプロイがアプリケーション全体の再デプロイよりも効率がいい場合がありますが、セッションBean、メッセージドリブンBeanまたはEJB 3.0 JPAエンティティには当てはまりません。この機能を使用する場合の詳細は、「更新されたEJBモジュールの増分再デプロイ」を参照してください。 |
表10-13に、updateEJBModuleタスクに設定できる属性の一覧を示します。
表10-13 updateEJBModuleタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のユーザー名。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のパスワード。 |
|
|
必須。 EJBモジュールが含まれるアプリケーションの名前。スタンドアロンEJBモジュールを更新している場合は、 |
|
|
必須。 |
|
|
必須。更新されるEJB JARのパスとファイル名。 |
|
|
オプション。 更新で生成されるログ・ファイルのパスと名前。 |
Antタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループの共有ライブラリを作成および管理できます。次の項目で詳しく説明します。
publishSharedLibraryタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループに共有ライブラリをインストールします。一度インストールした共有ライブラリは、各インスタンス内のアプリケーションで使用できます。次に例を示します。
<oracle:publishSharedLibrary
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
libraryName="name"
libraryVersion="version"
logfile="${log.dir}/filename.log">
<oracle:uploadCodeSource path="path/file" />
<oracle:addCodeSource path="path/file" />
<oracle:sharedLibraryImport libraryname="name" min-version="version"
max-version="version" />
</oracle:publishSharedLibrary>
共有ライブラリ・バイナリは、各OC4Jインスタンス内のORACLE_HOME/j2ee/instance/shared-libディレクトリにインストールされます。同時に、共有ライブラリを宣言する<shared-library>要素が各OC4Jインスタンス上のserver.xmlファイルに追加されます。
アップロードまたは追加するコード・ソースごとに1つの要素を指定します。インポートする既存の共有ライブラリそれぞれについても同様にします。
新しいコード・ソースを各OC4Jサーバーにアップロードするには、アップロードするJARまたはZIPアーカイブ・ファイルのパスとファイル名を、ネストされた<oracle:uploadCodeSource>要素に指定します。パスは、絶対パスまたは現行作業ディレクトリに対する相対パスとして指定できます。
サーバーにすでに存在するJARまたはZIPファイルを追加するには、<oracle:addCodeSource>要素にパスとファイル名を指定します。各OC4Jサーバー上の既存のファイルの場所を指す絶対パスまたは相対パスを指定します。相対パスを使用すると、ORACLE_HOMEに対する相対パスとして解析されます。
既存の共有ライブラリを新しい共有ライブラリにインポートするには、OC4Jインスタンスで定義されている共有ライブラリの名前を<oracle:sharedLibraryImport>要素に指定します。インポートするライブラリの最小または最大（あるいは両方）のバージョンを指定できます。
次の例では、2つのJARファイルが各ターゲットOC4Jサーバーにアップロードされます。
<oracle:publishSharedLibrary
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
libraryName="acme.common"
libraryVersion="2.5"
logfile="${log.dir}/filename.log">
<oracle:uploadCodeSource path="/acme/acme-apis.jar" />
<oracle:uploadCodeSource path="/acme/acmeImpl.jar" />
</oracle:publishSharedLibrary>
表10-14に、publishSharedLibraryタスクに設定できる属性の一覧を示します。
表10-14 publishSharedLibraryタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のユーザー名。 |
|
|
必須。ターゲットのOC4Jインスタンスまたはインスタンス・グループの管理者のパスワード。 |
|
|
必須。共有ライブラリの名前。 共通APIが複数のベンダーによって実装されている場合、この名前はベンダー名とテクノロジ名の両方を含む必要があります。たとえば、 |
|
|
必須。共有ライブラリのバージョン。この値はコードの実装バージョンを反映するように指定することをお薦めします。 |
|
|
オプション。親共有ライブラリの名前（該当する場合）。 |
|
|
オプション。親共有ライブラリのバージョン（該当する場合）。 |
|
|
オプション。 インストールで生成されるログ・ファイルのパスと名前。 |
modifySharedLibraryタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループにインストールされた既存の共有ライブラリを変更します。次に例を示します。
<oracle:modifySharedLibrary
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
libraryName="name"
libraryVersion="version"
logfile="${log.dir}/filename.log">
<oracle:uploadCodeSource path="path/file" />
<oracle:removeCodeSource path="file" />
<oracle:addCodeSource path="path/file" />
<oracle:addImport libraryName="name" min-version="version"
max-version="version" />
<oracle:removeImport libraryname="name" min-version="version"
max-version="version" />
</oracle:modifySharedLibrary>
アップロード、追加または削除するコード・ソースごとに1つの要素を指定します。インポートまたは削除する既存の共有ライブラリそれぞれについても同様にします。
新しいコード・ソースを各OC4Jサーバーにアップロードするには、アップロードするJARまたはZIPアーカイブ・ファイルのパスとファイル名を、ネストされた<oracle:uploadCodeSource>要素に指定します。パスは、絶対パスまたは現行作業ディレクトリに対する相対パスとして指定できます。
サーバーにすでに存在するJARまたはZIPファイルを追加するには、<oracle:addCodeSource>要素にパスとファイル名を指定します。OC4Jサーバー上の既存のファイルの場所を指す絶対パスまたは相対パスを指定します。相対パスを使用すると、ORACLE_HOMEに対する相対パスとして解析されます。
既存のコード・ソースを共有ライブラリから削除するには、<oracle:removeCodeSource>を使用します。共有ライブラリから削除するコード・ソースのファイル名を指定します。
既存の共有ライブラリを新しい共有ライブラリにインポートするには、OC4Jインスタンスで定義されている共有ライブラリの名前を<oracle:addImport>要素に指定します。インポートするライブラリの最大または最小（あるいは両方）のバージョンをオプションで指定できます。
インポートされた共有ライブラリを削除するには、<oracle:removeImport>要素を使用します。
次の例では、ターゲットの共有ライブラリから、コード・ソースとインポートされたライブラリが削除されます。
<oracle:modifySharedLibrary
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
libraryName="acme.common"
libraryVersion="2.5"
logfile="${log.dir}/filename.log">
<oracle:removeCodeSource path="acme-apis.jar" />
<oracle:removeImport libraryName="foo" min-version="2.0"/>
</oracle:modifySharedLibrary>
表10-15に、modifySharedLibraryタスクに設定できる属性の一覧を示します。
removeSharedLibraryタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループから共有ライブラリを削除します。次に例を示します。
<oracle:removeSharedLibrary
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
logfile="${log.dir}/filename.log"
libraryName="name"
libraryVersion="version"/>
表10-16に、removeSharedLibraryタスクに設定できる属性の一覧を示します。
startタスクまたはstopタスクを使用して、デプロイ操作の一部として、特定のOC4Jインスタンスまたはクラスタ全体のOC4Jインスタンス・グループでアプリケーションと子アプリケーションの起動、再起動または停止を行います。次に例を示します。
<oracle:start|stop
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"
deploymentName="${app.name}"/>
表10-17に、startおよびstopタスクに設定できる属性の一覧を示します。
restartServerタスクまたはshutdownServerタスクを使用して、特定のOC4Jインスタンスまたはクラスタ全体のOC4Jインスタンス・グループを、再起動または停止します。次に例を示します。
<oracle:restartServer|shutdownServer
deployerUri="${deployer.uri}"
userid="${oc4j.admin.user}"
password="${oc4j.admin.password}"/>
表10-18に、restartServerおよびshutdownServerタスクに設定できる属性の一覧を示します。
Antタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループのデータソースを管理できます。次の項目で詳しく説明します。
Antタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループのデータソース接続プールを追加、テストおよび削除できます。次の項目で詳しく説明します。
addDataSourceConnectionPoolタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4Jインスタンスで、アプリケーションに対するデータソース接続プールを追加します。次に例を示します。
<oracle:addDataSourceConnectionPool deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" name="ScottConnectionPool" factoryClass="oracle.jdbc.pool.OracleDataSource" dbUser="scott" dbPassword="tiger" url="jdbc:oracle:thin:@localhost:1521:xe"/>
表10-19に、addDataSourceConnectionPoolタスクに設定できる属性の一覧を示します。
表10-19 addDataSourceConnectionPoolタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。接続するときに使用するデフォルトのユーザー名。 |
|
|
必須。接続するときに使用するデフォルトのパスワード。 |
|
|
必須。新規のデータソース接続プールをJNDIにバインドする際に使用する場所。 |
|
|
必須。コネクション・ファクトリ実装の完全修飾パス。 |
|
|
必須。新規のデータソース接続プールに対するデフォルトのユーザー名。 |
|
|
必須。新規のデータソース接続プールに対するデフォルトのパスワード。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
|
|
オプション。デプロイ先のアプリケーションの名前。 |
|
|
オプション。新規のデータソース接続プールに対するログイン・タイムアウト。 |
|
|
オプション。トランザクション・レベル（ |
|
|
オプション。使用するデータベース・スキーマ。 |
|
|
オプション。OC4Jでローカル・トランザクションを管理するかどうか示します。デフォルト値は |
testDataSourceConnectionPoolタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4Jインスタンスのデータソース接続プールに対するアプリケーションの接続をテストします。次に例を示します。
<oracle:testDataSourceConnectionPool deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" connectionPoolName="ScottConnectionPool" sqlStatement="select * from dual" />
表10-20に、testDataSourceConnectionPoolタスクに設定できる属性の一覧を示します。
表10-20 testDataSourceConnectionPoolタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。接続するときに使用するデフォルトのユーザー名。 |
|
|
必須。接続するときに使用するデフォルトのパスワード。 |
|
|
必須。接続プールの名前。 |
|
|
必須。接続のテストに使用するSQL文。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
|
|
オプション。アプリケーションの名前。 |
|
|
オプション。使用するユーザー名。 |
|
|
オプション。使用するデフォルトのパスワード。 |
removeDataSourceConnectionPoolタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4Jインスタンスのアプリケーションからデータソース接続プールを削除します。次に例を示します。
<oracle:removeDataSourceConnectionPool deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" name="ScottConnectionPool"/>
表10-21に、removeDataSourceConnectionPoolタスクに設定できる属性の一覧を示します。
Antタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループのデータソースを追加、テストおよび削除できます。次の項目で詳しく説明します。
addManagedDataSourceタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4Jインスタンスで、アプリケーションに対するマネージド・データソースを追加します。次に例を示します。
<oracle:addManagedDataSource deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" dataSourceName="ScottDataSource" jndiLocation="jdbc/ScottDataSource" connectionPoolName="ScottConnectionPool" />
表10-22に、addManagedDataSourceタスクに設定できる属性の一覧を示します。
表10-22 addManagedDataSourceタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。接続するときに使用するデフォルトのユーザー名。 |
|
|
必須。接続するときに使用するデフォルトのパスワード。 |
|
|
必須。データソースの名前。 |
|
|
必須。新規のデータソースをJNDIにバインドする際に使用する場所。 |
|
|
必須。データソースが対応する接続プールの名前。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
|
|
オプション。データソースを追加する対象のアプリケーションの名前。 |
|
|
オプション。新規のデータソースに対するデフォルトのユーザー名。 |
|
|
オプション。新規のデータソースに対するデフォルトのパスワード。 |
|
|
オプション。新規のデータソースに対するログイン・タイムアウト。 |
|
|
オプション。トランザクション・レベル（ |
|
|
オプション。使用中のEJB CMP実装がOrion CMPの場合に使用するデータベース・スキーマ。（TopLink CMPがデフォルトです。） |
|
|
オプション。OC4Jでローカル・トランザクションを管理するかどうか示します。デフォルト値は |
removeManagedDataSourceタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4Jインスタンスで、アプリケーションからマネージド・データソースを削除します。次に例を示します。
<oracle:removeManagedDataSource deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" dataSourceName="ScottDataSource"/>
表10-23に、removeManagedDataSourceタスクに設定できる属性の一覧を示します。
addNativeDataSourceタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4Jインスタンスで、アプリケーションに対するネイティブ・データソースを追加します。次に例を示します。
<oracle:addNativeDataSource deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" dataSourceName="ScottNativeDataSource" dbUser="scott" dbPassword="tiger" jndiLocation="jdbc/ScottNativeDataSource" loginTimeout="60" dataSourceClass="oracle.jdbc.pool.OracleDataSource" url="jdbc:oracle:thin:@localhost:1521:xe" > <oracle:nativeDataSourceProperty name="maxStatements" value="20"/> <oracle:nativeDataSourceProperty name="implicitCachingEnabled" value="30"/> </oracle:addNativeDataSource>
表10-24に、addNativeDataSourceタスクに設定できる属性の一覧を示します。
表10-24 addNativeDataSourceタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。接続するときに使用するデフォルトのユーザー名。 |
|
|
必須。接続するときに使用するデフォルトのパスワード。 |
|
|
必須。新規のデータソースの名前。 |
|
|
必須。新規のデータソースをJNDIにバインドする際に使用する場所。 |
|
|
必須。新規のデータソースに対するデフォルトのユーザー。 |
|
|
必須。新規のデータソースに対するデフォルトのパスワード。 |
|
|
必須。新規のデータソースの完全修飾クラス。 |
|
|
必須。新規のデータソースでデータベースへの接続に使用されるURL。 |
|
<nativeDataSourceProperty> |
|
|
name |
必須。新規のデータソースに対するプロパティの名前。 |
|
value |
必須。新規のデータソースに対するプロパティの値。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
|
|
オプション。データソースを追加する対象のアプリケーションの名前。 |
|
|
オプション。新規のデータソースに対するログイン・タイムアウト。 |
removeNativeDataSourceタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4Jインスタンスで、アプリケーションからネイティブ・データソースを削除します。次に例を示します。
<oracle:removeNativeDataSource deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" dataSourceName="ScottNativeDataSource"/>
表10-25に、removeNativeDataSourceタスクに設定できる属性の一覧を示します。
testDatabaseConnectionタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4Jインスタンスのデータベースに対するアプリケーションの接続をテストします。次に例を示します。
<oracle:testDatabaseConnection deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" sqlStatement="select * from dual" factoryClass="oracle.jdbc.pool.OracleDataSource" dbUser="scott" dbPassword="tiger" url="jdbc:oracle:thin:@localhost:1521:xe"/>
表10-26に、testDatabaseConnectionタスクに設定できる属性の一覧を示します。
表10-26 testDatabaseConnectionタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。接続するときに使用するデフォルトのユーザー名。 |
|
|
必須。接続するときに使用するデフォルトのパスワード。 |
|
|
必須。接続のテストに使用するSQL文。 |
|
|
必須。テストするJDBCファクトリ（ |
|
|
必須。データベースに対するデフォルトのユーザー名。 |
|
|
必須。データベースに対するデフォルトのパスワード。 |
|
|
必須。JDBCファクトリで設定するURL。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
|
|
オプション。データベース接続をテストする対象のアプリケーションの名前。 |
testDataSourceタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4Jインスタンスのデータソースに対するアプリケーションの接続をテストします。次に例を示します。
<oracle:testDataSource deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" dataSourceName="ScottDataSource" sqlStatement="select * from dual" />
表10-27に、testDataSourceタスクに設定できる属性の一覧を示します。
表10-27 testDataSourceタスクの属性
| 属性 | タスク |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。接続するときに使用するデフォルトのユーザー名。 |
|
|
必須。接続するときに使用するデフォルトのパスワード。 |
|
|
必須。テストするデータソース。 |
|
|
必須。接続のテストに使用するSQL文。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
|
|
オプション。データソースをテストする対象のアプリケーションの名前。 |
|
|
オプション。データソースに対するデフォルトのユーザー名。 |
|
|
オプション。データソースに対するデフォルトのパスワード。 |
getDataSourcesDescriptorタスクを使用して、アプリケーションのデータソース記述子を取得します。次に例を示します。
<oracle:getDataSourcesDescriptor deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" applicationName="default" />
表10-28に、getDataSourcesDescriptorタスクに設定できる属性の一覧を示します。
OC4J Antタスクを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループのデータJMSリソースを管理できます。次の項目で詳しく説明します。
Antタスクを使用してOC4J JMSコネクション・ファクトリを管理します。次の項目で詳しく説明します。
addJMSConnectionFactoryタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各インスタンスに、JMSコネクション・ファクトリを追加します。次に例を示します。
<oracle:addJMSConnectionFactory deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" domain="Queue" jndiLocation="jms/ExampleQueueCF" />
表10-29に、addJMSConnectionFactoryタスクに設定できる属性の一覧を示します。
表10-29 addJMSConnectionFactoryタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。接続するときに使用するデフォルトのユーザー名。 |
|
|
必須。接続するときに使用するデフォルトのパスワード。 |
|
|
必須。このコネクション・ファクトリのJMSドメイン（ |
|
|
必須。このコネクション・ファクトリがバインドされるJNDIロケーション。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
|
|
オプション。このコネクション・ファクトリに関連付けられているホスト名（デフォルトは対象のOC4J JMSサーバー・ホスト）。 |
|
|
オプション。このコネクション・ファクトリに関連付けられているポート番号（デフォルトは対象のOC4J JMSサーバー・ポート）。 |
|
|
オプション。このコネクション・ファクトリに関連付けられているユーザー名（デフォルトは |
|
|
オプション。このコネクション・ファクトリに関連付けられているパスワード（デフォルトはNULL）。 |
|
|
オプション。このコネクション・ファクトリに関連付けられているJMSクライアントID（デフォルトはNULL）。 |
|
|
オプション。これがXAコネクション・ファクトリかどうかを示します（デフォルトは |
removeJMSConnectionFactoryタスクを使用して、OC4JインスタンスからJMSコネクション・ファクトリを削除します。次に例を示します。
<oracle:removeJMSConnectionFactory deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" jndiLocation="jms/ExampleQueueCF" />
表10-30に、removeJMSConnectionFactoryタスクに設定できる属性の一覧を示します。
getJMSConnectionFactoriesタスクを使用して、クラスタ内のOC4JインスタンスまたはOC4Jインスタンス・グループの各JMSコネクション・ファクトリに対する属性を返します。次に例を示します。
<oracle:getJMSConnectionFactories deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" />
表10-31に、getJMSConnectionFactoriesタスクに設定できる属性の一覧を示します。
Antタスクを使用してOC4J JMS宛先を管理します。次の項目で詳しく説明します。
addDestinationタスクを使用してJMS宛先を追加します。次に例を示します。
<oracle:addDestination deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1"domain="Queue" name="ExampleQueue" jndiLocation="jms/ExampleQueue" />
表10-32に、addDestinationタスクに設定できる属性の一覧を示します。
表10-32 addDestinationタスクの属性
| 属性 | 説明 |
|---|---|
|
|
必須。デプロイ・ターゲットを指定するURI。 |
|
|
必須。接続するときに使用するデフォルトのユーザー名。 |
|
|
必須。接続するときに使用するデフォルトのパスワード。 |
|
|
必須。この宛先のJMSドメイン（ |
|
|
必須。宛先のOC4J JMSプロバイダ固有名。 |
|
|
必須。この宛先がバインドされるJNDIロケーション。 |
|
|
オプション。 デプロイで生成されるログ・ファイルのパスと名前。 |
|
|
オプション。この宛先に関連付けられている永続性ファイル（デフォルトはNULL）。 |
|
description |
オプション。この宛先のテキストによる説明（デフォルトはNULL）。 |
removeDestinationタスクを使用して、クラスタ内のOC4Jインスタンスまたはグループの各OC4JインスタンスからJMS宛先を削除します。次に例を示します。
<oracle:removeDestination deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" jndiLocation="jms/ExampleQueue" />
表10-33に、removeDestinationタスクに設定できる属性の一覧を示します。
getDestinationsタスクを使用して、クラスタ内のOC4JインスタンスまたはOC4Jインスタンス・グループの各OC4J JMS宛先に対する属性を返します。次に例を示します。
<oracle:getDestinations deployerUri="deployer:oc4j:localhost" userid="oc4jadmin" password="welcome1" />
表10-34に、getDestinationsタスクに設定できる属性の一覧を示します。
