Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Rolling Upgrades

How to use GridGain Enterprise/Ultimate Rolling Upgrades to upgrade a cluster version without downtime, including the process, monitoring, guidelines, and the Java API.

Overview

Rolling Upgrades is a feature of GridGain Enterprise and Ultimate Edition that allows nodes with different GridGain versions to coexist in a cluster while you roll out a new version. This prevents downtime when performing software upgrades.

With Rolling Upgrades enabled, you can have a new node with a newer version of GridGain join the cluster. For example, if you have ten nodes running on ten physical servers, you can start a new node with a new version of GridGain on any of the servers. The data is rebalanced to accommodate this new member of the cluster. Once the data rebalancing is complete, you can shut down the old node. Then repeat the above process for all server nodes.

Enable Rolling Upgrades

The Rolling Upgrades feature is disabled by default. To upgrade GridGain without stopping the entire cluster, you need to enable this feature.

Enabling rolling upgrades may have a performance impact on your environment.

To enable Rolling Upgrades:

<bean class="org.apache.ignite.configuration.IgniteConfiguration">

    <property name="pluginConfigurations">
        <list>
            <bean class="org.gridgain.grid.configuration.GridGainConfiguration">
                <property name="rollingUpdatesEnabled" value="true"/> 
            </bean>
        </list>
    </property>

</bean>
GridGainConfiguration pluginCfg = new GridGainConfiguration();
pluginCfg.setRollingUpdatesEnabled(true);

IgniteConfiguration cfg = new IgniteConfiguration();
cfg.setPluginConfigurations(pluginCfg);

Ignite ignite = Ignition.start(cfg);
var cfg = new GridGainPluginConfiguration()
{
    RollingUpdatesEnabled = true
};

unsupported

This page contains:

The Rolling Upgrade Process

The functionality described below is available in GridGain starting from version 8.8.1.

Start a Rolling Upgrade

To start a Rolling Upgrade:

The Rolling Upgrades feature enable you to connect nodes with only one GridGain version different from (more recent than) the current one.

To suppress this constraint, you can activate the Rolling Updates using the "force" option:

Perform the Rolling Upgrade

Once you have activated a rolling upgrade, you can upgrade a multi-node cluster to a new GridGain version without stopping the whole cluster:

  1. Download the new GridGain version.

  2. If you are using persistence: Configure storagePath, walPath and walArchivePath properties. If these properties are explicitly configured in the current version of GridGain you are using, then provide the same value of these properties to the new GridGain version's configuration. If these properties are not set, provide the default location used by these properties.

  3. Stop one running node.

  4. Restart the node with the new version. At this point, the cluster will start to rebalance.

  5. Wait while the rebalancing is going on. You can monitor the logs for something like this:

Rebalancing scheduled [order=[Cache1, Cache2, Cache3], top=AffinityTopologyVersion [topVer=59, minorTopVer=1], force=false, evt=DISCOVERY_CUSTOM_EVT, node=79794392-5518-4609-ac13] ... ... ... Completed (final) rebalancing [fromNode=node=79794392-5518-4609-ac13, cacheOrGroup=Cache2, topology=AffinityTopologyVersion [topVer=59, minorTopVer=1], time=370550 ms]

Alternatively, if rebalancing is not needed, it is skipped:

  1. After rebalancing is complete, repeat steps 1-6 for all nodes.

Due to performance reasons, it is not advisable to run multiple versions of GridGain in the cluster for a long period of time.

Check the Rolling Upgrade Status

To check the Rolling Upgrade status:

Stop the Rolling Upgrade

The features available from a newer GridGain version are not activated until you manually stop the Rolling Upgrades process. To stop the Rolling Upgrade:

Performance Considerations

When Rolling Upgrades are enabled, every network message is appended with rolling upgrade data. In most situations, the overhead is small compared to the overall throughput and has almost no performance impact. This includes workloads dealing with medium- or large-sized entries (1 KB and larger), as well as compute-intensive applications.

