3.2.4. Configure Server Hinting (Library Mode)

In JBoss Data Grid's Library mode, Server Hinting is configured at the transport level. The following is a Server Hinting sample configuration: 
<transport clusterName = "MyCluster"
           machineId = "LinuxServer01"
           rackId = "Rack01"
           siteId = "US-WestCoast" />
As illustrated in the sample configuration, the following configuration attributes are used to configure Server Hinting in JBoss Data Grid:
  • The clusterName attribute specifies the name assigned to the cluster.
  • The machineId attribute specifies the JVM instance that contains the original data. This is particularly useful for nodes with multiple JVMs and physical hosts with multiple virtual hosts.
  • The rackId parameter specifies the rack that contains the original data, so that other racks are used for backups.
  • The siteId parameter differentiates between nodes in different data centers replicating to each other.
The listed parameters are optional in a JBoss Data Grid configuration.
If machineId, rackId, or siteId are included in the configuration, TopologyAwareConsistentHashFactory is selected automatically, enabling Server Hinting. However, if Server Hinting is not configured, JBoss Data Grid's distribution algorithms are allowed to store replications in the same physical machine/rack/data centre as the original data.
Report a bug