ヘッダーをスキップ
Oracle® Fusion Middleware Oracle Complex Event Processing開発者ガイド
11gリリース1 (11.1.1.6.2) for Eclipse
B61654-04
  目次へ移動
目次
索引へ移動
索引

前
 
次
 

F スキーマ参照: サーバー構成wlevs_server_config.xsd

この付録では、ロギング、Oracle Continuous Query Language (CQL)、Secure Sockets Layer (SSL)、Java Management Extensions (JMX)、HTTPパブリッシュ・サブスクライブなどのOracle CEPサーバーの属性およびサービスを構成するのに使用するXMLの背後にあるスキーマである、welvs_server_config.xsdスキーマの要素へのリファレンスを示します。

F.1 Oracle CEPサーバー構成要素の概要

Oracle CEPは、Oracle CEPサーバー専用の属性およびサービスを構成するために使用するサーバー構成要素の数を提供します。

F.1.2 Oracle CEPサーバー構成ファイルの例

HelloWorldアプリケーションからの次のサンプルOracle CEPサーバー構成ファイルは、多くのOracle CEP要素の使用方法を示します。

<?xml version="1.0" encoding="UTF-8"?>
<n1:config xsi:schemaLocation="http://www.bea.com/ns/wlevs/config/server wlevs_server_config.xsd"
    xmlns:n1="http://www.bea.com/ns/wlevs/config/server" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <domain>
     <name>WLEventServerDomain</name>
  </domain>
 
  <netio>
    <name>NetIO</name>
    <port>9002</port>
  </netio>
  
  <netio>
    <name>sslNetIo</name>
    <ssl-config-bean-name>sslConfig</ssl-config-bean-name>
    <port>9003</port>
  </netio>
  
  <work-manager>
    <name>JettyWorkManager</name>
    <min-threads-constraint>5</min-threads-constraint>
    <max-threads-constraint>10</max-threads-constraint>
  </work-manager>
  
  <jetty>
    <name>JettyServer</name>
    <network-io-name>NetIO</network-io-name>
    <work-manager-name>JettyWorkManager</work-manager-name>
    <secure-network-io-name>sslNetIo</secure-network-io-name>
  </jetty>
    
  <rmi>
    <name>RMI</name>
    <http-service-name>JettyServer</http-service-name>
  </rmi>
 
  <jndi-context>
    <name>JNDI</name>
  </jndi-context>
 
  <exported-jndi-context>
    <name>exportedJndi</name>
    <rmi-service-name>RMI</rmi-service-name>
  </exported-jndi-context>
 
  <jmx>
    <rmi-service-name>RMI</rmi-service-name>
    <rmi-jrmp-port>9999</rmi-jrmp-port>
    <jndi-service-name>JNDI</jndi-service-name>
    <rmi-registry-port>9004</rmi-registry-port>
  </jmx>
  
  <ssl>
    <name>sslConfig</name>
    <key-store>./ssl/evsidentity.jks</key-store>
    <key-store-pass>
        <password>{Salted-3DES}s4YUEvH4Wl2DAjb45iJnrw==</password>
    </key-store-pass>
    <key-store-alias>evsidentity</key-store-alias>
    <key-manager-algorithm>SunX509</key-manager-algorithm>
    <ssl-protocol>TLS</ssl-protocol>
    <enforce-fips>false</enforce-fips>
    <need-client-auth>false</need-client-auth>
  </ssl>
  
  <http-pubsub>
    <name>pubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
      <server-config>
        <supported-transport>
          <types>
            <element>long-polling</element>
          </types>
        </supported-transport>
        <publish-without-connect-allowed>true</publish-without-connect-allowed>
      </server-config>
    <channels>
        <element>
          <channel-pattern>/evsmonitor</channel-pattern>
        </element>
        <element>
          <channel-pattern>/evsalert</channel-pattern>
        </element>
        <element>
          <channel-pattern>/evsdomainchange</channel-pattern>
        </element>
    </channels>
    </pub-sub-bean>
  </http-pubsub>
 
  <!-- Sample cluster configuration -->
  <!--
  <cluster>
    <server-name>myServer</server-name>
    <multicast-address>239.255.0.1</multicast-address>
    <enabled>coherence</enabled> 
    <security>none</security>
    <groups></groups>
  </cluster>
  -->
 
  <logging-service>
    <name>myLogService</name>    
    <log-file-config>myFileConfig</log-file-config>
    <stdout-config>myStdoutConfig</stdout-config>
    <logger-severity>Notice</logger-severity>
    <!-- logger-severity-properties is used to selectively enable logging for
     individual categories -->
    <!--logger-severity-properties>
      <entry>
        <key>org.springframework.osgi.extender.internal.dependencies.startup</key>
        <value>Debug</value>
      </entry>
    </logger-severity-properties-->
  </logging-service>
  
  <log-file>
    <name>myFileConfig</name>
    <rotation-type>none</rotation-type>
  </log-file>
 
  <log-stdout>
    <name>myStdoutConfig</name>
    <stdout-severity>Debug</stdout-severity>
  </log-stdout>
 
</n1:config>

F.2 auth-constraint

この要素を使用すると、channel-constraints要素の認可制約を構成できます。

チャネルの詳細は、「channels」を参照してください。

F.2.1 子要素

auth-constraintサーバー構成要素は、表F-1で一覧表示される子要素をサポートします。

表F-1 auth-constraintの子要素

XMLタグ タイプ 説明

description

string

ロールの説明。

role-name

string

有効なロール名。

『Oracle Fusion Middleware Oracle Complex Event Processing管理者ガイド』のユーザー、グループおよびロールに関する項


F.2.2 属性

auth-constraintサーバー構成要素には属性がありません。

F.2.3

次の例は、Oracle CEPサーバー構成ファイル内のauth-constraint要素の使用方法を示します。

<http-pubsub>
    <name>myPubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
...
        <channel-constraints>
            <element>
...
                <auth-constraint>
                    <description>Administrators</description>
                    <role-name>admin</role-name>
                </auth-constraint>
            </element>
        </channel-constraints>
    </pub-sub-bean>
</http-pubsub>

F.3 bdb-config

この要素を使用すると、Berkeleyデータベース・インスタンスを使用するデフォルトのイベント・ストア・プロバイダを構成できます。

オプションで、F.32項「rdbms-event-store-provider」で説明するように、イベント・ストア・プロバイダとしてリレーショナル・データベースのインスタンスを使用するようにOracle CEPサーバーを構成できます。

F.3.1 子要素

bdb-configサーバー構成要素は、表F-2で一覧表示される子要素をサポートします。

表F-2 bdb-configの子要素

XMLタグ タイプ 説明

db-env-path

string

Oracle CEPサーバーは、サブディレクトリ内でサーバーのDOMAIN_DIR/servername/configディレクトリに関連するBerkeleyデータベースのインスタンスを作成しますが、このサブディレクトリを指定します。ここで、DOMAIN_DIRは、/oracle_cep/user_projects/domains/myDomainなどのドメイン・ディレクトリを参照し、servernamedefaultserverなどのサーバー名を参照します。

デフォルト: bdb

cache-size

long

Berkeleyデータベースのキャッシュ・エントリに使用可能なメモリー量をバイト単位で指定します。キャッシュ・サイズを調整し、Berkeleyデータベースのパフォーマンスをチューニングできます。

詳細は、次を参照してください:

デフォルト: je.maxMemoryPercent * JVM最大メモリー


F.3.2 属性

bdb-configサーバー構成要素には属性がありません。

F.3.3

次の例は、Oracle CEPサーバー構成ファイル内のbdb-config要素の使用方法を示します。

<bdb-config>
    <db-env-path>bdb</db-env-path>
    <cache-size>1000</cache-size>
</bdb-config>

F.4 channels

この要素を使用すると、pubsub-bean要素の1つ以上のチャネルを構成できます。

チャネル・パターンは、常にスラッシュ(/)で開始します。クライアントはこれらのチャネルをサブスクライブし、メッセージのパブリッシュまたは受信のいずれかを行います。

F.4.1 子要素

channelsサーバー構成要素には、1つ以上のelement子要素が含まれ、それぞれの子要素はchannel-pattern子要素およびゼロ以上のmessage-filters子要素を持ちます。各message-filters子要素には、message-filters要素に対応するmessage-filter-namestring値を持つelement子要素が含まれます。

F.4.2 属性

channelsサーバー構成要素には属性がありません。

F.4.3

次の例は、Oracle CEPサーバー構成ファイル内のchannels要素の使用方法を示します。

<http-pubsub>
    <name>myPubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
        <server-config>
            <supported-transport>
                <types>
                    <element>long-polling</element>
                </types>
            </supported-transport>
            <publish-without-connect-allowed>
                true
            </publish-without-connect-allowed>
        </server-config>
        <channels>
            <element>
                <channel-pattern>/evsmonitor</channel-pattern>
            </element>
            <element>
                <channel-pattern>/evsalert</channel-pattern>
            </element>
            <element>
                <channel-pattern>/evsdomainchange</channel-pattern>
            </element>
        </channels>
    </pub-sub-bean>
</http-pubsub>

F.5 channel-constraints

この要素を使用すると、pubsub-bean要素の1つ以上のチャネル制約を構成できます。

チャネルの詳細は、「channels」を参照してください。

F.5.1 子要素

channel-constraintsサーバー構成要素には、1つ以上のelement子要素が含まれ、それぞれの子要素は次の子要素をサポートします。

F.5.2 属性

channel-constraintsサーバー構成要素には属性がありません。

F.5.3

次の例は、Oracle CEPサーバー構成ファイル内のchannel-constraints要素の使用方法を示します。

<http-pubsub>
    <name>myPubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
...
        <channel-constraints>
            <element>
                <channel-resource-collection>
                    <element>
                        <channel-resource-name>Foo</channel-resource-name>
                        <descriptions>
                            <element>Foo</element>
                        </descriptions>
                        <channel-patterns>
                            <element>Foo</element>
                        </channel-patterns>
                        <channel-operations>
                            <element>Foo</element>
                        </channel-operations>
                    </element>
                </channel-resource-collection>
                <auth-constraint>
                    <description>Foo</description>
                    <role-name>Foo</role-name>
                </auth-constraint>
            </element>
        </channel-constraints>
    </pub-sub-bean>
</http-pubsub>

F.6 channel-resource-collection

この要素を使用すると、channel-constraints要素の1つ以上のチャネル・リソース・コレクションを構成できます。

チャネルの詳細は、「channels」を参照してください。

F.6.1 子要素

channel-resource-collectionサーバー構成要素には、表F-3で一覧表示されている子要素をサポートするゼロ以上のelement子要素が含まれます。

表F-3 channel-resource-collectionの子要素

XMLタグ タイプ 説明

channel-resource-name

string

このチャネル・リソース名。

descriptions

string

このチャネル・リソース・コレクションの説明。

この要素には、string値を持つelement子要素が含まれます。

channel-patterns

string

チャネル・パターンを指定します。

この要素には、string値を持つelement子要素が含まれます。

channel-operations

string

チャネルへの操作を指定し、次を含む値を検証します。

  • create

  • delete

  • subscribe

  • publish

この要素には、string値を持つelement子要素が含まれます。


F.6.2 属性

channel-resource-collectionサーバー構成要素には属性がありません。

F.6.3

次の例は、Oracle CEPサーバー構成ファイル内のchannel-resource-collection要素の使用方法を示します。

<http-pubsub>
    <name>myPubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
...
        <channel-constraints>
            <element>
                <channel-resource-collection>
                    <element>
                        <channel-resource-name>Foo</channel-resource-name>
                        <descriptions>
                            <element>Foo</element>
                        </descriptions>
                        <channel-patterns>
                            <element>Foo</element>
                        </channel-patterns>
                        <channel-operations>
                            <element>Foo</element>
                        </channel-operations>
                    </element>
                </channel-resource-collection>
                <auth-constraint>
                    <description>Foo</description>
                    <role-name>Foo</role-name>
                </auth-constraint>
            </element>
        </channel-constraints>
    </pub-sub-bean>
