一般的なサーバタスクとドメインタスク

この節では、Oracle CEP Visualizer で実行できる一般的なサーバタスクとドメインタスクについて説明します。

Visualizer は直感的でかなりわかりやすいため、すべてのタスクについてはここで取り上げませんが、以下の共通の一般的なタスクがあり、他の類似のタスクはここから推測できます。

JMX コンフィグレーションの表示

Oracle CEP は、Java Management Extensions (JMX) 仕様に完全に準拠した標準ベースのインタフェースを提供します。ソフトウェアベンダはこれらのインタフェースを使用して、Oracle CEP MBean をモニタし、Oracle CEP ドメインのコンフィグレーションを変更し、ドメイン内のすべてのサーバインスタンスへのこれらの変更の配布 (アクティブ化) をモニタできます。

Visualizer および wlevs.Admin コマンドラインツールはサーバへの接続に JMX を使用します。ただし、これらのツールを使用したり、通常の JMX インタフェースを使用するには、config.xml ファイルで JMX コンフィグレーション情報を使用して Oracle CEP をコンフィグレーションする必要があります。

Visualizer では Oracle CEP サーバの JMX コンフィグレーションの表示のみが可能です。コンフィグレーションを変更するには、サーバの config.xml ファイルを手動で更新する必要があります。詳細については、Oracle CEP で使用する JMX のコンフィグレーションを参照してください。

Oracle CEP サーバの JMX コンフィグレーションを表示するには :

左ペインで、[Domain｜Server] ノードをクリックします。Domain は、Oracle CEP ドメイン名を指します。Server は、サーバインスタンス名を指します。
右ペインで、[JMX] タブをクリックします。
以下の JMX プロパティがテーブルに表示されます。

jndi-service-name—jmx サーバがオブジェクトをバインドする JNDI サービス名。
rmi-service-name—jmx サーバが呼び出しの受信のために登録する RMI サービス名。
rmi-jrmp-port—RMI JRMP JMX 要求をリスンするポート。
rmi-registry-port—RMIRegistry を開始するポート。

コンフィグレーションされたデータソースの表示

Oracle CEP ではリレーショナルデータベースへのアクセスのため Java Database Connectivity (JDBC) 3.0 がサポートされています。

JDBC API では、API をサポートするデータベースサーバや他のタイプの表形式リソースに接続し、対話するための、ベンダに依存しない標準的なメカニズムが提供されます。JDBC javax.sql.DataSource インタフェースは、ドライバで実装されるデータベース接続ファクトリを指定します。DataSource オブジェクトのインスタンスは、アプリケーションがデータベース接続 (java.sql.Connection のインスタンス) を取得するのに使用されます。接続が取得されると、アプリケーションは SQL コマンドを送信し、結果を受信することで、リソースと対話します。

Visualizer では Oracle CEP サーバのデータソースコンフィグレーションの表示のみが可能です。コンフィグレーションを変更するには、サーバの config.xml ファイルを手動で更新する必要があります。詳細については、「リレーショナルデータベースへのアクセスのコンフィグレーション」を参照してください。

Oracle CEP サーバにコンフィグレーションされたデータソースを表示するには :

左ペインで、[Domain｜Server] ノードをクリックします。Domain は、Oracle CEP ドメイン名を指します。Server は、サーバインスタンス名を指します。
右ペインで、[DataSource] タブをクリックします。
[Data Sources] テーブルで、表示するデータソースの名前をクリックして選択します。
以下のような、データソースの基本コンフィグレーションを表示するには、[Data Source] オプションをクリックします。

[Name]—データソースの名前。
[JNDI name]—このデータソースがバインドされる JNDI パス。
[Global Tx Protocol]—1 フェーズコミットや 2 フェーズコミットのエミュレートなど、グローバルトランザクションを処理する際に Oracle CEP がトランザクション分岐に使用するプロトコル。

以下のような、データソースが接続するデータベースの情報を表示するには、[Driver] オプションをクリックします。

[URL]—データベースへの接続に使用されるデータベース URL。この URL にはデータベースの名前や、データベースサーバを実行中のコンピュータのホストとポートなどが含まれます。
[Driver Name]—Oracle CEP がデータベースへの接続に使用するデータベースドライバの名前。Oracle や Derby など、ドライバはデータベースサーバに固有です。
[User Name]—データソースの各接続で使用するデータベースユーザアカウント名。
[Password]—データベースユーザアカウントのパスワード。
[Use XA]—XA ドライバを使用するかどうか。

以下のような、データソースの接続プールプロパティを表示するには、[Connection Pool] オプションをクリックします。

[Initial Capacity]—接続プールの作成時に作成する物理的な接続数。
[Max Capacity]—この接続プールに含めることのできる物理的な接続の最大数。
[Capacity Increment]—必要に応じて、容量を増やす場合の増分。

