Skip to main content

Configuring a cluster without Redis (deprecated)

warning

This Hazelcast-based clustering method is deprecated as of July 2024. Convert to the Redis-based method — see Configuring a cluster.

Prerequisites​

  • A load balancer — the single entry point (URL) for users. Round-robin balancers work; advanced balancers route to the least-loaded node.

Steps​

1. Set up the initial node​

Install the first node per the installation guide in non-clustered mode. Once the node has a database, you can sign in, and you've added any users or an LDAP directory, shut it down. Then enable clustering for your installation type — and increase the instance's memory, since clustered nodes store overhead data from other nodes:

  • Pre-deployed Tomcat installed via install_service.bat (Windows) — run manage_service.bat (add your custom service name as a parameter if you use one, for example manage_service.bat myiceservice), go to the Java tab, add the JVM system variable -Digrafx.clustering.enabled=true, click OK, and restart the service.
  • Pre-deployed Tomcat run manually via startup.bat — edit setenv.bat and set CLUSTERING_ENABLED to true.
  • WAR file — add the system property -Digrafx.clustering.enabled=true to your application server.

Once set, start the node — it's now in cluster mode.

2. Add more nodes​

Set up each additional node like the first, but instead of a regular installation, copy the dbconfig.xml file from the initial node into the igrafxdata folder of each additional node.

3. Set up the load balancer​

The actual load-balancing or failover configuration depends on your goals and IT infrastructure and is outside iGrafx's scope. For a demonstration, see Configuring a local load balancer.

Advanced setup​

To override the default cluster settings (disable multicast, predefine node members, and so on), place a Hazelcast configuration file named clustercacheconfig.xml in the iGrafx base directory. See the Hazelcast network configuration documentation.