4.23.2 ロードバランス/フェイルオーバーアルゴリズム

条件	タイミング
Home/Remoteインタフェースを利用する場合	Enterprise JavaBeansをlookupした時
EJB3.0以降のリモートビジネスインタフェースを利用する場合	JNDIを利用する場合	Enterprise JavaBeansをlookupした時
アノテーションを利用する場合	@EJBアノテーションにEnterprise JavaBeansオブジェクトが注入された時

クライアントに指定するエンドポイント(ホスト名とポートの組み合わせ)には、EJBディスパッチャが運用されているサーバーインスタンスを指定します。JNDIサービスにアクセスしたタイミング（JNDIのAPIを実行したタイミング）でクライアントに指定したエンドポイントのリストから最初に指定したエンドポイントにアクセスします。
リストの最初のエンドポイントの要求が接続エラーとなった場合、リストの2番目のエンドポイントにアクセスし、同様にその他エンドポイントにフェイルオーバーされます。
接続先のサーバーが起動されていない場合、フェイルオーバーに時間がかかります。

EJBディスパッチャは以下の振り分けタイミングで振り分け対象に処理を振り分けます。Enterprise JavaBeans以外のサービス(JNDIサービスやGMS)に対するIIOP通信については振り分け対象となりません。

条件		振り分けタイミング
Home/Remoteインタフェースを利用する場合		Homeインタフェースの初回のcreateメソッドを実行した時。createメソッドの実行後は、lookupメソッドが再実行されるまで初回のcreateメソッドで振り分けられたサーバーインスタンスに振り分け続けます。
EJB3.0以降のリモートビジネスインタフェースを利用する場合	JNDIを利用する場合	Enterprise JavaBeansをlookupした時
EJB3.0以降のリモートビジネスインタフェースを利用する場合	アノテーションを利用する場合	－（アノテーションは利用しないでください。）

注意

ロードバランス機能利用時にアノテーションの利用を推奨しない理由

EJB3.0以降のリモートビジネスインタフェースでアノテーションを利用する場合、@EJBアノテーションにEnterprise JavaBeansオブジェクトが注入された時に振り分け先が決定します。しかし、@EJBアノテーションにEnterprise JavaBeansオブジェクトを再注入する方法がないため、一度オブジェクトが注入されたアプリケーションで振り分け先を変更する方法がありません。このため、ロードバランス機能を使用する場合にはアノテーションは利用しないでください。

上記の振り分けタイミングで取得したオブジェクトリファレンスに対して処理を要求すると、振り分けタイミングで呼び出されたサーバーインスタンスに対して処理が要求されます。
処理を要求するサーバーインスタンスを変更したい場合には、上記の振り分けタイミングの処理から再実行してください。

注意

EJB3.0以降のリモートビジネスインタフェースでアノテーションを利用する場合、@EJBアノテーションにEnterprise JavaBeansオブジェクトを再注入する方法がないため、ロードバランス機能を使用する場合にはアノテーションは利用しないでください。

以下にHome/Remoteインタフェースを利用した場合のEJB2.1規約での動作について説明します。なお、EJB3.0規約のビジネスインタフェースを利用した場合には、「(2)lookupの実行」で内部的に「(3)Homeインタフェースのcreateメソッドの実行」まで行われるため、そのように読み替えてください。
「EJB Home」はEJBアプリケーションのHomeインタフェースのオブジェクト、「EJB Remote」はEJBアプリケーションのRemoteインタフェースのオブジェクト、「Home OR」はEJBアプリケーションのHomeインタフェースのオブジェクトリファレンス、「Remote OR」はEJBアプリケーションのRemoteインタフェースのオブジェクトリファレンスを表しています。
オブジェクトはIIOP通信要求をサーバーで処理する実体であり、オブジェクトリファレンスは分散して配置されたオブジェクトを特定するための情報です。

JNDIのlookupメソッドやHomeインタフェースのcreateメソッドで返却されるオブジェクトリファレンスには、オブジェクトリファレンスを生成/返却したサーバーインスタンスのホスト名とIIOPリスナーポート番号の情報が設定されます。このオブジェクトリファレンスに対する要求は、設定されているホスト名とIIOPリスナーポート番号に対して送信されます。
上記の各種処理において、どのようにIIOP通信されるかを以下に説明します。

(1) InitialContextの生成: EJBディスパッチ機能を利用した場合にはサーバーへの要求は行われません。