</http-pubsub>

F.7 cluster

この要素を使用すると、Oracle CEPサーバーでクラスタ・コンポーネントを構成できます。

詳細は、『Oracle Fusion Middleware Oracle Complex Event Processing管理者ガイド』のOracle CEPネイティブ・クラスタリングによるマルチサーバー・ドメインの管理に関する項を参照してください。

F.7.1 子要素

clusterサーバー構成要素は、表F-4で一覧表示される子要素をサポートします。

表F-4 クラスタの子要素

XMLタグ タイプ 説明

name

string

このクラスタの名前。詳細は、「name」を参照してください。

server-name

string

一意のサーバー名を指定します。Oracle CEP Visualizerは、サーバーをコンソールで表示するときにこの要素の値を使用します。

デフォルト値:

  • Oracle CEPネイティブ・クラスタリング: WLEvServer-identity。ここで、identityidentity要素の値です。

  • Oracle Coherence:WLEvServer-identity。ここで、identityはOracle Coherenceによって決定されるメンバーIDです。

server-host-name

string

ポイント・ツー・ポイントHTTPマルチサーバー通信に使用されるホスト・アドレスまたはIPを指定します。デフォルト値は、マシンのデフォルトNICに関連付けられたIPアドレスです。

multicast-address

string

この子要素は、マルチサーバー・ドメインのすべてのサーバーが同一のコンピュータにホストされていない場合に必要となります。この場合、multicast-address要素を省略することができ、Oracle CEPはコンピュータのIPアドレスに基づいて自動的にマルチキャスト・アドレスをマルチサーバー・ドメインに割り当てます。

ただし、サーバーが異なるコンピュータ上でホストされる場合、適切なドメイン・ローカル・アドレスを提供する必要があります。Oracleは、239.255.X.X形式のアドレスを使用することをお薦めします。自動で割り当てられたマルチキャスト・アドレスは、このアドレスに基づきます。

このmulticast-addressを使用するすべてのOracle CEPサーバーは、同じサブセット上で稼働する必要があります。

Oracle Coherenceを使用すると、拡張機能もあります。ユニキャスト・アドレスを使用する場合、Oracle CoherenceはWell Knownアドレス(WKA)モードで構成されます。これは、マルチキャストをサポートしない環境で必要です。

multicast-interface

string

マルチキャスト・アドレスのバインド先のインタフェース名。次のいずれかになります。

  • eth0などの単純な名前です。

  • 192.168.1.2などの、NICのバインド先のIPアドレス。

  • NICのバインド先のIPアドレスおよびネットワーク・マスク。192.68.1.2/255.255.255.0のように、/で区切られます。

multicast-port

int

マルチキャスト・トラフィックに使用されるポートを指定します。デフォルト値は9100です。

identity

string

Oracle CEPネイティブ・クラスタリングにのみ適用可能: サーバーのアイデンティティを指定し、1からINT_MAXまでの整数にする必要があります。Oracle CEPは、マルチサーバー操作中にサーバー・アイデンティティを数値的に比較し、最小のアイデンティティを持つサーバーがドメイン・コーディネータになります。マルチサーバー・ドメイン内の各サーバーは、必ず異なるアイデンティティを持つようにしてください。サーバーが同一のアイデンティティを持つ場合、マルチサーバー操作の結果は予測できなくなります。

Oracle Coherenceには適用できません。

enabled

説明を参照

クラスタが有効かどうかを指定します。有効な値:

  • coherence

  • evs4j

  • true: クラスタは有効(Oracle Coherenceモード)

  • false: クラスタは無効(デフォルト)

security

説明を参照

このクラスタのセキュリティ・タイプを指定します。有効な値:

  • none: デフォルト値。マルチサーバー・ドメインにセキュリティを構成しないことを指定します。

  • encrypt: マルチサーバー・メッセージが暗号化されるように指定します。

groups

string

このクラスタが属するグループ名のカンマ区切りのリストを指定します。詳細は、『Oracle Fusion Middleware Oracle Complex Event Processing管理者ガイド』のグループに関する項を参照してください。

operation-timeout

int

ポイント・ツー・ポイントHTTPマルチサーバー・リクエストのタイムアウトをミリ秒単位で指定します。デフォルト値は30000です。


F.7.2 属性

clusterサーバー構成要素には属性がありません。

F.7.3

次の例は、Oracle CEPサーバー構成ファイル内のcluster要素の使用方法を示します。

<cluster>
    <name>MyCluster</name>
    <server-name>myServer1</server-name>
    <multicast-address>239.255.0.1</multicast-address>
    <identity>1</identity> 
    <enabled>true</enabled>
</cluster> 

この例では、cluster要素の一意の識別子はMyClusterです。

F.8 connection-pool-params

この要素を使用すると、接続プール関連のdata-sourceパラメータを指定できます。

F.8.1 子要素

connection-pool-paramsサーバー構成要素は、表F-5で一覧表示される子要素をサポートします。

表F-5 connection-pool-paramsの子要素

XMLタグ タイプ 説明

statement-timeout

int

現在実行中の文がタイムアウトする時間です。statement-timeoutは、基礎となるJDBCドライバ・サポートに依存します。サーバーは、java.sql.Statement.setQueryTimeoutメソッドを使用することによって、JDBCドライバに指定された時間を渡します。JDBCドライバがこのメソッドをサポートしない場合、例外がスローされることがあり、タイムアウト値が無視されます。値を-1に指定すると、この機能は無効になります。値を0に指定すると、文はタイムアウトしないことになります。

デフォルト: -1

profile-harvest-frequency-seconds

int

診断プロファイルの収集操作中の秒数。

デフォルト: 300

inactive-connection-timeout-seconds

int

接続が再要求され、接続プールに解放される前に予約された接続で非アクティブになる秒数。

デフォルト: 0

shrink-frequency-seconds

int

要求を満たすために徐々に増加した接続プールが縮小する前に待機する秒数。

デフォルト: 900

driver-interceptor

string

JDBCドライバへのメソッド・コールを補足するために使用されるアプリケーション・クラスの絶対名を指定します。指定されるアプリケーションは、weblogic.jdbc.extensions.DriverInterceptorインタフェースを実装する必要があります。

seconds-to-trust-an-idle-pool-connection

int

接続がアプリケーションに渡される前、または定期的な接続テストの処理中に、その接続がまだ有効であると信頼されて接続テストがスキップされる接続使用の秒数。

デフォルト: 10

pinned-to-thread

boolean

このオプションは、アプリケーションが論理接続を終了した後でさえもプールされたデータベース接続を維持するための実行スレッドを有効化することによって、パフォーマンスを向上できます。

デフォルト: false

test-connections-on-reserve

boolean

クライアントに渡す前に接続をテストします。test-table-nameを指定する必要があります。

デフォルト: false

profile-type

int

収集対象のプロファイル・データの種類を指定します。

statement-cache-type

string

文キャッシュに格納されたプリコンパイルされた文の管理に使用するアルゴリズム有効な値:

  • LRU: 新しいプリコンパイルされた文または呼出し可能な文が使用されるときに、最も長い期間使用されていない文がキャッシュ内で置換されます。

  • FIXED: プリコンパイルされた文および呼出し可能な文の最初の固定数がキャッシュされます。

デフォルト: LRU

connection-reserve-timeout-seconds

int

接続プールからの接続を予約するコールがタイムアウトするまでの秒数。0に設定すると、コールはタイムアウトしません。-1に設定すると、コールはすぐにタイムアウトします。

デフォルト: -1

credential-mapping-enabled

boolean

アプリケーションがデータベース接続をリクエストするとき、サーバーがデータベースIDのマップに基づいてデータベース接続上で軽量クライアントIDを設定することを有効化します。

デフォルト: false

login-delay-seconds

int

各物理データベース接続を作成するまでにかかる遅延時間の秒数。この遅延により、短時間に連続する複数の接続リクエストを処理できないデータベース・サーバーがサポートされます。遅延は、物理データベース接続が作成されるときは常に、初期データ・ソースの作成時およびデータ・ソースの存続期間中に発生します。

デフォルト: 0

test-table-name

string

物理データベース接続のテスト時に使用するデータベース表の名前。この名前は、test-frequency-secondsを指定し、test-reserved-connectionsを有効化するときに必要になります。接続テストに使用されるデフォルトのSQLコードはselect count(*) from test-table-nameです。ここで、test-table-nameはtest-table-name要素の値です。大半のデータベース・サーバーは、表スキャンを回避するためにこのSQLを最適化しますが、表名にtest-table-nameを設定してもよいでしょう。この表は、行をほとんど持たないか、あるいはまったく持ちません。test-table-nameがSQLで始まる場合、その先行トークンに続く残りの文字列は、標準の問合せのかわりに接続テストに使用されるリテラルのSQL文と解釈されます。

statement-cache-size

int

キャッシュに保存されるプリコンパイルされた文および呼出し可能な文の数で、1から1024までになります。これによって、サーバーのパフォーマンスが向上することがあります。

デフォルト: 10

init-sql

string

これを実行するためのSQL文は、新しく作成された物理データベース接続を初期化します。文はSQLで開始し、次にスペースを入れます。

connection-creation-retry-frequency-seconds

int

データベースへの接続確立を試行する間隔の秒数。この値を設定しないと、データ・ソース作成はデータベースが使用できない場合に失敗します。値を設定し、データ・ソースの作成時にデータベースが使用できない場合、サーバーは、指定する秒数後にもう一度プール内で接続の作成を試行し、成功するまで接続の作成を試行し続けます。0に設定すると、接続の再試行は無効化されます。

デフォルト: 0

test-frequency-seconds

int

未使用の接続がサーバーにテストされる秒間隔。(「テスト対象の表名」を指定する必要があります)テストに失敗した接続は閉じられ、再度開かれて有効な物理接続が再確立されます。テストが再度失敗すると、その接続は閉じられます。マルチ・データ・ソースでは、サーバーが以前に異常とマークしたデータ・ソースの状態をチェックする頻度をこの属性が制御します。0に設定すると、この機能は無効化されます。

デフォルト: 120

jdbc-xa-debug-level

int

XAドライバのJDBCデバッグ・レベルを指定します。

デフォルト: 10

initial-capacity

int

データ・ソースで接続プールの作成時に作成する物理接続数。この接続数を作成できない場合、データ・ソースの作成は失敗します。

デフォルト: 1

max-capacity

int

この接続プールが保持可能な物理接続の最大数。

デフォルト: 15

capacity-increment

int

新規接続の接続プールへの追加時に作成される接続数。

デフォルト: 1

highest-num-waiters

int

データ・ソースの接続プールから接続を予約するために待機している間に、スレッドを同時実行的にブロックできる接続リクエストの最大数。

デフォルト: Integer.MAX_VALUE


F.8.2 属性

connection-pool-paramsサーバー構成要素には属性がありません。

F.8.3

次の例は、Oracle CEPサーバー構成ファイル内のconnection-pool-params要素の使用方法を示します。

<data-source>
    <name>orads</name>
    <xa-params>
        <keep-xa-conn-till-tx-complete>true</keep-xa-conn-till-tx-complete>
    </xa-params>
    <driver-params>
        <url>jdbc:oracle:thin:@localhost:1521:ce102</url>
        <driver-name>oracle.jdbc.OracleDriver</driver-name>
        <properties>
            <element>
                <name>user</name>
                <value>wlevs</value>
            </element>
            <element>
                <name>password</name>
                <value>wlevs</value>
            </element>
        </properties>
    </driver-params>
    <connection-pool-params>
        <initial-capacity>5</initial-capacity>
        <max-capacity>10</max-capacity>
        <test-table-name>SQL SELECT 1 FROM DUAL</test-table-name>
        <test-frequency-seconds>5</test-frequency-seconds>
    </connection-pool-params>
    <data-source-params>
        <jndi-names>
            <element>orads</element>
        </jndi-names>
        <global-transactions-protocol>None</global-transactions-protocol>
    </data-source-params>
