Data Grid のアップグレード

手順

1. ターゲットクラスターがソースクラスターに接続できるリモートキャッシュストア設定を JSON 形式で作成します。

   ターゲットクラスターのリモートキャッシュストアは、Hot Rod プロトコルを使用して、ソースクラスターからデータを取得します。

   {
     "remote-store": {
       "cache": "myCache",
       "shared": true,
       "raw-values": true,
       "security": {
         "authentication": {
           "digest": {
             "username": "username",
             "password": "changeme",
             "realm": "default"
           }
         }
       },
       "remote-server": [
         {
           "host": "127.0.0.1",
           "port": 12222
         }
       ]
     }
   }

   Copy to Clipboard Toggle word wrap

2. Data Grid コマンドラインインターフェイス (CLI) または REST API を使用して、リモートキャッシュストア設定をターゲットクラスターに追加し、ソースクラスターに接続できるようにします。

   • CLI: ターゲットクラスターで migrate cluster connect コマンドを使用します。

     [//containers/default]> migrate cluster connect -c myCache --file=remote-store.json

     Copy to Clipboard Toggle word wrap

   • REST API: rolling-upgrade/source-connection メソッドを使用して、ペイロードにリモートストア設定が含まれる POST リクエストを呼び出します。

     POST /rest/v2/caches/myCache/rolling-upgrade/source-connection

     Copy to Clipboard Toggle word wrap
3. 移行するキャッシュごとに直前の手順を繰り返します。

4. すべての要求の処理を開始するために、クライアントをターゲットクラスターに切り替えます。

   1. クライアント設定をターゲットクラスターの場所で更新します。
   2. クライアントを再起動します。

手順

1. ターゲットクラスターに移行する各キャッシュと Data Grid コマンドラインインターフェイス (CLI) または REST API との同期を開始します。

   • CLI: migrate cluster synchronize コマンドを使用します。

     migrate cluster synchronize -c myCache

     Copy to Clipboard Toggle word wrap

   • REST API: POST リクエストと共に ?action=sync-data パラメーターを使用します。

     POST /rest/v2/caches/myCache?action=sync-data

     Copy to Clipboard Toggle word wrap

     操作が完了すると、Data Grid はターゲットクラスターにコピーされたエントリーの合計数で応答します。

2. ターゲットクラスター内の各ノードをソースクラスターから切断します。

   • CLI: migrate cluster disconnect コマンドを使用します。

     migrate cluster disconnect -c myCache

     Copy to Clipboard Toggle word wrap

   • REST API: DELETE リクエストを呼び出します。

     DELETE /rest/v2/caches/myCache/rolling-upgrade/source-connection

     Copy to Clipboard Toggle word wrap

手順

1. migrator.properties ファイルを作成します。

2. migrator.properties ファイルを使用して、ソースおよびターゲットのキャッシュストアのプロパティーを設定します。

   1. source. 接頭辞をソースキャッシュストアの全設定プロパティーに追加します。

      ソースキャッシュストアの例

      source.type=SOFT_INDEX_FILE_STORE
      source.cache_name=myCache
      source.location=/path/to/source/sifs
      source.version=<version>

      Copy to Clipboard Toggle word wrap

      重要

      セグメント化されたキャッシュストアからデータを移行するには、source.segment_count プロパティーを使用してセグメント数も設定する必要があります。セグメント数は、Data Grid 設定の clustering.hash.numSegments と一致させる必要があります。キャッシュストアのセグメント数が対応するキャッシュのセグメント数と一致しないと、Data Grid がキャッシュストアからデータを読み取ることができません。

   2. target. 接頭辞をターゲットキャッシュストアの全設定プロパティーに追加します。

      ターゲットキャッシュストアの例

      target.type=SINGLE_FILE_STORE
      target.cache_name=myCache
      target.location=/path/to/target/sfs.dat

      Copy to Clipboard Toggle word wrap