Chapter 5. Stopping and Starting Data Grid Clusters

download PDF

Stop and start Data Grid clusters with Data Grid Operator.

Cache definitions

Both Cache service and Data Grid service store permanent cache definitions in persistent volumes so they are still available after cluster restarts.


Data Grid service nodes can write all cache entries to persistent storage during cluster shutdown if you add a file-based cache store.

5.1. Shutting Down Data Grid Clusters

Shutting down Cache service nodes removes all data in the cache. For Data Grid service nodes, you should configure the storage size for Data Grid service nodes to ensure that the persistent volume can hold all your data.

If the available container storage is less than the amount of memory available to Data Grid service nodes, Data Grid writes the following exception to logs and data loss occurs during shutdown:

WARNING: persistent volume size is less than memory size. Graceful shutdown may not work.


  • Set the value of replicas to 0 and apply the changes.
  replicas: 0

5.2. Restarting Data Grid Clusters

Complete the following procedure to restart Data Grid clusters after shutdown.


For Data Grid service nodes, you must restart clusters with the same number of nodes before shutdown. For example, you shut down a cluster of 6 nodes. When you restart that cluster, you must specify 6 as the value for spec.replicas.

This allows Data Grid to restore the distribution of data across the cluster. When all nodes in the cluster are running, you can then add or remove nodes.

You can find the correct number of nodes for Data Grid clusters as follows:

$ oc get infinispan example-infinispan -o=jsonpath='{.status.replicasWantedAtRestart}'


  • Set the value of spec.replicas to the appropriate number of nodes for your cluster, for example:

      replicas: 6
Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.