28.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 28.2. Configure Server Hinting for Library Mode

The following configuration attributes are used to configure Server Hinting in JBoss Data Grid.
  1. Set the clusterName Attribute

    The clusterName attribute specifies the name assigned to the cluster.
    <transport clusterName = "MyCluster" />
    Copy to Clipboard Toggle word wrap
  2. Add the machineId

    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.
    <transport clusterName = "MyCluster"
               machineId = "LinuxServer01" />
    Copy to Clipboard Toggle word wrap
  3. Add the rackId

    The rackId parameter specifies the rack that contains the original data, so that other racks are used for backups.
    <transport clusterName = "MyCluster"
               machineId = "LinuxServer01"
               rackId = "Rack01" />
    Copy to Clipboard Toggle word wrap
  4. Add the siteId

    The siteId parameter differentiates between nodes in different data centers replicating to each other.
    <transport clusterName = "MyCluster"
               machineId = "LinuxServer01"
               rackId = "Rack01"
               siteId = "US-WestCoast" />
    Copy to Clipboard Toggle word wrap
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.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat