Volatile Storage

Overview

GridGain Volatile storage is designed to provide a quick and responsive storage without guarantees of data persistence.

When it is enabled for the data region, GridGain stores all data in the data region in RAM. Data will be lost on cluster shutdown, so make sure to have a separate data region for persistent storage.

Profile Configuration

Each GridGain storage engine can have several storage profiles. Each profile has the following properties:

Property	Default	Description
aimem.initSizeBytes	268435456	Initial memory region size in bytes, when the used memory size exceeds this value, new chunks of memory will be allocated.
Yes	Yes	Min 256Mb, max defined by the addressable memory limit of the OS
aimem.maxSizeBytes	268435456	Maximum memory region size in bytes.
Yes	Yes	Min 256Mb, max defined by the addressable memory limit of the OS
aimem.eviction.mode	DISABLED	Eviction mode.
Yes	No	DISABLED - Eviction is disabled. HISTORY_ONLY - Only historical versions of rows are evicted. RANDOM - Historical versions of rows are evicted first, followed by the eviction of the most recent row versions, which are chosen randomly.
aimem.eviction.threshold	90%	Threshold for eviction initiation. A number with a dimension identifier: % - percentage of aimem.maxSize k - Kb m - Mb g - Gb For instance, "90%" means that the page memory starts eviction only after 90% of the data region is occupied.
Yes	No	0-100% 0-9223372036854775807k/m/g
aimem.eviction.lwmUpdateInterval	60000	Frequency of the low watermark update in milliseconds.
Yes	No	1 - inf
aimem.eviction.interval	60000	Interval between the data eviction iterations.
Yes	No	1 - inf
aimem.eviction.lwmThreshold	1000	If the low watermark is less than evictionLwmThreshold from the current timestamp, the row eviction is triggered.
Yes	No	0 - inf
aimem.eviction.batchSize	60000	Eviction batch size in rows.
Yes	No	1 - inf

Property

Default

Description

aimem.initSizeBytes

268435456

Initial memory region size in bytes, when the used memory size exceeds this value, new chunks of memory will be allocated.

Yes

Min 256Mb, max defined by the addressable memory limit of the OS

aimem.maxSizeBytes

268435456

Maximum memory region size in bytes.

Yes

Min 256Mb, max defined by the addressable memory limit of the OS

aimem.eviction.mode

DISABLED

Eviction mode.

Yes

DISABLED - Eviction is disabled.
HISTORY_ONLY - Only historical versions of rows are evicted.
RANDOM - Historical versions of rows are evicted first, followed by the eviction of the most recent row versions, which are chosen randomly.

aimem.eviction.threshold

90%

Threshold for eviction initiation. A number with a dimension identifier:

% - percentage of aimem.maxSize
k - Kb
m - Mb
g - Gb

For instance, "90%" means that the page memory starts eviction only after 90% of the data region is occupied.

Yes

0-100%
0-9223372036854775807k/m/g

aimem.eviction.lwmUpdateInterval

60000

Frequency of the low watermark update in milliseconds.

Yes

1 - inf

aimem.eviction.interval

60000

Interval between the data eviction iterations.

Yes

1 - inf

aimem.eviction.lwmThreshold

1000

If the low watermark is less than evictionLwmThreshold from the current timestamp, the row eviction is triggered.

Yes

0 - inf

aimem.eviction.batchSize

60000

Eviction batch size in rows.

Yes

1 - inf

Configuration Example

In GridGain 9, you can create and maintain configuration in either HOCON or JSON. The configuration file has a single root "node," called ignite. All configuration sections are children, grandchildren, etc., of that node. The example below shows how to configure one data region that uses volatile storage.

{
  "ignite" : {
    "storage" : {
      "profiles" : [
        {
           "engine": "aimem",
           "name": "default_aimem",
           "emptyPagesPoolSize": 100,
           "eviction": {
             "batchSize": 200,
             "interval": 60000,
             "lwmThreshold": 1000,
             "lwmUpdateInterval": 60000,
             "mode": "DISABLED",
             "threshold": "90%"
           },
           "initSizeBytes": 268435456,
           "maxSizeBytes": 268435456
          }
      ]
    }
  }
}

You can then use the profile (in this case, aimemory) in your distribution zone configuration.

© 2025 GridGain Systems, Inc. All Rights Reserved. Privacy Policy | Legal Notices. GridGain® is a registered trademark of GridGain Systems, Inc.
Apache, Apache Ignite, the Apache feather and the Apache Ignite logo are either registered trademarks or trademarks of The Apache Software Foundation.

Last updated on May 12, 2025