この章は、Oracle Event Processingネイティブ・クラスタリングに基づくOracle Event Processingマルチサーバー・ドメインの管理方法を説明します。これらのドメインの作成と更新、その中でのメッセージの保護、グループ・メンバーの管理、サーバーの起動および停止方法を説明します。
この章の内容は次のとおりです。
7.1項「Oracle Event Processingネイティブ・クラスタリングを使用したOracle Event Processingマルチサーバー・ドメインの作成」
7.2項「Oracle Event Processingネイティブ・クラスタリングを使用したOracle Event Processingマルチサーバー・ドメインの更新」
この項では、Oracle Event Processingネイティブ・クラスタリングを使用して2つ以上のOracle Event Processingサーバーからマルチサーバー・ドメインを作成して構成する方法について説明します。この項には、次の項目が含まれます。
注意: マルチサーバー・ドメインでサーバーを適切に構成するには、そのサーバーは、同じマルチキャスト・アドレスとポート、および同じドメイン名を使用して構成する必要があります。同じマルチキャスト・アドレスおよびポートを使用し、異なるドメイン名を使用してサーバーを構成するとエラーになります。 |
この手順では、事前定義済の2つのグループ(シングルトン・グループとドメイン・グループ)のみを使用してマルチサーバー・ドメインを作成する方法について説明します。デフォルト・グループを使用するドメインでは、すべてのサーバーが完全に同一である必要があります。
ドメインが完全に同一ではないサーバーをサポートする必要がある場合、カスタム・グループを使用して構成します。7.1.2項「Oracle Event Processingネイティブ・クラスタリングを使用したカスタム・グループによるOracle Event Processingマルチサーバー・ドメインの作成方法」を参照してください。
デフォルト・グループとカスタム・グループの詳細は、6.2項「グループ」を参照してください。
注意: この項では、1つのサーバーを含むドメインがすでに作成済であり、ドメインをマルチサーバー・ドメインにするには追加のサーバーをドメインに追加することを前提としています。ドメインの作成の詳細は、第3章「Oracle Event Processingスタンドアロンサーバー・ドメインの管理」を参照してください。 |
Oracle Event Processingネイティブ・クラスタリングを使用してデフォルト・グループによるOracle Event Processingマルチサーバー・ドメインを作成するには:
1つの初期サーバーを含むドメインを作成します。
構成ウィザードを使用して、ドメインに1つまたは複数のサーバーを追加します。
注意: 構成ウィザードではマルチサーバー・ドメインへの新規サーバーの追加はサポートされていませんが、構成ウィザードを使用して新しいスタンドアロンサーバーを生成し、生成したサーバーの構成を手動で更新することにより、サーバーをマルチサーバー・ドメインに追加できます。 |
7.2項「Oracle Event Processingネイティブ・クラスタリングを使用したOracle Event Processingマルチサーバー・ドメインの更新」を参照してください。
手動でconfig.xml
ファイルを編集し、特定の情報とともにcluster
要素を追加して、マルチサーバー・ドメイン内のすべてのサーバーを構成します。
デフォルト・グループを使用してマルチサーバー・ドメインのサーバーを構成するには、各メンバー・サーバーのconfig.xml
ファイルを更新し、例7-1に示すように、ルートconfig
要素のcluster
子要素を追加します。
clusterの次の子要素を含みます。
server-name
: cluster
のserver-name
子要素は、サーバーの一意の名前を指定します。コンソールにサーバーを表示する場合、Oracle Event Processing Visualizerはこの要素の値を使用します。要素が設定されていない場合、デフォルト値はServer-
identity
です。ここで、identity
はidentity
要素の値です。
server-host-name
: ポイント・ツー・ポイントHTTPマルチサーバー通信に使用するホスト・アドレス/IPを指定します。デフォルト値はlocalhost
です。
マルチサーバー・ドメイン内の1つ以上のOracle Event Processingサーバーが異なるホストにあり、Oracle Event Processing Visualizerを使用してマルチサーバー・ドメインを管理する場合は、この要素が必須です。サーバーが複数のIPアドレスが構成されたホスト・マシンにデプロイされている場合も、これは必須です(マルチサーバーかスタンドアロンサーバー環境のいずれでも)。
multicast-address
: マルチサーバー・ドメインのすべてのサーバーが同じコンピュータ上でホストされている場合を除いて、multicast-address
要素は必要です。その場合は、multicast-address
要素を省略でき、コンピュータのIPアドレスに基づいてOracle Event Processingによりマルチサーバー・ドメインにマルチキャスト・アドレスが自動的に割り当てられます。
ただし、サーバーが異なるコンピュータ上でホストされる場合、適切なドメイン・ローカル・アドレスを提供する必要があります。Oracleは、239.255.X.X
形式のアドレスを使用することをお薦めします。自動で割り当てられたマルチキャスト・アドレスは、このアドレスに基づきます。
このmulticast-address
を使用しているすべてのOracle Event Processingサーバーは、同一のサブネット上にある必要があります。
identity
: identity
要素は、サーバーのIDを識別します。そのIDは1とINT_MAX
間の整数である必要があります。Oracle Event Processingは、マルチサーバー操作中にサーバー・アイデンティティを数値的に比較し、最小のアイデンティティを持つサーバーがドメイン・コーディネータになります。マルチサーバー・ドメイン内の各サーバーは、必ず異なるアイデンティティを持つようにしてください。サーバーが同一のアイデンティティを持つ場合、マルチサーバー操作の結果は予測できなくなります。
enabled
: デフォルトでは、マルチサーバー・ドメインにあるサーバーのクラスタリングは、Oracle Coherenceに対して有効になっています。Oracle Event Processingネイティブ・クラスタリングを有効にするには、<enabled>evs4j</enabled>
を使用します。
例7-1 myServer1 config.xmlファイル
<config> <domain> <name>myDomain</name> </domain> <cluster> <server-name>myServer1</server-name> <multicast-address>239.255.0.1</multicast-address> <identity>1</identity> <enabled>evs4j</enabled> </cluster> ... </config>
例7-2では、サーバーはmyDomain
というドメインの一部です。
マルチサーバー・ドメインの各サーバーに対して、multicast-address
要素には同じ値が含まれている必要があります。ただし、identity
とserver-name
要素は、マルチサーバー・ドメインの各サーバーで異なる必要があります。
例7-2には、myDomain
マルチサーバー・ドメインのmyServer2
という2番目のサーバーのconfig.xml
ファイルを示します。このサーバーのIDは2である点に注意してください。
例7-2 myServer2 config.xmlファイル
<config> <domain> <name>myDomain</name> </domain> <cluster> <server-name>myServer2</server-name> <multicast-address>239.255.0.1</multicast-address> <identity>2</identity> <enabled>evs4j</enabled> </cluster> ... </config>
追加のマルチサーバーの関連する構成要素と子要素の必要な順序の説明は、6.5項「cluster要素の子要素の順序」を参照してください。
オプションで、暗号化とデジタル署名を構成して、ドメイン内のサーバー間で共有されるメッセージを保護します。
7.3.1項「Oracle Event Processingネイティブ・クラスタリングを使用したマルチサーバー・ドメインのサーバー間で送信されるメッセージの保護方法」を参照してください。
単一点障害を防ぐために、ドメインにあるn
マシンの小さいサブセットでOracle Event Processing Visualizerを有効にすることを考慮します。
『Oracle Fusion Middleware Oracle Event Processing Visualizerユーザーズ・ガイド』のマルチサーバー・ドメインでOracle Event Processing Visualizerを起動する方法に関する項を参照してください。
注意: 特定のOracle Event ProcessingサーバーでOracle Event Processing Visualizerを有効にすると、Oracle Event Processing Visualizerのワークロードによってサーバーのパフォーマンスが低下される可能性があります。 |
マルチサーバー・ドメインのすべてのサーバーを起動します。
7.5項「マルチサーバー・ドメインのOracle Event Processingサーバーの起動と停止」を参照してください。
この手順では、完全に同一ではないサーバーを格納するためにカスタム・グループを使用するマルチサーバー・ドメインの作成方法について説明します。
ドメインにあるすべてのサーバーが完全に同一である場合、カスタム・グループを作成する必要はありません。かわりに、事前定義済のシングルトン・グループとドメイン・グループを使用できます。7.1.1項「Oracle Event Processingネイティブ・クラスタリングを使用したデフォルト・グループによるOracle Event Processingマルチサーバー・ドメインの作成方法」を参照してください。
デフォルト・グループとカスタム・グループの詳細は、6.2項「グループ」を参照してください。
注意: この項では、1つのサーバーを含むドメインがすでに作成済であり、ドメインをマルチサーバー・ドメインにするには追加のサーバーをドメインに追加することを前提としています。ドメインの作成の詳細は、第3章「Oracle Event Processingスタンドアロンサーバー・ドメインの管理」を参照してください。 |
この手順では、myServer1
、myServer2
、およびmyServer3
と3つのサーバーを作成していることを想定します。myServer1
は、selector
グループのメンバーであり、myServer2
とmyServer3
は、strategy
グループのメンバーであるとしています。
Oracle Event Processingネイティブ・クラスタリングを使用してカスタム・グループによるOracle Event Processingマルチサーバー・ドメインを作成するには:
1つの初期サーバーを含むドメインを作成します。
構成ウィザードを使用して、ドメインに1つまたは複数のサーバーを追加します。
注意: 構成ウィザードではマルチサーバー・ドメインへの新規サーバーの追加はサポートされていませんが、構成ウィザードを使用して新しいスタンドアロンサーバーを生成し、生成したサーバーの構成を手動で更新することにより、サーバーをマルチサーバー・ドメインに追加できます。 |
7.2項「Oracle Event Processingネイティブ・クラスタリングを使用したOracle Event Processingマルチサーバー・ドメインの更新」を参照してください。
手動でconfig.xml
ファイルを編集し、特定の情報とともにcluster
要素を追加して、マルチサーバー・ドメイン内のすべてのサーバーを構成します。
カスタム・グループを使用してマルチサーバー・ドメイン内のサーバーを構成するには、ファイルがすでに存在していない場合はcluster
のgroups
子要素を追加して各メンバー・サーバーのconfig.xml
ファイルを更新し、groups
要素の値としてグループの名前を指定します。
サーバーが複数のグループのメンバーである場合、groups
要素には複数のグループ名が含まれます。カンマを使用して複数のグループ名を区切ります。
groups
要素はオプションです。サーバー構成にこの要素がない場合、サーバーはデフォルト・グループ(ドメインおよびシングルトン)のメンバーになります。ドメインとシングルトン・グループの詳細は、6.2項「グループ」を参照してください。
例7-3、例7-4および例7-5には、各サーバーのconfig.xml
ファイルの関連するスニペットを示します。
例7-3 myServer1のサーバー構成ファイルconfig.xml
<config> <domain> <name>myDomain</name> </domain> <cluster> <server-name>myServer1</server-name> <multicast-address>239.255.0.1</multicast-address> <identity>1</identity> <enabled>evs4j</enabled> <groups>selector</groups> </cluster> ... </config>
オプションで、暗号化とデジタル署名を構成して、ドメイン内のサーバー間で共有されるメッセージを保護します。
7.3.1項「Oracle Event Processingネイティブ・クラスタリングを使用したマルチサーバー・ドメインのサーバー間で送信されるメッセージの保護方法」を参照してください。
単一点障害を防ぐために、ドメインにあるn
マシンの小さいサブセットでOracle Event Processing Visualizerを有効にすることを考慮します。
『Oracle Fusion Middleware Oracle Event Processing Visualizerユーザーズ・ガイド』のマルチサーバー・ドメインでOracle Event Processing Visualizerを起動する方法に関する項を参照してください。
注意: 特定のOracle Event ProcessingサーバーでOracle Event Processing Visualizerを有効にすると、Oracle Event Processing Visualizerのワークロードによってサーバーのパフォーマンスが低下される可能性があります。 |
マルチサーバー・ドメインのすべてのサーバーを起動します。
7.5項「マルチサーバー・ドメインのOracle Event Processingサーバーの起動と停止」を参照してください。
ドメインを後でマルチサーバー・ドメインに変換できるように、構成ウィザードを使用して新しいサーバーを既存のスタンドアロン・サーバー・ドメインに追加します。手順は新しいドメインを作成する場合と同じです。この項を続行する前に3.1項「Oracle Event Processingスタンドアロン・サーバー・ドメインの作成」を必ず参照してください。
次の手順では、WindowsまたはUnixの両方の関連するコマンド・スクリプトを実行し、グラフィカル・モードで構成ウィザードの起動と使用方法について説明します。
注意: Windowsでは、「スタート」メニューを使用して構成ウィザードを起動できます。 Start > All Programs > Oracle Event Processing 10gR3 > Tools > Configuration Wizard |
わかりやすくするために、次を前提とします。
新しいドメインをすでに作成済であり、ドメイン・ディレクトリはC:\oracle_cep\user_projects\domains\mydomain
です。
ドメインには、myServer1
という単一のサーバーが含まれ、サーバー・ファイルはC:\oracle_cep\user_projects\domains\myDomain\myServer1
ディレクトリにあります。
既存のmydomain
ドメインにmyServer2
という新しいサーバーを作成します。
グラフィカル・モードで構成ウィザードを使用してOracle Event Processingマルチサーバー・ドメインを更新するには:
コマンド・ウィンドウを開き、環境を設定します。『Oracle Fusion Middleware Oracle Event Processing開発者ガイド for Eclipse』の開発環境の設定に関する項を参照してください。
ORACLE_CEP_HOME
/ocep_11.1/common/bin
ディレクトリに変更します。ここで、ORACLE_CEP_HOME
は、/oracle_cep
のようなメインOracle Event Processingインストール・ディレクトリを示します。
prompt> cd /oracle_cep/ocep_11.1/common/bin
ウィザードを起動するには、config.cmd
(Windows)またはconfig.sh
(UNIX)コマンドを起動します。
prompt> config.sh
構成ウィザードのロードが終了すると、標準のOracleへようこそウィンドウが表示されます。
注意: Oracle Event Processing構成ウィザードはわかりやすいプログラムですが、ツールの使用方法について詳細情報が必要な場合は、次の手順説明に従ってください。 |
「次へ」をクリックします。
「ドメインの作成または更新の選択」ウィンドウで、新規Oracle Event Processingドメインの作成を選択します。
「次へ」をクリックします。
ドメインに追加する新しいサーバーの管理者ユーザー名とパスワードを入力します。
「次へ」をクリックします。
ドメインの新しいサーバーに関する基本構成情報を入力します。
注意: 新しいサーバーがドメイン内の他のサーバーと同じコンピュータ上に配置される場合、すべてのサーバーを起動したときに競合が発生しないように、次の情報が他のサーバーと重複しないようにする必要があります。 |
具体的には:
新しいサーバー名を入力します。
この名前は、新しいサーバーのファイルを格納するディレクトリ名としても使用されます。次の例では、この値はmyServer2
です。
Oracle Event Processingサーバーのリスニング・ポート。
「次へ」をクリックします。
Oracle Event Processingアイデンティティ・キーストアのパスワードを入力し、確認します。
デフォルトでは、証明書のプライベート・キーのパスワードはアイデンティティ・キーストアと同じです。別のパスワードを使用する場合は、キーストア・パスワードを使用の選択を解除し、プライベート・キーのパスワードを入力します。
「次へ」をクリックします。
「構成オプション」ウィンドウで、次のように設定をします。
デフォルトのJDBCデータ・ソース構成を変更する場合は、「はい」を選択します。
デフォルトの構成を使用する場合は、「いいえ」を選択します。
注意: アプリケーションをドメイン内のグループにデプロイすると、Oracle Event Processingはグループのメンバーである各サーバーにアプリケーションをレプリケートします。つまり、アプリケーションでデータソースを使用し、ドメイン内のサーバーごとにデータソースの構成が異なる場合は、このデータ・ソースでのデータの格納および取得は、アプリケーションを実行しているサーバーによって異なります。 |
「次へ」をクリックします。
デフォルトのJDBCデータ・ソース構成を変更することを選択した場合は、「Configure Database Properties」ウィンドウに情報を入力します。
上のセクションで、データソース名を入力します。次に、データベース・タイプ(OracleまたはMicrosoft SQL Server)と該当のドライバを選択します。「Browse/Append」ボタンを使用して、新しいドライバを参照することもできます。
下のセクションで、データベース名、データベース・サーバーをホストするコンピュータ名、ポート、およびデータベースに接続するユーザーの名前とパスワードなど、このデータ・ソースから接続するデータベースの詳細を入力します。この情報に基づいて、使用するJDBC接続URLが自動的に生成されます。
「次へ」をクリックします。
「サーバーの構成」ウィンドウで、既存のドメイン名とドメインの場所のフル・パス名を入力します。
次の例では、ドメイン名にmyDomain
、ドメインの場所にC:\oracle_cep\user_projects\domains
を入力します。
「作成」をクリックします。
新しいサーバーが正常に作成されると、「Creating Domain」ウィンドウに次のようなメッセージが表示されます。
Domain created successfully! Domain location: C:\oracle_cep\user_projects\domains\myDomain
「完了」をクリックします。
マルチサーバーに関係するメッセージを変換することで、マルチサーバー・ドメインのサーバーはその状態を更新します。それらのメッセージは少なくとも整合性のチェックをすることが重要です。整合性を実現するために秘密鍵を使用できます。この鍵はドメインのすべてのサーバーで共有される必要があります。
この項では次の内容について説明します。
Oracle Event Processingネイティブ・クラスタリングを使用して、マルチサーバー・ドメインのサーバー間で送信されるメッセージを保護できます。
Oracle Event Processingネイティブ・クラスタリングを使用してOracle Event Processingマルチサーバー・ドメインのサーバー間で送信されるメッセージを保護するには:
サーバーが現在実行中の場合、マルチサーバー・ドメインのすべてのサーバーを停止します。
7.5項「マルチサーバー・ドメインのOracle Event Processingサーバーの起動と停止」を参照してください。
例7-6に示すようにsecurity
子要素をcluster
要素に追加し、マルチサーバー・ドメインの各サーバーのconfig.xml
ファイルを編集します。
例7-6 cluster要素のsecurity子要素
<config>
<domain>
<name>myDomain</name>
</domain>
<cluster>
<server-name>myServer1</server-name>
<multicast-address>239.255.0.1</multicast-address>
<identity>1</identity>
<enabled>coherence</enabled>
<security>encrypt</security>
</cluster>
...
</config>
config.xml
ファイルは、各サーバーのDOMAIN_DIR
/
servername
/config
ディレクトリにあります。ここで、DOMAIN_DIR
は、ドメイン・ディレクトリを参照し、servername
は、d:\oracle_cep_home\user_projects\domains\mydomain\myserver1\config
のようなサーバーの名前を参照します。
security
子要素に対して次のいずれかの値を指定する必要があります。
none
: デフォルト値。マルチサーバー・ドメインに対してセキュリティが構成されていないことを指定します。
encrypt
: マルチサーバー・メッセージを暗号化する必要があることを指定します。
cluster要素の子要素の正しい順序に従います。6.5項「cluster要素の子要素の順序」を参照してください。
例7-7に示すようにconfig
ルート要素のencryption-service
子要素を追加し、マルチサーバー・ドメインの各サーバーのDOMAIN_DIR
/servername/config/security-config.xml
ファイルを編集します。
マルチサーバー・ドメインの各サーバーのDOMAIN_DIR
/
servername
/.aesinternal.dat
ファイルは、1つのサーバーから他のサーバーにコピーすることによって、まったく同じであることを確認します。
このファイルは、サーバーの最初の作成時に、構成ウィザードにより自動的に作成されます。Oracle Event Processingはこのファイルを使用してメッセージを暗号化します。
たとえば、ドメインのすべてのサーバーがd:\oracle_cep\user_projects\domains\mydomain
ディレクトリにあり、そのドメインにserver1
、server2
、およびserver3
の3つのサーバーがあることを想定します。すべてのサーバーに同じ.aesinternal.dat
ファイルがあることを確認するには、1つのファイルをserver1
から他のサーバーにコピーします。
prompt> cd d:\oracle_cep\user_projects\domains\mydomain\server1 prompt> cp .aesinternal.dat ..\server2 prompt> cp .aesinternal.dat ..\server3
ドメイン内の1つのサーバーを起動します。
7.5項「マルチサーバー・ドメインのOracle Event Processingサーバーの起動と停止」を参照してください。
ステップ3でencryption-service
要素をsecurity-config.xml
ファイルに追加しているため、Oracle Event Processingでは自動的にメイン・サーバー・ディレクトリに.msasig.dat
ファイルが作成されます。Oracle Event Processingはメッセージのデジタル署名のためにこのファイルを使用します。
起動したサーバーを停止します。
7.5項「マルチサーバー・ドメインのOracle Event Processingサーバーの起動と停止」を参照してください。
ステップ5で作成した.msasig.dat
ファイルを他のサーバーにコピーします。
例:
prompt> cd d:\oracle_cep\user_projects\domains\mydomain\server1 prompt> cp .msasig.dat ..\server2 prompt> cp .msasig.dat ..\server3
このドメインのサーバーでOracle Event Processing Visualizerを使用する場合は、10.5.3項「Oracle Event Processing Visualizer用のマルチサーバー・ドメインでSSLを構成する方法」を参照してください。
マルチサーバー・ドメインのすべてのサーバーを起動します。
7.5項「マルチサーバー・ドメインのOracle Event Processingサーバーの起動と停止」を参照してください。
アクティブ/アクティブ・システムでは、アプリケーションは複数のサーバーに均一にデプロイされ、アクティブに実行されます。
しかし、均一にデプロイされたこれらのアプリケーションからコーディネータ(リーダー)となるプライマリ・アプリケーションを選択する必要が生じる場合があります。この場合、コーディネータ・アプリケーションから発生したイベントは保持され、EPNの次のコンポーネントに渡されます。セカンダリ・サーバーの結果は削除されます。ただし、コーディネータにエラーが発生した場合は、いずれかのセカンダリ・サーバーが新しいコーディネータとして選択される必要があります。
アプリケーションでこれを有効化するには、一般的にイベント・シンクのロールに属するアダプタまたはイベントBeanが、com.bea.wlevs.ede.api.cluster.GroupMembershipListener
インタフェースを実装する必要があります。それにより、マルチサーバー・ドメイン・グループのメンバーシップの変更をイベント・シンクがリスニングできるようになります。実行時には、メンバーシップに変更が発生するたびに、Oracle Event ProcessingがonMembershipChange
コールバック・メソッドを自動的に呼び出します。
コールバック・メソッドのシグネチャは次のとおりです。
onMembershipChange(Server localIdentity, Configuration groupConfiguration);
onMembershipChange
コールバック・メソッドの実装では、イベント・シンクがServer
オブジェクト(localIdentity
)を使用してリーダーかどうかを検証します。この検証は、localIdentity
と、第2パラメータgroupConfiguration
でのConfiguration.getCoordinator()
の実行結果を比較して行うことができます。また、このパラメータを使用すると、Configuration.getMembers()
を実行して、現在のグループのメンバーをサーバーに知らせることもできます。
メンバーがコーディネータである場合にのみイベントを保持するために、イベント・シンクはグループのメンバーシップに変更があるたびに新しいServer
IDを取得する必要があります。グループ・メンバーシップに変更が発生するのは、たとえば、グループ内の他のサーバーでエラーが発生し、そのサーバーがコーディネータではなくなった場合です。
グループに対する変更だけでなくドメイン全体に対するメンバーシップの変更をリスニングするための、同様のインタフェースcom.bea.wlevs.ede.api.cluster.DomainMembershipListener
があります。
ホット-ホット構成には、失敗の通知にゼロ以外の遅延がある点に注意してください。クラスタリングの実装に通知APIを使用する場合、サーバー障害とマスター・サーバーに配信される通知の間のウィンドウで発生するイベントを失って、処理できません。
詳細は、Oracle Fusion Middleware Oracle Event Processing Java APIリファレンスを参照してください。
マルチサーバー・ドメインのサーバーを起動するには、起動スクリプトを実行して各サーバーを個別に起動します。これは、スタンドアロン・サーバー・ドメインのサーバーを起動する方法と同じです。詳細は、3.3項「スタンドアロンサーバー・ドメインのOracle Event Processingサーバーの起動と停止」を参照してください。
マルチ・サーバー・ドメインのカスタム・グループを構成しなかった場合、単純にすべてのサーバーは事前定義されたドメイン・グループ(マルチ・サーバー・ドメイン内のすべてのサーバーが含まれる)とシングルトン・グループ(メンバーのサーバーごとに1つ)のメンバーになります。つまり、マルチ・サーバー・ドメインに3つのサーバーが存在する例では、シングルトン・グループも3つになります。
これに対し、マルチサーバー・ドメインにカスタム・グループを構成した場合、サーバーは事前定義されたグループのメンバーであると同時に、構成されたグループのメンバーにもなります。