</data-source>

F.9 cql

この要素を使用すると、Oracle CEPサーバーでOracle CQL専用オプションを構成できます。

F.9.1 子要素

cqlサーバー構成要素は、次の子要素をサポートしています。

F.9.2 属性

cqlサーバー構成要素には属性がありません。

F.9.3

次の例は、Oracle CEPサーバー構成ファイル内のcql要素の使用方法を示します。

<cql>
    <name>myCQL</name>
    <storage>
        <folder>myfolder</folder>
        <metadata-name>myname</metadata-name>
    </storage>
    <scheduler>
        <class-name>myclass</class-name>
        <threads>10</threads>
        <direct-interop>false</direct-interop>
    </scheduler>
</cql>

この例では、cql要素の一意の識別子はmyCQLです。

F.10 data-source

この構成タイプは、DataSourceサービスの構成を定義します。

F.10.1 子要素

data-sourceサーバー構成要素は、次の子要素をサポートしています。

F.10.2 属性

data-sourceサーバー構成要素には属性がありません。

F.10.3

次の例は、Oracle CEPサーバー構成ファイル内のdata-source要素の使用方法を示します。

<data-source>
    <name>orads</name>
    <driver-params>
        <url>jdbc:oracle:thin:@localhost:1521:ce102</url>
        <driver-name>oracle.jdbc.OracleDriver</driver-name>
        <properties>
            <element>
                <name>user</name>
                <value>wlevs</value>
            </element>
            <element>
                <name>password</name>
                <value>wlevs</value>
            </element>
        </properties>
    </driver-params>
    <connection-pool-params>
        <initial-capacity>5</initial-capacity>
        <max-capacity>10</max-capacity>
        <test-table-name>SQL SELECT 1 FROM DUAL</test-table-name>
        <test-frequency-seconds>5</test-frequency-seconds>
    </connection-pool-params>
    <data-source-params>
        <jndi-names>
            <element>orads</element>
        </jndi-names>
        <global-transactions-protocol>None</global-transactions-protocol>
    </data-source-params>
</data-source>

この例では、data-source要素の一意の識別子はoradsです。

F.11 data-source-params

この要素を使用すると、データ・ソース関連のdata-sourceパラメータを指定できます。

F.11.1 子要素

data-source-paramsサーバー構成要素は、表F-6で一覧表示される子要素をサポートします。

表F-6 data-source-paramsの子要素

XMLタグ タイプ 説明

algorithm-type

説明を参照

マルチ・データ・ソースの接続リクエスト処理を決定するアルゴリズム。有効な値:

  • Failover

  • Load-Balancing

デフォルト: Failover

stream-chunk-size

int

ストリーム・データ型のデータ・チャンク・サイズを1から65536まで指定します。

デフォルト: 256

row-prefetch

boolean

1回のサーバー・アクセスで複数の行がプリフェッチされる(つまり、サーバーからクライアントに送信される)かどうかを指定します。

デフォルト: false

data-source-list

string

マルチ・データ・ソースが接続リクエストをルーティングする対象のデータ・ソースのリスト。リスト内のデータ・ソースの順序は、フェイルオーバーの順序を決定します。

failover-request-if-busy

boolean

フェイルオーバー・アルゴリズムを使用するマルチ・データ・ソースでは、現在のデータ・ソースのすべての接続が使用中である場合に、接続リクエストを次のデータ・ソースにフェイルオーバーできます。

デフォルト: false

row-prefetch-size

int

行のプリフェッチが有効化されている場合、クライアント用にプリフェッチする結果セットの行数を2から65536まで指定します。

デフォルト: 48

jndi-names

説明を参照

このデータ・ソースのバインド先のJNDIパス。デフォルトでは、JNDI名はデータ・ソースの名前です。この要素には、次の子要素が含まれます。

  • element: 有効なdata-source要素の文字列名を含みます。詳細は、「data-source」を参照してください。

  • config-data-source-DataSourceParams-JNDINames.

scope

boolean

データ・ソースの範囲を指定します。GlobalのみはMSAでサポートされる範囲なので注意してください。

デフォルト: Global

connection-pool-failover-callback-handler

string

マルチ・データ・ソースがマルチ・データ・ソース内の別のデータ・ソースに接続リクエストをフェイルオーバーまたはフェイルバックする準備ができているときに、送られたコールバックを処理するアプリケーション・クラスの名前。この名前は、weblogic.jdbc.extensions.ConnectionPoolFailoverCallbackインタフェースを実装するアプリケーション・クラスの絶対名です。

global-transactions-protocol

int

データ・ソースのトランザクション・プロトコル(グローバル・トランザクション処理動作)を決定します。有効な値:

  • TwoPhaseCommit: 標準XA トランザクション処理。XAドライバが必要です。

  • LoggingLastResource: 1つの非XAリソースに対するパフォーマンス強化。

  • EmulateTwoPhaseCommit: 1つの非XAリソースがグローバル・トランザクションに参加することを有効化します。ただし、データにリスクが発生することがあります。

  • OnePhaseCommit: 非XAドライバを使用した、1フェーズXAトランザクション処理。これはデフォルト設定です。

  • None: ローカル・トランザクションのみサポートします。

デフォルト: OnePhaseCommit


F.11.2 属性

data-source-paramsサーバー構成要素には属性がありません。

F.11.3

次の例は、Oracle CEPサーバー構成ファイル内のdata-source-params要素の使用方法を示します。

<data-source>
    <name>orads</name>
    <xa-params>
        <keep-xa-conn-till-tx-complete>true</keep-xa-conn-till-tx-complete>
    </xa-params>
    <driver-params>
        <url>jdbc:oracle:thin:@localhost:1521:ce102</url>
        <driver-name>oracle.jdbc.OracleDriver</driver-name>
        <properties>
            <element>
                <name>user</name>
                <value>wlevs</value>
            </element>
            <element>
                <name>password</name>
                <value>wlevs</value>
            </element>
        </properties>
    </driver-params>
    <connection-pool-params>
        <initial-capacity>5</initial-capacity>
        <max-capacity>10</max-capacity>
        <test-table-name>SQL SELECT 1 FROM DUAL</test-table-name>
        <test-frequency-seconds>5</test-frequency-seconds>
    </connection-pool-params>
    <data-source-params>
        <jndi-names>
            <element>orads</element>
        </jndi-names>
        <global-transactions-protocol>None</global-transactions-protocol>
    </data-source-params>
</data-source>

F.12 driver-params

この要素を使用すると、JDBCドライバ関連のdata-sourceパラメータを指定できます。

F.12.1 子要素

driver-paramsサーバー構成要素は、表F-7で一覧表示される子要素をサポートします。

表F-7 driver-paramsの子要素

XMLタグ タイプ 説明

use-xa-data-source-interface

boolean

サーバーがJDBCドライバのXAインタフェースを使用するように指定します。データベース接続の作成に使用されるJDBCドライバ・クラスが、JDBCドライバのXAおよび非XAバージョンの両方を実装する場合、この属性を設定して、サーバーがJDBCドライバをXAドライバまたは非XAドライバとして処理することを指定するようにできます。

デフォルト: true

password

string

物理データベース接続の作成時にJDBCドライバに渡されるパスワード属性。

driver-name

string

データ・ソースの接続プールで物理データベース接続の作成に使用するJDBCドライバ・クラスの完全パッケージ名。

url

string

データベースの接続先のURL。URLの書式は、使用するJDBCドライバによって異なります。このURLは、物理データベース接続を作成するためにJDBCドライバに渡されます。

properties

string

物理データベース接続の作成時にJDBCドライバに渡されるプロパティのリストを指定します。この要素には、次の子要素を持つ1つ以上のelement子要素が含まれます。

  • name: プロパティ名。

  • value: プロパティ値。


F.12.2 属性

driver-paramsサーバー構成要素には属性がありません。

F.12.3

次の例は、Oracle CEPサーバー構成ファイル内のdriver-params要素の使用方法を示します。

<data-source>
    <name>orads</name>
    <xa-params>
        <keep-xa-conn-till-tx-complete>true</keep-xa-conn-till-tx-complete>
    </xa-params>
    <driver-params>
        <url>jdbc:oracle:thin:@localhost:1521:ce102</url>
        <driver-name>oracle.jdbc.OracleDriver</driver-name>
        <properties>
            <element>
                <name>user</name>
                <value>wlevs</value>
            </element>
            <element>
                <name>password</name>
                <value>wlevs</value>
            </element>
        </properties>
    </driver-params>
    <connection-pool-params>
        <initial-capacity>5</initial-capacity>
        <max-capacity>10</max-capacity>
        <test-table-name>SQL SELECT 1 FROM DUAL</test-table-name>
        <test-frequency-seconds>5</test-frequency-seconds>
    </connection-pool-params>
    <data-source-params>
        <jndi-names>
            <element>orads</element>
        </jndi-names>
        <global-transactions-protocol>None</global-transactions-protocol>
    </data-source-params>
</data-source>

F.13 domain

この要素を使用すると、Oracle CEPサーバーでドメイン名を構成できます。

F.13.1 子要素

domainサーバー構成要素は、次の子要素をサポートしています。

F.13.2 属性

domainサーバー構成要素には属性がありません。

F.13.3

次の例は、Oracle CEPサーバー構成ファイル内のdomain要素の使用方法を示します。

<domain>
    <name>WLEventServerDomain</name>
</domain>

この例では、domainの一意の識別子はWLEventServerDomainです。

F.14 debug

この要素を使用すると、Oracle CEPサーバーの1つ以上のデバッグ・プロパティを構成できます。

F.14.1 子要素

debugサーバー構成要素は、表F-8で一覧表示される子要素をサポートします。

表F-8 debugの子要素

XMLタグ タイプ 説明

name

string

このdebug構成の名前。詳細は、「name」を参照してください。

debug-properties

string

デバッグ・フラグ名(そのパッケージ名は使用せずに)を使用し、値をtrueに指定することによって、1つ以上の子要素が形成されます。

すべてのデバッグ・フラグの完全リストに関する詳細は、『Oracle Fusion Middleware Oracle Complex Event Processing管理者ガイド』の構成ファイルを使用したOracle CEPデバッグ・オプションの構成方法に関する項を参照してください。


F.14.2 属性

debugサーバー構成要素には属性がありません。

F.14.3

次の例では、Oracle CEPサーバー構成ファイル内でデバッグ・フラグcom.bea.core.debug.DebugSDSを使用して、Simple Declarative Services (SDS) デバッグ処理を有効にするためのdebug要素の使用方法を示します。

<debug>
    <name>myDebug</name>
    <debug-properties>
        <DebugSDS>true</DebugSDS>
...
    </debug-properties>
</debug>

F.15 event-store

この要素を使用すると、Oracle CEPサーバーのイベント・ストアを構成できます。

F.15.1 子要素

event-storeサーバー構成要素は、表F-9で一覧表示される子要素をサポートします。

表F-9 event-storeの子要素

XMLタグ タイプ 説明

name

string

このdebug構成の名前。詳細は、「name」を参照してください。

provider-order

string

Oracle CEPサーバーがアクセスする順序で1つ以上のprovider子要素の名前を指定します。

詳細は、次を参照してください:


F.15.2 属性

event-storeサーバー構成要素には属性がありません。

F.15.3

次の例は、Oracle CEPサーバー構成ファイル内のevent-store要素の使用方法を示します。

