26.3. Configure Server Hinting (Library Mode)
In Red Hat JBoss Data Grid's Library mode, Server Hinting is configured at the transport level. The following is a Server Hinting sample configuration:
Procedure 26.2. Configure Server Hinting for Library Mode
The following configuration attributes are used to configure Server Hinting in JBoss Data Grid.
Set the
clusterNameAttributeTheclusterNameattribute specifies the name assigned to the cluster.<transport clusterName = "MyCluster" />
Add the
machineIdThemachineIdattribute 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.<transport clusterName = "MyCluster" machineId = "LinuxServer01" />Add the
rackIdTherackIdparameter specifies the rack that contains the original data, so that other racks are used for backups.<transport clusterName = "MyCluster" machineId = "LinuxServer01" rackId = "Rack01" />Add the
siteIdThesiteIdparameter differentiates between nodes in different data centers replicating to each other.<transport clusterName = "MyCluster" machineId = "LinuxServer01" rackId = "Rack01" siteId = "US-WestCoast" />
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 center as the original data.
