This section provides information you need to know before you begin to upgrade Pivotal
Note: Thoroughly test your systems with the new 1.3 version before moving into production.
Downgrading from 1.3 to a previous version of GemFire XD is not supported
- During the upgrade from SQLFire to GemFire XD 1.3, you must upgrade client
applications, stored procedures, and listener implementation to use the new package
names and libraries provided in GemFire XD. The upgrade documentation describes this
process and provides sample commands for upgrading a DBSynchronizer
- Read the GemFire XD Release
Notes to familiarize yourself with all feature changes and upgrade
- If your existing GemFire XD deployment uses DBSynchronizer, failover-related issues (such as
duplicate rows in the RDBMS) can occur during an upgrade if clients are actively
performing DML on synchronized tables. See How Failover and Upgrades Affect Synchronization in the DBSynchronizer documentation.
- Know how to configure
environment variables for your system.
- Confirm that your system meets the requirements to
run GemFire XD. See Pivotal HD 2.1 Required for HDFS Integration.
check your current Java version, type java -version at a
- GemFire XD is compatible with disk stores that were
created with SQLFire 1.1.1 or later. GemFire XD automatically loads and upgrades
these disk stores during the software upgrade procedure.
Note: Do not use the
upgrade-disk-store command with SQLFire disk stores, as it
is not supported and is not required for the upgrade process.
XD is not compatible with persistence files (disk stores) that were created in
versions of SQLFire earlier than version 1.1.1. You must upgrade these disk
store files to version 1.1.1 or 1.1.2 before you can upgrade them to GemFire XD.
See the Pivotal SQLFire documentation for upgrade
- GemFire XD does not support rolling upgrades from SQLFire 1.1.1 or 1.1.2. You must shut down
and upgrade all members of the SQLFire distributed system before restarting the
- Although GemFire XD introduces the gfxd utility to replace the
earlier sqlf utility, "sqlf" is still provided and supported as an
optional syntax in this release for convenience. Note, however, that the
-initial-heap and -max-heap options are no
longer supported. Use the single -heap-size option instead. See
gfxd Launcher Commands.