(2)lookupメソッドの実行: lookupメソッド処理ではサーバー上のJNDIサービスにIIOP通信し、JNDIサービスからHomeインタフェースのオブジェクトリファレンスを取得します。このIIOP通信処理はクライアントに指定したエンドポイント(ホスト名とIIOPリスナーポート番号)に要求が送信されます。
要求を受けたEJBディスパッチャは要求がEnterprise JavaBeansに対する要求ではない(JNDIサービスに対する要求である)ためディスパッチ処理は行わず、EJBディスパッチャが動作するサーバーインスタンス上のJNDIサービスがHomeインタフェースのオブジェクトリファレンスを返却します。
注意
EJBディスパッチャを運用するサーバーインスタンスに、振り分け対象とするEnterprise JavaBeansを展開することでHomeインタフェースのオブジェクトリファレンスが登録されます。
Enterprise JavaBeans（アプリケーション）の展開方法については、「4.6.9 アプリケーションの展開」を参照してください。

(3)Homeインタフェースのcreateメソッドの実行: 上記の(2)で返却されたオブジェクトリファレンスには、EJBディスパッチャが動作するサーバーインスタンスの情報が設定されているため、Homeインタフェースのcreateメソッドの要求はEJBディスパッチャが動作するサーバーインスタンスに送信されます。要求を受けたEJBディスパッチャはEnterprise JavaBeansに対する要求であるため、振り分け対象のサーバーインスタンスのオブジェクトリファレンスに対して再送要求を返信します。再送要求を受け付けた呼び出し元は自動的に振り分け対象のサーバーインスタンスに要求が再送されて、振り分けられたサーバーインスタンス上でRemoteインタフェースのオブジェクトリファレンスを生成して返却します。このため、オブジェクトリファレンスには、振り分け先のサーバーインスタンスのホスト名とIIOPリスナーポート番号が設定されます。
注意
初回のcreateメソッドで返却された振り分け対象のオブジェクトリファレンスの情報は、lookupメソッドで取得したHomeインタフェースのオブジェクトリファレンスの情報に上書きします。初回のcreateメソッドの実行後は、同一のサーバーインスタンスに振り分けられます。振り分け先を変更する場合には、lookupメソッドから再実行する必要があります。

(4)ビジネスメソッドの実行: 上記の(3)で返却されたRemoteインタフェースのオブジェクトリファレンスには、振り分け先のサーバーインスタンスの情報が設定されているため、ビジネスメソッドの要求は直接Enterprise JavaBeansが動作するサーバーインスタンスに送信されます。

(5)Remoteインタフェースのremoveメソッドの実行: 上記と同様にRemoteインタフェースのremoveメソッドの要求は直接Enterprise JavaBeansが動作するサーバーインスタンスに送信されます。

上記の各処理では以下のロードバランスもしくはフェイルオーバーが動作します。

処理	ロードバランスもしくはフェイルオーバーの動作
Home/Remoteインタフェースを利用する場合	Homeインタフェースのcreateメソッドを実行した時
(1) InitialContextの生成	なし（サーバーへの要求は行われません）
(2)lookupメソッドの実行	・クライアントに指定したエンドポイントのリストにおいて最初に指定したエンドポイントから順番にアクセスするフェイルオーバー
(3)Homeインタフェースのcreateメソッドの実行	■ クライアントからEJBディスパッチャ間・Homeインタフェースに対するオブジェクトリファレンスのフェイルオーバー（※）（EJBディスパッチャを運用するサーバーインスタンスの"オブジェクトリファレンスのフェイルオーバー設定"で有効となります。） ■ クライアントから振り分け対象のサーバーインスタンス間・EJBディスパッチャによるロードバランス・Homeインタフェースに対するオブジェクトリファレンスのフェイルオーバー（※）（EJBディスパッチャのディスパッチ対象となるサーバーインスタンスの"オブジェクトリファレンスのフェイルオーバー設定"で有効となります。）
(4)ビジネスメソッドの実行	・Remoteインタフェースに対するオブジェクトリファレンスのフェイルオーバー（※）（EJBディスパッチャのディスパッチ対象となるサーバーインスタンスの"オブジェクトリファレンスのフェイルオーバー設定"で有効となります。）

※）オブジェクトリファレンスのフェイルオーバー設定については「オブジェクトリファレンスのフェイルオーバー設定」を参照してください。

ディスパッチするサーバーインスタンスの決定方法

EJBディスパッチャは振り分け対象とするサーバーインスタンスのリストを作成します。EJBアプリケーションに対する要求を受け付けると、このリストの先頭から順番にラウンドロビンで振り分けるサーバーインスタンスで決定します。

