24.2. L1 Cache Configuration
24.2.1. L1 Cache Configuration (Library Mode)
The following sample configuration shows the L1 cache default values in Red Hat JBoss Data Grid's Library Mode.
Example 24.1. L1 Cache Configuration in Library Mode
<clustering mode="dist"> <sync/> <l1 enabled="true" lifespan="60000" /> </clustering>
The
l1
element configures the cache behavior in distributed cache instances. If used with non-distributed caches, this element is ignored.
- The
enabled
parameter enables the L1 cache. - The
lifespan
parameter sets the maximum life span of an entry when it is placed in the L1 cache.
24.2.2. L1 Cache Configuration (Remote Client-Server Mode)
The following sample configuration shows the L1 cache default values in Red Hat JBoss Data Grid's Remote Client-Server mode.
Example 24.2. L1 Cache Configuration for Remote Client-Server Mode
<distributed-cache l1-lifespan="${VALUE}"> <!-- Additional configuration information here --> </distributed-cache>
The
l1-lifespan
element is added to a distributed-cache
element to enable L1 caching and to set the life span of the L1 cache entries for the cache. This element is only valid for distributed caches.
If
l1-lifespan
is set to 0
or a negative number (-1
), L1 caching is disabled. L1 caching is enabled when the l1-lifespan
value is greater than 0
.
Note
When the cache is accessed remotely via the Hot Rod protocol, the client accesses the owner node directly. Therefore, using L1 Cache in this situation does not offer any performance improvement and is not recommended. Other remote clients (Memcached, REST) cannot target the owner, therefore, using L1 Cache may increase the performance (at the cost of higher memory consumption).
Note
In Remote Client-Server mode, the L1 cache was enabled by default when distributed cache was used, even if the
l1-lifespan
attribute is not set. The default lifespan value was 10 minutes. Since JBoss Data Grid 6.3, the default lifespan is 0 which disables the L1 cache. Set a non-zero value for the l1-lifespan
parameter to enable the L1 cache.