7 サーバー構成スキーマ
Oracle Stream Analyticsサーバーの属性およびサービス(ロギング、Oracle Continuous Query Language (CQL)、Secure Sockets Layer (SSL)、Java Management Extensions (JMX)、HTTPパブリッシュ・サブスクライブなど)を構成するために使用するXMLの背後にあるスキーマである、wlevs_server_config.xsd
スキーマの要素へのリファレンスを示します。
この章の内容は次のとおりです。
7.1 Oracle Stream Analyticsサーバーの構成要素
Oracle Stream Analyticsには、Oracle Stream Analytics固有の属性とサービスを構成するための多数のサーバー構成要素があります。
最上位レベルのOracle Stream Analyticsサーバー構成要素は、次の階層で構成されています。
config domain rmi jndi-context exported-jndi-context jmx transaction-manager work-manager logging-service log-stdout log-file jetty-web-app netio jetty glassfish-ws netio-client debug data-source http-pubsub event-store cluster bdb-config rdbms-event-store-provider user-event-store-provider ssl weblogic-rmi-client weblogic-jta-gateway use-secure-connections show-detail-error-message cql event-inspector
7.2 auth-constraint
auth-constraint
要素を使用すると、channel-constraints
要素の認可制約を構成できます。この要素には、次の子要素があり、属性はありません。
表7-1 子要素: auth-constraint
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
ロールの説明。 |
|
|
有効なロール名。 |
チャネルの詳細は、「channels」
を参照してください。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.3 bdb-config
bdb-config
要素を使用すると、Berkeleyデータベース・インスタンスを使用するデフォルトのイベント・ストア・プロバイダを構成できます。
オプションで、リレーショナル・データベース・インスタンスをイベント・ストア・プロバイダとして使用するように、Oracle Stream Analyticsサーバーを構成できます(詳細は、「rdbms-event-store-provider」を参照してください)。
この要素には、次の子要素があり、属性はありません。
表7-2 子要素: bdb-config
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
Oracle Stream AnalyticsサーバーがBerkeleyデータベースを作成するサブディレクトリを指定します。このサブディレクトリは、サーバーの デフォルト: |
|
|
Berkeleyデータベースのキャッシュ・エントリに使用可能なメモリー量をバイト単位で指定します。キャッシュ・サイズを調整し、Berkeleyデータベースのパフォーマンスをチューニングできます。 デフォルト: |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのbdb-config
要素の使用方法を示します。
<bdb-config> <db-env-path>bdb</db-env-path> <cache-size>1000</cache-size> </bdb-config>
7.4 calendar
calendar
要素を使用すると、Oracle Stream Analyticsサーバーのcql
カレンダ・オプションを構成できます。この要素には、次の子要素があり、属性はありません。
表7-3 子要素: calendar
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
文字列は、 |
|
|
文字列は、 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのcalendar
要素の使用方法を示します。この例では、cql
要素の一意の識別子はmyCQL
です。
<cql> <name>myCQL</name> <storage> <folder>myfolder</folder> <metadata-name>myname</metadata-name> </storage> <calendar> <date-format>myclass</date-format> <timezone>10</timezone> </calendar> <scheduler> <class-name>myclass</class-name> <threads>10</threads> <direct-interop>false</direct-interop> </scheduler> </cql>
7.5 channels
channels
要素を使用して、pubsub-bean
要素に1つ以上のチャネルを構成します。チャネル・パターンは、常にスラッシュ(/
)で開始します。クライアントは、メッセージのパブリッシュ、またはメッセージの受信のためにこれらのチャネルにサブスクライブします。
この要素には、1つ以上のelement
子要素があり、そのそれぞれにはchannel-pattern
子要素および0個以上のmessage-filters
子要素が含まれます。各message-filters
子要素には、message-filters
要素に対応する
message-filter-name
のstring値を持つelement
子要素が含まれます。
この要素に属性はありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.6 channel-constraints
channel-constraints
要素を使用すると、pubsub-bean
要素の1つ以上のチャネル制約を構成できます。この要素には、次の子要素があり、属性はありません。
チャネルの詳細は、「channels」
を参照してください。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.7 channel-resource-collection
channel-resource-collection
要素を使用すると、channel-constraints
要素の1つ以上のチャネル・リソース・コレクションを構成できます。この要素には、次の子要素があり、属性はありません。
表7-4 子要素: channel-resource-collection
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
このチャネル・リソース名。 |
|
|
このチャネル・リソース・コレクションの説明。 この要素には、 |
|
|
チャネル・パターンを指定します。 この要素には、 |
|
|
チャネルへの操作を指定し、次を含む値を検証します。
この要素には、 |
チャネルの詳細は、「channels」
を参照してください。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.8 cluster
cluster
要素を使用すると、Oracle Stream Analyticsサーバーのクラスタ・コンポーネントを構成できます。この要素には、次の子要素があり、属性はありません。
表7-5 子要素: cluster
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
このクラスタの名前。詳細は、「name」を参照してください。 |
|
|
一意のサーバー名を指定します。Oracle Stream Analyticsのビジュアライザは、この要素の値を使用して、コンソールにサーバーを表示します。 デフォルト値:
|
|
|
ポイント・ツー・ポイントHTTPマルチサーバー通信に使用されるホスト・アドレスまたはIPを指定します。デフォルト値は、マシンのデフォルトNICに関連付けられたIPアドレスです。 |
|
|
この子要素は、マルチサーバー・ドメインのすべてのサーバーが同一のコンピュータでホストされている場合は不要です。この場合、 ただし、サーバーが異なるコンピュータ上でホストされる場合、適切なドメイン・ローカル・アドレスを提供する必要があります。Oracleは、 この Oracle Coherenceを使用すると、拡張機能もあります。ユニキャスト・アドレスを使用する場合、Oracle CoherenceはWell Knownアドレス(WKA)モードで構成されます。これは、マルチキャストをサポートしない環境で必要です。 |
|
|
マルチキャスト・アドレスのバインド先のインタフェース名。次のいずれかになります。
|
|
|
マルチキャスト・トラフィックに使用されるポートを指定します。デフォルト値は |
|
|
Oracle Stream Analyticsネイティブ・クラスタリングにのみ適用可能: サーバーのIDを指定し、1から Oracle Coherenceには適用できません。 |
|
説明を参照 |
クラスタが有効かどうかを指定します。有効な値は次のとおりです。
|
|
説明を参照 |
このクラスタのセキュリティ・タイプを指定します。有効な値は次のとおりです。
|
|
|
このクラスタが属するグループ名のカンマ区切りのリストを指定します。 |
|
|
ポイント・ツー・ポイントHTTPマルチサーバー・リクエストのタイムアウトを指定します(ミリ秒)。デフォルト値は |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.9 connection-pool-params
connection-pool-params
要素を使用すると、接続プール関連のdata-source
パラメータを指定できます。この要素には、次の子要素があり、属性はありません。
表7-6 子要素: connection-pool-params
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
現在実行中の文がタイムアウトする時間です。 デフォルト: -1。 |
|
|
診断プロファイルの収集操作中の秒数。 デフォルト: 300。 |
|
|
接続が再要求され、接続プールに解放される前に予約された接続で非アクティブになる秒数。 デフォルト: 0。 |
|
|
接続プールが需要に見合うよう増加された後、縮小するまでの秒数。 デフォルト: 900。 |
|
|
JDBCドライバに対するメソッド呼出しのインターセプトに使用されるアプリケーション・クラスの絶対名を指定します。指定するアプリケーションは、 |
|
|
接続がアプリケーションに渡される前、または定期的な接続テストの処理中に、その接続がまだ有効であると信頼されて接続テストがスキップされる接続使用の秒数。 デフォルト: 10。 |
|
|
このオプションは、アプリケーションが論理接続を終了した後でさえもプールされたデータベース接続を維持するための実行スレッドを有効化することによって、パフォーマンスを向上できます。 デフォルト: |
|
|
クライアントに渡す前に接続をテストします。 デフォルト: |
|
|
収集対象のプロファイル・データの種類を指定します。 |
|
|
文キャッシュに格納されたプリコンパイルされた文の管理に使用するアルゴリズム。有効な値は次のとおりです。
デフォルト: |
|
|
接続プールから接続を予約する呼出しがタイムアウトになるまでの秒数。0に設定すると、コールはタイムアウトしません。-1に設定すると、コールはすぐにタイムアウトします。 デフォルト: -1。 |
|
|
アプリケーションがデータベース接続をリクエストするとき、サーバーがデータベースIDのマップに基づいてデータベース接続上で軽量クライアントIDを設定することを有効化します。 デフォルト: |
|
|
各物理データベース接続を作成するまでにかかる遅延時間(秒)。この遅延により、短時間に連続する複数の接続リクエストを処理できないデータベース・サーバーがサポートされます。この遅延は、最初にデータ・ソースが作成されるときにも、データ・ソースの生存期間中に物理データベース接続が作成されるときにも発生します。 デフォルト: 0。 |
|
|
物理データベース接続のテスト時に使用するデータベース表の名前。この名前は、 |
|
|
キャッシュに保存されるプリコンパイルされた文および呼出し可能な文の数で、1から1024までになります。これによって、サーバーのパフォーマンスが向上することがあります。 デフォルト: 10。 |
|
|
新しく作成した物理データベース接続を初期化するときに実行されるSQL文。文の記述は |
|
|
データベース接続の確立を試行する間隔の秒数。この値を設定しないと、データベースが使用できない場合にデータ・ソースの作成が失敗します。値を設定し、データ・ソースの作成時にデータベースが使用できない場合、サーバーは、指定する秒数後にもう一度プール内で接続の作成を試行し、成功するまで接続の作成を試行し続けます。0に設定すると、接続の再試行は無効化されます。 デフォルト: 0。 |
|
|
未使用の接続がサーバーにテストされる秒間隔。(「テスト対象の表名」を指定する必要があります。)テストに失敗した接続は閉じられ、再度開かれて有効な物理接続が再確立されます。テストが再度失敗すると、その接続は閉じられます。マルチ・データ・ソースでは、サーバーが以前に異常とマークしたデータ・ソースの状態をチェックする頻度をこの属性が制御します。0に設定すると、この機能は無効化されます。 デフォルト: 120。 |
|
|
XAドライバのJDBCデバッグ・レベルを指定します。 デフォルト: 10。 |
|
|
データ・ソースに接続プールを作成するときに作成する物理接続の数。この数の接続を作成できない場合、データ・ソースの作成は失敗します。 デフォルト: 1。 |
|
|
この接続プールが保有できる物理接続の最大数。 デフォルト: 15。 |
|
|
接続プールに新しい接続を追加するときに作成する接続数。 デフォルト: 1。 |
|
|
データ・ソースの接続プールからの接続の予約を待機する間、同時にスレッドをブロックできる接続リクエストの最大数。 デフォルト: |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.10 cql
cql
要素を使用すると、Oracle Stream AnalyticsサーバーのOracle CQL固有のオプションを構成できます。この要素には、次の子要素があり、属性はありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.11 data-source
このdata-source
要素は、データ・ソース・サービスの構成を定義します。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのdata-source
要素の使用方法を示します。この例では、data-source
要素の一意の識別子はorads
です。
<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>
7.12 data-source-params
data-source-params
要素を使用すると、データ・ソース関連のdata-source
パラメータを指定できます。この要素には、次の子要素があり、属性はありません。
表7-7 子要素: data-source-params
XMLタグ | タイプ | 説明 |
---|---|---|
|
説明を参照 |
マルチ・データ・ソースの接続リクエスト処理を決定するアルゴリズム。有効な値は次のとおりです。
デフォルト: |
|
|
ストリーム・データ型のデータ・チャンク・サイズを1から65536まで指定します。 デフォルト: 256。 |
|
|
1回のサーバー・アクセスで複数の行がプリフェッチされる(つまり、サーバーからクライアントに送信される)かどうかを指定します。 デフォルト: |
|
|
マルチ・データ・ソースが接続リクエストを送信するデータ・ソースのリスト。リスト内のデータ・ソースの順番でフェイルオーバーの順序が決まります。 |
|
|
フェイルオーバー・アルゴリズムを使用するマルチ・データ・ソースでは、現在のデータ・ソースのすべての接続が使用中である場合に、接続リクエストを次のデータ・ソースにフェイルオーバーできます。 デフォルト: |
|
|
行のプリフェッチが有効化されている場合、クライアント用にプリフェッチする結果セットの行数を2から65536まで指定します。 デフォルト: 48。 |
|
説明を参照 |
このデータ・ソースのバインド先のJNDIパス。デフォルトでは、JNDI名はデータ・ソースの名前です。この要素には、次の子要素が含まれます。
|
|
|
データ・ソースの範囲を指定します。 デフォルト: |
|
|
マルチ・データ・ソースがマルチ・データ・ソース内の別のデータ・ソースに接続リクエストをフェイルオーバーまたはフェイルバックする準備ができているときに、送られたコールバックを処理するアプリケーション・クラスの名前。この名前は、 |
|
|
データ・ソースのトランザクション・プロトコル(グローバル・トランザクション処理動作)を決定します。有効な値は次のとおりです。
デフォルト: |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.13 driver-params
driver-params
要素を使用すると、JDBCドライバ関連のdata-source
パラメータを指定できます。この要素には、次の子要素があり、属性はありません。
表7-8 子要素: driver-params
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
サーバーがJDBCドライバのXAインタフェースを使用するように指定します。データベース接続の作成に使用されるJDBCドライバ・クラスが、JDBCドライバのXAおよび非XAバージョンの両方を実装する場合、この属性を設定して、サーバーがJDBCドライバをXAドライバまたは非XAドライバとして処理することを指定するようにできます。 デフォルト: |
|
|
物理データベース接続の作成時にJDBCドライバに渡されるパスワード属性。 |
|
|
データ・ソースの接続プールで物理データベース接続の作成に使用するJDBCドライバ・クラスの完全パッケージ名。 |
|
|
接続先データベースのURL。URLの書式は、使用するJDBCドライバによって異なります。URLは、物理データベース接続を作成するためにJDBCドライバに渡されます。 |
|
|
物理データベース接続の作成時にJDBCドライバに渡されるプロパティのリストを指定します。この要素には、次の子要素を持つ1つ以上の
|
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.14 domain
domain
要素を使用すると、Oracle Stream Analyticsサーバーのドメイン名を構成できます。この要素には、name子要素があり、属性はありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのdomain
要素の使用方法を示します。この例では、domainの一意の識別子はWLEventServerDomain
です。
<domain> <name>WLEventServerDomain</name> </domain>
7.15 debug
debug
要素を使用すると、Oracle Stream Analyticsサーバーの1つ以上のデバッグ・プロパティを構成できます。この要素には、次の子要素があり、属性はありません。
表7-9 子要素: debug
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
デバッグ・フラグ名(そのパッケージ名は使用せずに)を使用し、値を |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でデバッグ・フラグcom.bea.core.debug.DebugSDS
を使用して、Simple Declarative Services (SDS)デバッグ処理を有効にするためのdebug
要素の使用方法を示します。
<debug> <name>myDebug</name> <debug-properties> <DebugSDS>true</DebugSDS> ... </debug-properties> </debug>
7.16 event-inspector
event-inspector
要素を使用すると、コンポーネントをテストできます。この要素には、pubsub-server-name
子要素があり、属性はありません。
pubsub-server-name
値は、ローカルのOracle Stream Analyticsサーバー・ファイルに定義されている、http-pubsub
要素のname子要素の値です。
次の例は、構成ファイル内でのevent-inspector
要素の使用方法を示します。
<event-inspector> <name>myEventInspectorConfig</name> <pubsub-server-name>myPubSub</pubsub-server-name> </event-inspector>
次の例は、対応するローカルのOracle Stream Analyticsサーバー・ファイルのエントリを示します。
<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> ... </channels> </pub-sub-bean> </http-pubsub>
7.17 event-store
event-store要素を使用すると、Oracle Stream Analyticsサーバーのイベント・ストアを構成できます。この要素には、次の子要素があり、属性はありません。
表7-10 子要素: event-store
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
Oracle Stream Analyticsサーバーがアクセスする順序で1つ以上の 詳細は、次を参照してください。 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのevent-store
要素の使用方法を示します。この例では、adapterの一意の識別子はmyEventStore
です。
<config> <event-store> <name>myEventStore</name> <provider-order> <provider>provider1</provider> <provider>provider2</provider> </provider-order> </event-store> </config>
7.18 exported-jndi-context
exported-jndi-context
要素を使用すると、クライアント経由でRMIを使用してアクセスできるリモートJNDIサービスをエクスポートできます。これによってRMIサービスを使用するJNDIコンテキストが登録されるため、InitialContext
オブジェクトの作成時にプロバイダURLパラメータを渡すクライアントによってリモートからアクセスできます。このサービスでは、jndi-context
構成オブジェクトも指定される必要があります。指定されない場合、このサービスを開始できません。
この要素には、次の子要素があり、属性はありません。
表7-11 子要素: exported-jndi-context
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
ネットワークでこのJNDIコンテキストを処理するために使用されるRMIサービスの名前。構成内の既存のRMIオブジェクトと一致する必要があります。詳細は、 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのexported-jndi-context
要素の使用方法を示します。この例では、adapterの一意の識別子はRemoteJNDI
です。
<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>
7.19 glassfish-ws
glassfish-ws
要素を使用すると、Oracle Stream AnalyticsのWebサービスを構成できます。この要素にはhttp_service_name
要素があり、属性はありません。
http_service_name
要素を使用すると、Oracle Stream AnalyticsにWebサービス・エンド・ポイントを登録する際に使用する、HTTPサービスの名前を指定できます。このサービスは、同名のJettyインスタンスによって提供されます。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのglassfish-ws
要素の使用方法を示します。この例では、glassfish-ws
要素の一意の識別子はmyWS
です。
<glassfish-ws> <name>myWS</name> <http-service-name>TestJetty</http-service-name> </glassfish-ws>
7.20 http-pubsub
http-pubsub
要素を使用すると、HTTPパブリッシュ/サブスクライブ・サービスを構成できます。この要素には、次の子要素があり、属性はありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのhttp-pubsub
要素の使用方法を示します。この例では、http-pubsub
要素の一意の識別子はmyPubsub
です。
<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>
7.21 jetty
jetty
要素を使用すると、Jetty HTTPサーバーのインスタンスを構成できます。この要素には、次の子要素があり、属性はありません。
表7-12 子要素: jetty
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
使用されるネットワークI/Oサービス名。これは、サーバーがどのポートでリスニングするかも定義します。このパラメータは、有効な「netio」構成オブジェクトの名前を参照する必要があります。 |
|
|
スレッドのプールに使用されるワーク・マネージャの名前。このパラメータが指定されない場合、Jettyはデフォルトのワーク・マネージャを使用します。詳細は、 |
|
|
Webアプリケーション、JSP、およびその他のWebアーティファクトに必要な一時ファイルが保持されるディレクトリ名。このパラメータは、 |
|
|
Jettyコードにおけるデバッグ処理を有効にします。指定されたデバッグ・メッセージは、ログ・サービスにおけるすべての他の |
|
|
設定されるネットワーク・ポートの名前。このパラメータは、 |
|
|
セキュアな通信に使用されるネットワークI/Oサービス名。指定されたサービスは、SSL暗号化をサポートするために構成される必要があります。このパラメータは、有効な |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのjetty
要素の使用方法を示します。この例では、jetty
要素の一意の識別子はTestJetty
です。
<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>
7.22 jetty-web-app
jetty-web-app
要素を使用すると、Jettyによって使用されるWebアプリケーションを表示できます。このオブジェクトの各インスタンスは、Jettyサービスを使用することによってデプロイされる必要があるWebアプリケーションを表します。
この要素には、次の子要素があり、属性はありません。
表7-13 子要素: jetty-web-app
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
このWebアプリケーションがWebサーバーのネームスペースにデプロイされるコンテキスト・パス。 デフォルト: |
|
|
JettyがこのWebアプリケーションの一時ファイルを保存する場所。このパラメータは、 |
|
|
サーバー上のWebアプリケーションの場所を指すファイル名。ディレクトリまたはWARファイルを指定できます。 |
|
|
このWebアプリケーションがデプロイされるJettyサービス名。この名前は、既存の |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのjetty-web-app
要素の使用方法を示します。この例では、jetty-web-app
要素の一意の識別子はfinancial
です。
<jetty-web-app> <name>financial</name> <context-path>/financial</context-path> <path>../testws2/financialWS.war</path> <jetty-name>TestJetty</jetty-name> </jetty-web-app>
7.23 jmx
jmx
要素を使用すると、Oracle Stream AnalyticsサーバーのJava Management Extension (JMX)のプロパティを構成できます。
表7-14 子要素: jmx
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
ネットワークでこのJNDIコンテキストを処理するために使用されるRMIサービスの名前。構成内の既存のRMIオブジェクトと一致する必要があります。詳細は、 |
|
|
JMXサーバーがそのオブジェクトをバインドする先のJNDIサービス名。 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのjmx
要素の使用方法を示します。この例では、jmx
要素の一意の識別子はmyJMX
です。
<jmx> <name>myJMX</name> <jndi-service-name>JNDI</jndi-service-name> <rmi-service-name>RMI</rmi-service-name> </jmx>
7.24 jndi-context
jndi-context
要素を使用すると、JNDIプロバイダを構成できます。構成内に配置されると、MSA JNDIコンテキストが初期化されます。JNDIサービスをローカルで使用する場合や、exported-jndi-context
構成タイプを介してリモートで使用する場合は、この構成タイプの1つのインスタンスが構成内に配置されている必要があります。
この要素には、次の子要素があり、属性はありません。
表7-15 子要素: jndi-context
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
このパラメータのデフォルトは、 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのjndi-context
要素の使用方法を示します。この例では、adapterの一意の識別子はmyJNDI
です。
<jndi-context> <name>myJNDI</name> <default-provider>true</default-provider> </jndi-context>
7.25 log-file
log-file
要素を使用すると、Oracle Stream Analyticsサーバー上のファイルへのロギングを構成できます。
表7-16 子要素: log-file
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
ローテーションされたファイルを永久に保存するかどうかを決定します。 デフォルト: |
|
|
ログ・ファイルのローテーション方法をサイズ・ベースまたは時間ベースで行うか、あるいはまったく行わないかを決定します。有効な値は次のとおりです。
デフォルト: |
|
|
最初のローテーションが発生したときの時間( デフォルト: 00:00。 |
|
|
ローテーションされた古いファイルを削除する場合、このパラメータによって最新のファイルを常に保存する数が決定されます。 デフォルト: 7。 |
|
|
ログ・ファイルがローテーションされるときのサイズのしきい値(単位はKB)。 デフォルト: 500。 |
|
|
時間ベースのログ・ローテーションの頻度となる一定のミリ秒に到達すると期間に適用される倍率。 デフォルト: ( |
|
|
各時間ベースのログ・ローテーションの間隔。 デフォルト: 24。 |
|
|
ログ・ファイル名。 デフォルト: |
|
|
起動時にログ・ファイルをローテーションするかどうかを指定します。 デフォルト: |
|
|
ハンドラに伝播されるメッセージのしきい値の重要度を指定します。デフォルトは
デフォルト: |
|
|
ローテーションされた古いファイルが保存されているディレクトリ。設定しない場合、古いファイルはベース・ログ・ファイルとして同一ディレクトリ内に保存されます。 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのlog-file
要素の使用方法を示します。この例では、log-file
要素の一意の識別子はlogFile
です。
<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>
7.26 log-stdout
log-stdout
要素を使用すると、Oracle Stream Analyticsサーバー上の標準出力(コンソール)へのロギングを構成できます。この要素には、次の子要素があり、属性はありません。
表7-17 子要素: log-stdout
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
標準出力に表示するスタック・トレース・フレーム数を決定します。すべてのフレームはログ・ファイルに表示されます。値を-1に設定すると、すべてのフレームが表示されます。 デフォルト: -1。 |
|
|
ログ記録されたメッセージに含まれるとき、スタック・トレースをコンソールにダンプするかどうかを指定します。 デフォルト: |
|
string |
ハンドラに伝播されるメッセージのしきい値の重要度を定義します。デフォルトは
デフォルト: |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのlog-stdout
要素の使用方法を示します。この例では、log-stdout
要素の一意の識別子はlogStdout
です。
<log-stdout> <name>logStdout</name> <stdout-severity>Debug</stdout-severity> </log-stdout>
7.27 logging-service
logging-service要素は、Oracle Stream Analyticsサーバーでロギング・サービスを構成する際に使用します。この要素には、次の子要素があり、属性はありません。
表7-18 子要素: logging-service
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
ログ・ファイルとそのローテーション・ポリシーの構成。 |
|
|
stdout出力の構成。 |
|
|
ハンドラに伝播されるメッセージのしきい値の重要度を定義します。デフォルトは
デフォルト: |
|
説明を参照 |
ロガー・ツリーにおける異なるステージの重大度の値で、それぞれが |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのlogging-service
要素の使用方法を示します。この例では、logging-service
要素の一意の識別子はmyLogService
です。
<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>
7.28 message-filters
message-filters
要素を使用すると、pubsub-bean
要素の1つ以上のメッセージ・フィルタを構成できます。
この要素には、1つ以上のelement
子要素があり、そのそれぞれにmessage-filter-name
およびmessage-filter-class
子要素があります。
この要素に属性はありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.29 name
name
要素を使用すると、Oracle Stream Analyticsサーバー構成要素の一意の識別子を宣言できます。この要素には、子要素も属性もありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのname
要素の使用方法を示します。
<http-pubsub> <name>pubsub</name> <path>/pubsub</path> ... </http-pubsub>
7.30 netio
netio
要素を使用すると、ネットワーク入力/出力(IO)サービスを表示できます。このサービスは、ネットワークIO用サーバーとして機能するために他のサービスが使用できます。この要素には、次の子要素があり、属性はありません。
表7-19 子要素: netio
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
使用するSSL構成オブジェクト名。nullではない場合、このクライアントは指定したSSL構成を使用してセキュア・ソケットを作成します。設定しない場合、SSLはサポートされません。 |
|
|
基礎となるソケット実装にどのプロバイダを使用するかを指定します。 |
|
|
ソケットの処理に使用するスレッド数に関するプロバイダへのヒント。値を0に指定すると、プロバイダはデフォルト設定に基づいて選択を行うようになります。デフォルト: 0。 |
|
|
リスニングする元となるポート。サーバーはこのポート上で受信接続へのリスニングをただちに開始します。 |
|
|
受信接続へのリスニングを行う元となるNetioのインスタンスのアドレス。 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのnetio
要素の使用方法を示します。この例では、netio
要素の一意の識別子はmyNetio
です。
<netio> <name>myNetio</name> <port>12345</port> </netio>
7.31 netio-client
netio-client
要素を使用すると、非ブロック・ネットワークIOを実行するために使用されるネットワーク入力/出力(IO)サービスを登録できます。ただし、このサービスはサーバーとして機能せず、受信接続をリスニングしません。この要素には、次の子要素があり、属性はありません。
表7-20 子要素: netio-client
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
使用するSSL構成オブジェクト名。nullではない場合、このクライアントは指定したSSL構成を使用してセキュア・ソケットを作成します。設定しない場合、SSLはサポートされません。 |
|
|
基礎となるソケット実装にどのプロバイダを使用するかを指定します。 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのnetio-client
要素の使用方法を示します。この例では、netio-client
要素の一意の識別子はnetiossl
です。
<netio-client> <name>netiossl</name> <ssl-config-bean-name>sslConfig</ssl-config-bean-name> <provider-type>NIO</provider-type> </netio-client>
7.32 partition-order-capacity
partition-order-capacity
要素を使用すると、ordering-constraint属性がPARTITION_ORDEREDに設定されている場合に問合せパーティションの最大容量を定義できます。この要素は、cqlコンポーネントに設定します。パラレル実行用の問合せプロセッサが構成されていて、問合せのordering-constraint属性がPARTITION_ORDEREDに設定されている場合に、この要素の値を設定することを検討してください。デフォルト値は4です。
この要素には、子要素も属性もありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのpartition-order-capacity
要素の使用方法を示します。
<cql> <name>myCQL</name> <partition-order-capacity>20</partition-order-capacity> </cql>
7.33 path
path
要素を使用して、http-pubsub
要素のパスを構成します。この要素には、子要素も属性もありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.34 pubsub-bean
pubsub-bean
要素を使用すると、http-pubsub
要素のpublish-subscribe Beanを構成できます。この要素には、次の子要素があり、属性はありません。
http://www.oracle.com/webfolder/technetwork/weblogic/weblogic-pubsub/1.0/weblogic-pubsub.xsd
を参照してください。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.35 rdbms-event-store-provider
rdbms-event-store-provider
要素を使用すると、Oracle Stream Analyticsサーバーのリレーショナル・データベース管理システムを使用するイベント・ストア・プロバイダを構成できます。デフォルトでは、Oracle Stream Analyticsはイベント・ストア・プロバイダとしてBerkeleyデータベース・インスタンスを使用します(「bdb-config」を参照してください)。
この要素には、次の子要素があり、属性はありません。
表7-21 子要素: rdbms-event-store-provider
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
Oracle Stream Analyticsサーバーが、このプロバイダの初期化を待機する最大時間(ミリ秒)。 デフォルト: 10000ミリ秒。 |
|
|
データ・ソース要素の名前。詳細は、 |
|
説明を参照 |
追加のデータ・ソース・プロパティの指定に使用する |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.36 rmi
rmi
要素を使用すると、RMIサービスを構成できます。このサービスによって、サーバー側のオブジェクトをリモート・クライアントにエクスポートできます。この要素には、次の子要素があり、属性はありません。
表7-22 子要素: rmi
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
切断通知をすべての登録済リスナーにトリガーする前に失敗したハートビートの試行回数。デフォルト値: 4。 |
|
|
HTTPサービス名で、このサービスがリモート・オブジェクトの登録に使用します。このサービスは、同名のJettyまたはTomcatのインスタンスによって提供されます。 |
|
|
ハートビート間の時間(ミリ秒)。失敗したハートビートの試行回数が デフォルト値: 5000。 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのrmi
要素の使用方法を示します。この例では、rmi
要素の一意の識別子はmyRMI
です。
<rmi> <name>myRMI</name> <http-service-name>TestJetty</http-service-name> </rmi>
7.37 scheduler
scheduler
要素を使用すると、Oracle Stream Analyticsサーバーのcql
スケジューラ・オプションを構成できます。この要素には、次の子要素があり、属性はありません。
表7-23 子要素: scheduler
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
Oracle CQLスケジューラがOracle CQL問合せを実行する頻度。 デフォルト: 1000ミリ秒 |
|
|
Oracle Stream Analyticsサービス・エンジンのスケジューラが個別のスレッドを使用するかどうか。オプションは次のとおりです。
|
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのscheduler
要素の使用方法を示します。
<cql> <name>myCQL</name> <calendar> <date-format>myclass</date-format> <timezone>10</timezone> </calendar> <scheduler> <class-name>oracle.cep.execution.scheduler.FIFOScheduler</class-name> <threads>10</threads> <direct-interop>false</direct-interop> </scheduler> </cql>
7.38 server-config
server-config
要素を使用すると、pubsub-bean
要素のサーバー専用プロパティを構成できます。この要素には、次の子要素があり、属性はありません。
表7-24 子要素: server-config
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
説明を参照 |
この要素には、1つ以上の
|
|
|
クライアントが接続/再接続のメッセージを送信しなかった場合に、HTTPパブリッシュ/サブスクライブ・サーバーがクライアントとの接続を切断してからの秒数を指定します。 デフォルト: 60。 |
|
|
永続クライアントが接続または再接続メッセージを送信しない間に、永続クライアントが切断されてパブリッシュ/サブスクライブ・サーバーによって削除されてからの秒数を指定します。この値は、client-timeout-secsよりも大きくする必要があります。永続クライアントは、この永続タイムアウト値に達する前に再接続した場合はその期間内に永続チャネルにパブリッシュされたすべてのメッセージを受信できますが、このタイムアウト値より後に再接続した場合はそれらのメッセージを受信できません。 デフォルト: 600秒。 |
|
|
クライアントが デフォルト: 500ミリ秒。 |
|
|
メッセージをクライアントに配信するワーク・マネージャの名前を指定します。この要素の値は、割り当てる 詳細は、 |
|
|
HTTPパブリッシュ/サブスクライブ・サーバーに明示的に接続せずに、クライアントがメッセージをパブリッシュできるかどうかを指定します。有効な値は次のとおりです。
|
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.39 services
services
要素を使用すると、pubsub-bean
要素のサービス・プロパティを構成できます。この要素には、次の子要素があり、属性はありません。
表7-25 子要素: services
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
サービス・チャネルを指定します。例: |
|
|
このサービスを使用するクラスを指定します。例: |
|
|
サービス・クラスにおけるサービス・メソッドを定義します。このサービス・メソッドは、タイプ |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.40 show-detail-error-message
show-detail-error-message
要素を使用すると、Oracle Stream Analyticsサーバーがセキュア接続を使用するかどうかを構成できます。この要素には、次の子要素があり、属性はありません。
表7-26 子要素: show-detail-error-message
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
詳細エラー・メッセージを表示するかどうか。有効な値は次のとおりです。
|
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのshow-detail-error-message
要素の使用方法を示します。この例では、show-detail-error-message
要素の一意の識別子はmyShowDetail
です。
<show-detail-error-message> <name>myShowDetail</name> <value>true</value> </show-detail-error-message>
7.41 ssl
ssl
要素を使用すると、Oracle Stream AnalyticsサーバーでSecure Sockets Layer固有のプロパティを構成できます。この要素には、次の子要素があり、属性はありません。
表7-27 子要素: ssl
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
このクラスタの名前。詳細は、 |
|
|
|
|
説明を参照 |
この要素には、キーストアへのアクセスに使用されるパスワードを指定する |
|
|
キーストアの別名を指定します。 |
|
|
|
|
|
|
|
|
|
|
説明を参照 |
この要素には、トラスト・ストアへのアクセスに使用されるパスワードを指定する |
|
|
トラスト・ストアの別名を指定します。 |
|
|
|
|
|
|
|
|
Oracle Stream AnalyticsサーバーがFederal Information Processing Standards (FIPS)認証済の擬似乱数ジェネレータを使用するかどうかを指定します。 |
|
|
クライアント証明書認可が必要かどうかを指定します。 |
|
説明を参照 |
この要素には1つ以上の |
|
|
|
|
|
|
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのssl
要素の使用方法を示します。
この例では、ssl
要素の一意の識別子はsslConfig
です。
<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>
7.42 timeout-seconds
timeout-seconds
要素を使用すると、Oracle Stream Analyticsサーバーのweblogic-jta-gateway
デフォルト・トランザクション・タイムアウトを秒単位で構成できます。デフォルト値は60です。この要素には、子要素も属性もありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.43 transaction-manager
transaction-manager
要素を使用すると、Oracle Stream Analyticsサーバーのトランザクション・マネージャのプロパティを構成できます。この要素には、次の子要素があり、属性はありません。
表7-28 子要素: transaction-manager
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
各サーバーで許容されるリソースへの同時リクエストの最大数。 デフォルト: 50。 |
|
|
リソースが失効を宣言される最大期間(ミリ秒)。この期間後、リソース・プロバイダが明示的にリソースを再登録する場合でも、リソースはもう一度使用可能を宣言されます。デフォルト: 1800000。 |
|
|
グローバル・トランザクションに参加するサーバー間でのXA呼出しに使用される通信チャネルのセキュリティ・モードを指定します。ドメイン内のすべてのサーバー・インスタンスのセキュリティ・モード設定が同じである必要があります。有効な値は次のとおりです。
デフォルト: |
|
|
使用可能なスレッドが存在する場合に、XAコールを並列で実行します。 デフォルト: |
|
|
トランザクション・ログを含むファイル・ストアの場所。この属性は、ファイルシステム内の絶対パスまたは相対パスのいずれかにすることができます。 |
|
|
リソースへのXAコールが許可される最大存続期間。リソースに対する特定のXA呼出しがこの制限時間を超過すると、そのリソースは利用不可能と宣言されます。 デフォルト: 120000。 |
|
|
デフォルトのトランザクション・タイムアウト(秒単位)。 デフォルト: 30。 |
|
|
トランザクション・マネージャがトランザクション・ログ・チェックポイント操作を実行する間隔。 デフォルト: 300。 |
|
|
トランザクション・マネージャが自動的にヒューリスティック・トランザクション完了のXAResource放棄操作を実行するかどうかを指定します。有効化すると、トランザクション・マネージャは、トランザクションがヒューリスティックな結果を認識するとすべてのリソースのXA Resource デフォルト: |
|
|
トランザクション・マネージャが、完了前の同期コールバック処理を実行するサイクルの最大数。 デフォルト: 10。 |
|
|
2フェーズ・コミット(準備およびその後)の第2フェーズにおけるトランザクションのトランザクション中止タイムアウト秒数。2フェーズ・コミット処理の第2フェーズ中に、すべてのリソース・マネージャがトランザクションの完了を示すまで、トランザクション・マネージャがトランザクションを完了させようとします。このタイムアウトを使用することによって、トランザクションの第2フェーズ中にトランザクションを完了させようとする試行をトランザクション・マネージャが永続する最大時間を設定できます。トランザクション破棄タイムアウトの時間をすぎると、トランザクションを解決するための処理はこれ以上行われなくなります。中止される前にトランザクションが準備状態にある場合は、トランザクション・マネージャがトランザクションをロールバックし、中止されたトランザクションのかわりに保持されたロックを解放します。 デフォルト: 86400。 |
|
|
リソースの登録のシリアライズに使用される内部オブジェクトがクリーンアップされる間隔。 デフォルト: 30000。 |
|
|
トランザクション・マネージャがリソースの登録解除前に完了するリソースを含むトランザクションを待機する猶予期間(秒数)。猶予期間は、アプリケーションにパッケージ化されたJDBCデータ・ソース・モジュールなどの、登録解除されたリソースのために中止されたトランザクションのリスクを最小化するのに役立ちます。指定された猶予期間中、コールが戻されるまでunregisterResourceコールがブロックされ、関連するリソースに対して新しいトランザクションは開始されません。リソースに対して未処理のトランザクションの数が0になると、unregisterResource呼出しは即座に返ります。猶予期間の終わりに、まだリソースに関連する未処理のトランザクションがある場合は、unregisterResourceが返り、リソースが以前登録されていたサーバー上にログ・メッセージが書き込まれます。 デフォルト: 30。 |
|
|
分散型トランザクション調整に使用されるRMIサービス名。 詳細は、 |
|
|
統計情報が保持される一意のトランザクション名の最大数。 デフォルト: 1000。 |
|
|
チェックポイント・レコードに含まれるように、特定のリソースがアクセスされる必要がある間隔。 デフォルト: 86400。 |
|
|
このサーバー上で許可される同時進行中のトランザクションの最大数。 デフォルト: 10000。 |
|
|
移行されたトランザクション・ログ(TLOG)にチェックポイントが実行される間隔。 デフォルト: 60。 |
|
|
リソースが使用可能になるまでリカバリが試行される間隔。 デフォルト: 300000。 |
|
|
JTAサブシステムが デフォルト: 60000。 |
|
|
XA操作を並列に実行するときに使用するディスパッチ・ポリシー。デフォルトでは、トランザクションを調整するスレッドのポリシーが使用されます。 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのtransaction-manager
要素の使用方法を示します。この例では、transaction-manager
要素の一意の識別子はMy_tm
です。
<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>
7.44 use-secure-connections
use-secure-conditions
要素を使用すると、Oracle Stream Analyticsサーバーがセキュア接続を使用するかどうかを構成できます。この要素には、次の子要素があり、属性はありません。
表7-29 子要素: use-secure-connections
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
セキュア接続を使用するかどうか。有効な値は次のとおりです。
|
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのuse-secure-connections
要素の使用方法を示します。
<use-secure-connections> <name>myUseSecConn</name> <value>true</value> </use-secure-connections>
7.45 weblogic-instances
weblogic-instances
要素を使用すると、weblogic-jta-gateway
要素のOracle Stream Analyticsサーバー・インスタンスを構成できます。この要素には、次の子要素があり、属性はありません。
表7-30 子要素: weblogic-instances
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
Oracle Stream Analyticsサーバーのドメイン名を指定します。 |
|
|
Oracle Stream Analyticsサーバーの名前を指定します。 |
|
|
JTAプロトコルを指定します。 デフォルト: |
|
|
Oracle Stream Analyticsサーバーのホスト名またはIPアドレス。 |
|
|
Oracle Stream Analyticsサーバーの |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>
7.46 weblogic-jta-gateway
weblogic-jta-gateway
要素を使用すると、シングルトンOracle Stream Analyticsサーバー・クライアントのJTAゲートウェイ・サービスの属性を構成できます。この要素には、次の子要素があり、属性はありません。
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのweblogic-jta-gateway
要素の使用方法を示します。この例では、weblogic-jta-gateway
要素の一意の識別子は、myJTAGateway
です。
<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>
7.47 weblogic-rmi-client
weblogic-rmi-client
要素を使用すると、シングルトンOracle Stream AnalyticsサーバーのRMIクライアントの属性を構成できます。この要素には、次の子要素があり、属性はありません。
表7-31 子要素: weblogic-rmi-client
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
使用する |
|
|
SSLに構成される |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのweblogic-rmi-client
要素の使用方法を示します。この例では、 weblogic-rmi-client
要素の一意の識別子はwlclient
です。
<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>
7.48 work-manager
work-manager
要素を使用すると、Oracle Stream Analyticsサーバーのワーク・マネージャを構成できます。
表7-32 子要素: work-manager
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
この |
|
|
このワーク・マネージャが使用する最小スレッド制約。 デフォルト: -1。 |
|
|
このワーク・マネージャが使用するフェア・シェア値。 デフォルト: -1。 |
|
|
このワーク・マネージャが使用する最大スレッド制約。 デフォルト: -1。 |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内でのwork-manager
要素の使用方法を示します。この例では、work-manager
要素の一意の識別子はWM
です。
<work-manager> <name>WM</name> <fairshare>5</fairshare> <min-threads-constraint>1</min-threads-constraint> <max-threads-constraint>4</max-threads-constraint> </work-manager>
7.49 xa-params
xa-params
要素を使用すると、分散型トランザクション関連のdata-source
パラメータを指定できます。この要素には、次の子要素があり、属性はありません。
表7-33 子要素: xa-params
XMLタグ | タイプ | 説明 |
---|---|---|
|
|
トランザクションが完了するまで、接続プールからグローバル・トランザクションへの同一のXAデータベース接続にサーバーが関連できるようにします。これは、XAドライバを使用する接続プールにのみ適用されます。この設定は、JDBC XAドライバに関する特定の問題を回避するために使用します。 デフォルト: |
|
|
トランザクション・ブランチがタイムアウトするように設定する秒数。設定すると、この値がXAリソース・マネージャ(通常はJDBCドライバ)上の デフォルト: 0。 |
|
|
サーバーが、接続プールに接続を戻す前に接続上で デフォルト: |
|
|
トランザクション・マネージャがリソースに対して回復処理を実行する期間を秒数で指定します。値0を指定すると、再試行は行われません。 デフォルト: 60。 |
|
|
サーバーが、 デフォルト: |
|
|
物理XA接続が接続プールに戻されるときに、サーバーが、グローバル・トランザクションに対して論理JDBC接続を開いたまま保持できるようにします。データベース接続の作成に使用されるXAドライバまたはDBMSで、物理XA接続が接続プールに戻されてもトランザクション処理が継続している間は論理JDBC接続が開いたまま保持される必要がある場合に、このオプションを選択します。これは、XAドライバを使用するデータ・ソースにのみ適用されます。この設定は、JDBC XAドライバに関する特定の問題を回避するために使用します。 デフォルト: |
|
|
XAデータ・ソースのJTAリソース・ヘルス監視を有効化します。有効化すると、XAリソースがMaxXACallMillisで指定された期間中にXAコールに応答できない場合に、サーバーがデータ・リソースを正常でないとマークし、リソースに対する以降のコールをブロックします。このプロパティはXAデータ・ソースにのみ適用され、非XAドライバを使用するデータ・ソースでは無視されます。 デフォルト: |
|
|
専用のXA接続がグローバル・トランザクションのコミットおよびロールバック処理に使用されることを指定します。これは、XAドライバを使用するデータ・ソースにのみ適用されます。この設定は、JDBC XAドライバに関する特定の問題を回避するために使用します。 デフォルト: |
|
|
保留中の各 デフォルト: |
|
|
XA再試行処理を行う秒間隔(XARetryDurationSecondsが正の値に設定されている場合)。 デフォルト: 60。 |
|
|
トランザクション・マネージャがリソース上で回復処理を1回のみ呼び出すことを指定します。これは、XAドライバを使用するデータ・ソースにのみ適用されます。この設定は、JDBC XAドライバに関する特定の問題を回避するために使用します。 デフォルト: |
|
|
様々なJDBCオブジェクト(結果セット、文、接続など)が閉じられたときに、XAドライバが分散トランザクション・コンテキストを要求するかどうかを指定します。これは、XAドライバを使用する接続プールにのみ適用されます。有効化すると、JDBCオブジェクトを閉じるときにスローされるSQL例外のうち、トランザクション・コンテキストがないものが抑制されます。この設定は、JDBC XAドライバに関する特定の問題を回避するために使用します。 デフォルト: |
次の例では、Oracle Stream Analyticsサーバー構成ファイル内での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>