What is the purpose of the JDG Migration tool

Environment

• Red Hat JBoss Data Grid (JDG)
  • 6.x
  • 7.x

Issue

• For what type of migration the Migration Tool for JDBC cache store from JBoss Data Grid 6.1 and older versions which is available on the portal download page for JDG is needed?
• Is it possible to migrate the persistence with the tool without having a down time?

Resolution

The Tool can be used for a migration of the database tables used by a JDG-JDBCstore written with a JDG version 6.1.x or earlier. See this article for more information.

The persistence will migrate the store offline, it is not supported to migrate during JDG instances are still active working with this persistence.
A migration with active JDG instances might cause inconsistency!

It is possible to work with a copy of the table, but all updates during that period are lost and need to be handled manually!
Consider to have the same indexes applied to the copy, otherwise the migration performance might be worse.

The Latest versions for the This content is not included.migration tool from the download page does not provide all the fixes and performance improvements.
Please open a case if you need the enhanced version for the tool until it is public available for download.

Root Cause

The internal format for JDBC stores has changed from Infinispan 5 to infinispan 6.
Infinispan 5 was the implementation until JDG 6.1.
From JDG 6.2 onwards the implementation is based on Infinispan 6 or better.
So the Database must be migrated!

Related articles

Migration tool show "ISPN000242: Missing foreign externalizer with id=1100" if JDBC store should migrated
Which version does the JDG Migration Tool for JDBC Cache Stores work with?

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.