NF1.0 Distributed Cache

From iDempiere en

Feature: Distributed Cache

Goal: Technical

Sponsor: Trek Global


iDempiere have build in support for distributed cache for a load balance environment. The distributed cache is implemented using the opensource Hazelcast library.

From functional perspective it means for example that changes made on server are seen automatically by swing clients (or other servers) and viceversa. No need to reset cache to refresh the changes done on other instances.


Download the default configuration from and copy it to your iDempiere home folder. The first changes you should make to the default configuration is to assigned it a unique group name ( see ). For other configuration options, please refer to the official Hazelcast documentation at

Since iDempiere 3.x (IDEMPIERE-2245) you don't have to set the hazelcast group anymore because there is a sufficient default value set by the installation process.

API Changes:

Three constructor have been added to CCache:
public CCache (String name, int initialCapacity, int expireMinutes, boolean distributed)
public CCache (String tableName, String name, int initialCapacity, boolean distributed)
public CCache (String tableName, String name, int initialCapacity, int expireMinutes, boolean distributed)

Pass true for the distributed parameter to allocate distributed cache instance.


org.idempiere.hazelcast.service is the bundle that implement the distributed cache service. If you disable or stop this bundle, the system will fallback to local, non-distributed cache.

Technical Info: IDEMPIERE-491

Using separate instances

If you have several server instances on one machine or in one lan they will distribute their caches through the hazelcast. If you do not want that behaviour, e.g. because you use different instances for production and testing you better use different hazelcast groups. To do that you have to create a hazelcast.xml file (you can use the link up on this page for an example) and set a name in the <group> element. (See meeting minutes from 2014-06-25)

Best Practices:

Norbert Bede experience - version 7.1 - hazelcast makes group by database username. This was a problem for me when i had application servers with multiple postgres users in same cluster. As CarlosRuiz suggested, this can be done by changing hazelcast-template.xml around line 35--> DEFAULT is: <name>@ADEMPIERE_DB_USER@.@ADEMPIERE_DB_NAME@/@ADEMPIERE_DB_SERVER@</name> Can be changed to <name>@ADEMPIERE_DB_NAME@/@ADEMPIERE_DB_SERVER@</name>

Cookies help us deliver our services. By using our services, you agree to our use of cookies.