第1章 Data Grid 8 のアップグレードに関する注意点

以下の情報を参照して、以前のバージョンの Data Grid 8 から 8.2 へのアップグレードが成功するようにします。

単一ファイルキャッシュストアを使用したデプロイメントのアップグレード

Data Grid を 8.2.0 にアップグレードすると、SingleFileStore 永続性設定を含むキャッシュで、データの破損につながる問題が発生する可能性があります。

この問題は、Data Grid 8.2.0 へのアップグレードのみに影響します。Data Grid 8.2.1 以降、この問題はアップグレード中に発生しなくなりました。

以前のバージョンから 8.2.0 にすでにアップグレードしている場合は、できるだけ早く次のことを行う必要があります。

アップグレードが正常に完了すると、Data Grid は破損したデータを回復し、最初の起動時に単一ファイルストアを復元します。

Infinispan CLI から、次のように site push-site-state コマンドを使用します。

[//containers/default]> site push-site-state --cache=cacheName --site=NYC

[//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 アノテーションに移行する必要があります。