<config>
    <event-store>
        <name>myEventStore</name>
        <provider-order>
            <provider>provider1</provider>
            <provider>provider2</provider>
        </provider-order>
    </event-store>
</config>

この例では、adapterの一意の識別子はmyEventStoreです。

F.16 exported-jndi-context

この構成タイプは、RMIを使用してクライアントからアクセス可能なリモートJNDIサービスをエクスポートするために使用されます。これによってRMIサービスを使用するJNDIコンテキストが登録されるため、InitialContextオブジェクトの作成時にプロバイダURLパラメータを渡すクライアントによってリモートからアクセスできます。このサービスでは、jndi-context構成オブジェクトも指定される必要があります。指定されない場合、このサービスを開始できません。

F.16.1 子要素

exported-jndi-contextサーバー構成要素は、表F-10で一覧表示される子要素をサポートします。

表F-10 exported-jndi-contextの子要素

XMLタグ タイプ 説明

name

string

このdebug構成の名前。詳細は、「name」を参照してください。

rmi-service-name

string

ネットワークでこのJNDIコンテキストを処理するために使用されるRMIサービスの名前。構成内の既存のRMIオブジェクトと一致する必要があります。詳細は、「rmi」を参照してください。


F.16.2 属性

exported-jndi-contextサーバー構成要素には属性がありません。

F.16.3

次の例は、Oracle CEPサーバー構成ファイル内のexported-jndi-context要素の使用方法を示します。

<rmi>
    <name>myRMI</name>
    <http-service-name>TestJetty</http-service-name>
</rmi>

<exported-jndi-context>
    <name>RemoteJNDI</name>
    <rmi-service-name>myRMI</rmi-service-name>
</exported-jndi-context>

この例では、adapterの一意の識別子はRemoteJNDIです。

F.17 http-pubsub

この要素を使用すると、HTTPパブリッシュ/サブスクライブ・サービスを構成できます。

F.17.1 子要素

http-pubsubサーバー構成要素は、次の子要素をサポートしています。

F.17.2 属性

http-pubsubサーバー構成要素には属性がありません。

F.17.3

次の例は、Oracle CEPサーバー構成ファイル内のhttp-pubsub要素の使用方法を示します。

<http-pubsub>
    <name>myPubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
        <server-config>
            <supported-transport>
                <types>
                    <element>long-polling</element>
                </types>
            </supported-transport>
            <publish-without-connect-allowed>
                true
            </publish-without-connect-allowed>
        </server-config>
        <channels>
            <element>
                <channel-pattern>/evsmonitor</channel-pattern>
            </element>
            <element>
                <channel-pattern>/evsalert</channel-pattern>
            </element>
            <element>
                <channel-pattern>/evsdomainchange</channel-pattern>
            </element>
        </channels>
    </pub-sub-bean>
</http-pubsub>

この例では、http-pubsub要素の一意の識別子はmyPubsubです。

F.18 jetty

この要素を使用すると、Jetty HTTPサーバーのインスタンスを構成できます。

F.18.1 子要素

jettyサーバー構成要素は、表F-11で一覧表示される子要素をサポートします。

表F-11 jettyの子要素

XMLタグ タイプ 説明

name

string

このjetty要素の名前。詳細は、「name」を参照してください。

network-io-name

string

使用されるネットワークI/Oサービス名。これは、サーバーがどのポートでリスニングするかも定義します。このパラメータは、有効な「netio」構成オブジェクトの名前を参照する必要があります。

work-manager-name

string

スレッドのプールに使用されるワーク・マネージャの名前。このパラメータが指定されない場合、Jettyはデフォルトのワーク・マネージャを使用します。詳細は、「work-manager」を参照してください。

scratch-directory

string

Webアプリケーション、JSP、およびその他のWebアーティファクトに必要な一時ファイルが保持されるディレクトリ名。このパラメータは、jetty-web-app要素上のscratch-directoryパラメータによってオーバーライドされます。このディレクトリが存在しない場合、作成されます。

debug-enabled

boolean

Jettyコードにおけるデバッグ処理を有効にします。指定されたデバッグ・メッセージは、ログ・サービスにおけるすべての他のDebugレベル・メッセージと同じ方法でログに記録されます。

listen-port

int

設定されるネットワーク・ポートの名前。このパラメータは、network-io-nameパラメータが指定されない場合には設定できません。このパラメータがnetwork-io-nameのかわりに使用されるとき、netioモジュールを必要としない指定されたソケットI/Oサブシステムが使用されます。

secure-network-io-name

string

セキュアな通信に使用されるネットワークI/Oサービス名。指定されたサービスは、SSL暗号化をサポートするために構成される必要があります。このパラメータは、有効なnetio構成オブジェクトの名前を参照する必要があります。


F.18.2 属性

jettyサーバー構成要素には属性がありません。

F.18.3

次の例は、Oracle CEPサーバー構成ファイル内のjetty要素の使用方法を示します。

<jetty>
    <name>TestJetty</name>
    <work-manager-name>WM</work-manager-name>
    <network-io-name>Netio</network-io-name>
    <secure-network-io-name>SecureNetio</secure-network-io-name>
    <debug-enabled>false</debug-enabled>
    <scratch-directory>JettyWork</scratch-directory>
</jetty>

この例では、jetty要素の一意の識別子はTestJettyです。

F.19 jetty-web-app

この要素を使用すると、Jettyによって使用されるWebアプリケーションを表示できます。このオブジェクトの各インスタンスは、Jettyサービスを使用することによってデプロイされる必要があるWebアプリケーションを表します。

F.19.1 子要素

jetty-web-appサーバー構成要素は、表F-12で一覧表示される子要素をサポートします。

表F-12 jetty-web-appの子要素

XMLタグ タイプ 説明

name

string

このjetty-web-app要素の名前。詳細は、「name」を参照してください。

context-path

string

このWebアプリケーションがWebサーバーのネームスペースにデプロイされるコンテキスト・パス。

デフォルト: /

scratch-directory

string

JettyがこのWebアプリケーションの一時ファイルを保存する場所。このパラメータは、jetty要素上のscratch-directoryパラメータをオーバーライドします。このディレクトリが存在しない場合、作成されます。

path

string

サーバー上のWebアプリケーションの場所を指すファイル名。ディレクトリまたはWARファイルを指定できます。

jetty-name

string

このWebアプリケーションがデプロイされるJettyサービス名。この名前は、既存のjetty構成オブジェクトの名前に一致する必要があります。詳細は、「jetty」を参照してください。


F.19.2 属性

jetty-web-appサーバー構成要素には属性がありません。

F.19.3

次の例は、Oracle CEPサーバー構成ファイル内のjetty-web-app要素の使用方法を示します。

<jetty-web-app>
    <name>financial</name>
    <context-path>/financial</context-path>
    <path>../testws2/financialWS.war</path>
    <jetty-name>TestJetty</jetty-name>
</jetty-web-app> 

この例では、jetty-web-app要素の一意の識別子はfinancialです。

F.20 jmx

この要素を使用すると、Oracle CEPサーバーでJava Management Extension (JMX) のプロパティを構成できます。

F.20.1 子要素

jmxサーバー構成要素は、表F-13で一覧表示される子要素をサポートします。

表F-13 jmxの子要素

XMLタグ タイプ 説明

name

string

このdebug構成の名前。詳細は、「name」を参照してください。

rmi-service-name

string

ネットワークでこのJNDIコンテキストを処理するために使用されるRMIサービスの名前。構成内の既存のRMIオブジェクトと一致する必要があります。詳細は、「rmi」を参照してください。

jndi-service-name

string

JMXサーバーがそのオブジェクトをバインドする先のJNDIサービス名。


F.20.2 属性

jmxサーバー構成要素には属性がありません。

F.20.3

次の例は、Oracle CEPサーバー構成ファイル内のjmx要素の使用方法を示します。

<jmx>
    <name>myJMX</name>
    <jndi-service-name>JNDI</jndi-service-name>
    <rmi-service-name>RMI</rmi-service-name>
</jmx>

この例では、jmx要素の一意の識別子はmyJMXです。

F.21 jndi-context

この構成オブジェクトは、JNDIプロバイダの構成に使用されます。構成内に配置されると、MSA JNDIコンテキストが初期化されます。この構成タイプの1つのインスタンスは、JNDIサービスが使用される場合に、exported-jndi-context構成タイプによってローカルまたはリモートのいずれかで構成内に配置される必要があります。

F.21.1 子要素

jndi-contextサーバー構成要素は、表F-14で一覧表示される子要素をサポートします。

表F-14 jndi-contextの子要素

XMLタグ タイプ 説明

name

string

このdebug構成の名前。詳細は、「name」を参照してください。

default-provider

string

このパラメータのデフォルトは、trueです。falseに設定される場合、プロバイダはデフォルトとしてインストールされません。プロバイダは、DefaultProvidertrueに設定されている構成で1つ以上のJNDIContextType Beanが存在するかぎり、デフォルトとして設定されます。構成内に複数のJNDIContextTypeオブジェクトが配置されている場合、その影響は1つのオブジェクトが起動された場合と同一になります。


F.21.2 属性

jndi-contextサーバー構成要素には属性がありません。

F.21.3

次の例は、Oracle CEPサーバー構成ファイル内のjndi-context要素の使用方法を示します。

<jndi-context>
    <name>myJNDI</name>
    <default-provider>true</default-provider>
</jndi-context>

この例では、adapterの一意の識別子はmyJNDIです。

F.22 log-file

この要素を使用すると、Oracle CEPサーバーでファイルへのロギングを構成できます。

F.22.1 子要素

log-fileサーバー構成要素は、表F-15で一覧表示される子要素をサポートします。

表F-15 log-fileの子要素

XMLタグ タイプ 説明

name

string

このwork-manager要素の名前。詳細は、「name」を参照してください。

number-of-files-limited

boolean

ローテーションされたファイルを永久に保存するかどうかを決定します。

デフォルト: false

rotation-type

string

ログ・ファイルのローテーション方法をサイズ・ベースまたは時間ベースで行うか、あるいはまったく行わないかを決定します。有効な値:

  • bySize

  • byTime

  • none

デフォルト: bySize

rotation-time

string

最初のローテーションが発生したときの時間(k:mm形式)。ここで、kは24時間表記の時刻、mmは分を示します。

デフォルト: 00:00

rotated-file-count

int

ローテーションされた古いファイルを削除する場合、このパラメータによって最新のファイルを常に保存する数が決定されます。

デフォルト: 7

rotation-size

int

ログ・ファイルがローテーションされるときのサイズのしきい値(単位はKB)。

デフォルト: 500

rotation-time-span-factor

long

時間ベースのログ・ローテーションの頻度となる一定のミリ秒に到達すると期間に適用される倍率。

デフォルト: (long)(3600 * 1000)

rotation-time-span

int

各時間ベースのログ・ローテーションの間隔。

デフォルト: 24

base-log-file-name

string

ログ・ファイル名。

デフォルト: server.log

rotate-log-on-startup-enabled

boolean

起動時にログ・ファイルをローテーションするかどうかを指定します。

デフォルト: true

log-file-severity

string

ハンドラに伝播されるメッセージのしきい値の重要度を指定します。デフォルトはInfoで、重大度がDebugまたはTraceのいずれかに設定されていることを保証する必要があるDebugおよびTraceメッセージを確認できます。有効な値:

  • Emergency

  • Alert

  • Critical

  • Error

  • Warning

  • Notice

  • Info

  • Debug

  • Trace

デフォルト: Notice

log-file-rotation-dir

string

ローテーションされた古いファイルが保存されているディレクトリ。設定しない場合、古いファイルはベース・ログ・ファイルとして同一ディレクトリ内に保存されます。


F.22.2 属性

log-fileサーバー構成要素には属性がありません。

F.22.3

次の例は、Oracle CEPサーバー構成ファイル内のlog-file要素の使用方法を示します。

