37.2. フェイルオーバーモード

HornetQ クライアントは、ライブおよびバックアップサーバーの認識で設定できるため、クライアントで接続 (ライブサーバー接続) が失敗した場合に、クライアントがこれを検出し、バックアップサーバーに再接続します。次に、バックアップサーバーは、フェイルオーバーの実行前に各接続で存在したセッションとコンシューマーを自動的に再作成し、ユーザーは再接続ロジックを手動でコーディングする必要がなくなります。

項 15章使用済みの接続の検出 で説明されたように、HornetQ クライアントは、client-failure-check-period で指定された時間内にサーバーからパケットを受信しない場合に接続失敗を検出します。クライアントが適切な時間内にデータを受け取らない場合は、接続が失敗したと見なされ、フェイルオーバーが試行されます。

HornetQ クライアントは、ライブおよびバックアップサーバーのペアのリストを使用してさまざまな方法で設定できます。これらは、明示的に設定できます。これを行う最も一般的な方法は、クライアントがリストを自動的に検出するために server discovery を使用することです。サーバー検出の設定方法については、「サーバー検出」 を参照してください。また、「静的なクラスターサーバーリストの指定」 で説明されたように、クライアントはライブおよびバックアップサーバーのペアを明示的に指定できます。

自動クライアントフェイルオーバーを有効にするには、非ゼロ再接続試行を許可するようクライアントを設定する必要があります (32章クライアントの再接続とセッションの再割り当て を参照)。

場合によっては、ライブサーバーがクラッシュや接続の失敗ではなく正常にシャットダウンされた場合であっても、クライアントがバックアップサーバーにフェイルオーバーすることが適切であることがあります。これを設定するには、HornetQConnectionFactory (JMS を使用している場合)、 JBOSS_DIST/jboss-as/server/PROFILE/deploy/hornetq/hornetq-jms.xml ファイル (接続ファクトリーを定義する場合)、または ClientSessionFactoryImpl (プロパティーを直接設定してコアを使用する場合) でプロパティー FailoverOnServerShutdown を true に設定します。このプロパティーのデフォルト値は false です。つまり、デフォルトでは、ライブサーバーが正常にシャットダウンされた場合に、HornetQ クライアントはバックアップサーバーにフェイルオーバーされません。

デフォルトでは、フェイルオーバーは少なくとも 1 つの接続がライブサーバーに対して確立された後にのみ実行されます。このロジックを適用すると、クライアントがライブサーバーに対して最初の接続を確立するのに失敗した場合に、フェイルオーバーは実行されません。クライアントは、再接続試行プロパティーに基づいてライブサーバーへの接続を再試行し、この試行回数後に失敗します。

場合によっては、クライアントで、失敗したバックアップサーバーを自動的に試してライブサーバーに対する最初の接続を確立したいことがあります。この場合は、XML、ClientSessionFactoryImpl、または HornetQConnectionFactory でプロパティー FailoverOnInitialConnection、またはfailover-on-initial-connection を設定します。このパラメーターのデフォルト値は false です。