クライアントに指定するエンドポイント(ホスト名とポートの組み合わせ)には、Enterprise JavaBeansが運用されているサーバーインスタンスを指定します。RMI-IIOPクライアントがInitialContextオブジェクトを作成すると、そのクライアントで指定したエンドポイントのリストから最初に指定したエンドポイントのグループ管理サービス(GMS)にアクセスし、アクセスしたサーバーインスタンスのIJServerクラスタ内で有効なサーバーインスタンスのリストを取得します。この取得する情報には、IIOP通信するのに必要な以下の情報が含まれています。

取得情報	値
ホスト名	IIOPリスナーの定義項目「ネットワークアドレス」に設定された値が返却されます。ただし、ネットワークアドレスの設定が「0.0.0.0」(デフォルト)の場合、ノードエージェントのJMXコネクタに設定する「クライアントホスト名」に指定された値が返却されます。
ポート番号	IIOPリスナーの定義項目「リスナーポート」に設定された値が返却されます。

取得したサーバーインスタンスのリストからランダムなサーバーインスタンスのリストを作成します。サーバーインスタンスのリストの取得はプロセスで一度行われます。

作成したInitialContextオブジェクトに対して、API(lookupメソッドなど)を実行すると、ランダムなサーバーインスタンスのリストから、最初のサーバーインスタンスに処理を要求します。InitialContextオブジェクトを作成するたびにサーバーインスタンスのリストをローテーションしてランダムなサーバーインスタンスのリストが再作成されます。

lookupメソッドで取得したオブジェクトに対する処理は、lookupメソッドでアクセスしたサーバーインスタンスに対して要求します。ロードバランスしたい場合には、InitialContextの作成から再実行してください。

リストの最初の接続先(エンドポイントまたはサーバーインスタンス)の要求で通信エラーが発生して利用できない場合、リストの2番目の接続先が使用されて、同様にその他接続先にフェイルオーバーされます。接続先のホスト名(またはIPアドレス)のサーバが起動されていない場合、フェイルオーバーに時間がかかります。

ハートビートによる監視

GMSはハートビート信号により定期的にサーバーインスタンスが正常に稼動しているかを確認します。このため、GMSが返却するサーバーインスタンスの一覧情報は、ハートビートの設定により以下のように異なります。

ハートビート	サーバーインスタンスの一覧情報
無効	サーバーインスタンスの状態に関わらず、クラスタに属するサーバーインスタンスの一覧情報です。
有効	正常にハートビート信号が送信されており、正常に稼動しているとグループ管理サービスが認識しているサーバーインスタンスの一覧情報です。

ランダムなサーバーインスタンスのリスト作成方法

IJServerクラスタの各サーバーインスタンスはバランスするために重み付けされており、100に設定されます。各サーバーインスタンスの重み付けをすべて累積した値を算出します。サーバーインスタンス数が4の場合には400となります。

1～400の数字を以下のように各サーバーインスタンスに割り当て、その数字の中から乱数で値を選択してサーバーインスタンスを選択します。以下はサーバーインスタンスがMyInstance-1、MyInstance-2、MyInstance-3、MyInstance-4の場合の例です。乱数の選択についてはjava.util.RandomクラスのnextInt(int n)メソッドを使用します。詳細は、java.util.RandomクラスのJavadocを参照してください。

選択された値	サーバーインスタンス
1～100	MyInstance-1
101～200	MyInstance-2
201～300	MyInstance-3
301～400	MyInstance-4

選択されたサーバーインスタンス以降のリストを新しいリストの先頭に追加し、選択されたサーバーインスタンスまでのリストをその後に追加してランダムなリストを作成します。上記の例の場合、乱数で188が選択されると、188に対応するMyInstance-2以降が先頭に追加された以下のような新しいリストが作成されます。

新しいリスト
MyInstance-2
MyInstance-3
MyInstance-4
MyInstance-1

以下に概要図を記載します。
(1)でクライアントに指定されたエンドポイントにアクセスして、グループ管理サービスからサーバーインスタンスのリストを取得します。
エンドポイントを複数指定した場合、指定されたエンドポイントの先頭からアクセスし、アクセスに失敗した場合には(2)で次に指定されたエンドポイントにアクセスしてグループ管理サービスからサーバーインスタンスのリストを取得します。取得したサーバーインスタンスのリストから、クライアントでランダムなリストを生成します。
(3)で生成されたランダムなリストの先頭から実際の処理を要求します。
サーバーインスタンスが複数存在し、(3)のアクセスに失敗した場合には、(4)で次のサーバーインスタンスに処理を要求します。

4.23.2 ロードバランス/フェイルオーバーアルゴリズム

4.23.2.1 ロードバランス機能を使用しない場合

4.23.2.2 EJBディスパッチ機能によるロードバランス

4.23.2.3 グループ管理サービスによるロードバランス