The impact can get more noticeable if the system handles a comparatively larger number of smaller entries and messages. Using batching techniques (for example, data streamer or putAll method) allows you to combine entries in larger requests and reduce the overhead ratio.

Rolling Upgrade Monitoring in Control Center

GridGain Control Center allows you to monitor the process of Rolling Upgrades as you move to a newer version of GridGain.

The Rebalance widget in Control Center displays the cluster nodes and their versions. As you perform node-by-node migration to a newer version, watch the status of the rebalancing progress and proceed to the next node when it is finished.

Guidelines and Incompatible Versions

Before you start to upgrade to a newer version of GridGain, please note the following:

  • Upgrades are supported for minor and maintenance versions of the same major series only. The feature is not supported for upgrades between major versions due to the changes that might not be backward-compatible. For instance, it is possible to upgrade from 8.5.6 to 8.7.5 without downtime, but rolling upgrades will not work from version 7.9.1 to 8.7.5. For major version upgrades, contact GridGain for a possible zero-downtime solution.

  • There is always a way to upgrade to the latest GridGain version from any version of the same major series without downtime. In most cases, it is a direct one-step upgrade. For instance, you can upgrade from 8.5.6 to 8.7.5 with rolling upgrades, avoiding production outages.

  • Suppose there are any breaking changes between minor or maintenance versions of the same series. In that case, the upgrade involves a transitioning version: moving from version "A" to version "B" via "C" without production outages. For instance, if you need to upgrade from 8.1.3 to 8.8.1, then 8.5.3 has to be used as a transitioning version: 8.1.3 -> 8.5.3 -> 8.8.1.

Rolling Upgrade Example

This example demonstrates how to use the Rolling Upgrade functionality to upgrade a cluster from GridGain version 8.8.0 to 8.8.1:

  1. Check the current status of the Rolling Upgrade:

control.sh --rolling-upgrade status

Currently, the initial version corresponds to the current version of the cluster, and the Rolling Upgrades are disabled. If you run a new version, the joining node throws an exception, as shown below:

  1. Start a Rolling Upgrade:

control.sh --rolling-upgrade start --yes

  1. Check the Rolling Upgrade status:

control.sh --rolling-upgrade status

  1. When a new node connects to a new cluster, its version is saved in the target version, which you can verify by checking the status again:

Rolling upgrade is enabled Initial version: 8.8.0#20200714-sha1:35c405b6 Target version: 8.8.1#20200728-sha1:4e015639 List of alive nodes in the cluster that are not updated yet: 54a088fb List of alive nodes in the cluster that are updated: 01110503

  1. Once the last old node is released, you can stop the upgrade process:

control.sh --rolling-upgrade finish

Reverting Rolling Upgrades

You can revert a Rolling Upgrade while its process is still in progress. Even if the target version is identified, it is yet possible to shut down all nodes with the target version (8.8.1) and disable Rolling Upgrade. In this case, the initial version remains unchanged (8.8.0).

If you use the persistence functionality, the rolling upgrade status is persisted as well. You may shut down the whole cluster during the rolling upgrade and resume the process after the restart. After the upgrade is finished, the initial version is changed to the upgrade target version, as illustrated in the example below:

Using Java API to Manage a Rolling Upgrade

Since control.sh is based on the Java API, you can use Java to manage rolling upgrades programmatically. For that purpose, use the following methods:

Method Name
Description

start

Activates rolling upgrade mode or throws an exception if it is not possible.

finish

Disables rolling upgrade mode or throws an exception if it is not possible.

force

Switches rolling upgrade to the "force" mode.

getStatus

Returns the state of the rolling upgrade process.

A full description is provided in the GridGainRollingUpgrade class.

The following examples illustrate how to use the Java API to manage rolling upgrades:

The following example illustrates how to use this function in java code:

This page is: Copyright © 2026 MariaDB. All rights reserved.

Last updated

Was this helpful?