Upgrading VMware Tanzu GemFire

You can upgrade directly to VMware Tanzu GemFire for VMs version v1.14 from the latest patch release of versions Tanzu GemFire 1.10 or later. This “jump upgrade” is a two-step process:

  1. Verify that your current version of Tanzu GemFire is up-to-date.
  2. Follow the upgrade procedure described here.

Verify that Your Current Version is Up-to-date

Verify that your current version of Tanzu GemFire has been updated to its latest patch release. If you have not installed the latest patch, then do so. Eligible patch releases are:

Tanzu GemFire Version (Major.Minor) Latest Patch Release
1.13 1.13.3
1.12 1.12.3
1.11 1.11.3
1.10 1.10.7

Upgrading to Tanzu GemFire 1.14 from any version other than those shown requires multiple steps. For example, if your current version is v1.10.5, you must first upgrade to v1.10.7, from which you can then jump upgrade to 1.14.

In addition, be sure to check the following section for any version-specific upgrade considerations.

Version-specific Upgrade Notes

  • Each Tanzu GemFire release is compatible with two VMware Tanzu Application Service for VMs (TAS for VMs) and Ops Manager versions. Incorporate those upgrades to TAS for VMs and Ops Manager in your upgrade process as required to maintain compatibility, as described in Upgrading Ops Manager.

  • If your application connects via the Services Gateway feature, you must first upgrade to Tanzu GemFire v1.13.3 before upgrading further. Then upgrade to 1.14, unbind, rebind and restart your application.

  • To upgrade to v1.9 from earlier releases, you must upgrade minor releases sequential order. For example, VMware Tanzu GemFire for VMs v1.7 must be upgraded to Tanzu GemFire v1.8 prior to upgrading to Tanzu GemFire v1.9.

  • VMware Tanzu GemFire for VMs version 1.13.1, included an Apache Geode v1.13.2 performance improvement that increased the defaults for maximum number of pooled message processor threads and maximum partitioned region message processor threads.

    If you are upgrading from a version of VMware Tanzu GemFire for VMs earlier than version 1.13.1, and your system had been hitting the old, lower default maximums, then upgrading to v1.14 may cause increased use of system resources as the system is no longer constrained to the old values. If your system depends on constraining system resources to the old default values, you can set these properties explicitly using DistributionManager.MAX_THREADS and DistributionManager.MAX_PR_THREADS, respectively.

    The following table shows the old and new maximum values.

System Resource Old Default Value New Default Value
DistributionManager.MAX_THREADS 100 1000
DistributionManager.MAX_PR_THREADS The greater of (CPUs * 4) or 16 The greater of (CPUs * 32) or 200

Upgrade Procedure

Follow these steps to upgrade Tanzu GemFire:

  1. Download the new version of the tile from VMware Tanzu Network.
  2. Upload the product to Ops Manager.
  3. Click Add next to the uploaded product.
  4. Click on the Tanzu GemFire tile and configure the upgrade options.

    • To try the upgrade on a small number of service instances first, set the quantity of canary service instances as described in Service Instance Upgrades.
    • Set the number of instances that are to be upgraded in parallel as described in Service Instance Upgrades.
    • Under the Errands section, choose the Default (On) value for the Upgrade All Service Instances post-deploy errand. Save the change.
  5. Click Review Pending Changes (see Reviewing Pending Product Changes).

  6. Click Apply Changes.

Enable Individual Service Instance Upgrades

The default upgrade path upgrades all service instances as a result of a tile upgrade. This operation can take a lengthy amount of time. To expedite upgrades, an operator can permit developers to upgrade their own service instances once the tile has been upgraded.

An operator enables individual service instance upgrades during tile installation. This feature requires TAS for VMs/Ops Manager 2.7 or a higher version and works for upgrading from Tanzu GemFire 1.9.0 to a higher version.

Within the Tanzu GemFire tile, in the Errands section, the default for the Upgrade All Service Instances errand, which upgrades all service instances, appears as:

Individual Service Instance Upgrades Disabled

To change the state of this errand such that individual service instance upgrades are enabled, choose Off for this errand:

Individual Service Instance Upgrades Enabled

Click Save.

Once individual service instance upgrades are enabled, the developer upgrades an individual service instance following the instructions in Upgrade a Single Service Instance.