<log-file>
    <name>logFile</name>
    <number-of-files-limited>true</number-of-files-limited>
    <rotated-file-count>4</rotated-file-count>
    <rotate-log-on-startup-enabled>true</rotate-log-on-startup-enabled>
</log-file>

この例では、log-file要素の一意の識別子はlogFileです。

F.23 log-stdout

この要素を使用すると、Oracle CEPサーバーで標準出力(コンソール)へのロギングを構成できます。

F.23.1 子要素

log-stdoutサーバー構成要素は、表F-16で一覧表示される子要素をサポートします。

表F-16 log-stdoutの子要素

XMLタグ タイプ 説明

name

string

このwork-manager要素の名前。詳細は、「name」を参照してください。

stack-trace-depth

int

標準出力に表示するスタック・トレース・フレーム数を決定します。すべてのフレームはログ・ファイルに表示されます。値を-1に設定すると、すべてのフレームが表示されます。

デフォルト: -1

stack-trace-enabled

boolean

ログ記録されたメッセージに含まれるとき、スタック・トレースをコンソールにダンプするかどうかを指定します。

デフォルト: true

stdout-severity

string

ハンドラに伝播されるメッセージのしきい値の重要度を定義します。デフォルトはInfoで、重大度がDebugまたはTraceのいずれかに設定されていることを保証する必要があるDebugおよびTraceメッセージを確認できます。有効な値:

  • Emergency

  • Alert

  • Critical

  • Error

  • Warning

  • Notice

  • Info

  • Debug

  • Trace

デフォルト: Notice


F.23.2 属性

log-stdoutサーバー構成要素には属性がありません。

F.23.3

次の例は、Oracle CEPサーバー構成ファイル内のlog-stdout要素の使用方法を示します。

<log-stdout>
    <name>logStdout</name>
    <stdout-severity>Debug</stdout-severity>
</log-stdout>

この例では、log-stdout要素の一意の識別子はlogStdoutです。

F.24 logging-service

この要素を使用すると、Oracle CEPサーバーでロギング・サービスを構成できます。

F.24.1 子要素

logging-serviceサーバー構成要素は、表F-17で一覧表示される子要素をサポートします。

表F-17 logging-serviceの子要素

XMLタグ タイプ 説明

name

string

このwork-manager要素の名前。詳細は、「name」を参照してください。

log-file-config

string

ログ・ファイルとそのローテーション・ポリシーの構成。

stdout-config

string

stdout出力の構成。

logger-severity

string

ハンドラに伝播されるメッセージのしきい値の重要度を定義します。デフォルトはInfoで、重大度がDebugまたはTraceのいずれかに設定されていることを保証する必要があるDebugおよびTraceメッセージを確認できます。有効な値:

  • Emergency

  • Alert

  • Critical

  • Error

  • Warning

  • Notice

  • Info

  • Debug

  • Trace

デフォルト: Info

logger-severity-properties

説明を参照

ロガー・ツリーにおける異なるノードの重大度の値で、それぞれがkeyおよびvalue子要素を含む1つ以上のentry子要素から構成されます。


F.24.2 属性

logging-serviceサーバー構成要素には属性がありません。

F.24.3

次の例は、Oracle CEPサーバー構成ファイル内のlogging-service要素の使用方法を示します。

<logging-service>
    <name>myLogService</name>
    <stdout-config>myStdoutConfig</stdout-config>
    <logger-severity>Notice</logger-severity>
    <logger-severity-properties>
      <entry>
        <key>FileAdapter</key>
        <value>Debug</value>
      </entry>
      <entry>
        <key>CQLProcessor</key>
        <value>Debug</value>
      </entry>
    </logger-severity-properties>
</logging-service>

この例では、logging-service要素の一意の識別子はmyLogServiceです。

F.25 message-filters

この要素を使用すると、pubsub-bean要素の1つ以上のメッセージ・フィルタを構成できます。

F.25.1 子要素

message-filtersサーバー構成要素には、それぞれがmessage-filter-nameおよびmessage-filter-class子要素を持つ1つ以上のelement子要素が含まれます。

F.25.2 属性

message-filtersサーバー構成要素には属性がありません。

F.25.3

次の例は、Oracle CEPサーバー構成ファイル内のmessage-filters要素の使用方法を示します。

<http-pubsub>
    <name>pubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
...
      <message-fitlers>
        <element>
          <message-filter-name>Foo</message-filter-name>
          <message-filter-class>Foo</message-filter-class>
        </element>
        <element>
          <message-filter-name>Foo</message-filter-name>
          <message-filter-class>Foo</message-filter-class>
        </element>
      </message-filters>
...
    </pub-sub-bean>
</http-pubsub>

F.26 name

この要素を使用すると、Oracle CEPサーバー構成要素の一意の識別子を宣言できます。

F.26.1 子要素

nameサーバー構成要素には、子要素がありません。

F.26.2 属性

nameサーバー構成要素には属性がありません。

F.26.3

次の例は、Oracle CEPサーバー構成ファイル内のname要素の使用方法を示します。

<http-pubsub>
    <name>pubsub</name>
    <path>/pubsub</path>
...
</http-pubsub>

F.27 netio

この要素を使用すると、ネットワーク入力/出力(IO)サービスを表示できます。このサービスは、ネットワークIO用サーバーとして機能させるために他のサービスによって使用されます。

F.27.1 子要素

netioサーバー構成要素は、表F-18で一覧表示される子要素をサポートします。

表F-18 netioの子要素

XMLタグ タイプ 説明

name

string

このnetio要素の名前。詳細は、「name」を参照してください。

ssl-config-bean-name

string

使用するSSL構成オブジェクト名。nullではない場合、このクライアントは指定したSSL構成を使用してセキュア・ソケットを作成します。設定しない場合、SSLはサポートされません。

provider-type

string

基礎となるソケット実装にどのプロバイダを使用するかを指定します。有効なプロバイダ・タイプのリストは、『Oracle Fusion Middleware Oracle Complex Event Processing管理者ガイド』のネットワークI/Oプロバイダに関する項を参照してください。

io-threads

int

ソケットの処理に使用するスレッド数に関するプロバイダへのヒント。値を0に指定すると、プロバイダはデフォルト設定に基づいて選択を行うようになります。デフォルト: 0。

port

int

リスニングする元となるポート。サーバーはこのポート上で受信接続へのリスニングをただちに開始します。

listen-address

string

受信接続へのリスニングを行う元となるNetioのインスタンスのアドレス。a.b.c.d形式で数値のIPアドレスに設定されるか、またはホスト名に設定されます。設定しない場合、netioはすべてのネットワーク・インタフェース上でリスニングします。このパラメータの値は、サーバーが実際に起動するまで検証できないので注意してください。


F.27.2 属性

netioサーバー構成要素には属性がありません。

F.27.3

次の例は、Oracle CEPサーバー構成ファイル内のnetio要素の使用方法を示します。

<netio>
    <name>myNetio</name>
    <port>12345</port>
</netio>

この例では、netio要素の一意の識別子はmyNetioです。

F.28 netio-client

この要素を使用すると、非ブロック・ネットワークIOを実行するために使用されるネットワーク入力/出力(IO)サービスを登録できます。ただし、このサービスはサーバーとして機能せず、受信接続をリスニングしません。

F.28.1 子要素

netio-clientサーバー構成要素は、表F-19で一覧表示される子要素をサポートします。

表F-19 netio-clientの子要素

XMLタグ タイプ 説明

name

string

このnetio要素の名前。詳細は、「name」を参照してください。

ssl-config-bean-name

string

使用するSSL構成オブジェクト名。nullではない場合、このクライアントは指定したSSL構成を使用してセキュア・ソケットを作成します。設定しない場合、SSLはサポートされません。

provider-type

string

基礎となるソケット実装にどのプロバイダを使用するかを指定します。有効なプロバイダ・タイプのリストは、『Oracle Fusion Middleware Oracle Complex Event Processing管理者ガイド』のネットワークI/Oプロバイダに関する項を参照してください。


F.28.2 属性

netio-clientサーバー構成要素には属性がありません。

F.28.3

次の例は、Oracle CEPサーバー構成ファイル内のnetio-client要素の使用方法を示します。

<netio-client>
    <name>netiossl</name>
    <ssl-config-bean-name>sslConfig</ssl-config-bean-name>
    <provider-type>NIO</provider-type>
</netio-client>

この例では、netio-client要素の一意の識別子はnetiosslです。

F.29 partition-order-capacity

この要素を使用すると、ordering-constraint属性がPARTITION_ORDEREDに設定されている場合に問合せパーティションの最大容量を定義できます。これはcqlコンポーネントに設定します。パラレル実行用の問合せプロセッサが構成されていて、問合せのordering-constraint属性がPARTITION_ORDEREDに設定されている場合に、この要素の値を設定することを検討してください。

要素のデフォルト値は4です。

この値を設定できる場所(優先順位など)に関するベスト・プラクティスおよび情報などの詳細は、第10章「Oracle CQLプロセッサの構成」の「問合せのパーティション化でのpartition-order-capacityの使用」を参照してください。

F.29.1 子要素

partition-order-capacity要素には子要素はありません。

F.29.2 属性

partition-order-capacity要素には属性はありません。

F.29.3

次の例は、Oracle CEPサーバー構成ファイル内のpartition-order-capacity要素の使用方法を示します。

<cql>
    <name>myCQL</name>
    <partition-order-capacity>20</partition-order-capacity>
</cql>

F.30 path

この要素を使用すると、http-pubsub要素のパスを構成できます。

F.30.1 子要素

path要素には子要素がありません。

F.30.2 属性

path要素には属性がありません。

F.30.3

次の例は、Oracle CEPサーバー構成ファイル内のpath要素の使用方法を示します。

<http-pubsub>
    <name>myPubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
        <server-config>
            <supported-transport>
                <types>
                    <element>long-polling</element>
                </types>
            </supported-transport>
            <publish-without-connect-allowed>
                true
            </publish-without-connect-allowed>
        </server-config>
        <channels>
            <element>
                <channel-pattern>/evsmonitor</channel-pattern>
            </element>
            <element>
                <channel-pattern>/evsalert</channel-pattern>
            </element>
            <element>
                <channel-pattern>/evsdomainchange</channel-pattern>
            </element>
        </channels>
    </pub-sub-bean>
</http-pubsub>

F.31 pubsub-bean

この要素を使用すると、http-pubsub要素のpublish-subscribe Beanを構成できます。

F.31.1 子要素

pubsub-beanサーバー構成要素は、次の子要素をサポートしています。

F.31.2 属性

pubsub-beanサーバー構成要素には属性がありません。

F.31.3

次の例は、Oracle CEPサーバー構成ファイル内のpubsub-bean要素の使用方法を示します。

<http-pubsub>
    <name>myPubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
        <server-config>
            <supported-transport>
                <types>
                    <element>long-polling</element>
                </types>
            </supported-transport>
            <publish-without-connect-allowed>
                true
            </publish-without-connect-allowed>
        </server-config>
        <channels>
            <element>
                <channel-pattern>/evsmonitor</channel-pattern>
            </element>
            <element>
                <channel-pattern>/evsalert</channel-pattern>
            </element>
            <element>
                <channel-pattern>/evsdomainchange</channel-pattern>
            </element>
        </channels>
    </pub-sub-bean>
</http-pubsub>

F.32 rdbms-event-store-provider

この要素を使用すると、Oracle CEPサーバーでリレーショナル・データベース管理システムを使用するイベント・ストア・プロバイダを構成できます。

デフォルトでは、Oracle CEPサーバーはF.3項「bdb-config」で説明されているように、Berkeleyデータベースのインスタンスをイベント・ストア・プロバイダとして使用します。

F.32.1 子要素

rdbms-event-store-providerサーバー構成要素は、表F-20で一覧表示される子要素をサポートします。

