第1章 Data Grid 8 のアップグレードに関する注意点
本セクションの詳細を確認してから 1 つの Data Grid 8 バージョンから別のバージョンにアップグレードしてください。
1.1. Data Grid 8.2 へのアップグレード
以下の情報を参照して、以前のバージョンの Data Grid 8 から 8.2 へのアップグレードが成功するようにします。
単一ファイルキャッシュストアを使用したデプロイメントのアップグレード
Data Grid を 8.2.0 にアップグレードすると、SingleFileStore
永続性設定を含むキャッシュで、データの破損につながる問題が発生する可能性があります。
この問題は、Data Grid 8.2.0 へのアップグレードのみに影響します。Data Grid 8.2.1 以降、この問題はアップグレード中に発生しなくなりました。
以前のバージョンから 8.2.0 にすでにアップグレードしている場合は、できるだけ早く次のことを行う必要があります。
-
$RHDG_HOME/server/data/*.dat
ファイルをバックアップします。 - Data Grid 8.2.1 以降にアップグレードします。
アップグレードが正常に完了すると、Data Grid は破損したデータを回復し、最初の起動時に単一ファイルストアを復元します。
クロスサイトレプリケーションの状態転送
クロスサイトレプリケーションを介して他のクラスターにバックアップするキャッシュの場合は、8.2 にアップグレードした後に状態転送を実行する必要があります。
Infinispan CLI から、次のように site push-site-state
コマンドを使用します。
[//containers/default]> site push-site-state --cache=cacheName --site=NYC
最低でも 8.1 からのアップグレード
8.0 からアップグレードする場合は、最初に 8.1 にアップグレードする必要があります。Data Grid 8.0 の永続データは、Data Grid 8.2 とのバイナリー互換性がありません。これは、8.2 ではユーザーのシリアライゼーションコンテキストが Data Grid のシリアライゼーションコンテキストから分離されているためです。この非互換性の問題に対処するために、Data Grid 8.2 では、クラスター起動時に Data Grid 8.1 から既存の永続キャッシュストアを自動的に変換します。ただし、Data Grid は、Data Grid 8.0 からキャッシュストアを変換しません。
ProtoStream マーシャラー設定の移行
Data Grid 8.2 は、マーシャリング機能を提供する ProtoStream ライブラリーをアップグレードします。Data Grid 8.1 からのアップグレードプロセスの一部として、ProtoStreams エントリーを Protobuf としてエンコードする方法の違いにより、データ互換性の問題が発生するのを防ぐために、ProtoStream 移行の詳細も確認する必要があります。
さらに、MessageMarshaller
API および ProtoSchemaBuilder
アノテーションは ProtoStream API で非推奨になりました。Data Grid 8.1 のシリアライズコンテキストイニシャライザーを、Data Grid 8.2 へのアップグレードの一環として AutoProtoSchemaBuilder
アノテーションに移行する必要があります。