| Oracle® Fusion Middleware Oracle Event Processing管理者ガイド 11gリリース1 (11.1.1.7) B61653-06 |
|
 前 |
 次 |
この付録では、Oracle Event Processingアプリケーションのデプロイに使用できる、Oracle Event ProcessingのDeployerコマンドライン・ユーティリティへの参照を提供します。
この付録の内容は次のとおりです。
Deployerは、管理者や開発者がOracle Event Processingアプリケーションのデプロイ操作をコマンドラインで実行するためのJavaベースのデプロイメント・ユーティリティです。Oracle Event Processingデプロイメントのコンテキストでは、アプリケーションは次のアーティファクトを含むOSGiバンドルJARファイルとしてhttp://www.osgi.org/で定義されます。
アダプタ、アダプタ・ファクトリ、ビジネス・ロジックを格納したPOJOなど、アプリケーションのいくつかのコンポーネントを実装するコンパイル済Javaクラス・ファイル。
プロセッサ、アダプタ、ストリームなど、アプリケーションのコンポーネントを構成する1つまたは複数のOracle Event Processing構成XMLファイル。
構成ファイルは、OSGiバンドルJARファイルのMETA-INF/wlevsディレクトリにある必要があります。
アプリケーションのすべてのコンポーネントと、各コンポーネントが相互にどのように接続されているかを記述したEPNアセンブリ・ファイル。EPNアセンブリ・ファイルは標準のSpringコンテキスト・ファイルを拡張します。
EPNアセンブリ・ファイルは、OSGiバンドルJARファイルのMETA-INF/springディレクトリにある必要があります。
JARファイルのコンテンツを記述するMANIFEST.MFファイル。
このデプロイメント・バンドルを作成する方法の詳細は、『Oracle Fusion Middleware Oracle Event Processing開発者ガイド for Eclipse』のOracle Event Processingアプリケーションのアセンブリに関する項を参照してください。
デプロイヤ・ユーティリティはHTTPを使用してOracle Event Processingに接続します。つまり、アプリケーションのデプロイ先となるサーバー・インスタンスに応じてJettyを構成する必要があります。詳細は、『Oracle Fusion Middleware Oracle Event Processing管理者ガイド』のJettyの構成に関する項を参照してください。
Oracle Event Processingは、deployments.xmlファイルを使用して、デプロイ済アプリケーションのOSGiバンドルのリストを内部的に維持します。このファイルはDOMAIN_DIR/servernameディレクトリにあります。DOMAIN_DIRはメイン・ドメイン・ディレクトリであり、アプリケーションのデプロイ先となるサーバー・インスタンスに対応します。servernameはサーバー・インスタンス自体です。詳細は、『Oracle Fusion Middleware Oracle Event Processing開発者ガイド for Eclipse』のOracle Event Processingスキーマに関する項を参照してください。
|
警告:
|
デプロイヤ・ユーティリティを使用する前に、環境を適切に構成する必要があります。
デプロイヤ・ユーティリティ環境を構成するには:
Oracle Event Processingソフトウェアをインストールおよび構成します。『Oracle Fusion Middleware Oracle Event Processingスタート・ガイド』のOracle Event Processingのインストールに関する項を参照してください。
コマンド・ウィンドウを開き、環境を設定します。『Oracle Fusion Middleware Oracle Event Processing開発者ガイド for Eclipse』の開発環境の設定に関する項を参照してください。
ORACLE_CEP_HOME/ocep_11.1/binディレクトリにあるwlevsdeploy.jar JARファイルを含むようにCLASSPATH変数を更新します。ORACLE_CEP_HOMEは、/oracle_cepなどのOracle Event Processingメイン・インストール・ディレクトリです。
Oracle Event Processingをインストールして実行しているコンピュータとは別のコンピュータでDeployerユーティリティを実行すると便利な場合があります。
リモートでデプロイヤ・ユーティリティを実行するには:
Oracle Event Processingがインストールされているコンピュータからデプロイヤ・ユーティリティを実行するコンピュータに、次のJARファイルをコピーします。JARファイルのコピー先のディレクトリ名は、任意の名前とすることができます。
ORACLE_CEP_HOME/ocep_11.1/bin/wlevsdeploy.jar
ここで、ORACLE_CEP_HOMEは、Oracle Event Processingをインストールする先のメイン・ディレクトリを示します。
次のいずれかの方法で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 Event ProcessingインスタンスのデプロイヤのURLを指定します。 URLは次の形式にします。 http://host:port/wlevsdeployer 説明:
たとえば、Oracle Event Processingがホスト http://ariel:9002/wlevsdeployer |
表B-2は、デプロイヤ・ユーティリティで指定できるユーザー資格証明の引数を示しています。
表B-3は、デプロイヤ・ユーティリティで使用できるデプロイメント・コマンドを示しています。
表B-3 デプロイメント・コマンド
| コマンド | 説明 |
|---|---|
-encrypt |
ユーザー名とパスワードを暗号化し、出力ファイルに書き込みます。 |
-encryptoutfile encryptoutfile
|
encryptoutfileを使用して、暗号化されたユーザー名とパスワードを書き込むことを指定します。 |
-group groupname
|
デプロイ・コマンド(install、uninstall、update、suspendまたはresume)をターゲット・グループ(具体的には、そのグループ内の一連の実行中サーバー)に適用することを指定します。 ドメイン・グループを指定するには、次のようにキーワード -group all カスタム・グループを指定するには、単純にグループの名前を指定します: -group my_group 注意: サーバーがマルチサーバー・ドメインの一部である場合(つまり、クラスタリングが有効な場合)、グループに対してのみデプロイできます。サーバーがスタンドアロンサーバー・ドメインの一部である場合(つまり、クラスタリングが無効な場合)、グループに対してデプロイできません。詳細は、6.1項「Oracle Event Processingマルチサーバー・ドメインの管理の概要」を参照してください。 |
-help |
コマンド構文および引数について説明するメッセージを出力します。 |
-install bundle
|
指定したOracle Event Processingインスタンスに、指定したOSGiバンドルをインストールします。
バンドルが置かれている場所が、デプロイヤ・ユーティリティを実行しているディレクトリに対して相対的なディレクトリではない場合、バンドルのフル・パス名を必ず指定してください。 特に、Oracle Event Processingでは次の処理が行われます。
|
-resume name
|
指定したOracle Event Processingインスタンス上で一時停止されたOSGIバンドルを再開します。構成されたアダプタが再びただちに着信データを受信し始めます。
Bundle-SymbolicName: myApp |
-status name
|
現在のインストール済OSGiバンドルに関するステータス情報を返します。
Bundle-SymbolicName: myApp |
-suspend name
|
指定したOracle Event Processingインスタンスにインストール済で現在実行中のOSGIバンドルを一時停止します。
Bundle-SymbolicName: myApp |
-uninstall name
|
指定したOracle Event Processingインスタンスから既存のバンドルを削除します。
Bundle-SymbolicName: myApp 特に、Oracle Event Processingでは次の処理が行われます。
|
-update bundle
|
既存のOSGiバンドルを新しいアプリケーション・コードで更新します。
バンドルが置かれている場所が、デプロイヤ・ユーティリティを実行しているディレクトリに対して相対的なディレクトリではない場合、バンドルのフル・パス名を必ず指定してください。 特に、Oracle Event Processingでは次の処理が行われます。
|
-userconfigfile userconfigfile
|
userconfigfile (security-config.xml)を使用して、暗号化されたユーザー名とパスワードをファイルから取得することを指定します。 |
-userkeyfile userkeyfile
|
userkeyfile (.msainternal.dat)を使用して、ユーザー構成ファイルのパスワードを暗号化するために使用する暗号化キーを取得することを指定します。 |
次の例は、デプロイヤ・ユーティリティの使用方法を示しています。すべての例で、Oracle Event Processingはホスト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
