36.2. REST を使用したローリングアップグレード

手順36.1 REST を使用したローリングアップグレードの実施

1. ターゲットクラスターの設定

   ソースクラスターとは別にターゲットクラスター (新規 JBoss Data Grid のノードで構成) を設定するには、別のネットワーク設定または別の JGroups クラスター名のいずれかを使用します。それぞれのキャッシュについては、以下の設定を考慮に入れて RestCacheStore を設定します。
   1. ホストおよびポートの値がソースクラスターを参照するようにする。
   2. パスの値がソースクラスターの REST エンドポイントを参照するようにする。

2. ターゲットクラスターの開始

   ターゲットクラスターのノードを起動します。ソースクラスターではなく、ターゲットクラスターを参照するように各クライアントを設定します。最終的に、ターゲットクラスターはソースクラスターの代わりにすべての要求を処理します。次にターゲットクラスターは RestCacheStore を使用してソースクラスターのデータをオンデマンドでレイジーにロードします。

3. REST ローリングアップグレード時にはキーセットをダンプしない

   REST ローリングアップグレードのユースケースは、recordKnownGlobalKeyset 操作を使用せずにすべてのデータをソースクラスターから取得することが意図されています。

   警告

   REST ローリングアップグレードの recordKnownGlobalKeyset 操作は起動しないでください。この操作を起動すると、データの破損が生じ、REST ローリングアップグレードは正常に完了しません。

4. 残りのデータの取得

   ターゲットクラスターはソースクラスターから残りのデータすべてを取得する必要があります。これは、以下のように JMX または CLI を使用して実行されます。

   1. JMX の使用

      すべてのキャッシュが移行されるように、rest パラメーターをターゲットクラスターの RollingUpgradeManager MBean に指定して synchronizeData 操作を起動します。

   2. CLI の使用

      すべてのキャッシュが移行されるように upgrade --synchronize=rest をターゲットクラスターで実行します。オプションで、--all スイッチを使用して、クラスター内のすべてのキャッシュを同期します。

5. RestCacheStore の無効化

   JMX または CLI のいずれかを使用して、以下のようにターゲットクラスターで RestCacheStore を無効にします。

   1. JMX の使用

      rest パラメーターをターゲットクラスターの RollingUpgradeManager MBean に指定して disconnectSource 操作を起動します。

   2. CLI の使用

      ターゲットクラスターで upgrade --disconnectsource=rest コマンドを実行します。オプションで、--all スイッチを使用して、クラスター内のすべてのキャッシュの接続を解除します。