Use the offline upgrade procedure when you cannot, or choose not to, perform a rolling upgrade. For example, a rolling upgrade is not possible for a cluster that has partitioned regions without redundancy. (Without the redundancy, region entries would be lost when individual servers were taken out of the cluster during a rolling upgrade.)
For best reliability and performance, all server components of a Tanzu GemFire system should run the same version of the software. See Version Compatibilities for more details on how different versions of Tanzu GemFire can interoperate.
Data member interdependencies
When you restart your upgraded servers, interdependent data members may hang on startup waiting for each other. In this case, start the servers in separate command shells so they can start simultaneously and communicate with one another to resolve dependencies.
Stop any connected clients.
On a machine hosting a locator, open a terminal console.
gfsh prompt, using the version from your current Tanzu GemFire installation, and connect to a currently running locator. For example:
gfsh commands to characterize your current installation so you can compare your post-upgrade system to the current one. For example, use the
list members command to view locators and data members:
Name | Id -------- | ------------------------------------------------ locator1 | 172.16.71.1(locator1:26510:locator)<ec><v0>:1024 locator2 | 172.16.71.1(locator2:26511:locator)<ec><v1>:1025 server1 | 172.16.71.1(server1:26514)<v2>:1026 server2 | 172.16.71.1(server2:26518)<v3>:1027
Save your cluster configuration.
export cluster-configurationcommand. You only need to do this once, as the newly-upgraded locator will propagate the configuration to newly-upgraded members as they come online.
gemfire.properties, and any other relevant configuration files to a well-known location. You must repeat this step for each member you upgrade.
Shut down the entire cluster (by pressing Y at the prompt, this will lose no persisted data):
gfsh>shutdown --include-locators=true As a lot of data in memory will be lost, including possibly events in queues, do you really want to shutdown the entire distributed system? (Y/n): y Shutdown is triggered gfsh> No longer connected to 172.16.71.1. gfsh>quit
Since Tanzu GemFire is a Java process, to check before continuing that all Tanzu GemFire members successfully stopped, it is useful to use the JDK-included
jps command to check running java processes:
% jps 29664 Jps
On each machine in the cluster, install the new version of the software (alongside the older version of the software). See Installing %=vars.product_name_long%>.
Redeploy your environment's configuration files to the new version installation. If you are using the cluster configuration service, one copy of the exported
.zip configuration file is sufficient, as the first upgraded locator will propagate it to the other members. For XML configurations, you should have a copy of the saved configuration files for each data member.
On each machine in the cluster, install any updated server code. Point all client applications to the new installation of Tanzu GemFire.
Run the new version of
Start a locator and import the saved configuration. If you are using the cluster configuration service, use the same name and directory as the older version you stopped, and the new locator will access the old locator's cluster configuration without having to import it in a separate step:
gfsh>start locator --name=locator1 --enable-cluster-configuration=true \ --dir=/data/locator1
Otherwise, use the gfsh
import cluster-configuration command or explicitly import
.properties files, as appropriate.
Restart all system data members using the new version of gfsh. Use the same names, directories, and other properties that were used when starting the system under the previous version of the software. (Here is where a system startup script comes in handy as a reference.) Interdependent data members may hang on startup waiting for each other. In this case, start servers in separate shells so they can communicate with one another to resolve dependencies.
Upgrade Tanzu GemFire clients, following the guidelines described in Upgrading Clients.