| Oracle® Complex Event Processing管理者ガイド 11g リリース1(11.1.1.4.0) B61653-02 |
|
 前 |
 次 |
次の項では、wlevs.Adminユーティリティについて説明します。
wlevs.Adminユーティリティはコマンドライン・インタフェースであり、Oracle CEPを管理し、特に、Oracle CQLおよびEPLプロセッサのルールを動的に構成して、アプリケーションのイベント待機時間およびスループットを監視します。このユーティリティは、内部でJMXを使用してOracle CEPサーバーとデプロイされたアプリケーションの両方の構成およびランタイムMBeanに対して問合せます。
Oracle CEP構成フレームワークにより、アプリケーションとOracle CEPサーバー構成の両方に対して複数のユーザーによって同時変更が可能になります。フレームワークは、この同時実行性を管理するためにロック処理は使用しませんが、オプティミスティック・バージョン・ベース同時実行性を使用します。これは、2人のユーザーが常に更新対象の同一オブジェクトの構成を表示できますが、それらに対する変更の確定は1人のユーザーのみに許可されるということを意味します。同じ構成オブジェクトを更新しようとする場合、他のユーザーにはエラーが表示され、更新された構成を表示するためにはセッションをリフレッシュする必要があります。
それぞれのwlevs.Adminユーティリティ・コマンドは独自のトランザクションで実行します。各コマンドの実行後に暗黙的に確定されるということになります。複数の構成変更を1回のトランザクションで一括処理する場合は、wlevs.Adminユーティリティを使用せず、JMXを使用して直接変更を実行する必要があります。
wlevs.Adminユーティリティを使用する前に、環境を適切に構成する必要があります。
wlevs.Adminユーティリティ環境を構成するには:
『Oracle Complex Event Processingスタート・ガイド』のOracle CEPのインストールに関する項で説明されているように、Oracle CEPソフトウェアをインストールして構成します。
管理対象ドメインのJMX接続を構成します。第12章「Oracle CEPのJMXの構成」を参照してください。
コマンド・ウィンドウを開き、『Oracle Complex Event Processingスタート・ガイド』の開発環境の設定に関する項で説明されているように、環境を設定します。
次のいずれかの方法でCLASSPATHを設定します。
ユーティリティの実行時に-jar引数を使用して、CLASSPATHを暗黙的に設定します。
引数をORACLE_CEP_HOME/ocep_11.1/bin/wlevsadmin.jarファイルに設定します。ここで、ORACLE_CEP_HOMEは、メインのOracle CEPインストール・ディレクトリを示します。
-jar引数を使用するとき、コマンドラインでwlevs.Adminユーティリティ名は指定しないでください。例:
prompt> java -jar d:/oracle_cep/ocep_11.1/bin/wlevsadmin.jar -url service:jmx:msarmi://localhost:9002/jndi/jmxconnector UPLOAD -application helloworld -processor helloworldProcessor -sourceURL file:///d:/test/newrules2.xml
次のファイルをCLASSPATH環境変数に追加して、明示的にCLASSPATHを更新します。
ORACLE_CEP_HOME/ocep_11.1/bin/wlevsadmin.jarORACLE_CEP_HOME/ocep_11.1/bin/wlevs.jarORACLE_CEP_HOME/ocep_11.1/modules/com.bea.wlevs.deployment.server_11.1.0.0.jarORACLE_CEP_HOME/ocep_11.1/modules/com.bea.wlevs.ede_11.1.0.0.jarORACLE_CEP_HOME/ocep_11.1/modules/com.bea.wlevs.management_11.1.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.jndi.context_6.0.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.jmx_6.0.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.rmi_6.0.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.i18n_1.4.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.diagnostics.core_2.1.0.0.jarORACLE_CEP_HOME/modules/javax.xml.stream_1.1.1.0.jarORACLE_CEP_HOME/com.bea.core.bootbundle_8.0.0.0.jar
ここで、ORACLE_CEP_HOMEは、Oracle CEPをインストールする先のメイン・ディレクトリを示します。
wlevs.Adminユーティリティは、Oracle CEPがインストールされて稼働しているコンピュータとは異なるコンピュータ上で実行する方が有用な場合があります。
リモートでwlevs.Adminユーティリティを実行するには:
Oracle CEPがインストールされているコンピュータから次のJARファイルを、wlevs.Adminを実行する対象のコンピュータへコピーします。JARファイルを任意のディレクトリ名へコピーできます。
ORACLE_CEP_HOME/ocep_11.1/bin/wlevsadmin.jarORACLE_CEP_HOME/ocep_11.1/bin/wlevs.jarORACLE_CEP_HOME/ocep_11.1/modules/com.bea.wlevs.deployment.server_11.1.0.0.jarORACLE_CEP_HOME/ocep_11.1/modules/com.bea.wlevs.ede_11.1.0.0.jarORACLE_CEP_HOME/ocep_11.1/modules/com.bea.wlevs.management_11.1.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.jndi.context_6.0.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.jmx_6.0.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.rmi_6.0.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.i18n_1.4.0.0.jarORACLE_CEP_HOME/modules/com.bea.core.diagnostics.core_2.1.0.0.jarORACLE_CEP_HOME/modules/javax.xml.stream_1.1.1.0.jar
ここで、ORACLE_CEP_HOMEは、Oracle CEPをインストールする先のメイン・ディレクトリを示します。
次のいずれかの方法でCLASSPATHを設定します。
ユーティリティの実行時に-jar引数を使用して、暗黙的にCLASSPATHを設定し、引数をNEW_DIRECTORY/wlevsadmin.jarファイルに設定します。ここで、NEW_DIRECTORYは、必要なJARファイルをコピーしたリモート・コンピュータ上のディレクトリを示します。-jar引数を使用するとき、コマンドラインでwlevs.Adminユーティリティ名は指定しません。
リモート・コンピュータへコピーしたすべてのファイルをCLASSPATH環境変数に追加して、明示的にCLASSPATHを更新します。
次の項で説明されているように、wlevs.Adminユーティリティを起動します。
wlevs.Adminコマンドライン・ユーティリティを使用するときにSSLを使用するには、最初に信頼キーストアを作成する必要があります。
詳細は、10.1.4項「SSL」を参照してください。
wlevs.AdminユーティリティをSSLモードで実行するには:
コマンド・ウィンドウを開き、『Oracle Complex Event Processingスタート・ガイド』の開発環境の設定に関する項で説明されているように、環境を設定します。
Oracle CEPサーバーが起動していない場合は、起動します。
1.5.4項「Oracle CEPサーバーの起動と停止」を参照してください。
DOMAIN_DIR/servername/sslディレクトリに変更を加えます。ここで、DOMAIN_DIRはメインのドメイン・ディレクトリを示し、servernameはサーバー名を示します。
例:
d:\oracle_cep\user_projects\domains\mydomain\myserver\ssl.
次のコマンドを指定して、トラスト・キーストアを生成します(実際には、コマンドは1行にする必要があります)。
prompt> java -classpathORACLE_CEP_HOME\ocep_11.1\common\lib\evspath.jar;ORACLE_CEP_HOME\ocep_11.1\utils\security\wlevsgrabcert.jar com.bea.wlevs.security.util.GrabCerthost:secureport-alias=aliastruststorepath
説明
ORACLE_CEP_HOMEは、Oracle CEPのインストール・ディレクトリ(d:/oracle_cepなど)を意味します。
hostは、server2が実行されているコンピュータを意味します。
secureportは、server2用に構成されたSSLネットワーク入出力ポートを意味します。デフォルト値は9003です。
詳細は、10.5.1項「手動でSSLの構成方法」の例10-5を参照してください。
aliasは、トラスト・キーストアにある証明書の別名です。デフォルト値はhostnameです。
truststorepathは、生成されるトラスト・キーストア・ファイルのフルパス名を意味します。デフォルトはevstrust.jksです。
次のような例があります(実際には、コマンドは1行にする必要があります)。
prompt> java -classpath C:\OracleCEP\ocep_11.1\common\lib\evspath.jar;C:\OracleCEP\ocep_11.1\utils\security\wlevsgrabcert.jar com.bea.wlevs.security.util.GrabCert server2:9003 -alias=server2 evstrust.jks
wlevs.Adminコマンドライン・ユーティリティはこの信頼キーストアを使用することを指定するには、次のプロパティを使用します:
-Djavax.net.ssl.trustStore: 前述の手順で作成した信頼キーストア名。
-Djavax.net.ssl.trustStorePassword: 信頼キーストア・ファイルのパスワード。
また、URLには必ずセキュア・ポートを指定してください。例:
prompt> java -Djavax.net.ssl.trustStore=clitrust.jks -Djavax.net.ssl.trustStorePassword=secret -jar wlevsadmin.jar -url service:jmx:msarmis://localhost:9003/jndi/jmxconnector -username wlevs -password wlevs SHUTDOWN -scheduleAt 600
wlevs.Adminユーティリティを使用するための構文は次のとおりです。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
COMMAND-NAME command-arguments
コマンド名と引数では、大文字と小文字は区別されません。
次の項では、wlevs.Adminユーティリティに指定できる引数に関する構文の詳細情報を説明します。
次の項では、wlevs.Adminユーティリティのサポートされているコマンドに関する構文の詳細情報を説明します。
以降の節に示す例の多くは、次のような特定の環境が設定されていることを前提としています。
Oracle CEPインスタンスは、ポート9002でJMXリクエストをリスニングします。
Oracle CEPインスタンスは、arielという名前のホスト・マシン上にインストールされ、このホスト名をリスニング・アドレスとして使用します。
wlevsというユーザー名には、システム管理者権限が与えられており、パスワードにはwlevsが使用されます。
なお、わかりやすくするために例は複数行に分けて示していますが、コマンドを実行するときは、すべての引数とコマンドを1行に入力してください。
java wlevs.Admin
[ {-url URL} | {-listenAddress hostname -listenPort port} ]
[ User Credentials Arguments ]
[ Common Arguments ]
COMMAND-NAME command-arguments
ほとんどのwlevs.Adminコマンドを起動するときには、表A-1の引数を指定してOracle CEPインスタンスに接続します。
表A-1 接続引数
| 引数 | 定義 |
|---|---|
-url service:jmx:msarmi:// |
管理する対象のOracle CEPインスタンスとのJMX接続を確立するURLを指定します。説明:
この引数を使用する場合、
たとえば、Oracle CEPがarielというホスト名のコンピュータで実行されており、JMXリスニング・ポートが9002である場合、URLは次のようになります。 -url service:jmx:msarmi://ariel:9002/jndi/jmxconnector Oracle CEPのJMX、JNDI、およびRMIの構成に関する詳細は、第12章「Oracle CEPのJMXの構成」を参照してください。 |
-listenAddress hostname
|
Oracle CEPインスタンスが稼働中のコンピュータ名を指定します。この引数は、 この引数は、 たとえば、Oracle CEPが -listenAddress ariel |
-listenPort port
|
JMX接続をリスニングするOracle CEPに構成されたポートを指定します。この引数は、 この引数は、 JMXポートは、管理対象のOracle CEPドメインの
<netio>
<name>NetIO</name>
<port>9002</port>
</netio>
たとえば、このポートが -listenPort 9002 Oracle CEPのJMX、JNDI、およびRMIの構成に関する詳細は、第12章「Oracle CEPのJMXの構成」を参照してください。 |
java wlevs.Admin
[ Connection Arguments ]
[ -username username [-password password] ]
[ Common Arguments ]
COMMAND-NAME command-arguments
ほとんどのwlevs.Adminコマンドを起動するときには、表A-2の引数を指定し、コマンドを起動する権限を持つOracle CEPユーザーのユーザー資格証明を提供します。
Oracle CEPドメインに対してセキュリティが有効になっていない場合には、ユーザー資格証明を入力する必要はありません。
表A-2 ユーザー資格証明の引数
| 引数 | 定義 |
|---|---|
|
-username username |
コマンドを発行するユーザーの名前。このユーザーには、コマンドのターゲットを表示または変更するための適切な許可が必要です。 |
|
-password password |
このユーザー名に関連付けられたパスワード。 |
|
注意: すべてのコマンドについて、wlevs.Adminユーティリティがサーバーに接続できない場合、またはOracle CEPインスタンスでユーザー名とパスワードが拒否された場合、終了コードは1になります。 |
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ -verbose ]
COMMAND-NAME command-arguments
すべてのwlevs.Adminコマンドは、詳細出力を取得するために表A-3の引数をサポートしています。
この項では、使用方法ヘルプを起動するためのコマンドを説明します。
すべてのOracle CEPコマンド(デフォルト)について、またはHELPコマンド・ラインに値としてコマンドを指定した場合は単一のコマンドについて、構文と使用法に関する情報を表示します。
このコマンドは、Oracle CEPがインストールされている任意のコンピュータで発行できます。このコマンドを呼び出すためにサーバー・インスタンスを起動する必要はありません。また、サーバーに対してセキュリティが有効になっている場合でも、ユーザーの資格証明を入力する必要はありません。
java wlevs.Admin HELP [COMMAND]
COMMAND引数は次のとおりになります。
キーワードALLは、すべてのコマンドの使用情報を戻します。
キーワードMBEAN、RULES、またはLIFECYCLEのいずれかで、3つの異なるグループのコマンドに関する使用情報を戻します。
UPLOADなどの実際のコマンドで、特定のコマンドに関する使用方法情報を戻します。
次の例では、UPLOADコマンドの使用法に関する情報をリクエストしています。
prompt> java wlevs.Admin HELP UPLOAD
コマンドが次を返します(実際には、Javaコマンドは1行にする必要があります)。
Description:
Uploads rules to be configured in the processor.
Usage:
java wlevs.Admin
[-url | -listenAddress <host-name> -listenPort <port>]
-username <username> -password <password>
UPLOAD -application <application name> -processor <processor name> -sourceURL "source url"
Where:
-application = Name of the application.
-processor = Name of the processor.
-sourceURL = source URL containing the rules in an XML format.
java wlevs.Admin -url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs UPLOAD -application myapplication
-processor processor -sourceURL file:/d:/test/rules.xml
表A-4は、サーバー・インスタンスのライフサイクルを管理するためのコマンドの概要です。後続の項では、コマンド構文および引数を説明し、各コマンドの例を示します。
指定したOracle CEPインスタンスを正常に停止します。
正常な停止では、進行中の特定のアプリケーションの処理を完了する時間がOracle CEPに与えられます。
-url接続引数は、hostおよびjmxportの値に基づいて、シャットダウンする特定のOracle CEPインスタンスを指定します。詳細は、A.6項「接続引数」を参照してください。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
SHUTDOWN [-scheduleAt seconds]
表A-6は、Oracle CEPアプリケーションの特定プロセッサのOracle CQLルールを管理するコマンドの概要です。後続の項では、コマンド構文および引数を説明し、各コマンドの例を示します。
表A-6 アプリケーションのOracle CQLルールを管理するためのコマンドの概要
| コマンド | 説明 |
|---|---|
|
Oracle CEPアプリケーションのプロセッサの既存Oracle CQLルール、問合せ、またはビューのテキストを戻します。 |
|
|
新規Oracle CQLルール、問合せ、またはビューをOracle CEPアプリケーションのプロセッサに追加します。 |
|
|
既存Oracle CQLルール、問合せ、またはビューをOracle CEPアプリケーションのプロセッサから削除します。 |
|
|
|
既存Oracle CQLルール、問合せ、またはビューを新規Oracle CQLテキストに置換します。 |
|
|
以前に停止したOracle CQLルールまたは問合せを開始します。 |
|
|
以前に開始したOracle CQLルールまたは問合せを停止します。 |
|
コンポーネント構成XMLファイルからルールをアップロードして、Oracle CQLルール、問合せ、またはビューのセットをOracle CEPアプリケーションのプロセッサに構成します。 |
|
|
Oracle CEPアプリケーションのプロセッサに関連付けられたOracle CQLルール、問合せ、またはビューのセットをコンポーネント構成XMLファイルにダウンロードします。 |
Oracle CEPアプリケーションの指定されたOracle CQLプロセッサからOracle CQLルール、問合せ、またはビューの全文を戻します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
GETRULE -application application -processor processor -rule rulename
表A-7 GETRULE引数
| 引数 | 定義 |
|---|---|
-application application
|
Oracle CQLルールを管理する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のOracle CQLプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename
|
参照するOracle CQLルール、問合せ、またはビューの名前を指定します。 ルール、問合せ、またはビューの名前が不明な場合は、それに対して問い合せるための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。また、DOWNLOADコマンドを使用して特定のプロセッサのルール・リストも取得できます。 |
新規Oracle CQLルール、問合せ、またはビューをOracle CEPアプリケーションの指定されたプロセッサに追加します。
同一名のルール、問合せ、またはビュー(rulename、queryname、またはviewnameパラメータで識別される)がすでに存在する場合、ADDRULEコマンドが既存のルール、問合せ、またはビューを新規のものに置換します。
|
注意: Oracle CQL問合せは、その入力チャネルが入力イベントを提供する場合、すぐにイベントの出力を開始します。チャネル上で問合せセレクタとアップストリームOracle CQLプロセッサを併用する場合、問合せをアップストリームOracle CQLプロセッサに追加する時刻と、ダウンストリーム・チャネル上で問合せセレクタを構成する時刻との間で、ダウンストリーム・チャネル上で要求していない問合せ結果を観察する場合があります。詳細は、『Oracle Complex Event Processing Visualizerユーザーズ・ガイド』のチャネル・プロパティ: 問合せセレクタを使用したアウトバウンド・チャネルに関する項を参照してください。 |
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
ADDRULE -application application -processor processor
-rule [rulename] rulestring |
-query [queryname] querystring |
-view [viewname] viewstring [-schema comma-separated-names]
[-active true | false]
表A-8 ADDRULE引数
| 引数 | 定義 |
|---|---|
-application application
|
Oracle CQLルールを管理する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule [rulename] rulestring |
アプリケーションの指定プロセッサに追加するOracle CQLルールを指定します。Oracle CQLルールには次が含まれます。
Oracle CQLの |
-query [queryname] querystring |
アプリケーションの指定プロセッサに追加するOracle CQL問合せを指定します。
Oracle CQLの |
-view [viewname] viewstring [-schema |
アプリケーションの指定プロセッサに追加するOracle CQLビューを指定します。
Oracle CQLの
|
-active true | false |
ルールが開始され、追加後にイベントを処理する準備ができているかどうかを指定します。 この引数の有効な値は |
次の例では、Oracle CQL問合せSELECT * FROM Withdrawal [Rows 5]を、myqueryという名前で、helloworldアプリケーションのOracle CQLプロセッサhelloworldProcessorに追加する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
ADDRULE -application helloworld -processor helloworldProcessor
-query myquery "SELECT * FROM Withdrawal [Rows 5]"
既存のOracle CQLルールをOracle CEPアプリケーションの指定プロセッサから削除します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
DELETERULE -application application -processor processor -rule rulename
表A-9 DELETERULE引数
| 引数 | 定義 |
|---|---|
-application application
|
Oracle CQLルールを管理する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename
|
削除するOracle CQLルール、問合せ、またはビューの名前を指定します。 ルール名が不明な場合は、それを問い合せるための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。また、DOWNLOADコマンドを使用して特定のOracle CQLプロセッサのルール、問合せ、またはビューのリストも取得できます。 |
既存のOracle CQLルール、問合せ、またはビューを別のルール、問合せ、またはビューに置換します。Oracle CEPは、最初に元のルール、問合せ、またはビューを破棄してから、新規のものをそれぞれの場所に挿入します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
REPLACERULE -application application -processor processor
-rule rulename rulestring
表A-10 REPLACERULE引数
| 引数 | 定義 |
|---|---|
-application application
|
Oracle CQLルールを管理する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のOracle CQLプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename rulestring |
置換するOracle CQLルール、問合せ、またはビューの名前を指定します。Oracle CEPは、古いルール、問合せ、またはビューを削除してから、新規のものを同一の名前で、ただしルール・テキストは新規にして挿入します。ビューの場合、Oracle CEPは Oracle CQLの |
次の例では、myqueryというOracle CQL問合せを、helloworldアプリケーションのOracle CQL helloworldProcessorのOracle CQLテキストSELECT * FROM Withdrawal [Rows 10]に置換する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
REPLACERULE -application helloworld -processor helloworldProcessor
-rule myquery "SELECT * FROM Withdrawal [Rows 10]"
Oracle CEPアプリケーションの指定プロセッサで以前に停止された既存のOracle CQLルールまたは問合せを開始します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
STARTRULE -application application -processor processor -rule rulename
表A-11 STARTRULE引数
| 引数 | 定義 |
|---|---|
-application application
|
Oracle CQLルールを管理する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename
|
開始するOracle CQLルールまたは問合せの名前を指定します。 注意: ビューの停止と開始はできません。ビューは常にアクティブです。 ルール名が不明な場合は、それを問い合せるための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。また、DOWNLOADコマンドを使用して特定のOracle CQLプロセッサのルール、問合せ、またはビューのリストも取得できます。 |
Oracle CEPアプリケーションの指定プロセッサで以前に開始された既存のOracle CQLルールまたは問合せを停止します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
STOPRULE -application application -processor processor -rule rulename
表A-12 STOPRULE引数
| 引数 | 定義 |
|---|---|
-application application
|
管理対象のOracle CQLルールまたは問合せを持つOracle CEPアプリケーション名を指定します。 完全一致アプリケーション名が現在不明な場合、それを取得するための また、アプリケーションの |
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename
|
停止するOracle CQLルールまたは問合せの名前を指定します。 注意: ビューの停止と開始はできません。ビューは常にアクティブです。 ルール名が不明な場合は、それを問い合せるための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。また、DOWNLOADコマンドを使用して特定のOracle CQLプロセッサのルール、問合せ、またはビューのリストも取得できます。 |
指定プロセッサに構成されたOracle CQLルールを、アップロードされたコンポーネント構成ファイルのOracle CQLルールに置換します。
Oracle CQLルールが含まれるコンポーネント構成ファイルは、コンポーネント構成ファイルのスキーマに準拠しています(『Oracle Complex Event Processing開発者ガイドfor Eclipse』のコンポーネントの構成XSDスキーマ: wlevs_application_config.xsdに関する項を参照してください)。このファイルには、指定プロセッサに現在構成されているルールを置換する1つ以上のOracle CQLルールが含まれます。そのようなコンポーネント構成ファイルの例は、次のとおりです。
<?xml version="1.0" encoding="UTF-8" ?>
<config>
<processor>
<name>helloworldProcessor</name>
<rules>
<query id="helloworldRule1">
<![CDATA[ SELECT * FROM HelloWorldEvent [Rows 2] ]]>
</query>
</rules>
</processor>
</config>
前述の例では、コンポーネント構成ファイルは、helloworldRule1という名前の単一の Oracle CQL問合せを構成し、そのOracle CQL問合せテキストはSELECT * FROM HelloWorldEvent [Rows 2]です。
|
警告: wlevs.AdminユーティリティのUPLOADコマンドを使用するとき、他のOracle CQLコマンドを実行するときと同様に、-processor引数を使用して、Oracle CQLプロセッサ名をOracle CQLルールの追加先に指定します。これは、ネーミング競合を避けるために、ユーティリティがコンポーネント構成ファイル内の任意の<name>要素を無視することを意味します。 |
コンポーネント構成ファイルの作成に関する詳細および例は、『Oracle Complex Event Processing開発者ガイドfor Eclipse』のOracle CQLプロセッサの構成に関する項を参照してください。
A.12.9項「DOWNLOAD」で説明されているように、DOWNLOADコマンドを使用して、プロセッサのコンポーネント構成ファイルのコピーを取得できます。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
UPLOAD -application application -processor processor -sourceURL sourcefileURL
表A-13 UPLOAD引数
| 引数 | 定義 |
|---|---|
-application application
|
Oracle CQLルールを管理する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のOracle CQLプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-sourceURL sourcefileURL
|
次の形式のOracle CQLルールを含むコンポーネント構成ファイルのURLを指定します。
|
次の例は、c:\processor\config\myrules.xmlファイルのOracle CQLルールをhelloworldアプリケーションのOracle CQL helloworldProcessorへアップロードする方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
UPLOAD -application helloworld -processor helloworldProcessor
-sourceURL file:///c:/processor/config/myrules.xml
Oracle CEPアプリケーションの指定されたOracle CQLプロセッサに関連付けられたOracle CQLルール・セットを、XMLコンポーネント構成ファイルへダウンロードします。
このXMLファイルは、A.12.8項「UPLOAD」で説明されているのと同一の形式です。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
DOWNLOAD -application application -processor processor
-file destinationfile [-overwrite overwrite]
表A-14 DOWNLOAD引数
| 引数 | 定義 |
|---|---|
-application application
|
Oracle CQLルールを管理する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-file destinationfile
|
必ずファイルのフルパス名を指定してください。 |
-overwrite overwrite
|
この引数の有効な値は、 |
次の例では、helloworldアプリケーションのOracle CQL helloworldProcessorに付属のOracle CQLルール・セットを、c:\processor\config\myrules.xmlファイルへダウンロードする方法を示します。ユーティリティは任意の既存ファイルをオーバーライドします。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
DOWNLOAD -application helloworld -processor helloworldProcessor
-file c:\processor\config\myrules.xml -overwrite true
表A-15は、Oracle CEPアプリケーションの特定プロセッサのEPLルールを管理するためのコマンドの概要です。後続の項では、コマンド構文および引数を説明し、各コマンドの例を示します。
表A-15 アプリケーションのEPLルールを管理するためのコマンドの概要
| コマンド | 説明 |
|---|---|
|
Oracle CEPアプリケーションのプロセッサに新しいEPLルールを追加します。 |
|
|
Oracle CEPアプリケーションのプロセッサから既存のEPLルールを削除します。 |
|
|
|
既存のEPLルールを新しいEPLテキストと置き換えます。 |
|
Oracle CEPアプリケーションのプロセッサに適用されている既存のEPLルールのテキストを返します。 |
|
|
XMLファイルからルールをアップロードすることによって、Oracle CEPアプリケーションのプロセッサに適用するEPLルールのセットを構成します。 |
|
|
Oracle CEPアプリケーションのプロセッサに関連付けられているEPLルールのセットをファイルにダウンロードします。 |
|
|
|
パラメータ化されたEPL問合せに新しいパラメータ・セットを追加します。 |
|
|
パラメータ化されたEPL問合せからパラメータ・セットを削除します。 |
|
|
パラメータ化されたEPL問合せに現在バインドされているパラメータを返します。 |
Oracle CEPアプリケーションの指定したプロセッサに新しいEPLルールを追加します。
同一名のルール(rulenameパラメータで識別される)がすでに存在する場合、ADDRULEコマンドが既存ルールを新規ルールに置換します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
ADDRULE -application application -processor processor -rule [rulename] rulestring
表A-16 ADDRULE引数
| 引数 | 定義 |
|---|---|
-application application
|
EPLルールを管理する対象のOracle CEPアプリケーションを指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule [rulename] rulestring |
アプリケーションの指定したプロセッサに追加するEPLルールを指定します。
EPLルールを二重引用符で囲んで入力します。 |
次の例では、EPLルールSELECT * FROM Withdrawal RETAIN 5 EVENTSを、myruleという名前で、helloworldアプリケーションのhelloworldProcessorへ追加する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
ADDRULE -application helloworld -processor helloworldProcessor
-rule myrule "SELECT * FROM Withdrawal RETAIN 5 EVENTS"
Oracle CEPアプリケーションの指定したプロセッサから既存のEPLルールを削除します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
DELETERULE -application application -processor processor -rule rulename
表A-17 DELETERULE引数
| 引数 | 定義 |
|---|---|
-application application
|
EPLルールを管理する対象のOracle CEPアプリケーションを指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename
|
削除するEPLルールの名前を指定します。 ルール名が不明な場合は、それを問い合せるための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。また、DOWNLOADコマンドを使用して特定のプロセッサのルール・リストも取得できます。 |
既存のEPLルールを別のルールで置き換えます。Oracle CEPは最初に元のルールを破棄し、次に新しいルールをその場所に挿入します。元のルールがパラメータ化されている場合、既存のバインディングがあれば新しいルールに適用されます。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
REPLACERULE -application application -processor processor -rule rulename rulestring
表A-18 REPLACERULE引数
| 引数 | 定義 |
|---|---|
-application application
|
EPLルールを管理する対象のOracle CEPアプリケーションを指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename rulestring |
置き換えるEPLルールを指定します。Oracle CEPは古いルールを削除してから、新しいルール(同じ名前でルール・テキストが新しい)を挿入します。 EPLルールを二重引用符で囲んで入力します。 |
次の例では、myruleというルールを、helloworldアプリケーションのhelloworldProcessorのEPLテキストSELECT * FROM Withdrawal RETAIN 10 EVENTSに置換する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
REPLACERULE -application helloworld -processor helloworldProcessor
-rule myrule "SELECT * FROM Withdrawal RETAIN 10 EVENTS"
Oracle CEPアプリケーションの指定したプロセッサからEPLルールのテキスト全体を返します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
GETRULE -application application -processor processor -rule rulename
表A-19 GETRULE引数
| 引数 | 定義 |
|---|---|
-application application
|
EPLルールを管理する対象のOracle CEPアプリケーションを指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename
|
テキスト全体を表示するEPLルールの名前を指定します。 ルール名が不明な場合は、それを問い合せるための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。また、DOWNLOADコマンドを使用して特定のプロセッサのルール・リストも取得できます。 |
パラメータ化されたEPL問合せに新しいパラメータ・セットを追加します。
パラメータ化されたEPL問合せの使用に関する詳細は、『Oracle Complex Event Processing EPL言語リファレンス』のパラメータ化された問合せに関する項を参照してください。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
ADDPARAMS -application application -processor processor
-rule rulename -values values -params params
表A-20 ADDPARAMS引数
| 引数 | 定義 |
|---|---|
-application application
|
EPLルールを管理する対象のOracle CEPアプリケーションを指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename
|
新しいパラメータ・セットの追加先であるパラメータ化されたEPLルールの名前を指定します。 ルール名が不明な場合は、それを問い合せるための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。また、DOWNLOADコマンドを使用して特定のプロセッサのルール・リストも取得できます。 |
-values values
|
追加するパラメータのカンマ区切りの値リストを指定します。各値は、パラメータ化されたEPL問合せ内のプレースホルダーに対応します。 |
-params params
|
この新しいパラメータ・セットの一意の識別子を指定します。 |
次の例は、ADDPARAMSコマンドの使用方法を示しています。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
ADDPARAMS -application myApplication -processor myProcessor
-rule MarketRule
-values "NYSE,BGP" -params nyBGP
この例では、NYSE,BGPという値を持ち、文字列nyBGPによって識別されるパラメータ・セットを、myApplicationのmyProcessorコンポーネントで実行中のパラメータ化された問合せMarketRuleへ追加する方法を示します。このパラメータ・セットは2つの値によって構成されるため、EPL問合せには2つのプレースホルダが含まれる必要があります。
パラメータ化されたEPL問合せに関連付けられたパラメータ・セットの1つまたはすべてを削除します。
パラメータ化されたEPL問合せの使用に関する詳細は、『Oracle Complex Event Processing EPL言語リファレンス』のパラメータ化された問合せに関する項を参照してください。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
DELETEPARAMS -application application -processor processor
-rule rulename [-params params]
表A-21 DELETEPARAMS引数
| 引数 | 定義 |
|---|---|
-application application
|
EPLルールを管理する対象のOracle CEPアプリケーションを指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename
|
1つまたはすべてのパラメータ・セットを削除しようとしているパラメータ化されたEPLルールの名前を指定します。 ルール名が不明な場合は、それを問い合せるための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。また、DOWNLOADコマンドを使用して特定のプロセッサのルール・リストも取得できます。 |
-params params
|
削除するパラメータ・セットを指定します。 この引数はオプションです。これを指定しない場合、 |
次の例は、DELETEPARAMSコマンドの使用方法を示しています。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
DELETEPARAMS -application myApplication -processor myProcessor
-rule MarketRule
-params nasORCL
この例では、nasORCL文字列で識別されるパラメータ・セットを、myApplicationのmyProcessorコンポーネントで実行中のパラメータ化された問合せMarketRuleから削除する方法を示します。
この問合せに関連付けられたすべてのパラメータ・セットを削除するには、-paramsオプションを指定しません:
prompt> java wlevs.Admin -url service:jmx:msarmi://localhost:9002/jndi/jmxconnector -username wlevs -password wlevs DELETEPARAMS -application myApplication -processor myProcessor -rule MarketRule
パラメータ化されたEPL問合せに現在バインドされている1つまたはすべてのパラメータ・セットを返します。
パラメータ化されたEPL問合せの使用に関する詳細は、『Oracle Complex Event Processing EPL言語リファレンス』のパラメータ化された問合せに関する項を参照してください。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
GETPARAMS -application application -processor processor
-rule rulename [-params params]
表A-22 GETPARAMS引数
| 引数 | 定義 |
|---|---|
-application application
|
EPLルールを管理する対象のOracle CEPアプリケーションを指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-rule rulename
|
パラメータ・セットを取得しようとしているパラメータ化されたEPLルールの名前を指定します。 ルール名が不明な場合は、それを問い合せるための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。また、DOWNLOADコマンドを使用して特定のプロセッサのルール・リストも取得できます。 |
-params params
|
取得しようとしているパラメータ・セットを指定します。 この引数はオプションです。これを指定しない場合、 |
次の例は、GETPARAMSコマンドの使用方法を示しています。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
GETPARAMS -application myApplication -processor myProcessor
-rule MarketRule
この例では、myApplicationのmyProcessorコンポーネントで実行中のパラメータ化された問合せMarketRuleに現在関連付けられているすべてのパラメータを取得する方法を示します。コマンドは次の結果を戻します。
NASDAQ,ORCL
NYSE,JPM
NYSE,WFC
NYSE,BGP
特定のパラメータ・セットを取得するには、-paramsオプションを使用してそのIDを指定します:
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
GETPARAMS -application myApplication -processor myProcessor
-rule MarketRule
-params nasORCL
指定したプロセッサの構成済EPLルールを、アップロードしたXMLファイルのEPLルールと置き換えます。
EPLルールが含まれるXMLファイルは、コンポーネント構成ファイルのスキーマに準拠しています(『Oracle Complex Event Processing開発者ガイドfor Eclipse』のコンポーネントの構成XSDスキーマ: wlevs_application_config.xsdに関する項を参照してください)。このファイルには、指定プロセッサに現在構成されているルールを置換する1つ以上のEPLルールが含まれます。XMLファイルの例は次のとおりです。
<?xml version="1.0" encoding="UTF-8" ?>
<config>
<processor>
<name>helloworldProcessor</name>
<rules>
<rule id="helloworldRule1">
<![CDATA[ SELECT * FROM HelloWorldEvent RETAIN 2 EVENTS ]]>
</rule>
</rules>
</processor>
</config>
前述の例では、XMLファイルはhelloworldRule1という名前の単一の ルールを構成し、そのEPL問合せテキストはSELECT * FROM HelloWorldEvent RETAIN 2 EVENTSです。
|
警告: wlevs.AdminユーティリティのUPLOADコマンドを使用するときは、他のEPLコマンドの場合と同様に、-processor引数を使用して、EPLルールを追加するプロセッサの名前を指定します。つまり、名前の競合を避けるために、XMLファイル内の<name>要素はすべて無視されます。 |
EPLルールのXMLファイルの作成に関する詳細および例は、『Oracle Complex Event Processing開発者ガイドfor Eclipse』のEPLプロセッサの構成に関する項を参照してください。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
UPLOAD -application application -processor processor -sourceURL sourcefileURL
表A-23 UPLOAD引数
| 引数 | 定義 |
|---|---|
-application application
|
EPLルールを管理する対象のOracle CEPアプリケーションを指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-sourceURL sourcefileURL
|
EPLルールを含むXMLファイルのURLを指定します。 |
次の例は、c:\processor\config\myrules.xmlファイルのEPLルールをhelloworldアプリケーションのhelloworldProcessorへアップロードする方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
UPLOAD -application helloworld -processor helloworldProcessor
-sourceURL file:///c:/processor/config/myrules.xml
Oracle CEPアプリケーションの指定したプロセッサに関連付けられているEPLルールのセットをXMLファイルにダウンロードします。
このXMLファイルは、A.12.8項「UPLOAD」で説明されているのと同一の形式です。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
DOWNLOAD -application application -processor processor
-file destinationfile [-overwrite overwrite]
表A-24 DOWNLOAD引数
| 引数 | 定義 |
|---|---|
-application application
|
EPLルールを管理する対象のOracle CEPアプリケーションを指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-processor processor
|
特定のプロセッサ名を指定します。このプロセッサは、 完全一致名が不明な場合は、それを取得するための詳細は、A.13.5.3項「アプリケーションおよびプロセッサの名前の問合せ」を参照してください。 |
-file destinationfile
|
wlevs.AdminユーティリティでダウンロードするEPLルールのダウンロード先となるXMLファイルの名前を指定します。 必ずファイルのフルパス名を指定してください。 |
-overwrite overwrite
|
この引数の有効な値は、 |
次の例では、helloworldアプリケーションのhelloworldProcessorに現在付属のEPLルール・セットを、c:\processor\config\myrules.xmlファイルへダウンロードする方法を示します。ユーティリティは任意の既存ファイルをオーバーライドします。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
DOWNLOAD -application helloworld -processor helloworldProcessor
-file c:\processor\config\myrules.xml
次の項は、Oracle CEP MBeanを管理するためのwlevs.Adminコマンドを説明します。
Oracle CEP MBeanの詳細な説明は、『Oracle Fusion Middleware Oracle Complex Event Processing Java APIリファレンス』を参照してください。
アクセス、表示、または変更する対象のMBean(1つまたは複数)を指定するには、すべてのMBean管理コマンドで、-mbean引数または-type引数を指定する必要があります。
MBeanの単一のインスタンスを操作する場合は、-mbean引数を使用します。
-type引数を使用すると、指定するタイプのインスタンスであるすべてのMBeanに作用します。MBeanのタイプは、MBeanがインスタンスであるインタフェース・クラスを示します。すべてのOracle CEP MBeanは、com.bea.wlevs.management.configuration、com.bea.wlevs.management.runtime、com.bea.wlevs.deployment.mbeanおよびcom.bea.wlevs.server.management.mbeanパッケージで定義されたインタフェース・クラスのいずれかのインスタンスです。すべてのOracle CEP MBeanインタフェース・クラスの完全なリストは、それぞれのパッケージの『Oracle Fusion Middleware Oracle Complex Event Processing Java APIリファレンス』を参照してください。
-type引数に付与する値を決定するには、次の手順を実行します。MBeanのインタフェース・クラスを検索し、MBean接尾辞をクラス名から削除します。たとえば、com.bea.wlevs.management.configuration.CQLProcessorMBeanのインスタンスであるMBeanには、CQLProcessorを使用します。
表A-25は、MBean管理コマンドの概要です。
MBeanプロパティ(属性)およびJMXオブジェクト名を表示します(http://java.sun.com/j2se/1.5.0/docs/api/javax/management/ObjectName.html形式)。
コマンドの出力は次のようになります。
{MBeanName object-name {property1 value} {property2 value}. . .}
. . .
プロパティと値は名前と値のペアとして表され、各ペアは中カッコで囲まれています。この形式によって、スクリプトによる出力の解析が容易になります。
-prettyが指定される場合、それぞれのプロパティと値のペアは新しい行に表示され、ペアの区切りに波カッコは使用されません。
MBeanName: object-name property1: value property2: value . . . MBeanName: object-name property1: value abbribute2: value
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
GET [-pretty] {-type mbeanType| -mbean objectName} [-property property1] [-property property2]...
表A-26 GET引数
| 引数 | 定義 |
|---|---|
-type mbeanType
|
指定したタイプのすべてのMBean情報を戻します。詳細は、A.13.1項「MBeanタイプの指定」を参照してください。 |
-mbean objectName
|
たとえば、EPLプロセッサ・ステージのMBeanを参照する場合、ネーミングは次のとおりになります(実際には、文字列は1行にする必要があります)。 "com.bea.wlevs:Name=<name of the Stage>,Type=<type of Mbean>, Application=<name of the application>" |
-pretty |
プロパティと値のペアを1行に1組ずつ配置します。 |
-property property
|
リストする1つまたは複数のMBeanプロパティ(属性)の名前を指定します。
|
次の例は、helloworldというアプリケーションがOracle CEPにデプロイされたとき、プロセッサ・ステージに登録されたCQLProcessorMBeanのすべてのプロパティを示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
GET -pretty
-mbean com.bea.wlevs:Name=eplprocessor,Type=CQLProcessor,Application=helloworld
次の例は、すべてのCQLProcessorMBean MBeanのすべてのインスタンスを示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
GET -pretty -type CQLProcessor
1つ以上のMBeanの管理操作を起動します。Oracle CEP MBeanでは、通常このコマンドを使用して大半のOracle CEP MBeanが付与するget属性およびset属性以外の操作を起動します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
INVOKE {-type mbeanType | -mbean objectName} -method methodname [argument . . .]
表A-27 INVOKE引数
| 引数 | 定義 |
|---|---|
-type mbeanType
|
特定のタイプのすべてのMBeanに対する操作を起動します。詳細は、A.13.1項「MBeanタイプの指定」を参照してください。 |
-mbean objectName
|
たとえば、EPLプロセッサ・ステージのMBeanを呼び出す場合、名前の指定は次のようになります。 "com.bea.wlevs:Name=<name of the Stage>,Type=<type of Mbean>, Application=<name of the application>" |
-method methodname
|
呼び出すメソッドの名前。 |
argument
|
メソッド呼出しに渡される引数。 引数がString配列である場合は、次の形式で引数を渡す必要があります。 "String1;String2;. . . " |
次の例は、MBean com.bea.wlevs.management.configuration.EPLProcessorMBeanのaddRuleメソッドを起動します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
INVOKE -mbean com.bea.wlevs:Name=eplprocessor,Type=EPLProcessor,Application=helloworld
-method addRule "SELECT * FROM Withdrawal RETAIN ALL"
指定するパターンにhttp://java.sun.com/j2se/1.5.0/docs/api/javax/management/ObjectName.htmlが一致するOracle CEP MBeanを検索します。
http://java.sun.com/j2se/1.5.0/docs/api/javax/management/ObjectName.htmlのルールに準拠する名前でMBeanサーバーに登録されるOracle CEP MBeanタイプから作成されるすべてのMBean。特定のMBeanインスタンスを取得または変更するためにwlevs.Adminコマンドを使用する場合、MBeanのObjectNameを把握する必要があります。
コマンドの出力は次のようになります。
{MBeanName object-name {property1 value} {property2 value}. . .}
. . .
プロパティと値は名前と値のペアとして表され、各ペアは中カッコで囲まれています。この形式によって、スクリプトによる出力の解析が容易になります。
-prettyが指定される場合、それぞれのプロパティと値のペアは新しい行に表示され、ペアの区切りに波カッコは使用されません。
MBeanName: object-name property1: value property2: value . . . MBeanName: object-name property1: value abbribute2: value
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
QUERY -pretty -pattern object-name-pattern
表A-28 QUERY引数
| 引数 | 定義 |
|---|---|
-pretty |
プロパティと値のペアを1行に1組ずつ配置します。 |
-pattern object-name-pattern
|
property-list
ここで、property-listは プロパティと値のペアは任意の順序で指定できます。 指定したプロパティと値のペアの内部ではパターン・マッチングは行われません。完全なプロパティと値のペアのみがパターン・マッチングで使用されます。ただし、1つまたは複数のプロパティと値のペアのかわりに、*ワイルドカード文字を使用できます。 たとえば、
|
次の例は、すべてのcom.bea.wlevs.management.configuration.EPLProcessorMBean MBeanを検索します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
QUERY -pattern *:Type=EPLProcessor,*
コマンドが成功した場合、検出されたMBeanの属性を戻します(行が折り返されているのは、読みやすくするためです)。
{MBeanName="com.bea.wlevs:Name=MonitorProcessor,Type=EPLProcessor,Application=com.bea.wlevs.dataservices"{
AllRules=defaultRule = select * from DSMonitorEvent retain 1 event where metric > 10000}{
AllRulesInfo=defaultRule = {RULE_TYPE=RULE, STARTED=true, VALUE=select * from DSMonitorEvent
retain 1 event where metric > 10000, ID=defaultRule}}{Databases=}{Name=MonitorProcessor}
{NotificationInfo=[Ljavax.management.MBeanNotificationInfo;@20d319}
{ObjectName=com.bea.wlevs:Name=MonitorProcessor,Type=EPLProcessor,
Application=com.bea.wlevs.dataservices}{PlaybackConfiguration=}{PlayingBack=false}
{RecordConfiguration=}{RecordPlayback=com.bea.wlevs:Name=MonitorProcessor,
Type=RecordPlayback,Application=com.bea.wlevs.dataservices}{Recording=false}
{Type=EPLProcessor}}
Oracle CEPアプリケーションのEPLルールを管理するためのすべてのコマンドでは、アプリケーション名とルールを適用する先の特定のプロセッサ名を把握する必要があります。通常、これらの名前は把握済ですが、把握していない場合はQUERYコマンドを使用してアプリケーションおよびその付属プロセッサを表すMBeanインスタンスから情報を取得できます。
特に、次の-pattern引数を使用すると、所定のOracle CEPインスタンスのすべてのアプリケーション、プロセッサ、およびルールのリストを取得できます。
-pattern com.bea.wlevs:*,Type=EPLProcessor
例:
prompt> java wlevs.Admin -url
service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
QUERY -pretty
-pattern com.bea.wlevs:*,Type=EPLProcessor
このコマンドのサンプル出力を次に示します。
Command Output
------------------------------------------------------
MBeanName: "com.bea.wlevs:Name=helloworldProcessor,Type=EPLProcessor,Application=helloworld,"
AllRules:
helloworldRule = select * from HelloWorldEvent retain 1 event
--end of command output --------
このサンプル出力の項目は次のとおりです。
アプリケーション名はhelloworldです。
helloworldアプリケーションには、helloworldProcessorというプロセッサが含まれます。
helloworldProcessorには、helloworldRuleというルールが含まれます。
指定したプロパティ(属性)値をMBeanに対して設定します。
コマンドが成功した場合、OKを戻してサーバー構成への新しい値を保存します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
SET {-type mbeanType | -mbean objectName}
-property property1 property1_value
[-property property2 property2_value] . . .
表A-29 SET引数
| 引数 | 定義 |
|---|---|
-type mbeanType
|
特定のタイプのすべてのMBeanのプロパティを設定します。詳細は、A.13.1項「MBeanタイプの指定」を参照してください。 |
-mbean objectName
|
"com.bea.wlevs:Name=<name of the stage>,Type=<MBean type>,Application=<name of the deployed application>" |
-property property
|
設定されるプロパティの名前。 |
property _value
|
設定される値。
|
次の例は、helloworldアプリケーションのhelloworldOutstreamというチャネルのMaxSizeプロパティを設定する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
SET -mbean com.bea.wlevs:Name=helloworldOutstream,Type=Channel,Application=helloworld
-property MaxSize 1024
表A-30は、Oracle CEPアプリケーションの特定ステージのイベントの記録および再生を管理するためのコマンドの概要です。後続の項では、コマンド構文および引数について説明し、各コマンドの例を示します。
|
注意: ステージでイベントの記録および再生を制御するためのコマンドを使用する前に、最初に適切なイベントの記録および再生オプションを使用してステージを構成する必要があります。詳細は次を参照してください。
|
表A-30 イベントの記録および再生を制御するためのコマンドの概要
| コマンド | 説明 |
|---|---|
|
Oracle CEPアプリケーションのステージに対してイベントの記録を開始します。 |
|
|
Oracle CEPアプリケーションのステージに対してイベントの記録を停止します。 |
|
|
Oracle CEPアプリケーションのステージに対するイベントの記録に使用するパラメータを構成します。 |
|
|
|
Oracle CEPアプリケーションにおけるステージのイベント記録をスケジュールします。 |
|
|
Oracle CEPアプリケーションにおけるステージのイベント記録構成を一覧表示します。 |
|
Oracle CEPアプリケーションにおけるステージのイベント再生を開始します。 |
|
|
Oracle CEPアプリケーションにおけるステージのイベント再生を停止します。 |
|
|
|
Oracle CEPアプリケーションのステージに対するイベントの再生に使用するパラメータを構成します。 |
|
|
Oracle CEPアプリケーションにおけるステージのイベント再生をスケジュールします。 |
|
|
Oracle CEPアプリケーションにおけるステージのイベント再生構成を一覧表示します。 |
Oracle CEPアプリケーションの特定のステージに対してイベントの記録を開始します。
|
注意: ステージでイベントの記録および再生を制御するためのコマンドを使用する前に、最初に適切なイベントの記録および再生オプションを使用してステージを構成する必要があります。詳細は次を参照してください。
|
ステージを後で記録が開始されるように構成した場合、その構成は無視され、記録はすぐに開始されます。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
STARTRECORD -application application -stage stage
表A-31 STARTRECORD引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage |
特定のステージ名を指定します。このステージは、 |
次の例は、指定したOracle CEPインスタンスへデプロイされたhelloworldアプリケーションのhelloworldAdapterステージでイベントの記録を開始する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
STARTRECORD -application helloworld -stage helloworldAdapter
|
注意: ステージでイベントの記録および再生を制御するためのコマンドを使用する前に、最初に適切なイベントの記録および再生オプションを使用してステージを構成する必要があります。詳細は次を参照してください。
|
以前にイベントの記録を開始したOracle CEPアプリケーションのステージに対して、イベントの記録を停止します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
STOPRECORD -application application -stage stage
表A-32 STOPRECORD引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage |
特定のステージ名を指定します。このステージは、 |
次の例は、指定したOracle CEPインスタンスへデプロイされたhelloworldアプリケーションのhelloworldAdapterステージでイベントの記録を停止する方法を示します。イベントの記録は次のステージに対して開始されていると仮定します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
STOPRECORD -application helloworld -stage helloworldAdapter
Oracle CEPアプリケーションのステージに対するイベントの記録に関連したパラメータを構成します。
通常、このコマンドを使用して最初にステージのイベントの記録を構成したり、データセット名またはプロバイダ名を変更したりします。詳細は、『Oracle Complex Event Processing開発者ガイドfor Eclipse』のイベントの記録および再生の構成に関する項を参照してください。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
CONFIGURERECORD -application application -stage stage
[-datasetName datasetname]
[-storeProvider storeprovidername]
[-eventTypes eventtypes]
[-scheduleStartTime startime]
[-scheduleEndTime endtime | -scheduleDuration duration]
表A-33 CONFIGURERECORD引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage |
特定のステージ名を指定します。このステージは、 |
-datasetName |
イベントの記録先のデータセット名を指定します。 |
-storeProvider |
Oracle CEPサーバーの デフォルトのBDBプロバイダを選択するには、この引数を空白にするか、または 詳細は、『Oracle Complex Event Processing開発者ガイドfor Eclipse』のOracle CEPサーバーのイベント・ストアの構成に関する項を参照してください。 |
-eventTypes |
記録対象の有効なイベント型の名前のカンマ区切りリストを指定します。イベント型は、イベント型リポジトリで定義される必要があります。 |
-scheduleStartTime starttime
|
記録を開始する時刻を指定します。 開始時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、記録を2010年1月20日午前5時に開始するように指定するには、次の値を使用します。 2010-01-20T05:00:00 XMLSchemaの |
-scheduleEndTime endtime
|
記録が終了する実際の時間を指定します。 終了時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、記録を2010年1月20日午後6時に終了するように指定するには、次の値を使用します。 2010-01-20T18:00:00 XMLSchemaの 記録を永久に実行するには、
|
-scheduleDuration duration
|
このステージのイベントの記録が終了するまでの継続時間を指定します。記録を永久に実行するには、
|
この項の例では、指定したOracle CEPインスタンスへデプロイされたhelloworldアプリケーションのhelloworldAdapterのイベントの記録を構成する方法を示します。
次の例では、記録の開始および終了時刻を指定しています。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
CONFIGURERECORD -application helloworld -stage helloworldAdapter
-datasetName myds -storeProvider mysp
-scheduleStartTime 2010-01-20T05:00:00 -scheduleEndndTime 2010-01-20T18:00:00
次の例では、記録の開始時間および継続時間を指定しています。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
CONFIGURERECORD -application helloworld -stage helloworldAdapter
-datasetName myds -storeProvider mysp
-scheduleStartTime 2010-01-20T05:00:00 -scheduleDuration 01:00:00
次の例では、nullの開始時間および継続時間を指定しています。これは、記録が永久に実行されることを意味します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
CONFIGURERECORD -application helloworld -stage helloworldAdapter
-datasetName myds -storeProvider mysp
-scheduleStartTime 2010-01-20T05:00:00 -scheduleDuration null
Oracle CEPアプリケーションのステージに関するイベントの記録に関連付けられるスケジュール・パラメータを構成します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
SCHEDULERECORD -application application -stage stage
[-scheduleStartTime startime]
[-scheduleEndTime endtime | -scheduleDuration duration]
表A-34 SCHEDULERECORD引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage |
特定のステージ名を指定します。このステージは、 |
-scheduleStartTime starttime
|
記録を開始する時刻を指定します。 開始時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、記録を2010年1月20日午前5時に開始するように指定するには、次の値を使用します。 2010-01-20T05:00:00 XMLSchemaの |
-scheduleEndTime endtime
|
記録が終了する実際の時間を指定します。 終了時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、記録を2010年1月20日午後6時に終了するように指定するには、次の値を使用します。 2010-01-20T18:00:00 XMLSchemaの 記録を永久に実行するには、
|
-scheduleDuration duration
|
このステージのイベントの記録が終了するまでの継続時間を指定します。記録を永久に実行するには、
|
この項の例では、指定したOracle CEPインスタンスへデプロイされたhelloworldアプリケーションのhelloworldAdapterのイベント記録のスケジュールを構成する方法を示します。
次の例では、記録の開始および終了時刻を指定しています。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
SCHEDULERECORD -application helloworld -stage helloworldAdapter
-scheduleStartTime 2010-01-20T05:00:00 -scheduleEndndTime 2010-01-20T18:00:00
Oracle CEPアプリケーションの特定のステージに関するイベント記録の構成を一覧表示します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
LISTRECORD -application application -stage stage
表A-35 LISTRECORD引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage |
特定のステージ名を指定します。このステージは、 |
Oracle CEPアプリケーションの特定のステージのイベントの再生を開始します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
STARTPLAYBACK -application application -stage stage
[-filterStartTime starttime]
[-filterEndTime endtime | -filterDuration duration] [-speed speed] [-repeat true | false]
表A-36 STARTPLAYBACK引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage stage |
特定のステージ名を指定します。このステージは、 |
-filterStartTime startime
|
この値以上の記録時間を持つイベントのみが再生に選択されるように指定します。 開始時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、2010年1月20日午前5時以上の記録時間を持つイベントのみを再生するには、次の値を使用します。 2010-01-20T05:00:00 XMLSchemaの すべてのイベントを再生用に指定する場合、 |
-filterEndTime endtime
|
この値以下の記録時間を持つイベントのみが再生に選択されるように指定します。 終了時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、2010年1月20日午後6時以下の記録時間を持つイベントのみを再生するには、次の値を使用します。 2010-01-20T18:00:00 XMLSchemaの
|
-filterDuration duration
|
イベント・ストアでイベントに適用されるフィルタを指定します。フィルタ時間中に記録されたイベントのみが再生用に選択されます。すべてのイベントを再生用に指定する場合、
|
-speed speed
|
再生速度を正のfloatとして指定します。 デフォルト値は1であり、通常の速度に相当します。値2はイベントが元の記録速度の倍の速度で再生されることを意味します。同様に、値0.5はイベントが元の記録速度の半分の速度で再生されることを意味します。 |
-repeat repeat
|
指定された期間の再生が終了した後に、イベントをもう一度再生するかどうかを指定します。 有効な値は、 |
イベントの再生が以前開始されたOracle CEPアプリケーションのステージに関するイベントの再生を停止します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
STOPPLAYBACK -application application -stage stage
表A-37 STOPPLAYBACK引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage stage |
特定のステージ名を指定します。このステージは、 |
次の例は、指定したOracle CEPインスタンスへデプロイされたhelloworldアプリケーションのhelloworldAdapterステージでイベントの再生を停止する方法を示します。イベントの再生は以前に次のステージに対して開始されたと仮定します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
STOPPLAYBACK -application helloworld -stage helloworldAdapter
Oracle CEPアプリケーションのステージに対するイベントの再生に関連したパラメータを構成します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
CONFIGUREPLAYBACK -application application -stage stage
[-datasetName datasetname]
[-storeProvider storeprovidername]
[-eventTypes eventtypes]
[-scheduleStartTime sstart] [-scheduleEndTime send | -scheduleDuration sduration]
[-filterStartTime fstart] [-filterEndTime fend | -filterDuration fduration]
[-speed speed]
[-repeat true | false]
表A-38 CONFIGUREPLAYBACK引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage stage |
特定のステージ名を指定します。このステージは、 |
-datasetName |
イベントの記録先のデータセット名を指定します。 |
-storeProvider |
Oracle CEPサーバーの デフォルトのBDBプロバイダを選択するには、この引数を空白にするか、または 詳細は、『Oracle Complex Event Processing開発者ガイドfor Eclipse』のOracle CEPサーバーのイベント・ストアの構成に関する項を参照してください。 |
-eventTypes |
再生対象の有効なイベント型の名前のカンマ区切りリストを指定します。イベント型は、イベント型リポジトリで定義される必要があります。 |
-scheduleStartTime sstart
|
再生を開始する時間を指定します。 開始時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、再生を2010年1月20日午前5時に開始するように指定するには、次の値を使用します。 2010-01-20T05:00:00 XMLSchemaの |
-scheduleEndTime send
|
再生が終了する実際の時間を指定します。 終了時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、再生を2010年1月20日午後6時に終了するように指定するには、次の値を使用します。 2010-01-20T18:00:00 XMLSchemaの 記録を永久に実行するには、
|
-scheduleDuration sduration
|
このステージのイベントの再生が終了するまでの継続時間を指定します。イベントの再生を永久に実行するには、
|
-filterStartTime fstart
|
この値以上の記録時間を持つイベントのみが再生に選択されるように指定します。 開始時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、2010年1月20日午前5時以上の記録時間を持つイベントのみを再生するには、次の値を使用します。 2010-01-20T05:00:00 XMLSchemaの すべてのイベントを再生用に指定する場合、 |
-filterEndTime fend
|
この値以下の記録時間を持つイベントのみが再生に選択されるように指定します。 終了時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、2010年1月20日午後6時以下の記録時間を持つイベントのみを再生するには、次の値を使用します。 2010-01-20T18:00:00 XMLSchemaの
|
-filterDuration fduration
|
イベント・ストアでイベントに適用されるフィルタを指定します。フィルタ時間中に記録されたイベントのみが再生用に選択されます。すべてのイベントを再生用に指定する場合、
|
-speed speed
|
再生速度を正のfloatとして指定します。 デフォルト値は1であり、通常の速度に相当します。値2はイベントが元の記録速度の倍の速度で再生されることを意味します。同様に、値0.5はイベントが元の記録速度の半分の速度で再生されることを意味します。 |
-repeat repeat
|
指定された期間の再生が終了した後に、イベントをもう一度再生するかどうかを指定します。 有効な値は、 |
この項の例では、指定したOracle CEPインスタンスへデプロイされたhelloworldアプリケーションのhelloworldAdapterのイベントの再生を構成する方法を示します。
次の例では、再生の開始および終了時刻を指定し、再生速度を通常速度の倍にしています。また、指定した時間間隔でのイベントの再生が終了したら、再び再生を開始することを指定しています。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
CONFIGUREPLAYBACK -application helloworld -stage helloworldAdapter
-scheduleStartTime 2010-01-20T05:00:00 -scheduleEndTime 2010-01-20T18:00:00
-speed 2 -repeat true
次の例では、再生の開始時刻と持続時間を指定し、再生速度を通常の半分にしています。また、イベントの再生は1度だけ行います。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
CONFIGUREPLAYBACK -application helloworld -stage helloworldAdapter
-scheduleStartTime 2010-01-20T05:00:00 -scheduleEndTime 2010-01-20T18:00:00
-speed 0.5 -repeat false
次の例では、nullの開始および継続時間を指定しています。これは、再生が通常の速度で永久に実行されることを意味します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
CONFIGUREPLAYBACK -application helloworld -stage helloworldAdapter
-scheduleStartTime 2010-01-20T05:00:00 -scheduleDuration null
Oracle CEPアプリケーションのステージに関するイベントの再生に関連付けられるスケジュール・パラメータを構成します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
SCHEDULEPLAYBACK -application application -stage stage
[-scheduleStartTime startime]
[-scheduleEndTime endtime | -scheduleDuration duration]
表A-39 SCHEDULEPLAYBACK引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage |
特定のステージ名を指定します。このステージは、 |
-scheduleStartTime starttime
|
再生を開始する時間を指定します。 開始時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、再生を2010年1月20日午前5時に開始するように指定するには、次の値を使用します。 2010-01-20T05:00:00 XMLSchemaの |
-scheduleEndTime endtime
|
再生が終了する実際の時間を指定します。 終了時間を次のXMLSchemaの yyyy-mm-ddThh:mm:ss たとえば、再生を2010年1月20日午後6時に終了するように指定するには、次の値を使用します。 2010-01-20T18:00:00 XMLSchemaの 記録を永久に実行するには、
|
-scheduleDuration duration
|
このステージのイベントの再生が終了するまでの継続時間を指定します。記録を永久に実行するには、
|
この項の例では、指定したOracle CEPインスタンスへデプロイされたhelloworldアプリケーションのhelloworldAdapterのイベント再生のスケジュールを構成する方法を示します。
次の例では、イベント再生の開始時間および終了時間を指定しています。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
SCHEDULEPLAYBACK -application helloworld -stage helloworldAdapter
-scheduleStartTime 2010-01-20T05:00:00 -scheduleEndndTime 2010-01-20T18:00:00
Oracle CEPアプリケーションの特定のステージに関するイベント再生の構成を一覧表示します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
LISTPLAYBACK -application application -stage stage
表A-40 LISTPLAYBACK引数
| 引数 | 定義 |
|---|---|
-application application
|
イベントの記録と再生を管理する対象のOracle CEPアプリケーションの名前を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage |
特定のステージ名を指定します。このステージは、 |
表A-41は、Oracle CEPアプリケーションのスループットおよび待機時間を監視するためのコマンドの概要です。後続の項では、コマンド構文および引数について説明し、各コマンドの例を示します。
表A-41 スループットおよび待機時間を監視するためのコマンドの概要
| コマンド | 説明 |
|---|---|
|
イベントが指定されたEPNのパスを通過するのにかかる平均時間または待機時間を監視します。 |
|
|
イベントが指定されたEPNのパスを通過するのにかかる最大時間または待機時間を監視します。 |
|
|
EPNのパスを流れるイベントの平均待機時間が指定されたしきい値を超えたかどうかをモニターします。 |
|
|
指定されたステージのエントリ・ポイントまたは出口ポイントを通過するイベントの数をモニターします。 |
イベントが指定アプリケーションのEPNのパスを通過するのにかかる平均時間または待機時間を監視します。
パスの開始ステージと終了ステージを指定し、それぞれのステージのエントリ・ポイントまたは出口ポイントでパスが開始または終了するかどうかを指定します。パスの開始と終了に同じステージを指定すると、単一のステージを通過するイベントの待機時間をモニターできます。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
MONITORAVGLATENCY -application application
-startStage startStage -startStagePoint stagePoint
-endStage endStage -endStagePoint stagePoint
-avgInterval avgInterval -timeUnit timeUnit
表A-42 MONITORAVGLATENCY引数
| 引数 | 定義 |
|---|---|
-application application
|
スループットおよび待機時間を監視する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-startStage startStage |
待機時間を監視する対象のパスを開始するステージ名を指定します。このステージは、 |
-startStagePoint startStagePoint |
指定した開始ステージの待機時間をモニターするための特定の開始点を指定します。開始ステージのエントリ・ポイントまたは出口ポイントからモニターを開始できます。 有効な値は、 |
-endStage endStage |
待機時間を監視する対象のパスを終了するステージ名を指定します。このステージは、 |
-endStagePoint endStagePoint |
指定した終了ステージの待機時間をモニターするための特定の終了点を指定します。終了ステージのエントリ・ポイントまたは出口ポイントからモニターを終了できます。 有効な値は、 |
-avgInterval avgInterval
|
平均待機時間が計算される期間の平均間隔を指定します。単位を デフォルト値は100です。 |
-timeUnit timeUnit |
待機時間の計算の時間単位を指定します。 有効な値は、 |
次の例では、開始ポイントから終了ポイントまで、helloworldアプリケーションのeplprocessorコンポーネントを通って流れるイベントの平均待機時間を監視する方法を示します。同一のステージが開始および終了ステージの両方(eplprocessor)に指定されるため、待機時間の監視は単一のステージを通って流れるイベントに対してのみ行われます。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
MONITORAVGLATENCY -application helloworld -startStage eplprocessor
-startStagePoint entry -endStage eplprocessor -endStagePoint exit
-avgInterval 100 -timeUnit MILLISECONDS
パスの開始点と終了点の間のイベントの平均待機時間が指定されたしきい値を超えたかどうかをモニターします。
パスの開始ステージと終了ステージを指定し、それぞれのステージのエントリ・ポイントまたは出口ポイントでパスが開始または終了するかどうかを指定します。パスの開始と終了に同じステージを指定すると、単一のステージを通過するイベントの待機時間しきい値をモニターできます。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
MONITORAVGLATENCYTHRESHOLD -application application
-startStage startStage -startStagePoint stagePoint
-endStage endStage -endStagePoint stagePoint
-avgInterval avgInterval -timeUnit timeUnit -threshold threshold
表A-43 MONITORAVGLATENCYTHRESHOLD引数
| 引数 | 定義 |
|---|---|
-application application
|
スループットおよび待機時間を監視する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-startStage startStage |
待機時間のしきい値を監視する対象のパスを開始するステージ名を指定します。このステージは、 |
-startStagePoint startStagePoint |
指定した開始ステージの待機時間のしきい値をモニターするための特定の開始点を指定します。開始ステージのエントリ・ポイントまたは出口ポイントからモニターを開始できます。 有効な値は、 |
-endStage endStage |
待機時間のしきい値を監視する対象のパスを終了するステージ名を指定します。このステージは、 |
-endStagePoint endStagePoint |
指定した終了ステージの待機時間のしきい値をモニターするための特定の終了点を指定します。終了ステージのエントリ・ポイントまたは出口ポイントからモニターを終了できます。 有効な値は、 |
-avgInterval avgInterval
|
平均待機時間のしきい値が計算される平均間隔を指定します。 デフォルト値は100です。単位を |
-timeUnit timeUnit |
待機時間の計算の時間単位を指定します。 有効な値は、 |
-threshold threshold
|
しきい値を指定します。この値を超えると、平均間隔の終わりごとにメトリック・イベントが出力されます。 デフォルト値は100です。単位を |
次の例では、開始ポイントから終了ポイントまで、helloworldアプリケーションのeplprocessorステージにおける平均待機時間が10秒を超えるイベントの平均待機時間のしきい値を監視する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
MONITORAVGLATENCY -application helloworld -startStage eplprocessor
-startStagePoint entry -endStage eplprocessor -endStagePoint exit
-avgInterval 100 -timeUnit MILLISECONDS -threshold 100
指定されたアプリケーションでEPNの指定されたパスを流れるイベントの最大待機時間をモニターします。
パスの開始ステージと終了ステージを指定し、それぞれのステージのエントリ・ポイントまたは出口ポイントでパスが開始または終了するかどうかを指定します。パスの開始と終了に同じステージを指定すると、単一のステージを通過するイベントの最大待機時間をモニターできます。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
MONITORMAXLATENCY -application application
-startStage startStage -startStagePoint stagePoint
-endStage endStage -endStagePoint stagePoint
-maxInterval maxInterval -timeUnit timeUnit
表A-44 MONITORMAXLATENCY引数
| 引数 | 定義 |
|---|---|
-application application
|
スループットおよび待機時間を監視する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-startStage startStage |
最大待機時間を監視する対象のパスを開始するステージ名を指定します。このステージは、 |
-startStagePoint startStagePoint |
指定した開始ステージの最大待機時間をモニターするための特定の開始点を指定します。開始ステージのエントリ・ポイントまたは出口ポイントからモニターを開始できます。 有効な値は、 |
-endStage endStage |
最大待機時間を監視する対象のパスを終了するステージ名を指定します。このステージは、 |
-endStagePoint endStagePoint |
指定した終了ステージの最待機時間をモニターするための特定の終了点を指定します。終了ステージのエントリ・ポイントまたは出口ポイントからモニターを終了できます。 有効な値は、 |
-maxInterval maxInterval
|
最大待機時間が計算される間隔を指定します。 デフォルト値は100です。単位を |
-timeUnit timeUnit |
最大待機時間の計算の時間単位を指定します。 有効な値は、 |
次の例では、開始ポイントから終了ポイントまで、helloworldアプリケーションのeplprocessorステージを通って流れるイベントの最大待機時間を監視する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
MONITORMAXLATENCY -application helloworld -startStage eplprocessor
-startStagePoint entry -endStage eplprocessor -endStagePoint exit
-maxInterval 100 -timeUnit MILLISECONDS
指定されたアプリケーションでEPNのステージのエントリ・ポイントまたは出口ポイントを通過するイベントの平均件数をモニターします。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
MONITORAVGTHROUGHPUT -application application
-stage stage -StagePoint stagePoint
-throughputInterval throughputInterval -avgInterval avgInterval
-timeUnit timeUnit
表A-45 MONITORAVGLATENCY引数
| 引数 | 定義 |
|---|---|
-application application
|
スループットおよび待機時間を監視する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-stage stage |
イベントのスループットを監視する対象のステージ名を指定します。このステージは、 |
-stagePoint stagePoint |
指定したステージのエントリ・ポイントまたは出口ポイントでスループットをモニターするかどうかを指定します。 有効な値は、 |
-throughputInterval throughputInterval
|
スループットが計算されるスループット間隔を指定します。 デフォルト値は100です。単位を |
-avgInterval avgInterval
|
平均スループットが計算される平均間隔を指定します。 デフォルト値は100です。単位を |
-timeUnit timeUnit |
スループットの計算の時間単位を指定します。 有効な値は、 |
次の例では、helloworldアプリケーションのeplprocessorステージの開始ポイントを流れるイベントの数を監視する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
MONITORMAXLATENCY -application helloworld
-stage eplprocessor -stagePoint entry
-throughputInterval 100 -avgInterval 100 -timeUnit MILLISECONDS
表A-46は、Oracle CEPコンポーネントの構成履歴を管理するコマンドの概要です。詳細は、1.3.3項「構成履歴の管理」を参照してください。
後続の項では、コマンド構文および引数について説明し、各コマンドの例を示します。
表A-46 構成履歴を管理するためのコマンドの概要
| コマンド | 説明 |
|---|---|
|
構成履歴の管理コマンドのリストを戻します。 |
|
|
指定期間の変更レコードを削除します。 |
|
|
アプリケーションの変更レコードのリストを戻します。 |
|
|
アプリケーションの構成リソース・リビジョンのリストを戻します。 |
|
|
|
変更レコードIDによって指定された変更レコードをロールバックします。 |
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
CONFIGHISTORY
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
DELETECONFIGCHANGEHISTORY -application application -startTime starttime -endTime endtime
表A-47 DELETECONFIGCHANGEHISTORY引数
| 引数 | 定義 |
|---|---|
-application application
|
Oracle CQLルールを管理する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-startTime starttime
|
変更レコードを削除する期間の開始時間を指定します。
|
-endTime end-ime
|
変更レコードを削除する期間の終了時間を指定します。
|
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
LISTCHANGERECORDS -application application -startTime starttime -endTime endtime
表A-48 GETRULE引数
| 引数 | 定義 |
|---|---|
-application application
|
変更レコードを参照する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-startTime starttime
|
変更レコードの表示をフィルタ処理する期間の開始時間を指定します。
|
-endTime end-ime
|
変更レコードの表示をフィルタ処理する期間の終了時間を指定します。
|
次の例は、helloworldアプリケーションで2007年11月20日11:10:07から11:22:07までに作成されたすべての変更レコードを一覧表示する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
LISTCHANGERECORDS -application helloworld startTime 10-20-2007:11:10:07
-endTime 10-20-2007:11:22:07
アプリケーションの構成リソース・リビジョンのリストを戻します。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
LISTRESOURCEREVISIONS -application application -startTime starttime -endTime endtime
表A-49 GETRULE引数
| 引数 | 定義 |
|---|---|
-application application
|
リソース・リビジョンを参照する対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-startTime starttime
|
リソース・リビジョンのリストをフィルタ処理する期間の開始時間を指定します。
|
-endTime end-ime
|
リソース・リビジョンのリストをフィルタ処理する期間の終了時間を指定します。
|
次の例は、helloworldアプリケーションで2007年11月20日11:10:07から11:22:07までに作成されたすべてのリソース・リビジョンを一覧表示する方法を示します。
prompt> java wlevs.Admin
-url service:jmx:msarmi://localhost:9002/jndi/jmxconnector
-username wlevs -password wlevs
LISTRESOURCEREVISIONS -application helloworld startTime 10-20-2007:11:10:07
-endTime 10-20-2007:11:22:07
変更レコードIDで指定された変更レコードによって定義された変更をロールバックします。
java wlevs.Admin
[ Connection Arguments ]
[ User Credentials Arguments ]
[ Common Arguments ]
UNDOCONFIGCHANGE -application application -recordId changerecordid
表A-50 GETRULE引数
| 引数 | 定義 |
|---|---|
-application application
|
変更レコード元に戻す対象のOracle CEPアプリケーション名を指定します。 アプリケーションの完全一致名を取得するため、次を実行できます:
|
-recordId changerecordid
|
元に戻す変更レコードの識別子を指定します。 変更レコードの識別子を取得するため、次を使用できます: |
