| Oracle® Complex Event Processing管理者ガイド 11g リリース1(11.1.1.4.0) B61653-02 |
|
 前 |
 次 |
この章の内容は次のとおりです。
Deployerは、管理者や開発者がOracle CEPアプリケーションのデプロイ操作をコマンドラインで実行するためのJavaベースのデプロイメント・ユーティリティです。Oracle CEPデプロイメントのコンテキストでは、アプリケーションは次のアーティファクトを含むOSGiバンドルJARファイルとしてhttp://www.osgi.org/で定義されます。
アダプタ、アダプタ・ファクトリ、ビジネス・ロジックを格納したPOJOなど、アプリケーションのいくつかのコンポーネントを実装するコンパイル済Javaクラス・ファイル。
プロセッサ、アダプタ、ストリームなど、アプリケーションのコンポーネントを構成する1つまたは複数のOracle CEP構成XMLファイル。
構成ファイルは、OSGiバンドルJARファイルのMETA-INF/wlevsディレクトリにある必要があります。
アプリケーションのすべてのコンポーネントと、各コンポーネントが相互にどのように接続されているかを記述したEPNアセンブリ・ファイル。EPNアセンブリ・ファイルは標準のSpringコンテキスト・ファイルを拡張します。
EPNアセンブリ・ファイルは、OSGiバンドルJARファイルのMETA-INF/springディレクトリにある必要があります。
JARファイルのコンテンツを記述するMANIFEST.MFファイル。
このデプロイメント・バンドルを作成する方法の詳細は、『Oracle Complex Event Processing開発者ガイドfor Eclipse』のOracle CEPアプリケーションのアセンブリに関する項を参照してください。
デプロイヤ・ユーティリティはHTTPを使用してOracle CEPに接続します。つまり、アプリケーションのデプロイ先となるサーバー・インスタンスに応じてJettyを構成する必要があります。詳細は、『Oracle Complex Event Processing管理者ガイド』のJettyの構成に関する項を参照してください。
Oracle CEPは、deployments.xmlファイルを使用して、デプロイ済アプリケーションのOSGiバンドルのリストを内部的に維持します。このファイルはDOMAIN_DIR/servernameディレクトリにあります。DOMAIN_DIRはメイン・ドメイン・ディレクトリであり、アプリケーションのデプロイ先となるサーバー・インスタンスに対応します。servernameはサーバー・インスタンス自体です。詳細は、『Oracle Complex Event Processing開発者ガイドfor Eclipse』のOracle CEPスキーマに関する項を参照してください。
|
警告: deployments.xmlファイルのXSDは、あくまでも参考として示しています。deployments.xmlファイルを手動で更新することは、お薦めしません。 |
デプロイヤ・ユーティリティを使用する前に、環境を適切に構成する必要があります。
デプロイヤ・ユーティリティ環境を構成するには:
『Oracle Complex Event Processingスタート・ガイド』のOracle CEPのインストールに関する項で説明されているように、Oracle CEPソフトウェアをインストールして構成します。
コマンド・ウィンドウを開き、『Oracle Complex Event Processingスタート・ガイド』の開発環境の設定に関する項で説明されているように、環境を設定します。
ORACLE_CEP_HOME/ocep_11.1/binディレクトリにあるwlevsdeploy.jar JARファイルを含むようにCLASSPATH変数を更新します。ORACLE_CEP_HOMEは、/oracle_cepなどのOracle CEPメイン・インストール・ディレクトリです。
Oracle CEPをインストールして実行しているコンピュータとは別のコンピュータでDeployerユーティリティを実行すると便利な場合があります。
リモートでデプロイヤ・ユーティリティを実行するには:
Oracle CEPがインストールされているコンピュータからデプロイヤ・ユーティリティを実行するコンピュータに、次のJARファイルをコピーします。JARファイルのコピー先のディレクトリ名は、任意の名前とすることができます。
ORACLE_CEP_HOME/ocep_11.1/bin/wlevsdeploy.jar
ここで、ORACLE_CEP_HOMEは、Oracle CEPをインストールする先のメイン・ディレクトリを示します。
次のいずれかの方法でCLASSPATHを設定します。
ユーティリティを実行するときに、-jar引数を使用してCLASSPATHを暗黙的に設定します。つまり、この引数でNEW_DIRECTORY/wlevsdeploy.jarファイルを設定します。NEW_DIRECTORYは、必要なJARファイルをコピーしたリモート・コンピュータ上のディレクトリです。-jar引数を使用するときは、コマンド・ラインでDeployerユーティリティ名を指定しません。
リモート・コンピュータにコピーしたJARファイルをCLASSPATH環境変数に追加することにより、明示的にCLASSPATHを更新します。
次の項の説明に従ってDeployerユーティリティを起動します。
デプロイヤ・ユーティリティを使用するための構文は次のとおりです。
java -jar wlevsdeploy.jar
[Connection Arguments]
[User Credential Arguments]
[Deployment Commands]
次の項では、デプロイヤ・ユーティリティで使用できる様々な引数およびコマンドについて説明します。このユーティリティの具体的な使用方法の例については、付録B「デプロイヤ・ユーティリティの使用例」を参照してください。
表B-1は、デプロイヤ・ユーティリティで指定できる接続引数を示しています。
表B-1 接続引数
| 引数 | 説明 |
|---|---|
-url url
|
OSGIバンドルのデプロイ先となるOracle CEPインスタンスのデプロイヤのURLを指定します。 URLは次の形式にします。 http://host:port/wlevsdeployer 説明:
たとえば、Oracle CEPがホスト http://ariel:9002/wlevsdeployer |
表B-2は、デプロイヤ・ユーティリティで指定できるユーザー資格証明の引数を示しています。
表B-3は、デプロイヤ・ユーティリティで使用できるデプロイメント・コマンドを示しています。
表B-3 デプロイメント・コマンド
| コマンド | 説明 |
|---|---|
-install bundle
|
指定したOracle CEPインスタンスに、指定したOSGiバンドルをインストールします。
バンドルが置かれている場所が、デプロイヤ・ユーティリティを実行しているディレクトリに対して相対的なディレクトリではない場合、バンドルのフルパス名を必ず指定してください。 特に、Oracle CEPでは次の処理が行われます。
|
-update bundle
|
既存のOSGiバンドルを新しいアプリケーション・コードで更新します。
バンドルが置かれている場所が、デプロイヤ・ユーティリティを実行しているディレクトリに対して相対的なディレクトリではない場合、バンドルのフルパス名を必ず指定してください。 特に、Oracle CEPでは次の処理が行われます。
|
-uninstall name
|
指定したOracle CEPインスタンスから既存のバンドルを削除します。
Bundle-SymbolicName: myApp 特に、Oracle CEPでは次の処理が行われます。
|
-suspend name
|
指定したOracle CEPインスタンスにインストール済みで現在実行中のOSGIバンドルを中断します。
Bundle-SymbolicName: myApp |
-resume name
|
指定したOracle CEPインスタンス上で中断されたOSGIバンドルを再開します。構成されたアダプタが再びただちに着信データを受信し始めます。
Bundle-SymbolicName: myApp |
-group groupname
|
デプロイ・コマンド(install、uninstall、update、中断、または再開)をターゲット・グループ(具体的には、そのグループ内の一連の実行中サーバー)に適用することを指定します。 ドメイン・グループを指定するには、次のようにキーワード -group all カスタム・グループを指定するには、単純にグループの名前を指定します: -group my_group 注意: サーバーがマルチサーバー・ドメインの一部である場合(つまり、クラスタリングが有効な場合)、グループに対してのみデプロイできます。サーバーがスタンドアロン・サーバー・ドメインの一部である場合(つまり、クラスタリングが無効な場合)、グループに対してデプロイできません。詳細は、5.1項「Oracle CEPマルチサーバー・ドメインの管理の概要」を参照してください。 |
-status name
|
現在のインストール済みOSGiバンドルに関するステータス情報を返します。
Bundle-SymbolicName: myApp |
-startLevel startLevel
|
OSGiバンドルが開始されたレベルを指定します。この数字の小さいバンドルが先に開始されたバンドルです。 システム・バンドルの開始レベルは7未満です。 |
次の例は、デプロイヤ・ユーティリティの使用方法を示しています。すべての例で、Oracle CEPはホストarielで実行されていて、リスニング・ポートは9002です。また、サーバー管理者のユーザー名/パスワードはそれぞれwlevs/wlevsです。わかりやすくするために、例は複数行に分けて示していますが、コマンドを実行するときは、すべての引数とコマンドを1行に入力します。
prompt> java -jar wlevsdeploy.jar
-url http://ariel:9002/wlevsdeployer -user wlevs -password wlevs
-install /application/bundles/com.my.exampleApp_1.0.0.0.jar
上の例は、/application/bundlesディレクトリにあるcom.my.exampleApp_1.0.0.0.jarというOSGiバンドルをインストールする方法を示しています。
次のコマンドは、このアプリケーションを中断後に再開する方法を示しています。
prompt> java com.bea.wlevs.deployment.Deployer
-url http://ariel:9002/wlevsdeployer -user wlevs -password wlevs
-resume exampleApp
次の例は、このアプリケーションのアンインストール方法を示しています。アンインストールを実行すると、アプリケーションのすべてのトレース情報がドメイン・ディレクトリから削除されます。
prompt> java com.bea.wlevs.deployment.Deployer
-url http://ariel:9002/wlevsdeployer -user wlevs -password wlevs
-uninstall exampleApp
次の例は、strategies_1.0.jarというアプリケーションをstrategygroupにインストールする方法を示しています。また、javaユーティリティの-jarコマンドの使用方法も示しています。
prompt> java -jar wlevsdeploy.jar
-url http://ariel:9002/wlevsdeployer -install strategies_1.0.jar
-group strategygroup
