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.3:

Upgrading deployments with file-based cache stores

As of Data Grid 8.3, file-based cache stores default to soft index, SoftIndexFileStore, instead of single-file, SingleFileStore. In Data Grid 8.2 and earlier, SingleFileStore was the default for file-based cache stores.

Any file-store configuration that has a schema version of 13.0 or later is automatically migrated to a SoftIndexFileStore after upgrading.

If you are upgrading to Data Grid 8.3 from a previous version, and your caches include any configuration with the soft-index-file-store element, you should convert that configuration to use the file-store element instead. See the migration documentation for details about schema changes and modifying your Data Grid cache configuration.

Upgrading Data Grid Server deployments with multiple endpoint configuration

As of Data Grid Server 8.3 you configure endpoints with security realms and Hot Rod or REST connectors with endpoint elements. The endpoints element wraps multiple endpoint elements.

If you are upgrading Data Grid Server from 8.2 or earlier, and your configuration includes any child elements for the endpoints element, you must migrate your configuration to use the endpoint element.

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 later versions. To overcome this incompatibility issue, Data Grid 8.2 and later 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.