Chapter 1. Data Grid 8 upgrade notes

Read the following information to ensure a successful upgrade from previous versions of Data Grid 8 to 8.2:

Upgrading deployments with Single File cache stores

When upgrading Data Grid to 8.2.0, caches that include a SingleFileStore persistence configuration can encounter an issue that leads to data corruption.

This issue affects upgrades to Data Grid 8.2.0 only. As of Data Grid 8.2.1 this issue no longer occurs during upgrade.

If you have already upgraded from an earlier version to 8.2.0, you should do the following as soon as possible:

After successful upgrade, Data Grid recovers any corrupted data and restores the Single File Store on first start.

From the Infinispan CLI use the site push-site-state command as follows:

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

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

Upgrade from 8.1 at a minimum

If you are upgrading from 8.0, you must first upgrade to 8.1. Persistent data in Data Grid 8.0 is not binary compatible with Data Grid 8.2 because user serialization contexts are separated from Data Grid serialization contexts in 8.2. To overcome this incompatibility issue, Data Grid 8.2 automatically converts existing persistent cache stores from Data Grid 8.1 at cluster startup. However, Data Grid does not convert cache stores from Data Grid 8.0.

Migrating ProtoStream marshaller configuration

Data Grid 8.2 upgrades the ProtoStream library that provides marshalling capabilities. As part of the upgrade process from Data Grid 8.1 you should also review ProtoStream migration details to avoid any data compatibility issues that might arise from differences in how ProtoStream encodes entries as Protobuf.

In addition the MessageMarshaller API and the ProtoSchemaBuilder annotation are deprecated in the ProtoStream API. You should migrate any serialization context initializers in Data Grid 8.1 to the AutoProtoSchemaBuilder annotation as part of the upgrade to Data Grid 8.2.