表F-20 rdbms-event-store-providerの子要素

XMLタグ タイプ 説明

name

string

このdebug構成の名前。詳細は、「name」を参照してください。

init-timeout

int

このプロバイダが初期化するのをOracle CEPサーバーが待機する最大時間(ミリ秒)。

デフォルト: 10000ミリ秒。

data-source-name

string

データ・ソース要素の名前。詳細は、「data-source」を参照してください。

user-policy-attributes

説明を参照

追加のデータ・ソース・プロパティの指定に使用するkeyおよびvalue子要素をそれぞれが含む1つ以上のentry子要素。


F.32.2 属性

rdbms-event-store-providerサーバー構成要素には属性がありません。

F.32.3

次の例は、Oracle CEPサーバー構成ファイル内のrdbms-event-store-provider要素の使用方法を示します。

<rdbms-event-store-provider>
    <name>test-rdbms-provider</name>
    <init-timeout>10000</init-timeout>
    <data-source-name>derby1</data-source-name>
    <user-policy-attributes>
        <entry>
            <key>key1</key>
            <value>value1</value>
        </entry>
            <key>key1</key>
            <value>value1</value>
        <entry>
        </entry>
    </user-policy-attributes>
</rdbms-event-store-provider>

この例では、rdbms-event-store-provider要素の一意の識別子はtest-rdbms-providerです。

F.33 rmi

この要素を使用すると、RMIサービスを構成できます。このサービスによって、サーバー側のオブジェクトをリモート・クライアントにエクスポートすることができます。

F.33.1 子要素

rmiサーバー構成要素は、表F-21で一覧表示される子要素をサポートします。

表F-21 rmiの子要素

XMLタグ タイプ 説明

name

string

このrmi要素の名前。詳細は、「name」を参照してください。

heartbeat-period

int

切断通知をすべての登録済リスナーにトリガーする前に失敗したハートビートの試行回数。デフォルト値: 4。

http-service-name

string

HTTPサービス名で、このサービスがリモート・オブジェクトの登録に使用します。このサービスは、同名のJettyまたはTomcatのインスタンスによって提供されます。

heartbeat-interval

int

ハートビート間の時間(ミリ秒)。失敗したハートビートの試行回数がHeartbeatPeriod属性によって指定された値に到達したら、すべての登録済DisconnectListenerのインスタンスが通知されます。

デフォルト値: 5000


F.33.2 属性

rmiサーバー構成要素には属性がありません。

F.33.3

次の例は、Oracle CEPサーバー構成ファイル内のrmi要素の使用方法を示します。

<rmi>
    <name>myRMI</name>
    <http-service-name>TestJetty</http-service-name>
</rmi>

この例では、rmi要素の一意の識別子はmyRMIです。

F.34 scheduler

この要素を使用すると、Oracle CEPサーバーでcqlスケジューラ・オプションを構成できます。

F.34.1 子要素

schedulerサーバー構成要素は、表F-22で一覧表示される子要素をサポートします。

表F-22 schedulerの子要素

XMLタグ タイプ 説明

class-name

string

sched_nameスケジュール・オプションの1つの値を、Oracle CEPサービス・エンジンのスケジュール・アルゴリズムを実装するJavaクラスの完全修飾パッケージ名として指定します。このクラスによって、Oracle CEPサービス・エンジンのスケジューラがOracle CQL問合せを実行する順序が決定されます。有効な値:

  • oracle.cep.execution.scheduler.RoundRobinScheduler: このアルゴリズムは、時間スライスを平等な割合で順序通りに各Oracle CQL問合せに割り当て、すべてのプロセスを優先度なしに処理します。このオプションは、Oracle CQL問合せの数が大きく変動しない傾向の場合に適切です。

  • oracle.cep.execution.scheduler.FIFOScheduler: このアルゴリズムは、時間スライスを作成された順序で各Oracle CQL問合せに割り当てます。このアルゴリズムは、Oracle CQL問合せの数が大きく変動する傾向の場合に適切です。

デフォルト: oracle.cep.execution.scheduler.RoundRobinScheduler

runtime

long

Oracle CEPサービス・エンジンのスケジューラが実行される秒数の合計。

デフォルト: 1000000ミリ秒。

time-slice

int

Oracle CEPサービス・エンジンのスケジューラがOracle CQL問合せを実行する頻度。

デフォルト: 1000ミリ秒

schedule-on-new-thread

boolean

Oracle CEPサービス・エンジンのスケジューラが個別のスレッドを使用するかどうか。オプション:

  • true: スケジューラは個別のスレッドで実行されます。

  • false: スケジューラは、Oracle CEPサービス・エンジンと同一のスレッドで実行されます(デフォルト)。


F.34.2 属性

schedulerサーバー構成要素には属性がありません。

F.34.3

次の例は、Oracle CEPサーバー構成ファイル内のscheduler要素の使用方法を示します。

<cql>
    <name>myCQL</name>
    <scheduler>
        <class-name>oracle.cep.execution.scheduler.FIFOScheduler</class-name>
    </scheduler>
</cql>

F.35 server-config

この要素を使用すると、pubsub-bean要素のサーバー専用プロパティを構成できます。

F.35.1 子要素

server-configサーバー構成要素は、表F-23で一覧表示される子要素をサポートします。

表F-23 server-configの子要素

XMLタグ タイプ 説明

name

string

このserver-config要素の名前。詳細は、「name」を参照してください。

supported-transport

説明を参照

この要素には、1つ以上のtypes子要素が含まれます。子要素は各サポート対象トランスポートです。各types子要素には、stringの値としてトランスポート名を持つelement子要素が含まれます。有効な値:

  • long-polling: このトランスポートを使用すると、クライアントはOracle CEPサーバーから情報をリクエストし、Oracle CEPサーバーが使用可能な情報を持たない場合、情報を持つまで応答しません。Oracle CEPサーバーが応答するとき、クライアントは通常、別のリクエストをただちに送信します。

  • callback-polling: このトランスポートは、クロス・ドメイン構成を使用するHTTPパブリッシュ/サブスクライブ・アプリケーションに使用します。この構成では、ブラウザが1つのWebサーバー(JavaScriptコードを含む)からページをダウンロードし、HTTPパブリッシュ/サブスクライブ・クライアントとして別のサーバーに接続します。これは、Bayeuxプロトコルに必要です。Bayeuxプロトコルの詳細は、http://svn.xantus.org/shortbus/trunk/bayeux/bayeux.html を参照してください。

詳細は、『Oracle Fusion Middleware Oracle Complex Event Processing管理者ガイド』のHTTPパブリッシュ・サブスクライブ・サーバーの稼働方法に関する項を参照してください。

client-timeout-secs

int

クライアントが接続/再接続のメッセージを送信しなかった場合に、HTTPパブリッシュ/サブスクライブ・サーバーがクライアントとの接続を切断してからの秒数を指定します。

デフォルト: 60

persistent-client-timeout-secs

int

永続クライアントが接続または再接続メッセージを送信しない間に、永続クライアントが切断されてパブリッシュ/サブスクライブ・サーバーによって削除されてからの秒数を指定します。この値は、client-timeout-secsよりも大きくする必要があります。永続クライアントが永続タイムアウトに到達する前に再接続する場合、クライアントは永続チャネルにパブリッシュされたすべてのメッセージをこの間に受信します。クライアントがタイムアウト後に再接続する場合は、メッセージを受信しません。

デフォルト: 600秒

interval-millisecs

int

クライアントが/meta/connectチャネルへの後続リクエストを遅延できる期間(ミリ秒)を指定します。

デフォルト: 500ミリ秒。

work-manager

string

メッセージをクライアントに配信するワーク・マネージャの名前を指定します。この要素の値は、割り当てるwork-managername子要素の値に対応します。

詳細は、「work-manager」を参照してください。

publish-without-connect-allowed

boolean

HTTPパブリッシュ/サブスクライブ・サーバーに明示的に接続せずに、クライアントがメッセージをパブリッシュできるかどうかを指定します。有効な値:

  • true

  • false


F.35.2 属性

server-configサーバー構成要素には属性がありません。

F.35.3

次の例は、Oracle CEPサーバー構成ファイル内のserver-config要素の使用方法を示します。

<http-pubsub>
    <name>pubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
      <server-config>
        <name>/pubsub</name>
        <supported-transport>
          <types>
            <element>long-polling</element>
          </types>
        </supported-transport>
        <publish-without-connect-allowed>true</publish-without-connect-allowed>
      </server-config>
    <channels>
        <element>
          <channel-pattern>/evsmonitor</channel-pattern>
        </element>
        <element>
          <channel-pattern>/evsalert</channel-pattern>
        </element>
        <element>
          <channel-pattern>/evsdomainchange</channel-pattern>
        </element>
      </channels>
    </pub-sub-bean>
</http-pubsub>

F.36 services

この要素を使用すると、pubsub-bean要素のサービス・プロパティを構成できます。

F.36.1 子要素

servicesサーバー構成要素には、表F-24で一覧表示されている子要素をそれぞれサポートする1つ以上のelement子要素が含まれます。

表F-24 servicesの子要素

XMLタグ タイプ 説明

service-channel

string

サービス・チャネルを指定します。例: /service/echo

service-class

string

このサービスを使用するクラスを指定します。例: EchoService

service-method

string

サービス・クラスにおけるサービス・メソッドを定義します。このサービス・メソッドは、タイプObjectの唯一のペイロード・パラメータを持つ必要があります。例: Object echo(Object payload)


F.36.2 属性

servicesサーバー構成要素には属性がありません。

F.36.3

次の例は、Oracle CEPサーバー構成ファイル内のservices要素の使用方法を示します。

<http-pubsub>
    <name>pubsub</name>
    <path>/pubsub</path>
    <pub-sub-bean>
      <server-config>
        <name>/pubsub</name>
        <supported-transport>
          <types>
            <element>long-polling</element>
          </types>
        </supported-transport>
        <publish-without-connect-allowed>true</publish-without-connect-allowed>
      </server-config>
    <channels>
        <element>
          <channel-pattern>/evsmonitor</channel-pattern>
        </element>
        <element>
          <channel-pattern>/evsalert</channel-pattern>
        </element>
        <element>
          <channel-pattern>/evsdomainchange</channel-pattern>
        </element>
      </channels>
      <services>
          <element>
              <service-channel>Foo</service-channel>
              <service-class>Foo</service-class>
              <service-method>Foo</service-method>
          </element>
      </services>
    </pub-sub-bean>
</http-pubsub>

F.37 show-detail-error-message

この要素を使用すると、Oracle CEPサーバーがセキュア接続を使用するかどうかを構成できます。

F.37.1 子要素

show-detail-error-messageサーバー構成要素は、表F-25で一覧表示される子要素をサポートします。

表F-25 show-detail-error-messageの子要素

XMLタグ タイプ 説明

name

string

このshow-detail-error-message要素の名前。詳細は、「name」を参照してください。

value

boolean

詳細エラー・メッセージを表示するかどうか。有効な値:

  • true: Oracle CEPサーバーが詳細エラー・メッセージを表示します。

  • false: Oracle CEPサーバーが省略エラー・メッセージを表示します(デフォルト)。


F.37.2 属性

show-detail-error-messageサーバー構成要素には属性がありません。

F.37.3

次の例は、Oracle CEPサーバー構成ファイル内のshow-detail-error-message要素の使用方法を示します。

<show-detail-error-message>
    <name>myShowDetail</name>
    <value>true</value>
</show-detail-error-message>

この例では、show-detail-error-message要素の一意の識別子はmyShowDetailです。

F.38 ssl

この要素を使用すると、Oracle CEPサーバーでSecure Sockets Layer専用プロパティを構成できます。

F.38.1 子要素

sslサーバー構成要素は、表F-26で一覧表示される子要素をサポートします。