Jetty サーバのコンフィグレーションの表示

Oracle CEP では、HTTP サーブレットおよび静的リソースをデプロイする Java Web サーバとして Jetty がサポートされています。

Oracle CEP での Jetty サポートは、バージョン 1.2 OSGi HTTP サービスに基づいています。この API では、ランタイムと静的リソースに javax.servlet.Servlet オブジェクトを動的に登録および登録解除する機能が提供されます。

Visualizer では Oracle CEP サーバでコンフィグレーションされた Jetty サーバのコンフィグレーションの表示のみが可能です。コンフィグレーションを変更するには、サーバの config.xml ファイルを手動で更新する必要があります。詳細については、Oracle CEP で使用する Jetty のコンフィグレーションを参照してください。

Oracle CEP サーバにコンフィグレーションされたデータソースを表示するには :

左ペインで、[Domain｜Server] ノードをクリックします。Domain は、Oracle CEP ドメイン名を指します。Server は、サーバインスタンス名を指します。
右ペインで、[HTTP Server] タブをクリックします。
右ペインに、Jetty サーバのプロパティが表示されます。

Jetty サーバの名前。
Jetty サーバがバインドされているネットワーク I/O オブジェクト。
Jetty サーバがバインドされているワークマネージャ名。
この Jetty サーバにデプロイされている Web アプリケーションのリスト、およびアプリケーションのパスとコンテキストパス。

ワークマネージャのコンフィグレーション

Visualizer を使用して既存のワークマネージャのみをコンフィグレーションできます。Visualizer では古いワークマネージャの削除や新しいワークマネージャの作成はできません。サーバの config.xml ファイルを手動で更新する必要があります。詳細については、「ワークマネージャ」を参照してください。

Visualizer を使用して既存のワークマネージャをコンフィグレーションするには :

左ペインで、[Domain｜Server] ノードをクリックします。Domain は、Oracle CEP ドメイン名を指します。Server は、サーバインスタンス名を指します。
右ペインで、[Work Manager] タブをクリックします。
[Work Manager] テーブルで、コンフィグレーションするワークマネージャの名前をクリックして選択します。
ページの下にある [Change] ボタンをクリックします。
ワークマネージャのコンフィグレーションプロパティを更新します。

[Min threads]—タスクの実行にかかる初期時間を短縮するためにサーバが割り当てるスレッドの最小数。
[Max threads]—制約されたワークセットからの要求を実行する同時スレッドの最大数。
[Fair Share]—要求を処理するのに必要なスレッド使用時間の平均。

変更を保存するには [Save] をクリックします。更新を取り消すには [Cancel] をクリックします。

永続イベントストアの表示

Oracle CEP イベントリポジトリ機能を使用すると、イベント処理ネットワーク (EPN) コンポーネントを離れたイベントをデータベーステーブルなどのストアに永続化し、後からそれらを再生したり、イベント Bean などのコンポーネントからイベントに対するクエリを明示的に実行したりすることができます。Oracle CEP では、記録されたイベントがデフォルトでデータベースに格納されるため、独自のアプリケーションで記録および再生機能を使用する前に、データベースサーバの場所と、記録されたイベントが含まれるデータベースサーバの名前を指定する必要があります。

Visualizer では Oracle CEP サーバにコンフィグレーションされたイベントストアの表示のみが可能です。コンフィグレーションを変更するには、サーバの config.xml ファイルを手動で更新する必要があります。詳細については、「Oracle CEP サーバのイベントストアのコンフィグレーション」を参照してください。

Oracle CEP サーバにコンフィグレーションされたイベントストアを表示するには :

左ペインで、[Domain｜Server｜Services｜Event Repository] をクリックします。Domain は、Oracle CEP ドメイン名を指します。Server は、サーバインスタンス名を指します。
コンフィグレーションされているイベントストアが右ペインに表示されます。特に、以下のものが含まれています。

RDBMS プロバイダ名はストアプロバイダの名前を表示します。
データソースはプロバイダに関連付けられた JDBC データソースを表示します。

イベントタイプリポジトリの表示

イベントタイプは、Oracle CEP アプリケーションで処理されるイベントのプロパティを定義します。イベントタイプリポジトリは、サーバのアプリケーションで使用されるすべてのイベントタイプで構成されます。

Visualizer では Oracle CEP サーバにコンフィグレーションされたイベントタイプリポジトリとそれらのイベントタイプの表示のみが可能です。新しいイベントタイプを作成するには、「イベントタイプの作成」を参照してください。

Oracle CEP サーバにコンフィグレーションされたイベントストアを表示するには :

左ペインで、[Domain｜Server｜Services｜Event Type Repository] をクリックします。Domain は、Oracle CEP ドメイン名を指します。Server は、サーバインスタンス名を指します。

右ペインの [Event Name] テーブルに、サーバのアプリケーションで使用されるすべてのイベントタイプのリストが表示されます。

