OC4Jで提供されるコマンドライン・ユーティリティadmin_client.jar
は、Oracle Application Serverクラスタ環境のアクティブなOC4JインスタンスやスタンドアロンOC4Jサーバーで、デプロイ関連操作を実行します。また、admin_client.jar
を使用してOC4Jインスタンスまたはインスタンス・グループを再起動または停止できます。
またadmin_client.jar
ユーティリティは操作をリモートで実行するための管理クライアント・ユーティリティの一部でもあり、Companion CDから、またはOracle Technology Networkからダウンロードして入手できます。
デプロイ操作は、特定のOC4Jインスタンス、またはグループ内のすべてのOC4Jインスタンスで同時に実行できます。グループは、同じクラスタ・トポロジ(2つ以上の粗結合のOracle Application Serverノード)に属するOC4Jインスタンスの同期セットです。admin_client.jar
コマンドライン・ユーティリティを使用することで、OC4JインスタンスまたはOC4Jインスタンス・グループで次の操作を実行できます。
Webサイトを追加する。
エンタープライズ・アプリケーション・アーカイブ(EAR)、スタンドアロンWebモジュール(WAR)、Enterprise JavaBeans(EJB)モジュール(EJB JAR)、またはスタンドアロン・リソース・アダプタ(RAR)をデプロイする。
アプリケーション、Webモジュール、EJBモジュールまたはリソース・アダプタをアンデプロイする。
デプロイ済EJBモジュールを変更されたクラスで増分更新する。
WebサイトへのWebモジュールのバインド、WebサイトからのWebモジュールのアンバインド、およびWebバインディングの詳細の一覧表示を行う。
アプリケーションに対する共有ライブラリを作成、変更または削除する。
アプリケーションを起動、再起動または停止し、アプリケーションのステータスと詳細を一覧表示する。
OC4Jインスタンスやインスタンス・グループを再起動または停止する。
データソースとデータソース接続プールを追加、テスト、一覧表示および削除する。
JMS接続プールとJMS宛先を追加および削除する。
Application Server ControlまたはOC4J Antタスクで同様の操作を実行できます。詳細は、第9章「デプロイに対するApplication Server Controlの使用方法」または第10章「デプロイに対するOC4J Antタスクの使用方法」を参照してください。
次の項目について説明します。
admin_client.jar
ユーティリティは、各OC4Jインスタンス内のORACLE_HOME
/j2ee/
instance
ディレクトリにデフォルトでインストールされます。これは、OC4Jで操作を実行する場合の推奨コマンドライン・ツールです。また、このユーティリティは操作をリモートで実行するための管理クライアント・ユーティリティ内にあり、これはOracle Application Server 10gリリース3(10.1.3.5.0)のCDまたはOracle Technology Networkからのダウンロードで入手できます。
このユーティリティがOC4Jインスタンスで操作を実行する前に、インスタンスを起動する必要があります。
次の項目について説明します。
admin_client.jar
ユーティリティは次の構文を使用します。
java -jar admin_client.jar uri adminId adminPassword command
このコマンドラインで渡される重要なパラメータはuri
です。これは、指定するコマンドのターゲットを指定します。URIの構文は、ターゲットのインスタンスによって異なります。このURIの書式は、次の項目を参照してください。
OC4J管理者のユーザー名とパスワードもadmin_client.jar
ユーティリティに渡します。デフォルトの管理者アカウントのユーザー名はoc4jadmin
です。
たとえば、次のコマンドによってpetstore
アプリケーションが起動されます。このアプリケーションは、クラスタのメンバーであるnode1
のoc4j_2
というOC4Jインスタンスにインストールされています。
java -jar admin_client.jar deployer:oc4j:opmn://node1.company.com/oc4j_2 oc4jadmin password -application petstore -start
図11-1は、クラスタ内のOracle Application Serverインスタンスの1つで、OC4J_home
というOC4Jインスタンスから実行するように構成されている4つのプロセスを示しています。
図11-1 クラスタ内のOracle Application Serverインスタンスにおいて複数のJVMで実行中のOC4Jインスタンス
注意: home というOC4Jインスタンスは通常、複数のプロセスで実行するようには構成されません。複数のプロセス・モデルでの実行に適していないApplication Server Controlアプリケーションを、このインスタンスがホスティングするためです。 |
グループ内のすべてのOC4Jインスタンスをデプロイ・ターゲットとして指定する場合は、次のURIを使用します。グループは、同じクラスタ・トポロジに属するOC4Jインスタンスの同期的なセットです。デプロイ操作は、グループ内のすべてのOC4Jインスタンスで同時に実行できます。たとえば、クラスタ内のデフォルト・グループ(default_group
)に属する、すべてのOC4Jインスタンスで同時にデプロイ操作を実行するターゲットとして、default_group
を指定できます。
URIでは、クラスタ・ノードが互いに認識する、OPMNベースのクラスタリング・フレームワークが使用されます。クラスタ内のOracle Application Serverノードに対するホスト名と、オプションでOPMNリクエスト・ポートのみを指定する必要があります。これによってアプリケーションは、クラスタ内の他のノードすべてに対するホスト名およびOPMNポートを取得することが可能になります。
URIの構文は次のとおりです。
deployer:cluster:[rmis]:opmn://opmnHost
[:opmnPort
]/groupName
次に例を示します。
deployer:cluster:opmn://node1.company.com/default_group
表11-1 ターゲットがグループの場合のURIパラメータ
パラメータ | 説明 |
---|---|
rmis |
オプション。ターゲットでORMI over SSL(ORMIS)を利用している場合に指定します。 |
|
必須。クラスタ内のOracle Application Serverノードのホスト名。任意のノードを指定できます。クラスタの他のノードのリストは、このノードから取得されます。 |
|
オプション。 |
|
必須。クラスタ内の、OC4Jインスタンスが属するグループの名前。 |
クラスタ内のインスタンスを含めた、特定のOPMN管理のOC4Jインスタンスをターゲットとする場合は、次の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:6004/instance2/home
表11-2 ターゲットが特定インスタンスの場合のURIパラメータ
パラメータ | 説明 |
---|---|
|
オプション。ターゲットでORMI over SSL(ORMIS)を利用している場合に指定します。 |
|
必須。OPMNサーバーとして使用するクラスタ内の、ターゲットとするOracle Application Serverノードのホスト名。 |
|
オプション。 |
|
オプション。ターゲットとするOracle Application Serverインスタンスの名前( |
|
必須。ターゲットOC4Jインスタンスの名前。 |
スタンドアロンOC4Jサーバー・インスタンスをターゲットとする場合は、次のいずれかのURIを使用します。
RMIを使用する場合、URIを次のように指定します。
deployer:oc4j:host:rmiPort
次に例を示します。
deployer:oc4j:myserver:23791
ORMI over SSL(ORMIS)を使用する場合、URIを次のように指定します。
deployer:oc4j:rmis:host:ormisPort
次に例を示します。
deployer:oc4j:rmis:myserver:23943
表11-3 ターゲットがスタンドアロンOC4Jの場合のURIパラメータ
パラメータ | 説明 |
---|---|
|
ターゲットでORMI over SSL(ORMIS)を利用している場合は必須。 |
|
必須。クラスタ内のOracle Application Serverノードのホスト名。任意のノードを指定できます。クラスタの他のノードのリストは、このノードから取得されます。 |
|
RMIを使用する場合は必須。インスタンス固有の |
|
ORMISを使用する場合は必須。インスタンス固有の |
管理クライアント・ユーティリティのディストリビューションにはadmin_client.jar
コマンドライン・ユーティリティが含まれています。このユーティリティはOC4JまたはOracle Application Serverターゲットに接続し、ライフサイクル、デプロイおよびリソース構成などの一連の操作を実行します。
リモート・システムがOracle Application Serverインスタンスに対して定期的な操作を実行する必要がある場合を想定してください。たとえばリモート・システムに、デプロイ操作や、アプリケーション固有またはサーバーのJMX MBeansの管理目的による問合せや操作など、自動的なビルドまたはテスト・プロセスが存在する場合です。あるいはリモート・システムが、テスト環境から本番環境への移行において定期的にスケジュールされた一連の構成およびデプロイ操作を実行する場合です。管理クライアント・ユーティリティを使用すれば、リモート・システムにOC4JまたはOracle Application Serverをすべてインストールする必要なしに、これらを実行できます。
Oracle Application Server 10gリリース3(10.1.3.5.0)用の独立ディストリビューションである管理クライアント・ユーティリティは、Oracle Technology Networkからダウンロードして、またはOracle Application ServerのCDで入手できます。ディストリビューション・ファイルのoc4j_admin_client_101350.zip
には、OC4Jインスタンスをリモートに管理するために必要な次の要素がすべて含まれています。
OC4JまたはOracle Application ServerターゲットへのORMIプロトコルを使用したリモートJMX接続の確立に必要なJavaライブラリ
運用に必要なライブラリを含む、実行可能なadmin_client.jar
ユーティリティ
リモート・クライアント・ロールに関連する標準J2EEライブラリ
管理クライアント・ユーティリティをダウンロードおよび抽出する手順:
Oracle Technology Networkからoc4j_admin_client_101350.zip
をダウンロードします。
http://download.oracle.com/otn/java/oc4j/10131/oc4j_admin_client_101350.zip
oc4j_admin_client_101350.zip
の内容をローカル・ディレクトリに抽出します。次に例を示します。
>mkdir oc4j_admin_client >cd oc4j_admin_client >jar xvf d:\software\oc4j_admin_client_101350.zip
生成されるディレクトリ構造は次のようになります。
\j2ee \home oc4jclient.jar admin_client.jar \lib ejb.jar mail.jar adminclient.jar javax88.jar javax77.jar jmx_remote_api.jar jmxri.jar \lib xmlparserv2.jar dms.jar \opmn \lib optic.jar \jlib oraclepki.jar ojpse.jar
次のURIは異なるOC4Jターゲットに対して異なるパターンを使用します。
スタンドアロンOC4Jサーバー:
deployer:oc4j:test-cycle.oracle.com:23791
Oracle Application Serverの特定のOC4Jインスタンス:
deployer:oc4j:opmn://test-cycle.oracle.com/testunit
クラスタ内のOC4Jインスタンスのグループ:
deployer:cluster:opmn://test-cycle.oracle.com/[groupName]
admin_client.jar
をターゲットのOC4Jインスタンスに接続し、接続をテストします。次に例を示します。
>cd j2ee\home >java -jar admin_client.jar deployer:oc4j:opmn://test-cycle.oracle.com/testunit oc4jadmin welcome1 –validateURI URI deployer:oc4j:opmn://test-cycle.oracle.com/testunit is valid and connected
admin_client.jar
コマンドに関するオンライン・ヘルプのテキストをコンソールに表示するには、コマンドラインで-help
と入力します。次に例を示します。
java -jar admin_client.jar -help
特定のコマンドに対するヘルプを表示するには、-usage
に続けてコマンド識別子を入力します。次に例を示します。
java -jar admin_client.jar -usage [command]
admin_client.jar
の実行時に発生するエラーのトラブルシューティングのために、このツールの実行時にJavaロギングを有効にすることができます。ログ・メッセージはコンソールに出力されます。
ロギングを有効化する手順は、次のとおりです。
次の1行を含むlogging.properties
ファイルを作成します。
oracle.oc4j.admin.jmx.client.CoreRemoteMBeanServer.level=INFO
このファイルをORACLE_HOME
/j2ee/
instance
以外の場所に作成した場合は、次のコマンドにファイルのパスを指定する必要があります。
admin_client.jar
コマンドラインで次のように-Djava.util.logging.config.file=logging.properties
を設定します。
java -Djava.util.logging.config.file=logging.properties -jar admin_client.jar uri adminId adminPassword command
logging.properties
ファイルの値は、表11-4内のいずれかのJavaログ・レベル値に設定できます。
表11-4 Javaログ・レベル
Javaログ・レベル | 説明 |
---|---|
SEVERE |
システム管理者の注意を要するシステム・エラーをロギングします。 |
WARNING |
確認の必要があり、エラーが発生する前に処理が必要になる可能性がある操作や条件の検出をロギングします。 |
INFO |
通常の操作またはイベントをロギングします。これには、ログイン完了などのユーザー操作や、ログ・ファイルのローテーションなどの自動処理が該当します。 |
CONFIG |
ログ構成に関連するログ・メッセージまたは問題。 |
FINE |
デバッグやパフォーマンス監視に使用されるトレース・メッセージまたはデバッグ・メッセージをロギングします。通常、詳しいイベント・データが含まれます。 |
FINER |
非常に詳細なトレース・メッセージまたはデバッグ・メッセージをロギングします。 |
FINEST |
さらに詳細なトレース・メッセージまたはデバッグ・メッセージをロギングします。 |
次に例を示します。
oracle.oc4j.admin.jmx.client.CoreRemoteMBeanServer.level=FINE
-addWebSite
コマンドを使用して、スタンドアロンOC4Jインスタンスまたはクラスタ内のOC4JインスタンスにWebサイトを追加できます。新しいWebサイトには、デフォルトWebサイトからのデフォルトWebアプリケーションが含まれます。OC4J Webサイトの詳細、およびWebサイトの手動での追加方法は、『Oracle Containers for J2EE構成および管理ガイド』の第13章「OC4JでのWebサイトの管理」を参照してください。
注意: -addWebSite コマンドは、グループ内の複数のOC4JインスタンスにWebサイトを作成する場合には使用できません。 |
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -addWebSite -webSiteName site-name -protocol protocol -port port [-keystorePath path] [-keystorePassword password] [-sslProvider class-name]
次の例では、OC4Jスタンドアロン・インスタンス上にtest-web-site
という名前の新しいWebサイトを作成しています。
java -jar admin_client.jar deployer:oc4j:localhost:23791 oc4jadmin welcome1 -addWebSite -webSiteName test-web-site.xml -protocol http -port 8899
表11-5 -addWebSiteコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。Webサイトの名前。 |
|
必須。Webサイトで使用されるプロトコル。プロトコルは、 |
|
必須。Webサイトで使用されるポート番号。2つのWebサイトで同じポート番号を共有できるのは、 |
|
オプション。キーストア・ファイルのファイル名(パスを含む)。このパラメータは、 |
|
オプション。キーストア・ファイルのパスワード。このパラメータは、 |
|
オプション。サード・パーティ |
admin_client.jar
ユーティリティを使用して、アプリケーション(EARまたはアプリケーション・ディレクトリ)、スタンドアロンWebモジュール(WAR)、スタンドアロンEJBモジュール(JAR)またはスタンドアロン・リソース・アダプタ(RAR)を、特定のOC4JインスタンスまたはOC4Jインスタンス・グループにデプロイすることができます。
次の項目について説明します。
注意: グループに対してアーカイブをデプロイする場合は、すべてのインスタンスのoc4jadmin アカウントのパスワードが同じであることが必要です。 |
-deploy
コマンドを使用して、EARファイルとしてパッケージされたJ2EEアプリケーションや、標準のエンタープライズ・アプリケーション・ディレクトリ構造のJ2EEアプリケーションをデプロイします。J2EEアプリケーションのモジュールは、パッケージすることも、ディレクトリ構造のままにしておくこともできます。構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -deploy -file path/filename -deploymentName appName [-bindAllWebApps [webSiteName]] [-targetPath path] [-parent appName] [-deploymentDirectory path] [sequential [waitsec]] [-enableIIOP] [-iiopClientJar path/filename] [-deploymentPlan path/filename] [-removeArchive]
-bindAllWebApps
パラメータを指定して、アプリケーション内のすべてのWebモジュールを、アクセスに使用するWebサイトにバインドできます。Webサイトを指定しない場合、モジュールはdefault
Webサイトにバインドされます。
たとえば次のコマンドでは、utility
アプリケーションが、クラスタ内のdefault_group
グループに属するすべてのOC4Jインスタンスにデプロイされます。アプリケーションのすべてのWebモジュールは、default
Webサイトにバインドされます。
java -jar admin_client.jar deployer:cluster:opmn://node1.company.com/default_group oc4jadmin password -deploy -file C:/dev/utility.ear -deploymentName utility -bindAllWebApps
また、アプリケーションを標準のJ2EEアプリケーション・ディレクトリ構造でアセンブルすることもできます。-file
パラメータを使用してディレクトリを指定します。次の例では、utility
ディレクトリ内にあるアプリケーションをデプロイしています。
java -jar admin_client.jar deployer:cluster:opmn://node1.company.com/default_group oc4jadmin password -deploy -file C:/dev/utility -deploymentName utility -bindAllWebApps
表11-6 EARデプロイのための-deployコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。デプロイするアーカイブまたはアプリケーション・ディレクトリのファイル・パス。ディレクトリ・ベースのデプロイを使用する場合は、アプリケーション・ディレクトリを標準のJ2EEアプリケーション・ディレクトリ構造でアセンブルする必要があります。 |
|
必須。ユーザー定義のアプリケーション・デプロイ名。OC4J内でのアプリケーションの識別に使用されます。 |
|
オプション。指定したWebサイトにEARのすべてのWebモジュールがバインドされます。指定がない場合、
このパラメータを指定しない場合、デプロイ後に |
|
オプション。EARのデプロイ先のディレクトリ。ディレクトリを指定しない場合、EARはデフォルトで デプロイ済EARファイルもこのディレクトリにコピーされます。連続してデプロイを行うと、毎回このEARファイルが上書きされます。 |
|
オプション。このアプリケーションの親アプリケーション。デフォルトは |
|
オプション。アプリケーションに適用するデプロイ・プランのパスとファイル名。プランは、以前のデプロイ時にXMLファイルとして保存されている場合があります。このファイルはローカル・ホストに存在する必要があります。 |
|
オプション。OC4J固有のデプロイメント・ディスクリプタと生成されるファイル(コンパイル済JSPクラスやEJBラッパー・クラスなど)を含むディレクトリ。 デフォルト・ディレクトリは |
|
オプション。グループ内の各OC4Jインスタンスにアーカイブをデプロイする場合に指定します。各ターゲットOC4Jインスタンスへのデプロイが完了しなければ、次のターゲット・インスタンスへのデプロイは開始されません。OC4JインスタンスにEARがデプロイされている間は、リクエストはそのインスタンスにルーティングされません。
-sequential 15
このパラメータを指定しない場合、デフォルトでグループ内のすべてのOC4Jインスタンスにアーカイブが同時にデプロイされます。 このオプションはクラスタ環境のみで有効です。スタンドアロンOC4Jでは無効です。 |
|
オプション。このパラメータは、IIOPクライアント・スタブをOC4Jサーバーで生成するときに指定します。 すべてのEJBモジュールに対して生成されたアプリケーションレベルのスタブは、 この機能を使用するには、 |
|
オプション。IIOPクライアント・スタブを出力するJARのパスとファイル名。 すべてのEJBモジュールに対して生成されたアプリケーションレベルのスタブは、 また、個別のEJBモジュールに対するスタブは、 この機能を使用するには、 |
|
オプション。デプロイ後にサーバーのファイル・システムからEARファイルを削除する場合に指定します。 |
リモート・クライアントからOracle Application Server上の特定のOC4JインスタンスにEARをデプロイする場合の例を、次に示します。
cd j2ee/home >java -jar admin_client.jar deployer:oc4j:opmn://test-cycle.oracle.com/testunit oc4jadmin welcome1 -deploy -file d:\temp\rupg\testru.ear -deploymentName testru –bindAllWebApps 06/06/20 17:00:16 Notification ==>Uploading file testru.ear ... 06/06/20 17:00:18 Notification ==>Application Deployer for testru STARTS. 06/06/20 17:00:19 Notification ==>Copy the archive to /scratch/sbutton/m1_060618/j2ee/admin/applications/testru.ear 06/06/20 17:00:19 Notification ==>Initialize /scratch/sbutton/m1_060618/j2ee/admin/applications/testru.ear begins... 06/06/20 17:00:19 Notification ==>Unpacking testru.ear 06/06/20 17:00:20 Notification ==>Done unpacking testru.ear 06/06/20 17:00:20 Notification ==>Unpacking testru-web.war 06/06/20 17:00:20 Notification ==>Done unpacking testru-web.war 06/06/20 17:00:20 Notification ==>Initialize /scratch/sbutton/m1_060618/j2ee/admin/applications/testru.ear ends... 06/06/20 17:00:20 Notification ==>Starting application : testru 06/06/20 17:00:20 Notification ==>Initializing ClassLoader(s) 06/06/20 17:00:20 Notification ==>Initializing EJB container 06/06/20 17:00:20 Notification ==>Loading connector(s) 06/06/20 17:00:20 Notification ==>Starting up resource adapters 06/06/20 17:00:20 Notification ==>Initializing EJB sessions 06/06/20 17:00:20 Notification ==>Committing ClassLoader(s) 06/06/20 17:00:20 Notification ==>Initialize testru-web begins... 06/06/20 17:00:20 Notification ==>Initialize testru-web ends... 06/06/20 17:00:21 Notification ==>Started application : testru 06/06/20 17:00:21 Notification ==>Binding web application(s) to site default-web-site begins... 06/06/20 17:00:21 Notification ==>Binding testru-web web-module for application testru to site default-web-site under context root /testru 06/06/20 17:00:22 Notification ==>Binding web application(s) to site default-web-site ends... 06/06/20 17:00:22 Notification ==>Application Deployer for testru COMPLETES. Operation time: 3785 msecs
-deploy
コマンドを使用して、WARファイルとしてパッケージされたスタンドアロンWebモジュールをデプロイします。
注意: -deploy コマンドは、スタンドアロンWebモジュールのディレクトリ・ベースのデプロイをサポートしていません。Webモジュールは、WARファイルとしてパッケージする必要があります。ただし、Webモジュール・ディレクトリが個別のMETA-INF/application.xml ファイルとともにJ2EEアプリケーション・ディレクトリ構造に含まれている場合は、Webモジュールのディレクトリ・ベースのデプロイがサポートされます。この場合は、Webモジュールではなくアプリケーションをデプロイしてください。 |
WAR固有構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -deploy -file path/filename -deploymentName appName [-bindAllWebApps [webSiteName]] [-targetPath path] [-parent appName] [-deploymentDirectory path] [-contextRoot context] [-removeArchive]
WARは、Webモジュール・コンポーネントをまだ含んでいない、他のデプロイ済アプリケーションの子として指定できます。指定しない場合、WARはdefault
アプリケーションにデプロイされます。
WARは、すでにWebモジュールが含まれているアプリケーションの子としてデプロイすることはできません。つまり、acme
アプリケーションにすでにacme-web.war
が含まれる場合は、別のWARファイルをそのアプリケーションにデプロイすることはできません。アプリケーションのEARファイルにWARを再パッケージして、アプリケーションを再デプロイしてください。
次のコマンドでは、node1
をメンバーとして含むクラスタ内のdefault_group
に属するすべてのOC4Jインスタンスで、スタンドアロンacme-web.war
Webモジュールがdefault
アプリケーションにデプロイされます。-bindAllWebApps
パラメータが指定されているため、バインドするWebサイトは指定されていませんが、モジュールはdefault
Webサイトにバインドされます。
java -jar admin_client.jar deployer:cluster:opmn://node1.company.com/default_group oc4jadmin password -deploy -file C:/dev/acme-web.war -deploymentName utility -bindAllWebApps -parent default
表11-7 WARデプロイのための-deployコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。デプロイするアーカイブのパスとファイル名。 |
|
必須。ユーザー定義のWebモジュール名。OC4J内でのモジュールの識別に使用されます。 |
|
オプション。指定したWebサイトにWebモジュールがバインドされます。指定がない場合、
|
|
オプション。アーカイブのデプロイ先のディレクトリ。ディレクトリを指定しない場合、アーカイブはデフォルトで スタンドアロンWARファイルを含む生成済EARファイルもこのディレクトリにコピーされます。連続してデプロイを行うと、毎回このアーカイブが上書きされます。 |
|
オプション。モジュールがデプロイされる親アプリケーション。デフォルトは |
|
オプション。OC4J固有のデプロイメント・ディスクリプタと生成されるファイル(コンパイル済JSPクラスなど)を含むディレクトリ。 デフォルト・ディレクトリは |
|
オプション。Webモジュールのコンテキスト・ルート。Webブラウザを介してアプリケーションにアクセスするときに、URLの最後に付加されます。コンテキスト・ルートを指定しない場合、 たとえば、コンテキスト・ルートとして
|
|
オプション。デプロイ後にサーバーのファイル・システムからWARファイルを削除する場合に挿入します。 |
-deploy
コマンドを使用して、JARファイルとしてパッケージされたスタンドアロンEJBモジュールをデプロイします。構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -deploy -file path/filename -deploymentName jarName [-targetPath path] [-parent appName] [-deploymentDirectory path] [-removeArchive]
次のコマンドでは、node1
をメンバーとして含むクラスタ内のdefault_group
に属するすべてのOC4Jインスタンスで、スタンドアロンacme-ejb.jar
EJBモジュールがdefault
アプリケーションにデプロイされます。
java -jar admin_client.jar deployer:cluster:opmn://node1.company.com/default_group oc4jadmin password -deploy -file C:/dev/acme-ejb.jar -deploymentName acme
表11-8 EAR JARデプロイのための-deployコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。デプロイするアーカイブのパスとファイル名。 |
|
必須。ユーザー定義のEJBモジュール名。OC4J内でのモジュールの識別に使用されます。 |
|
オプション。EJB JARのデプロイ先のディレクトリ。ディレクトリを指定しない場合、EJB JARはデフォルトで デプロイ済EJB JARファイルもこのディレクトリにコピーされます。連続してデプロイを行うと、毎回このEJB JARファイルが上書きされます。 |
|
オプション。EJBモジュールがデプロイされる親アプリケーション。デフォルトは |
|
オプション。OC4J固有のデプロイメント・ディスクリプタが含まれるディレクトリ。デフォルト・ディレクトリは |
|
オプション。デプロイ後にサーバーのファイル・システムからJARファイルを削除します。 |
-deploy
コマンドを使用して、RARファイルとしてパッケージされたJava Connector Architecture準拠のリソース・アダプタをデプロイまたは再デプロイします。リソース・アダプタは、デフォルトでORACLE_HOME
/j2ee/
instance
/connectors
ディレクトリにデプロイされます。
スタンドアロンRARの再デプロイまたはアンデプロイでは、default
アプリケーションの再起動が不要です。
RAR固有構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -deploy -file path/filename -deploymentName connectorName [-nativePathLib path] [-grantAllPermissions] [-removeArchive]
次のコマンドでは、クラスタ内のdefault_group
に属するすべてのOC4Jインスタンスにacme-rar.rar
モジュールがデプロイされます。
java -jar admin_client.jar deployer:cluster:opmn://node1.company.com/default_group oc4jadmin password -deploy -file /dev/acme-rar.rar -deploymentName acme-rar -grantAllPermissions -removeArchive
表11-9 RARデプロイのための-deployコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。デプロイするRARファイルのパスとファイル名。 |
|
必須。ユーザー定義のコネクタ名。OC4J内でのコネクタの識別に使用されます。 |
|
オプション。RARファイル内のネイティブ・ライブラリ(DLLなど)を含むディレクトリのパス。 |
|
オプション。必要であればこのパラメータを指定して、リソース・アダプタでリクエストされるすべてのランタイム権限を付与します。 |
|
オプション。このパラメータは、デプロイ後にサーバーのファイル・システムからRARファイルを削除する場合に挿入します。 |
詳細は、第6章「リソース・アダプタのデプロイ」を参照してください。
デプロイ・コマンドを含むスクリプト・ファイルをadmin_client.jar
コマンドラインで指定できます。-script
コマンドでファイルを指定すると、admin_client.jar
はデプロイメント・マネージャへの1つの接続のみでコマンド・リストを実行します。バッチ・デプロイの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -script filename
スクリプト・ファイルのfilename
には、次の例のような複数の行が含まれます。
-deploy -file /scratch/rpan/apps/hello-planet.ear -deploymentName hello-planet -bindWebApp -appName hello-planet -webModuleName hello-planet-web -stop hello-planet -start hello-planet -redeploy -file /scratch/rpan/apps/hello-planet.ear -deploymentName hello-planet -bindAllWebApps -undeploy hello-planet -validateURI
インストールからスクリプトまたはログを参照し、既存のコンフィギュレーション・アシスタントで使用される関連行を抽出することでバッチ・モードに変換できます。
admin_client.jar
ユーティリティを使用すると、WebサイトへのWebモジュールのバインド、WebサイトからのWebモジュールのアンバインド、およびWebサイトの現在のWebモジュール・バインディングの一覧表示を行うことができます。これらのコマンドは、特定のOC4Jインスタンスに対して実行することも、クラスタ内のOC4Jインスタンス・グループに対して実行することもできます。
次の項目について説明します。
OC4JにデプロイするすべてのWebモジュールは、アクセスに使用されるWebサイトにバインドする必要があります。
通常、EAR内のWARファイルとしてパッケージされたWebモジュールをバインドするのは、EARが-deploy
コマンドの-bindAllWebApps
パラメータを使用してデプロイされるときです。ただし、EARがデプロイされるときに-bindAllWebApps
パラメータが指定されなかった場合は、デプロイ後にモジュールをWebサイトにバインドすることができます。次の項目で詳しく説明します。
-bindAllWebApps
コマンドを使用して、J2EEアプリケーション内のすべてのWebモジュールを、同一のWebサイトまたはデフォルトのdefault-web-site
にバインドします。このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -bindAllWebApps -appName appName -webSiteName siteName -shared true/false -loadOnStartup true/false -accessLog true/false
表11-10 -bindAllWebAppsコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。デプロイ時に指定した親アプリケーションの名前。 |
|
オプション。Webモジュールのバインド先のWebサイト名。 このパラメータを指定しない場合、WebモジュールはターゲットOC4JインスタンスのデフォルトWebサイト( |
|
オプション。HTTPとHTTPSの間でアプリケーションを共有できます。デフォルト値は |
|
オプション。起動時にアプリケーションをロードできます。デフォルト値は |
|
オプション。アプリケーションのアクセス・ロギングを有効化できます。デフォルト値は |
-bindWebApp
コマンドを使用して、J2EEアプリケーション内の特定のWebモジュールを、指定したWebサイトまたはdefault
Webサイトにバインドします。Webモジュールへのアクセスに使用するコンテキスト・ルートを設定することもできます。
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -bindWebApp -appName appName -webModuleName moduleName -webSiteName siteName -contextRoot contextRoot -shared true/false -loadOnStartup true/false -accessLog true/false
表11-11 -bindWebAppコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。デプロイ時に指定した親アプリケーションの名前。 |
|
必須。バインドするWebモジュールの名前。EARファイルに含まれるWARファイルの名前から |
|
オプション。Webモジュールのバインド先のWebサイト名。 このパラメータを指定しない場合、WebモジュールはターゲットOC4JインスタンスのデフォルトWebサイト( |
|
オプション。Webモジュールのコンテキスト・ルート。これは、Webブラウザによるアプリケーションへのアクセスに使用される次のようなURLに付加されます。
コンテキスト・ルートを指定しない場合、親アプリケーションの |
|
オプション。HTTPとHTTPSの間でアプリケーションを共有できます。デフォルト値は |
|
オプション。起動時にアプリケーションをロードできます。デフォルト値は |
|
オプション。アプリケーションのアクセス・ロギングを有効化できます。デフォルト値は |
デプロイ後にWebモジュールをWebサイトからアンバインドできます。WebサイトからすべてのWebモジュールをアンバインドすることも、Webサイトから特定のWebモジュールをアンバインドすることもできます。
-unbindAllWebApps
コマンドを使用して、OC4Jインスタンス内、またはクラスタを構成するOC4Jインスタンス・グループ内のWebサイトから、すべてのWebモジュール・バインディングを削除します。
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -unbindAllWebApps -appName appname [-webSiteName web-site-name]
次の例では、OPMNリクエスト・ポート6003
でリスニングしている複数のOC4Jインスタンスで構成されるクラスタ内のdefault-web-site
という名前のすべてのWebサイトから、hello
アプリケーションに属するすべてのWebモジュールをアンバインドしています。
java -jar admin_client.jar deployer:cluster:opmn://localhost:6003/default_group oc4jadmin welcome1 -unbindAllWebApps -appName hello -webSiteName default-web-site
-unbindWebApp
コマンドを使用して、OC4Jインスタンス内、またはクラスタを構成するOC4Jインスタンス・グループ内の特定のWebサイトから、特定のWebモジュール・バインディングを削除します。
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -unbindWebApp -appName appname -webModuleName web-module-name [-webSiteName web-site-name]
次の例では、OC4Jスタンドアロン・インスタンスのWebサイトdefault-web-site
からhello
アプリケーションのWebモジュールhello-web
をアンバインドしています。
java -jar admin_client.jar deployer:oc4j:localhost:23971 oc4jadmin welcome1 -unbindWebApp -appName hello -webModuleName hello-web
表11-13 -unbindWebAppコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。デプロイ時に指定した親アプリケーションの名前。 |
|
必須。アンバインドするWebモジュールの名前。EARファイルに含まれるWARファイルの名前から |
|
オプション。WebモジュールをアンバインドするWebサイト名。 このパラメータを指定しない場合、WebモジュールはターゲットOC4JインスタンスのデフォルトWebサイト( |
-listWebBindings
コマンドを使用して、OC4Jインスタンス内、またはクラスタを構成するOC4Jインスタンス・グループ内のWebモジュールごとに、Webサイト・バインディングを表示します。デフォルトでは、アプリケーション名、モジュール名、コンテキスト・ルート、Webサイト名の順に情報が表示されます。さらに詳細な情報を表示するには、後述する-verbose
オプションを使用してください。
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -listWebBindings [webSiteName web-site-name][-verbose]
次の例では、OPMNリクエスト・ポート6003
でリスニングしている複数のOC4Jインスタンスで構成されるクラスタ内のdefault-web-site
という名前のすべてのWebサイトにバインドされているWebモジュールの詳細情報が表示されます。
java -jar admin_client.jar deployer:cluster:opmn://localhost:6003/default_group oc4jadmin welcome1 -listWebBindings -webSiteName default-web-site -verbose
-redeploy
コマンドを使用して、以前デプロイしたアーカイブを再デプロイします。
この操作では、正常な再デプロイが実行されます。つまり、アプリケーションが実行中であれば、停止してからアーカイブをアンデプロイします。その後、アプリケーションをデプロイして再起動します。一方、-deploy
コマンドによるアーカイブの再デプロイでは、アプリケーションは停止されません。アンデプロイ、再デプロイおよび再起動が実行されるのみです。
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -redeploy -file path/filename -deploymentName appName [-bindAllWebApps] [-isConnector] [-keepSettings] [-sequential [waitsec]] [-removeArchive]
表11-15 -redeployコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。再デプロイするEAR、WARまたはRARファイルのパスとファイル名。 |
|
必須。ユーザー定義のアプリケーション・デプロイ名。OC4J内でのアプリケーションの識別に使用されます。この値は、サーバー上の既存のアプリケーションの名前と一致する必要があります。 |
|
スタンドアロンRARの再デプロイでは必須。 |
|
オプション。指定したWebサイトにEARのすべてのWebモジュールがバインドされます。指定がない場合、
別の方法として、「WebモジュールとWebサイトのデプロイ後のバインド」の手順に従って、後からすべてのWebモジュールをWebサイトにバインドできます。 |
|
オプション。このパラメータを指定すると、再デプロイされたアプリケーションが、以前のデプロイのデプロイ・プランをフェッチして使用します。アーカイブにパッケージされているデプロイメント・ディスクリプタに設定された値は無視されます。 このパラメータを指定しない場合、アーカイブにパッケージされたデプロイメント・ディスクリプタの値が設定されます。 |
|
オプション。グループ内の各OC4Jインスタンスに順にアーカイブを再デプロイする場合に指定します。各ターゲットOC4Jインスタンスへの再デプロイが完了しなければ、次のターゲット・インスタンスへの再デプロイは開始されません。OC4Jインスタンスにアーカイブが再デプロイされている間は、リクエストはそのインスタンスにルーティングされません。
-sequential 15 このパラメータを指定しない場合、デフォルトでグループ内のすべてのOC4Jインスタンスにアーカイブが同時にデプロイされます。 このオプションはクラスタ環境のみで有効です。スタンドアロンOC4Jでは無効です。 |
|
オプション。デプロイ後にサーバーのファイル・システムからEAR、WARまたはRARファイルを削除する場合に指定します。 |
|
オプション。失敗した再デプロイからのリカバリを可能にします。可能な場合、以前のアーカイブが再デプロイされます。 |
admin_client.jar -redeploy
コマンドの-sequential
パラメータに基づいてグループにアプリケーションを再デプロイする場合、再デプロイ操作は順番に実行されます。再デプロイは、一度に1つのOC4Jインスタンスに対して実行されるため、ターゲット・アプリケーションが完全に停止状態になることはありません。順次再デプロイでは、現在のOC4Jインスタンスに対する再デプロイ操作が完了すると、デプロイメント・マネージャにより、アプリケーション・クラスタのメンバーを実行している次のOC4Jインスタンスに対する再デプロイが即座に開始されます。この結果、次の再デプロイが開始される前に新規アプリケーション・インスタンスを完全にアクティブにするために、システムの安定性が失われる可能性があります。これにより、次の副次的影響が発生する可能性があります。
あるOC4Jインスタンス上でアプリケーションが停止されている間、アプリケーションが他のインスタンスで使用可能であるとmod_oc4j
に通知されるまで、アプリケーションにアクセスできなくなる可能性があります。
セッション・レプリケーション・アクティビティは、実行の機会を失う可能性があります。
一部の環境では、admin_client.jar -redeploy
コマンドでクラスタにアプリケーションを再デプロイする場合に、-sequential
および-keepsettings
パラメータを指定していてもアプリケーションのセッション状態が失われることがあります。
OC4J 10g(10.1.3.5.0)では、-sequential
パラメータのwaitsec
オプションを使用して、アプリケーション・クラスタを実行中の異なるOC4Jインスタンスに対する各再デプロイ間の秒数を指定できます。この遅延により、セッション状態のレプリケーションに十分な時間を確保できます。
オプションのwaitsec
値が指定されると、デプロイメント・マネージャは、グループ内のOC4Jインスタンスに対する各再デプロイ操作間において指定の秒数待機します。この遅延により、システムでは、グループ全体にわたる再デプロイ操作の発生時に安定性を保つことが可能となり、アプリケーションにアクセスできなくなる可能性やセッション状態が失われる可能性が低減します。
たとえば、次のadmin_client.jar -redeploy
コマンドでは、異なるOC4Jインスタンスに対する再デプロイ間に15秒の遅延を指定しています。
java -jar admin_client.jar deployer:cluster:opmn://host:port/home oc4jadmin password -redeploy -file "myapp.ear" -deploymentName rolling -sequential 15 -keepsettings
新しいwaitsec
オプションは、admin_client.jar -deploy
コマンドの-sequential
パラメータにも適用されます。
-undeploy
コマンドを使用して、アプリケーション、スタンドアロンWebモジュール、スタンドアロンEJBモジュールまたはスタンドアロン・コネクタ・モジュールをターゲットOC4Jインスタンスから削除します。次の項目で詳しく説明します。
EAR、スタンドアロンWebモジュールまたはスタンドアロンEJB JARをアンデプロイすると、OC4Jランタイムから削除されます。既存のWebサイトとのバインドも削除されます。
EAR、スタンドアロンWARまたはスタンドアロンEJB JARのアンデプロイの構文を次に示します。アプリケーションまたはモジュールの名前を指定する必要があります。
java -jar admin_client.jar uri adminId adminPassword -undeploy appName
-updateEJBModule
コマンドは、OC4JインスタンスまたはOC4Jインスタンス・グループで実行するアプリケーション内のEJBモジュールの増分再デプロイ、つまり部分的な再デプロイを行います。この機能により、EJB JAR内の変更されたBeanのみを再デプロイすることが可能になります。
注意: CMPまたはBMPエンティティBeanについては、増分再デプロイがアプリケーション全体の再デプロイよりも効率がよい場合がありますが、セッションBean、メッセージドリブンBeanまたはEJB 3.0 JPAエンティティには当てはまりません。この機能を使用する場合の詳細は、「更新されたEJBモジュールの増分再デプロイ」を参照してください。 |
デプロイ済EJBモジュールで変更済クラスを更新する場合の構文を、次に示します。EJB JARが含まれるアプリケーションの名前を指定する必要があります。スタンドアロンEJBモジュールを更新している場合は、default
アプリケーションを指定します。
java -jar admin_client.jar uri adminId adminPassword -updateEJBModule -appName appName -ejbModuleName ejbJarName -file path/ejbJarName
次に例を示します。
java -jar admin_client.jar deployer:cluster:opmn://node1.company.com/default_group oc4jadmin password -updateEJBModule -appName petstore -ejbModuleName customerEjb.jar -file build/customerEjb.jar
admin_client.jar
ユーティリティを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループの共有ライブラリを作成および管理できます。次の項目で詳しく説明します。
-publishSharedLibrary
コマンドを使用して、共有ライブラリのディレクトリ構造を作成し、その構造内のライブラリを構成するバイナリを特定のOC4JインスタンスまたはOC4Jインスタンス・グループにインストールできます。共有ライブラリは、各OC4JインスタンスのORACLE_HOME
/j2ee/
instance
/shared-lib
ディレクトリに作成されます。
また、このコマンドでは、各OC4Jインスタンスのserver.xml
ファイルの<shared-library>
要素で共有ライブラリが宣言され、アプリケーションで使用できるようになります。
共有ライブラリのインストールの構文を次に示します。複数のコード・ソース(共有ライブラリを構成するバイナリ)のパスとファイル名を、それぞれ空白で区切って指定できます。
java -jar admin_client.jar uri adminId adminPassword -publishSharedLibrary -name libName -version libVersion [-parentName parentLibName] [-parentVersion parentLibVersion] [-installCodeSources path [path ...]] [-addCodeSources path [path ...]] [-imports sharedLibName [:min-version][,max-version] [sharedLibName ...]]
次のコマンドでは、クラスタ内のOC4Jインスタンス(default_group
のメンバーすべて)のグループにacme.common:2.5
共有ライブラリがデプロイされます。
java -jar admin_client.jar deployer:cluster:opmn://server.company.com:6004/default_group oc4jadmin password -publishSharedLibrary -name acme.common -version 2.5 -installCodeSources /myserver/tmp/acme-apis.jar /myserver/tmp/acmeImpl.jar
このときターゲットOC4Jサーバー内に生成されるディレクトリ構造は次のようになります。
ORACLE_HOME/j2ee/home/shared-lib
/acme.common
/2.5
acme-apis.jar
acmeImpl.jar
表11-17 -publishSharedLibraryコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。共有ライブラリの名前。 共通APIが複数のベンダーによって実装されている場合、この名前はベンダー名とテクノロジ名の両方を含む必要があります。たとえば、 |
|
必須。共有ライブラリのバージョン番号。この値はコードの実装バージョンを反映するように指定することをお薦めします。 |
|
オプション。親共有ライブラリの名前(該当する場合)。 |
|
オプション。親共有ライブラリのバージョン番号(該当する場合)。 |
|
OC4Jインスタンスにアップロードし、共有ライブラリの一部としてインストールする、1つ以上のJARファイルまたはZIPファイルのパスとファイル名。パス/ファイル名を示す各文字列は空白で区切ります。 |
|
オプション。共有ライブラリに追加するためにOC4Jインスタンスにすでにアップロードされている、JARファイルまたはZIPファイルのパスとファイル名。パス/ファイル名を示す各文字列は空白で区切ります。 |
|
オプション。この共有ライブラリにインポートする1つ以上の既存共有ライブラリの名前。名前を示す各文字列は空白で区切ります。 インポートするライブラリの最大または最小(あるいは両方)のバージョンを指定できます。 |
-modifySharedLibrary
コマンドを使用して、既存の共有ライブラリの内容を変更することができます。また、このコマンドを使用し、各OC4Jインスタンスのserver.xml
ファイルで共有ライブラリの定義を更新することもできます。
既存共有ライブラリの変更の構文を次に示します。複数のコード・ソース(共有ライブラリを構成するバイナリ)のパスとファイル名を、それぞれ空白で区切って指定できます。
java -jar admin_client.jar uri adminId adminPassword -modifySharedLibrary -name libName -version libVersion [-installCodeSources path [path ...]] [-addCodeSources path [path ...]] [-removeCodeSources path [path ...]] [-addImports sharedLibName[:min-version][,max-version] [sharedLibName ...]] [-removeImports sharedLibName[:min-version][,max-version] [sharedLibName ...]]
次のコマンドでは、acme.common:2.5
共有ライブラリが更新されます。
java -jar admin_client.jar deployer:cluster:opmn://server.company.com:6004/default_group oc4jadmin password -modifySharedLibrary -name acme.common -version 2.5 -addCodeSources /myserver/tmp/acme-helpers.jar
表11-18 -modifySharedLibraryコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。更新する共有ライブラリの名前。 |
|
必須。更新する共有ライブラリのバージョン番号。 |
|
オプション。OC4Jインスタンスにアップロードし、共有ライブラリの一部としてインストールする、JARファイルまたはZIPファイルのパスとファイル名。パス/ファイル名を示す各文字列は空白で区切ります。 |
|
オプション。共有ライブラリに追加するためにOC4Jインスタンスにすでにアップロードされている、1つ以上のJARファイルまたはZIPファイルのパスとファイル名。パス/ファイル名を示す各文字列は空白で区切ります。 |
|
オプション。共有ライブラリから削除する1つ以上のJARファイルまたはZIPファイルのパスとファイル名。パス/ファイル名を示す各文字列は空白で区切ります。 |
|
オプション。この共有ライブラリにインポートする1つ以上の既存共有ライブラリの名前。名前を示す各文字列は空白で区切ります。 インポートするライブラリの最大または最小(あるいは両方)のバージョンを指定できます。 |
|
オプション。この共有ライブラリから削除する1つ以上の既存共有ライブラリの名前。 削除するライブラリの最大または最小(あるいは両方)のバージョンを指定できます。 |
-describeSharedLibrary
コマンドを使用して、指定した共有ライブラリを構成する、コード・ソースとインポートされた共有ライブラリを表示します。構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -describeSharedLibrary -name libName -version libVersion
-listSharedLibraries
コマンドを使用して、ターゲットOC4Jインスタンスに定義されているすべての共有ライブラリのリストを出力します。構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -listSharedLibraries
注意: JDK1.4を使用している場合、Oracle Application Server 10gリリース3(10.1.3.5.0)では、共有ライブラリとしてJDKに付属するXalanライブラリの使用はサポートされません。Xalanライブラリを使用する場合、次の2つの代替策があります。
|
-removeSharedLibrary
コマンドを使用して、ターゲットOC4Jインスタンスから共有ライブラリを削除します。構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -removeSharedLibrary -name libName -version libVersion
-addImportSharedLibrary
コマンドを使用して、既存の共有ライブラリをアプリケーションのクラス・ローダーにインポートします。このコマンドは、アプリケーションのorion-application.xml
ディスクリプタに<import-shared-library>
要素を追加することに相当します。このコマンドでは、変更を有効にするためにアプリケーションを再起動する必要があります。共有ライブラリのインストール手順は、「共有ライブラリのインストール」を参照してください。構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -addImportSharedLibrary -appName application -name name -minVer MinVersion -maxVer MaxVersion
次の例では、oracle.jdbc
共有ライブラリをMyapp
という名前のアプリケーションにインポートしています。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -addImportSharedLibrary -appName Myapp -name oracle.jdbc
-deleteImportSharedLibrary
コマンドを使用して、アプリケーションのクラス・ローダーから共有ライブラリを削除します。このコマンドは、アプリケーションのorion-application.xml
ディスクリプタから<import-shared-library>
要素を削除することに相当します。このコマンドでは、変更を有効にするためにアプリケーションを再起動する必要があります。構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -deleteImportSharedLibrary -appName application -name name
次の例では、Myapp
という名前のアプリケーションからoracle.jdbc
共有ライブラリを削除しています。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -deleteImportSharedLibrary -appName Myapp -name oracle.jdbc
-addRemoveInheritedSharedLibrary
コマンドを使用して、アプリケーションのクラス・ローダーが共有ライブラリを継承しないように設定します。このコマンドは、アプリケーションのorion-application.xml
ディスクリプタに<remove-inherited>
要素を追加することに相当します。このコマンドでは、変更を有効にするためにアプリケーションを再起動する必要があります。構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -addRemoveInheritedSharedLibrary -appName application -name name
次の例では、Myapp
という名前のアプリケーションがoracle.jdbc
共有ライブラリを継承しないように設定しています。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -addRemoveInheritedSharedLibrary -appName Myapp -name oracle.jdbc
-deleteRemoveInheritedSharedLibrary
コマンドを使用して、アプリケーションのクラス・ローダーが共有ライブラリを継承できるように設定します。このコマンドは、アプリケーションのorion-application.xml
ディスクリプタから<remove-inherited>
要素を削除することに相当します。このコマンドでは、変更を有効にするためにアプリケーションを再起動する必要があります。構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -deleteRemoveInheritedSharedLibrary -appName application -name name
次の例では、Myapp
という名前のアプリケーションがoracle.jdbc
共有ライブラリを継承できるように設定しています。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -deleteRemoveInheritedSharedLibrary -appName Myapp -name oracle.jdbc
admin_client.jar
ユーティリティを使用して、特定のOC4JインスタンスまたはOC4Jインスタンス・グループ内のアプリケーションおよびその子アプリケーションを起動、再起動または停止できます。また、特定のOC4JインスタンスまたはOC4Jインスタンス・グループ内のデプロイ済アプリケーションのステータスを一覧表示することもできます。この項の内容は次のとおりです。
-start
コマンドを使用して、ターゲットOC4Jインスタンスのアプリケーションおよびその子アプリケーションを起動します。アプリケーション内に更新されたファイルがある場合、それらのアプリケーションは起動時に自動的に再デプロイされます。
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -start appName
-start
コマンドでは、デプロイ時に指定したアプリケーション名が必要となります。次の例では、クラスタ内のnode2
のascontrol
アプリケーションを起動しています。
java -jar admin_client.jar deployer:oc4j:opmn://node2.company.com:6004/home oc4jadmin password -start ascontrol
-stop
コマンドを使用して、ターゲットOC4Jインスタンスのアプリケーションおよびその子アプリケーションを停止します。デフォルトでは、アプリケーションが即時に停止されます。現在処理中のリクエストはすべて失われます。計画的に停止する場合は、停止前にリクエストの処理を完了するための時間をアプリケーションに設定することもできます。
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -stop appName [-timeout timeInSeconds] [-graceful true|false]
-stop
コマンドでは、デプロイ時に指定したアプリケーション名が必要となります。次の例では、クラスタ内のnode2
のascontrol
アプリケーションを停止しています。アプリケーションが強制的に停止されるまでに、リクエストを完了するための時間が5秒設定されています。
java -jar admin_client.jar deployer:oc4j:opmn://node2.company.com:6004/home oc4jadmin password -stop ascontrol -timeout 5
表11-25 -stopコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
オプション。アプリケーションの正常な停止を待機する時間。タイムアウトに達すると、アプリケーションは強制的に停止されます。タイムアウトが指定されていない場合、デフォルトのタイムアウトは |
|
オプション。gracefulオプションは、アプリケーションの停止に使用される方法を指定します。値
|
-restartApp
コマンドを使用して、ターゲットOC4Jインスタンスのアプリケーションおよびその子アプリケーションを停止してから起動します。アプリケーション内に更新されたファイルがある場合、それらのアプリケーションは起動時に自動的に再デプロイされます。デフォルトでは、アプリケーションが即時に停止されます。現在処理中のリクエストはすべて失われます。計画的に停止する場合は、停止前にリクエストの処理を完了するための時間をアプリケーションに設定することもできます。
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -restartApp appName [-timeout timeInSeconds] [-graceful true|false]
-restartApp
コマンドでは、デプロイ時に指定したアプリケーション名が必要となります。次の例では、クラスタ内のnode2
のascontrol
アプリケーションを再起動しています。アプリケーションが強制的に停止されてから起動されるまでに、リクエストを完了するための時間が5秒設定されています。
java -jar admin_client.jar deployer:oc4j:opmn://node2.company.com:6004/home oc4jadmin password -restartApp ascontrol -timeout 5
表11-26 -restartAppコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
オプション。アプリケーションの正常な停止を待機する時間。タイムアウトに達すると、アプリケーションは強制的に停止されます。タイムアウトが指定されていない場合、デフォルトのタイムアウトは |
|
オプション。gracefulオプションは、アプリケーションの停止に使用される方法を指定します。値
|
-listApplications
コマンドを使用して、OC4Jインスタンス内、またはクラスタを構成するOC4Jインスタンス・グループ内に現在デプロイされているアプリケーションのステータスを表示します。デフォルトでは、アプリケーション名、中に含まれているモジュール、アプリケーション・タイプ、アプリケーションの状態、親アプリケーションの順にステータス情報が表示されます。さらに詳細な情報を表示するには、後述する-verbose
オプションを使用してください。
このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -listApplications [-verbose]
次の例では、OPMNリクエスト・ポート6003
でリスニングしている複数のOC4Jインスタンスで構成されるクラスタ上にデプロイされたアプリケーションの詳細情報が表示されます。
java -jar admin_client.jar deployer:cluster:opmn://localhost:6003/default_group oc4jadmin welcome1 -listApplications -verbose
admin_client.jar
ユーティリティを使用して、スタンドアロンOC4Jサーバー、管理環境内の特定のOC4Jインスタンス、またはOC4Jインスタンス・グループを停止できます。-shutdown
コマンドは指定したOC4Jインスタンスをシャットダウンし、あらゆるOPMN管理インスタンスに対してシャットダウン中であることをOPMNに通知します。-restart
コマンドは指定したインスタンスを再起動します。
これらのコマンドの構文および例について、次の項目で説明します。
admin_client.jar
-restart
コマンドを次のように使用して、OC4JインスタンスまたはOC4Jインスタンス・グループを再起動します。
java -jar admin_client.jar uri adminId adminPassword -restart
たとえば、次のコマンドではスタンドアロンOC4Jサーバーが再起動します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin password -restart
次のコマンドでは、クラスタ・トポロジ内の各Oracle Application Serverにおけるdefault_group
のメンバーすべてのOC4Jインスタンスが再起動します。
java -jar admin_client.jar deployer:cluster:opmn://node1.company.com/default_group oc4jadmin password -restart
admin_client.jar
-shutdown
コマンドを次のように使用して、OC4JインスタンスまたはOC4Jインスタンス・グループを停止します。
java -jar admin_client.jar uri adminId adminPassword -shutdown
たとえば、次のコマンドではスタンドアロンOC4Jサーバーが停止します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin password -shutdown
このコマンドは、まるでホスト・マシンの電源プラグが抜かれたかのように、OC4Jサーバー全体をシャットダウンしてすべてのスレッドを即座に終了します。このコマンドを使用すると、クラスタ化アプリケーションの現在の状態はレプリケートされません。
次のコマンドは、OPMN管理のOracle Application Server環境で指定したOC4Jインスタンスを停止します。
java -jar admin_client.jar deployer:oc4j:opmn://localhost/home oc4jadmin password -shutdown
次のコマンドでは、クラスタ・トポロジ内の各Oracle Application Serverにおけるdefault_group
のメンバーすべてのOC4Jインスタンスが停止します。
java -jar admin_client.jar deployer:cluster:opmn://node1.company.com/default_group oc4jadmin password -shutdown
これらのコマンドは指定したインスタンスをシャットダウンし、すべてのスレッドを即座に終了します。-shutdown
コマンドを使用すると、クラスタ化アプリケーションの現在の状態はレプリケートされません。OPMN管理の各OC4Jインスタンスについて、admin_client.jar
はOPMNにサーバーが意図的にシャットダウンされていることを通知します。これは、OPMNが再起動を行わないようにするためです。
admin_client.jar
ユーティリティを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループのデータソースを管理できます。次の項目で詳しく説明します。
admin_client.jar
ユーティリティを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループのデータソース接続プールを追加、テスト、一覧表示および削除できます。次の項目で詳しく説明します。
-addDataSourceConnectionPool
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各OC4Jインスタンスのアプリケーションに対するデータソース接続プールを追加します。
データソース接続プールの追加の構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -addDataSourceConnectionPool -applicationName applicationName -name name -factoryClass factoryClass -dbUser dbUser -dbPassword dbPassword -url url [-factoryProperties name1 value1 [name2 value2 [...]]]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -addDataSourceConnectionPool -applicationName default -name ScottConnectionPool -factoryClass oracle.jdbc.pool.OracleDataSource -dbUser scott -dbPassword tiger -url jdbc:oracle:thin:@localhost:1521:xe
表11-28 -addDataSourceConnectionPoolコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。データソース接続プールを追加する対象のアプリケーションの名前。 |
|
必須。接続プールの名前。 |
|
必須。コネクション・ファクトリ実装の完全修飾パス。 |
|
必須。接続するときに使用するデフォルトのユーザー名。 |
|
必須。接続するときに使用するデフォルトのパスワード。 |
|
必須。接続するときに使用するコネクション・ファクトリのURL。 |
|
オプション。コネクション・ファクトリ定義で設定する1つ以上のプロパティの名前/値ペア。 |
-testDataSourceConnectionPool
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各OC4Jインスタンスのデータソース接続プールに対するアプリケーションの接続をテストします。
データソース接続プールへの接続テストの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -testDataSourceConnectionPool -name name -sqlStatement sqlStatement [-applicationName applicationName] [-dbUser dbUser] [-dbPassword dbPassword]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -testDataSourceConnectionPool -sqlStatement "select * from dual" -applicationName default -name ScottConnectionPool
-listDataSourceConnectionPools
コマンドを使用して、アプリケーションに構成されているデータソース接続プールのリストを表示します。リストには、各接続プールに構成されているプロパティが表示されます。
データソース接続プールの一覧表示の構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -listDataSourceConnectionPools [-applicationName applicationName]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost:23791 oc4jadmin oc4j -listDataSourceConnectionPools -applicationName default
-removeDataSourceConnectionPool
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各OC4Jインスタンスのアプリケーションからデータソース接続プールを削除します。データソース接続プールの削除の構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -removeDataSourceConnectionPool -name name [-applicationName applicationName]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -removeDataSourceConnectionPool -name ScottConnectionPool -applicationName default
admin_client.jar
ユーティリティを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループのデータソースを追加、テスト、一覧表示および削除できます。次の項目で詳しく説明します。
-addManagedDataSource
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各OC4Jインスタンスのアプリケーションに対するマネージド・データソースを追加します。マネージド・データソースの追加の構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -addManagedDataSource -applicationName applicationName -name name -jndiLocation jndiLocation -connectionPoolName connectionPoolName [-dbUser dbUser] [-dbPassword dbPassword] [-loginTimeout loginTimeout] [-txLevel txLevel] [-dbSchema dbSchema] [-manageLocalTransactions true|false]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -addManagedDataSource -applicationName default -name ScottDataSource -jndiLocation jdbc/ScottDataSource -connectionPoolName ScottConnectionPool
表11-32 -addManagedDataSourceコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。データソースを追加する対象のアプリケーションの名前。 |
|
必須。データソースの名前。 |
|
必須。新規のデータソースをJNDIにバインドする際に使用する場所。 |
|
必須。データソースが対応する接続プールの名前。 |
|
オプション。新規のデータソースに対するデフォルトのユーザー。 |
|
オプション。新規のデータソースに対するデフォルトのパスワード。 |
|
オプション。新規のデータソースに対するログイン・タイムアウト。 |
|
オプション。トランザクション・レベル( |
|
オプション。使用中のEJB CMP実装がOrion CMPの場合に使用するデータベース・スキーマ。(TopLink CMPがデフォルトです。) |
|
オプション。OC4Jでローカル・トランザクションを管理するかどうか示します。デフォルト値は |
-removeManagedDataSource
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各OC4Jインスタンスのアプリケーションからマネージド・データソースを削除します。マネージド・データソースの削除の構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -removeManagedDataSource -name name [-applicationName applicationName]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -removeManagedDataSource -name ScottDataSource -applicationName default
-addNativeDataSource
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各OC4Jインスタンスのアプリケーションに対するネイティブ・データソースを追加します。ネイティブ・データソースの追加の構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -addNativeDataSource -name name -dbUser dbUser -dbPassword dbPassword -jndiLocation jndiLocation -loginTimeout loginTimeout -dataSourceClass dataSourceClass -url url [-applicationName applicationName] [-properties name1 value1 [name2 value2 ][...]]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -addNativeDataSource -name ScottDataSource -dbUser scott -dbPassword tiger -jndiLocation jdbc/ScottNativeDataSource -loginTimeout 5 -dataSourceClass com.acme.DataSourceImpl -url jdbc:oracle:thin:@localhost:1521:xe
表11-34 -addNativeDataSourceコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。新規のデータソースの名前。 |
|
必須。新規のデータソースに対するデフォルトのユーザー。 |
|
必須。新規のデータソースに対するデフォルトのパスワード。 |
|
必須。新規のデータソースをJNDIにバインドする際に使用する場所。 |
|
必須。新規のデータソースに対するログイン・タイムアウト。 |
|
必須。新規のデータソースの完全修飾クラス。 |
|
必須。新規のデータソースでデータベースへの接続に使用されるURL。 |
|
オプション。データソースを追加する対象のアプリケーションの名前。 |
|
オプション。新規のデータソースに対するプロパティ。 |
-removeNativeDataSource
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各OC4Jインスタンスのアプリケーションからネイティブ・データソースを削除します。ネイティブ・データソースの削除の構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -removeNativeDataSource -name name [-applicationName applicationName]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -removeNativeDataSource -name ScottDataSource
-testDatabaseConnection
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各OC4Jインスタンスのデータベースに対するアプリケーションの接続をテストします。
データベース接続のテストの構文を次に示します。
java -jar admin_client.jar uri adminId adminPassword -testDatabaseConnection -sqlStatement sqlStatement -factoryClass factoryClass -dbUser dbUser -dbPassword dbPassword -url url [-applicationName applicationName]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -testDatabaseConnection -sqlStatement "select * from dual" -factoryClass oracle.jdbc.pool.OracleDataSource -dbUser scott -dbPassword tiger -url jdbc:oracle:thin:@localhost:1521:xe -applicationName default
表11-36 -testDatabaseConnectionコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。接続のテストに使用するSQL文。 |
|
必須。テストするJDBCファクトリ( |
|
必須。接続のテストに使用するユーザー名。 |
|
必須。接続のテストに使用するパスワード。 |
|
必須。JDBCファクトリで設定するURL。 |
|
オプション。アプリケーションの名前。 |
-testDataSource
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各OC4Jインスタンスのデータソースに対するアプリケーションの接続をテストします。
データソースのテストの構文を次に示します。
java -jar admin_client.jar uri adminId adminPassword -testDataSource -name name -sqlStatement sqlStatement [-applicationName applicationName] [-dbUser dbUser] [-dbPassword dbPassword]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -testDataSource -name ScottDataSource -sqlStatement "select * from dual" -applicationName default -dbUser scott -dbPassword tiger
-listDataSources
コマンドを使用して、アプリケーションに構成されているデータソースのリストを表示します。リストには、各データソースに構成されているプロパティが表示されます。
データソースの一覧表示の構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -listDataSources [-applicationName applicationName]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost:23791 oc4jadmin oc4j -listDataSources -applicationName default
admin_client.jar
ユーティリティを使用して、OC4JインスタンスまたはOC4Jインスタンス・グループのJMSリソースを管理できます。次の項目で詳しく説明します。
admin_client.jar
ユーティリティを使用してOC4J JMSコネクション・ファクトリを管理します。次の項目で詳しく説明します。
-addJMSConnectionFactory
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のグループの各インスタンスにJMSコネクション・ファクトリを追加します。このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -addJMSConnectionFactory
-domain domain -jndiLocation jndiLocation [-host host
] [-port port]
[-username username] [-password password] [-clientID clientID] [-isXA true|false]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -addJMSConnectionFactory -domain Queue -jndiLocation jms/ExampleQueueCF
表11-40 -addJMSConnectionFactoryコマンドのパラメータ
パラメータ | 説明 |
---|---|
|
必須。このコネクション・ファクトリのJMSドメイン( |
|
必須。このコネクション・ファクトリがバインドされるJNDIロケーション。 |
|
オプション。このコネクション・ファクトリに関連付けられているホスト名(デフォルトは対象のOC4J JMSサーバー・ホスト)。 |
|
オプション。このコネクション・ファクトリに関連付けられているポート番号(デフォルトは対象のOC4J JMSサーバー・ポート)。 |
|
オプション。このコネクション・ファクトリに関連付けられているユーザー名(デフォルトは |
|
オプション。このコネクション・ファクトリに関連付けられているパスワード(デフォルトはNULL)。 |
|
オプション。このコネクション・ファクトリに関連付けられているJMSクライアントID(デフォルトはNULL)。 |
|
オプション。これがXAコネクション・ファクトリかどうかを示します(デフォルトは |
-removeJMSConnectionFactory
コマンドを使用して、OC4JインスタンスからJMSコネクション・ファクトリを削除します。このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -removeJMSConnectionFactory -jndiLocation jndiLocation
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -removeJMSConnectionFactory -jndiLocation jms/ExampleQueueCF
-getJMSConnectionFactories
コマンドを使用して、OC4Jインスタンスまたはクラスタ内のOC4Jインスタンス・グループの各JMSコネクション・ファクトリに対する属性を返します。このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -getJMSConnectionFactories
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -getJMSConnectionFactories
admin_client.jar
ユーティリティを使用してOC4J JMS宛先を管理します。次の項目で詳しく説明します。
-addDestination
コマンドを使用してJMS宛先を追加します。このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -addDestination -domain domain -namename
-jndiLocation jndiLocation [-persistenceFilepersistenceFile
] [-description description]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -addDestination -domain Queue -name ExampleQueue -jndiLocation jms/ExampleQueue
-removeDestination
コマンドを使用して、OC4Jインスタンスまたはグループの各OC4JインスタンスからJMS宛先を削除します。このコマンドの構文は次のとおりです。
java -jar admin_client.jar uri adminId adminPassword -removeDestination
-name name
[-force true|false] [-removePFile true|false]
次に例を示します。
java -jar admin_client.jar deployer:oc4j:localhost oc4jadmin welcome1 -removeDestination -name ExampleQueue -removePFile true
「リモート管理クライアントのダウンロードと抽出」の説明にあるとおり、リモート管理クライアント・ユーティリティからファイルをインストールした後で、リモート・クライアントを使用してOC4Jを管理できます。次に、コマンドライン・ツールまたはJMXリモートAPIからadmin_client.jar
を使用できます。
OC4Jアプリケーション・サーバー・ターゲットに接続した後、「リモート管理クライアントのダウンロードと抽出」の説明にあるとおり、リモート・クライアントからadmin_client.jar
コマンドを発行できます。OC4Jインスタンス内から使用する構文と同じ構文を使用します。
JConsoleはJDK 5.0に含まれているJMX GUIコンソールです。JConsoleはあらゆるJVMに接続して実行中のMBeanServerにつながり、JVMのスレッドおよびメモリー使用量など、システムの様々な詳細が表示される一連のページを表示します。JConsoleはローカルJVMに接続します。また、JMXリモートAPIを使用してリモートJVMに接続することもできます。
管理クライアント・ユーティリティのディストリビューションには、JConsoleによるリモートOC4JまたはOracle Application Serverインスタンスへの接続に必要なライブラリが含まれています。ターゲット・インスタンスに接続するには、管理クライアント・ユーティリティのディストリビューションの関連する詳細によって、JConsoleユーティリティ(Windows環境でネイティブの実行可能ファイルとして提供される)を構成する必要があります。
Oracle Application Serverインスタンスに接続する手順は、次のとおりです。
/j2ee/
instance
/admin_client.jar
をCLASSPATH環境変数に追加します。
set CLASSPATH=j2ee/home/admin_client.jar
JConsoleライブラリをCLASSPATH環境変数に追加します。
set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\lib\jconsole.jar set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\lib\tools.jar
OC4J ORMIプロトコルを使用するようにJMXコネクタを構成します。
set PROPS= jmx.remote.protocol.provider.pkgs=oracle.oc4j.admin.jmx.remote
jconsoleを実行します。
%JAVA_HOME%\bin\jconsole -J-Djava.class.path=%CLASSPATH% -J-D%PROPS%
これによってJConsoleが起動します。
「エージェントに接続」画面の「詳細」タブで、OC4JまたはOracle Application Serverターゲットに対する接続文字列と、同様にターゲットに対する管理者のユーザー名およびパスワードも入力します。
OC4Jに対するJMX URLのパターンは、Oracle Application Serverターゲットに対するパターンとは異なります。表11-44にこれらのURLパターンの例を示します。
表11-44 OC4JおよびOracle Application Serverターゲットに対するJMX URL
ターゲット | JMX URL |
---|---|
スタンドアロンOC4Jサーバー |
|
Oracle Application Server上のOC4Jインスタンス |
|
Oracle Application Serverクラスタ |
service:jmx:rmis:///opmn://stadp69:6003/cluster/as101/admin |
JConsoleユーティリティはターゲット・インスタンスからOC4J MBeansを表示します。これらのMBeansはOC4Jインスタンスの構成の表示および管理に使用できます。
Windows環境では、JConsoleで使用される環境は特定のシステム・プロパティ・フォームを使用して変更できます。
-J-Dname=value
サンプルのコマンド・スクリプトを次に示します。
setlocal set URL=service:jmx:rmi:///opmn://test-cycle.oracle.com:6010/testunit set JAVA_HOME=C:\java\jdk150_07 set JCONSOLE_CPset JCONSOLE_CP=%JCONSOLE_CP%;%JAVA_HOME%\lib\jconsole.jar set JCONSOLE_CP=%JCONSOLE_CP%;%JAVA_HOME%\lib\tools.jar set ORACLE_HOME=D:\oc4j_admin_client set ORACLE_CP= set ORACLE_CP=%ORACLE_CP%;%ORACLE_HOME%\j2ee\home\admin_client.jar; set CLASSPATH=%JCONSOLE_CP%;%ORACLE_CP% set PROPS= set PROPS=%PROPS% -J-Djmx.remote.protocol.provider.pkgs=oracle.oc4j.admin.jmx.remote set PROPS=%PROPS% -J-Djava.class.path=%CLASSPATH% jconsole %PROPS% %URL% endlocal
管理クライアント・ユーティリティのディストリビューションでは、JMXクライアント・アプリケーションがリモートOC4Jインスタンスに接続するための完全なクライアント環境が提供されます。JMXのプログラム的クライアントを使用して、MBeanServerへの接続を確立できるJMXリモートAPI(JSR160)からOC4Jをリモートで管理できます。JDK 5.0による実行が必要なJARファイルは、管理クライアント・ユーティリティのディストリビューションが提供するoc4jclient.jar
とadmin_client.jar
のみです。
次の例では、これらのJARファイルをJMX APIで使用しています。
// A URL is of the form "service:jmx:rmi://127.0.0.1:23791" JMXServiceURL serviceURL = new JMXServiceURL(_url); Hashtable credentials = new Hashtable(); credentials.put("login", _username); credentials.put("password", _password); // Properties required to use the OC4J ORMI protocol Hashtable env = new Hashtable(); env.put(JMXConnectorFactory.PROTOCOL_PROVIDER_PACKAGES, "oracle.oc4j.admin.jmx.remote"); env.put(JMXConnector.CREDENTIALS, credentials); JMXConnector jmxCon = JMXConnectorFactory.newJMXConnector(serviceURL, env); jmxCon.connect(); MBeanServerConnection mbeanServer = jmxCon.getMBeanServerConnection();
JDK 5.0ではこのコードはOracleライブラリを必要とせず、JDKで提供されるライブラリのみでコンパイルします。
clear @echo off @setlocal set J2EE_HOME=c:\java\oc4j-1013-prod\j2ee\home set JAVA_HOME=c:\java\jdk50 set CLASSPATH=. rem rem Uncomment below if using JDK14 rem set CLASSPATH=%CLASSPATH%;%J2EE_HOME%\lib\jmxri.jar rem set CLASSPATH=%CLASSPATH%;%J2EE_HOME%\lib\jmx_remote_api.jar rem set CLASSPATH=%CLASSPATH%;%J2EE_HOME%\lib\javax77.jar rem %JAVA_HOME%\bin\javac -classpath %CLASSPATH% -d . *.java @endlocal
oc4j_admin_client_101350.zip
ディストリビューションでコードを実行する手順は、次のとおりです。
実行可能なJARファイルを作成します。
そのJARファイルを管理クライアント・ユーティリティのディストリビューションのj2ee/home
ディレクトリに置きます。
リモートOC4Jインスタンスに接続します。
コードがJDK 5.0で$ORACLE_HOME/j2ee/home/oc4jclient.jar
および$ORACLE_HOME/j2ee/home/admin_client.jar
とともに実行されます。
@echo off @setlocal clear set J2EE_HOME=c:\java\oc4j-1013-prod\j2ee\home set JAVA_HOME=c:\java\jdk50 rem Runtime classpath set CLASSPATH=. set CLASSPATH=%CLASSPATH%;%J2EE_HOME%\oc4jclient.jar; set CLASSPATH=%CLASSPATH%;%J2EE_HOME%\admin_client.jar; rem rem Uncomment if using JDK14 rem set CLASSPATH=%CLASSPATH%;%J2EE_HOME%\lib\jmxri.jar rem set CLASSPATH=%CLASSPATH%;%J2EE_HOME%\lib\jmx_remote_api.jar rem set CLASSPATH=%CLASSPATH%;%J2EE_HOME%\lib\javax77.jar @endlocal
例のメイン・メソッド内の接続URLは、ローカルOC4Jインスタンスに接続するように設定されています。ORMIポートからOracle Application Serverに接続する場合は、次のフォームのサービスURLを使用します。
service:jmx:rmi|ormi:///opmn://stadp57.us.oracle.com:6003/home
サービスURLはOPMNデーモンからORMIポートを取得します。ORMIポートは実行時に割り当てられます。OPMN接続文字列パスを使用すると、指定したOC4Jインスタンスに接続できます。
OC4Jインスタンスをリモートで管理するためのJMXクライアントの使用方法の詳細は、『Oracle Containers for J2EE開発者ガイド』のJMXリモートAPI(JSR-160)を使用するリモート管理に関する項を参照してください。