表F-26 sslの子要素

XMLタグ タイプ 説明

name

string

このクラスタの名前。詳細は、「name」を参照してください。

key-store

string

./ssl/evsidentity.jksなどのキーストアへのファイル・パスを指定します。

key-store-pass

説明を参照

この要素には、キーストアへのアクセスに使用されるパスワードを指定するstringの値を持つpassword子要素が含まれます。

key-store-alias

string

キーストアの別名を指定します。

key-manager-algorithm

string

SunX509などのキー・マネージャ・アルゴリズムを指定します。

ssl-protocol

string

TLSなどのSSLプロトコルを指定します。

trust-store

string

./ssl/evstrust.jksなどのトラスト・ストアへのファイル・パスを指定します。

trust-store-pass

説明を参照

この要素には、トラスト・ストアへのアクセスに使用されるパスワードを指定するstringの値を持つpassword子要素が含まれます。

trust-store-alias

string

トラスト・ストアの別名を指定します。

trust-store-type

string

JKSなどのトラスト・ストア・タイプを指定します。

trust-manager-algorithm

string

SunX509などのトラスト・マネージャ・アルゴリズムを指定します。

enforce-fips

boolean

Oracle CEPサーバーがFederal Information Processing Standards (FIPS)認証済の擬似乱数ジェネレータを使用するかどうかを指定します。

詳細は、『Oracle Fusion Middleware Oracle Complex Event Processing管理者ガイド』のFIPSに関する項を参照してください。

need-client-auth

boolean

クライアント証明書認可が必要かどうかを指定します。

ciphers

説明を参照

この要素には1つ以上のcipher子要素が含まれ、それぞれはciphersが必要であると指定するstringの値を持ちます。

secure-random-algorithm

string

enforce-fipstrueに設定されるとき、使用するセキュア・ランダム・アルゴリズムを指定します。有効な値:

  • FIPS186PRNG

secure-random-provider

string

enforce-fipstrueに設定されるとき、使用するセキュア・ランダム・プロバイダを指定します。有効な値:

  • JsafeJCE


F.38.2 属性

sslサーバー構成要素には属性がありません。

F.38.3

次の例は、Oracle CEPサーバー構成ファイル内のssl要素の使用方法を示します。

<ssl>
    <name>sslConfig</name>
    <key-store>./ssl/evsidentity.jks</key-store>
    <key-store-pass>
        <password>{Salted-3DES}s4YUEvH4Wl2DAjb45iJnrw==</password>
    </key-store-pass>
    <key-store-alias>evsidentity</key-store-alias>
    <key-manager-algorithm>SunX509</key-manager-algorithm>
    <ssl-protocol>TLS</ssl-protocol>
    <enforce-fips>false</enforce-fips>
    <need-client-auth>false</need-client-auth>
</ssl>

この例では、ssl要素の一意の識別子はsslConfigです。

F.39 timeout-seconds

この要素を使用すると、Oracle CEPサーバーでweblogic-jta-gatewayのデフォルト・トランザクション・タイムアウトを秒単位で構成できます。

デフォルト: 60

F.39.1 子要素

timeout-secondsサーバー構成要素には属性がありません。

F.39.2 属性

timeout-secondsサーバー構成要素には属性がありません。

F.39.3

次の例は、Oracle CEPサーバー構成ファイル内のtimeout-seconds要素の使用方法を示します。

<weblogic-jta-gateway>
    <name>myJTAGateway</name>
    <timeout-seconds>90</timeout-seconds>
    <weblogic-instances>
        <weblogic-instance>
            <domain-name>ocep_domain</domain-name>
            <server-name>fxserver</server-name>
            <protocol>t3</protocol>
            <host-address>ariel</host-address>
            <port>9002</port>
        </weblogic-instance>
    </weblogic-instances>
</weblogic-jta-gateway>

F.40 transaction-manager

この要素を使用すると、Oracle CEPサーバーでトランザクション・マネージャ・プロパティを構成できます。

F.40.1 子要素

transaction-managerサーバー構成要素は、表F-27で一覧表示される子要素をサポートします。

表F-27 transaction-managerの子要素

XMLタグ タイプ 説明

name

string

このtransaction-manager要素の名前。詳細は、「name」を参照してください。

max-resource-requests-on-server

int

各サーバーで許可されるリソースへの同時実行性リクエストの最大数。

デフォルト: 50

max-resource-unavailable-millis

long

リソースが失効を宣言される最大期間(ミリ秒)。この期間後、リソース・プロバイダが明示的にリソースを再登録する場合でも、リソースはもう一度使用可能を宣言されます。デフォルト: 1800000。

security-interop-mode

string

グローバル・トランザクションに参加するサーバー間のXAコールに使用される通信チャネルのセキュリティ・モードを指定します。ドメイン内のすべてのサーバー・インスタンスは、同一のセキュリティ・モード設定にする必要があります。有効な値:

  • default: トランザクション・コーディネータは、有効化されている場合、管理チャネルからカーネル・アイデンティティを使用してコールします。それ以外は無名を使用してコールします。管理チャネルが有効化されていない場合、man-in-the-middle攻撃が可能です。

  • Performance: トランザクション・コーディネータは、常に無名を使用してコールします。これは、悪質なサードパーティがman-in-the-middle攻撃を使用してトランザクションの結果に影響を与えようとする可能性があるため、黙示的にセキュリティ・リスクがあることを示唆します。

  • Compatibility: トランザクション・コーディネータは、セキュアでないチャネルからカーネル・アイデンティティとしてコールします。これは、man-in-the-middle攻撃が成功すると、攻撃者によって両ドメインへの管理制御が取得されてしまうため、セキュリティ・リスクが高くなります。この設定は、強固なネットワーク・セキュリティが設置されているときにのみ使用します。

デフォルト: default

parallel-xa-enabled

boolean

使用可能なスレッドが存在する場合に、XAコールを並列で実行します。

デフォルト: true

tlog-location

string

トランザクション・ログを含むファイル・ストアの場所。この属性は、ファイルシステム内の絶対パスまたは相対パスのいずれかにすることができます。

max-xa-call-millis

long

リソースへのXAコールが許可される最大存続期間。リソースへの特定のXAコールが限度を超える場合、リソースは使用不可能を宣言されます。

デフォルト: 120000

timeout-seconds

int

デフォルトのトランザクション・タイムアウト(秒単位)。

デフォルト: 30

checkpoint-interval-seconds

int

トランザクション・マネージャがトランザクション・ログ・チェックポイント操作を実行する間隔。

デフォルト: 300

forget-heuristics

boolean

トランザクション・マネージャが自動的にヒューリスティック・トランザクション完了のXAResource放棄操作を実行するかどうかを指定します。有効化すると、トランザクション・マネージャは、トランザクションがヒューリスティックな結果を認識するとすべてのリソースのXA Resource forget操作を自動的に実行します。リソースがヒューリスティックな決定をレポートするときに、リソースを使用した操作を把握している場合にのみ、この機能を無効にします。

デフォルト: true

before-completion-iteration-limit

int

トランザクション・マネージャが、完了前の同期コールバック処理を実行するサイクルの最大数。

デフォルト: 10

abandon-timeout-seconds

int

2フェーズ・コミット(準備およびその後)の第2フェーズにおけるトランザクションのトランザクション中止タイムアウト秒数。2フェーズ・コミット処理の第2フェーズ中に、すべてのリソース・マネージャがトランザクションの完了を示すまで、トランザクション・マネージャがトランザクションを完了させようとします。このタイムアウトを使用することによって、トランザクションの第2フェーズ中にトランザクションを完了させようとする試行をトランザクション・マネージャが永続する最大時間を設定できます。中止トランザクション・タイマーの期限が切れた後、トランザクションを解決するための試行は行われなくなります。中止される前にトランザクションが準備状態にある場合は、トランザクション・マネージャがトランザクションをロールバックし、中止されたトランザクションのかわりに保持されたロックを解放します。

デフォルト: 86400

serialize-enlistments-gc-interval-millis

long

リソースの登録のシリアライズに使用される内部オブジェクトがクリーンアップされる間隔。

デフォルト: 30000

unregister-resource-grace-period

int

トランザクション・マネージャがリソースの登録解除前に完了するリソースを含むトランザクションを待機する猶予期間(秒数)。猶予期間は、アプリケーションにパッケージ化されたJDBCデータ・ソース・モジュールなどの、登録解除されたリソースのために中止されたトランザクションのリスクを最小化するのに役立ちます。指定された猶予期間中、コールが戻されるまでunregisterResourceコールがブロックされ、関連するリソースに対して新しいトランザクションは開始されません。リソースの処理中のトランザクション数が0になると、unregisterResourceコールがただちに戻されます。猶予期間の終了時、リソースに関連する処理中のトランザクションが残っている場合、unregisterResourceコールが戻され、リソースが以前に登録されたサーバー上でログ・メッセージが書き込まれます。

デフォルト: 30

rmi-service-name

string

分散型トランザクション調整に使用されるRMIサービス名。

詳細は、「rmi」を参照してください。

max-unique-name-statistics

int

統計情報が保持される一意のトランザクション名の最大数。

デフォルト: 1000

purge-resource-from-checkpoint-interval-seconds

int

チェックポイント・レコードに含まれるように、特定のリソースがアクセスされる必要がある間隔。

デフォルト: 86400

max-transactions

int

このサーバー上で許可される同時進行中のトランザクションの最大数。

デフォルト: 10000

migration-checkpoint-interval-seconds

int

移行されたトランザクション・ログ(TLOG)にチェックポイントが実行される間隔。

デフォルト: 60

recovery-threshold-millis

long

リソースが使用可能になるまでリカバリが試行される間隔。

デフォルト: 300000

max-transactions-health-interval-millis

long

JTAサブシステムがCRITICALの状態を宣言するために、トランザクション・マップがフルになる必要がある間隔。

デフォルト: 60000

parallel-xa-dispatch-policy

string

XA操作を並列に実行するときに使用するディスパッチ・ポリシー。デフォルトでは、トランザクションを調整するスレッドのポリシーが使用されます。


F.40.2 属性

transaction-managerサーバー構成要素には属性がありません。

F.40.3

次の例は、Oracle CEPサーバー構成ファイル内のtransaction-manager要素の使用方法を示します。

<transaction-manager>
    <name>My_tm</name>
    <timeout-seconds>30</timeout-seconds>
    <abandon-timeout-seconds>86400</abandon-timeout-seconds>
    <forget-heuristics>true</forget-heuristics>
    <before-completion-iteration-limit>12</before-completion-iteration-limit>
    <max-transactions>10100</max-transactions>
    <max-unique-name-statistics>500</max-unique-name-statistics>
    <max-resource-requests-on-server>50</max-resource-requests-on-server>
    <max-resource-unavailable-millis>1800000</max-resource-unavailable-millis>
    <recovery-threshold-millis>300000</recovery-threshold-millis>
    <max-transactions-health-interval-millis>
        60000
    </max-transactions-health-interval-millis>
    <purge-resource-from-checkpoint-interval-seconds>
        86400
    </purge-resource-from-checkpoint-interval-seconds>
    <checkpoint-interval-seconds>300</checkpoint-interval-seconds>
    <parallel-xa-enabled>true</parallel-xa-enabled>
    <unregister-resource-grace-period>30</unregister-resource-grace-period>
    <security-interop-mode>default</security-interop-mode>
    <rmi-service-name>RMI_ce1</rmi-service-name>
  </transaction-manager>

この例では、transaction-manager要素の一意の識別子はMy_tmです。

F.41 use-secure-connections

この要素を使用すると、Oracle CEPサーバーがセキュア接続を使用するかどうかを構成できます。

詳細は、『Oracle Fusion Middleware Oracle Complex Event Processing管理者ガイド』のOracle CEP Visualizerのマルチサーバー・ドメインでSSLを構成する方法に関する項を参照してください。