右ペインで、[Event Name] テーブルにあるイベント名をクリックします。下のテキストボックスに、イベントタイプのプロパティが表示されます。たとえば、Strings の first と last、および整数の age という 3 つのプロパティを持つ単純な Name イベントタイプは、以下のようになります。

{first=java.lang.String, last=java.lang.String, age=int}

HTTP パブリッシュ/サブスクライブサーバチャネルのコンフィグレーション

Oracle CEP にはアプリケーションがメッセージをパブリッシュすることのできる HTTP パブリッシュ/サブスクライブサーバが含まれています。アプリケーションにより特定のチャネルにメッセージがパブリッシュされ、他のアプリケーションはこのチャネルをサブスクライブして、パブリッシュされたそれらのメッセージを受信できます。

Visualizer を使用して既存のチャネルを変更するほか、新規に作成したり、既存のチャネルを削除することもできます。Visualizer でチャネルをコンフィグレーションすると、それらは永続化され、サーバが再起動しても保持されます。カスタム http pub-sub アダプタから API を使用してコンフィグレーションされたチャネルは、動的であり、サーバの再起動により失われます。

Visualizer には、Visualizer 自身が使用する事前にコンフィグレーションされた以下のチャネルが含まれており、これらは削除または変更できません。

チャネルの追加

管理者ユーザを使用して Visualizer にログオンしていることを確認します。
左ペインで、[Domain｜Server｜Services｜Http Pub/Sub Server] ノードをクリックします。Domain は、Oracle CEP ドメイン名を指します。Server は、サーバインスタンス名を指します。

右ペインに、Oracle CEP にコンフィグレーションされた HTTP pub-sub サーバのリストを示すテーブルが表示されます。

右ペインで、テーブル内の HTTP pub-sub サーバ名をクリックします。デフォルトのサーバは pubsub です。
右ペインの下の作業領域で、[Channel Pattern] テキストボックスに新しいチャネルの名前を入力します。チャネルは /mychannel のように / で始まる必要があります。
セキュリティを有効にしている場合は、チャネルへのパブリッシュとサブスクライブが許可されているセキュリティロールを選択します。複数の場合は、〔Ctrl〕キーを押しながら選択します。
[Add Channel] をクリックします。新しいチャネルがペイン右上の [Channels] テーブルに表示されます。

既存のチャネルの削除

管理者ユーザを使用して Visualizer にログオンしていることを確認します。
左ペインで、[Domain｜Server｜Services｜Http Pub/Sub server] ノードをクリックします。Domain は、Oracle CEP ドメイン名を指します。Server は、サーバインスタンス名を指します。

右ペインに、Oracle CEP にコンフィグレーションされた HTTP pub-sub サーバのリストを示すテーブルが表示されます。

右ペインで、テーブル内の HTTP pub-sub サーバ名をクリックします。デフォルトのサーバは pubsub です。
[Channels] テーブルで、削除するチャネルの名前をクリックします。
ペイン下部の [Delete Channel] をクリックします。

HTTP パブリッシュ/サブスクライブチャネルにパブリッシュされたメッセージの表示

Visualizer を使用して、Visualizer 自身が使用する事前にコンフィグレーションされたチャネルとユーザ定義チャネルの両方について、現在チャネルにパブリッシュされているメッセージを表示できます。

この機能のサンプルについては、「イベントの記録と再生」のサンプルを参照してください。

上ペインで、[Viewstream] ボタンをクリックします。
右ペインで、[Initialize Client] をクリックします。
[Subscribe Channel] テキストボックスに、Oracle CEP サーバがメッセージをパブリッシュする先のチャネル名を入力します。たとえば、Oracle CEP インストールに付属の記録と再生のサンプルでは、HTTP pub-sub アダプタが /playbackchannel というチャネルにパブリッシュしています。
[Subscribe] をクリックします。

[Received Messages] テキストボックスに、チャネルにパブリッシュされているイベントが表示されます。

チャネルへのサブスクリプションを解除するには、[Unsubscribe] をクリックします。

ロギングのコンフィグレーション

Visualizer では、サーバが出力するログメッセージの重大度やログファイル名などのサーバ全体のロギングコンフィグレーションを変更できます。また、特定のモジュールのロギング情報を表示することも可能ですが、変更はできません。

Visualizer を使用して Oracle CEP のロギングシステムをコンフィグレーションするには :

Visualizer ヘルプ

一般的なサーバ タスクとドメイン タスク

JMX コンフィグレーションの表示

コンフィグレーションされたデータ ソースの表示

Jetty サーバのコンフィグレーションの表示

ワーク マネージャのコンフィグレーション

永続イベント ストアの表示

イベント タイプ リポジトリの表示

HTTP パブリッシュ/サブスクライブ サーバ チャネルのコンフィグレーション