F.41.1 子要素

use-secure-connectionsサーバー構成要素は、表F-28で一覧表示される子要素をサポートします。

表F-28 use-secure-connectionsの子要素

XMLタグ タイプ 説明

name

string

このuse-secure-connections要素の名前。詳細は、「name」を参照してください。

value

boolean

セキュア接続を使用するかどうか。有効な値:

  • true: Oracle CEPサーバーがセキュア接続のみを使用します。

  • false: Oracle CEPサーバーがセキュアでない接続を承諾します。


F.41.2 属性

use-secure-connectionsサーバー構成要素には属性がありません。

F.41.3

次の例は、Oracle CEPサーバー構成ファイル内のuse-secure-connections要素の使用方法を示します。

<use-secure-connections>
    <name>myUseSecConn</name>
    <value>true</value>
</use-secure-connections>

この例では、use-secure-connections要素の一意の識別子はmyUseSecConnです。

F.42 weblogic-instances

この要素を使用すると、weblogic-jta-gateway要素のOracle CEPサーバー・インスタンスを構成できます。

F.42.1 子要素

weblogic-instancesサーバー構成要素は、表F-29で一覧表示されている子要素をそれぞれ持つゼロ以上のweblogic-instance子要素をサポートしています。

表F-29 weblogic-instancesの子要素

XMLタグ タイプ 説明

domain-name

string

Oracle CEPサーバーのドメイン名を指定します。

server-name

string

Oracle CEPサーバー名を指定します。

protocol

string

JTAプロトコルを指定します。

デフォルト: t3

host-address

string

Oracle CEPサーバーのホスト名またはIPアドレス。

port

int

Oracle CEPサーバーのnetioポート。


F.42.2 属性

weblogic-instancesサーバー構成要素には属性がありません。

F.42.3

次の例は、Oracle CEPサーバー構成ファイル内のweblogic-instances要素の使用方法を示します。

<weblogic-jta-gateway>
    <name>myJTAGateway</name>
    <timeout-seconds>90</timeout-seconds>
    <weblogic-instances>
        <weblogic-instance>
            <domain-name>ocep_domain</domain-name>
            <server-name>fxserver</server-name>
            <protocol>t3</protocol>
            <host-address>ariel</host-address>
            <port>9002</port>
        </weblogic-instance>
    </weblogic-instances>
</weblogic-jta-gateway>

F.43 weblogic-jta-gateway

この要素を使用すると、シングルトンOracle CEPサーバー・クライアントのJTAゲートウェイ・サービスの属性を構成できます。

F.43.1 子要素

weblogic-jta-gatewayサーバー構成要素は、次の子要素をサポートしています。

F.43.2 属性

weblogic-jta-gatewayサーバー構成要素には属性がありません。

F.43.3

次の例は、Oracle CEPサーバー構成ファイル内のweblogic-jta-gateway要素の使用方法を示します。

<weblogic-jta-gateway>
    <name>myJTAGateway</name>
    <timeout-seconds>90</timeout-seconds>
    <weblogic-instances>
        <weblogic-instance>
            <domain-name>ocep_domain</domain-name>
            <server-name>fxserver</server-name>
            <protocol>t3</protocol>
            <host-address>ariel</host-address>
            <port>9002</port>
        </weblogic-instance>
    </weblogic-instances>
</weblogic-jta-gateway>

この例では、weblogic-jta-gateway要素の一意の識別子はmyJTAGatewayです。

F.44 weblogic-rmi-client

この要素を使用すると、シングルトンOracle CEPサーバーのRMIクライアントの属性を構成できます。

F.44.1 子要素

weblogic-rmi-clientサーバー構成要素は、表F-30で一覧表示される子要素をサポートします。

表F-30 weblogic-rmi-clientの子要素

XMLタグ タイプ 説明

name

string

このweblogic-rmi-client要素の名前。詳細は、「name」を参照してください。

netio-name

string

使用するnetio-client要素の名前を指定します。詳細は、「netio-client」を参照してください。

secure-netio-name

string

SSLに構成されるnetio-client要素の名前を指定します。詳細は、「netio-client」を参照してください。


F.44.2 属性

weblogic-rmi-clientサーバー構成要素には属性がありません。

F.44.3

次の例は、Oracle CEPサーバー構成ファイル内のweblogic-rmi-client要素の使用方法を示します。

<netio-client>
    <name>netio</name>
    <provider-type>NIO</provider-type>
</netio-client>
 
<netio-client>
    <name>netiossl</name>
    <provider-type>NIO</provider-type>
    <ssl-config-bean-name>sslConfig</ssl-config-bean-name>
</netio-client>
 
<weblogic-rmi-client>
    <name>wlclient</name>
    <netio-name>netio</netio-name>
    <secure-netio-name>netiossl</secure-netio-name>
</weblogic-rmi-client>

この例では、 weblogic-rmi-client要素の一意の識別子はwlclientです。

F.45 work-manager

この要素を使用すると、Oracle CEPサーバーでワーク・マネージャを構成できます。

F.45.1 子要素

work-managerサーバー構成要素は、表F-31で一覧表示される子要素をサポートします。

表F-31 work-managerの子要素

XMLタグ タイプ 説明

name

string

このwork-manager要素の名前。詳細は、「name」を参照してください。

min-threads-constraint

int

このワーク・マネージャが使用する最小スレッド制約。デフォルト: -1。

fairshare

int

このワーク・マネージャが使用するフェア・シェア値

デフォルト: -1

max-threads-constraint

int

このワーク・マネージャが使用する最大スレッド制約。

デフォルト: -1


F.45.2 属性

work-managerサーバー構成要素には属性がありません。

F.45.3

次の例は、Oracle CEPサーバー構成ファイル内のwork-manager要素の使用方法を示します。

<work-manager>
    <name>WM</name>
    <fairshare>5</fairshare>
    <min-threads-constraint>1</min-threads-constraint>
    <max-threads-constraint>4</max-threads-constraint>
</work-manager>

この例では、work-manager要素の一意の識別子はWMです。

F.46 xa-params

この要素を使用すると、分散型トランザクション関連のdata-sourceパラメータを指定できます。

F.46.1 子要素

xa-paramsサーバー構成要素は、表F-32で一覧表示される子要素をサポートします。

表F-32 xa-paramsの子要素

XMLタグ タイプ 説明

keep-xa-conn-till-tx-complete

boolean

トランザクションが完了するまで、接続プールからグローバル・トランザクションへの同一のXAデータベース接続にサーバーが関連できるようにします。XAドライバを使用する接続プールにのみ適用されます。この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。

デフォルト: true

xa-transaction-timeout

int

トランザクション・ブランチのタイムアウトとして設定する秒数。設定すると、この値がXAリソース・マネージャ(通常はJDBCドライバ)上のXAResource.setTransactionTimeoutコールのトランザクション・タイムアウト値として渡されます。この値が0に設定されると、トランザクション・マネージャは、メソッド内でグローバル・サーバーのトランザクション・タイムアウトを秒単位で渡します。設定する場合、この値はグローバル・サーバーのトランザクション・タイムアウト以上にする必要があります。注意: トランザクション・ブランチのタイムアウトを設定できるようにxa-set-transaction-timeoutを有効化する必要があります。

デフォルト: 0

rollback-local-tx-upon-conn-close

boolean

サーバーが、接続を接続プールに戻す前に接続上でrollbackをコールするようにできます。この属性を有効にすると、ロールバック・コールがデータベース・サーバーとの通信を要求するときのパフォーマンスに影響があります。

デフォルト: false

xa-retry-duration-seconds

int

トランザクション・マネージャがリソース上で復元操作を実行する際の持続時間を秒単位で決定します。値をゼロに指定すると、再試行は実行されません。

デフォルト: 60

xa-set-transaction-timeout

boolean

サーバーが、xa-transaction-timeoutの値に基づいてトランザクション・ブランチのタイムアウトを設定できるようにします。有効化すると、トランザクション・マネージャはXAResource.startの前にXAResource.setTransactionTimeoutをコールし、XAトランザクション・タイムアウト値またはグローバル・トランザクション・タイムアウトのいずれかを渡します。XAリソース上でデフォルトのタイムアウト値を超える長期間実行中のトランザクションがある場合、トランザクション・ブランチのタイムアウトを設定できます。

デフォルト: false

keep-logical-conn-open-on-release

boolean

物理XA接続が接続プールに戻されるときに、サーバーが、グローバル・トランザクションに対して論理JDBC接続を開いたまま保持できるようにします。データベース接続の作成に使用されるXAドライバまたはDBMSが、トランザクション処理の継続中に(物理XA接続は接続プールに戻されても)論理JDBC接続を開いたまま保持できるように求める場合、このオプションを選択します。XAドライバを使用するデータ・ソースにのみ適用されます。この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。

デフォルト: false

resource-health-monitoring

boolean

JTAリソースがXAデータ・ソースの状態を監視できるようにします。有効化すると、XAリソースがMaxXACallMillisで指定された期間中にXAコールに応答できない場合に、サーバーがデータ・リソースを正常でないとマークし、リソースに対する以降のコールをブロックします。このプロパティはXAデータ・リソースのみに適用され、XAドライバ以外を使用するデータ・リソースは無視されます。

デフォルト: true

new-xa-conn-for-commit

boolean

専用のXA接続がグローバル・トランザクションのコミットおよびロールバック処理に使用されることを指定します。XAドライバを使用するデータ・ソースにのみ適用されます。この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。

デフォルト: false

xa-end-only-once

boolean

保留中の各XAResource.startに対してXAResource.endを1回のみコールされることを指定します。このオプションによって、XAドライバはXAResource.end(TMSUSPEND)およびXAResource.end(TMSUCCESS)を連続してコールできなくなります。XAドライバを使用するデータ・ソースにのみ適用されます。この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。

デフォルト: false

xa-retry-interval-seconds

int

XARetryDurationSecondsが正の値に指定される場合のXA再試行操作間の秒数。

デフォルト: 60

recover-only-once

boolean

トランザクション・マネージャがリソース上で1回のみ復元をコールすることを指定します。XAドライバを使用するデータ・ソースにのみ適用されます。この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。

デフォルト: false

need-tx-ctx-on-close

boolean

各種JDBCオブジェクト(結果セット、文、接続など)を終了するときにXAドライバが分散型トランザクション・コンテキストを要求するかどうかを指定します。XAドライバを使用する接続プールにのみ適用されます。有効化すると、トランザクション・コンテキストを持たないJDBCオブジェクトを終了中にスローされるSQLの例外が抑止されます。この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。

デフォルト: false


F.46.2 属性

xa-paramsサーバー構成要素には属性がありません。

F.46.3

次の例は、Oracle CEPサーバー構成ファイル内のxa-params要素の使用方法を示します。

<data-source>
    <name>orads</name>
    <xa-params>
        <keep-xa-conn-till-tx-complete>true</keep-xa-conn-till-tx-complete>
    </xa-params>
    <driver-params>
        <url>jdbc:oracle:thin:@localhost:1521:ce102</url>
        <driver-name>oracle.jdbc.OracleDriver</driver-name>
        <properties>
            <element>
                <name>user</name>
                <value>wlevs</value>
            </element>
            <element>
                <name>password</name>
                <value>wlevs</value>
            </element>
        </properties>
    </driver-params>
    <connection-pool-params>
        <initial-capacity>5</initial-capacity>
        <max-capacity>10</max-capacity>
        <test-table-name>SQL SELECT 1 FROM DUAL</test-table-name>
        <test-frequency-seconds>5</test-frequency-seconds>
    </connection-pool-params>
    <data-source-params>
        <jndi-names>
            <element>orads</element>
        </jndi-names>
        <global-transactions-protocol>None</global-transactions-protocol>
    </data-source-params>
</data-source>