12.3.4. The hotrod.properties File

To use a Remote Cache Store configuration, the hotrod.properties file must be created and included in the relevant classpath for a Remote Cache Store configuration.
The hotrod.properties file contains one or more properties. The most simple version of a working hotrod.properties file can contain the following:
infinispan.client.hotrod.server_list=remote-server:11222
Properties that can be included in hotrod.properties are:
infinispan.client.hotrod.request_balancing_strategy
For replicated (vs distributed) Hot Rod server clusters, the client balances requests to the servers according to this strategy.
The default value for this property is org.infinispan.client.hotrod.impl.transport.tcp.RoundRobinBalancingStrategy.
infinispan.client.hotrod.server_list
This is the initial list of Hot Rod servers to connect to, specified in the following format: host1:port1;host2:port2... At least one host:port must be specified.
The default value for this property is 127.0.0.1:11222.
infinispan.client.hotrod.force_return_values
Whether or not to enable Flag.FORCE_RETURN_VALUE for all calls.
The default value for this property is false.
infinispan.client.hotrod.tcp_no_delay
Affects TCP NODELAY on the TCP stack.
The default value for this property is true.
infinispan.client.hotrod.ping_on_startup
If true, a ping request is sent to a back end server in order to fetch cluster's topology.
The default value for this property is true.
infinispan.client.hotrod.transport_factory
Controls which transport will be used. Currently only the TcpTransport is supported.
The default value for this property is org.infinispan.client.hotrod.impl.transport.tcp.TcpTransportFactory.
infinispan.client.hotrod.marshaller
Allows you to specify a custom Marshaller implementation to serialize and deserialize user objects.
The default value for this property is org.infinispan.marshall.jboss.GenericJBossMarshaller.
infinispan.client.hotrod.async_executor_factory
Allows you to specify a custom asynchronous executor for async calls.
The default value for this property is org.infinispan.client.hotrod.impl.async.DefaultAsyncExecutorFactory.
infinispan.client.hotrod.default_executor_factory.pool_size
If the default executor is used, this configures the number of threads to initialize the executor with.
The default value for this property is 10.
infinispan.client.hotrod.default_executor_factory.queue_size
If the default executor is used, this configures the queue size to initialize the executor with.
The default value for this property is 100000.
infinispan.client.hotrod.hash_function_impl.1
This specifies the version of the hash function and consistent hash algorithm in use, and is closely tied with the Hot Rod server version used.
The default value for this property is the Hash function specified by the server in the responses as indicated in ConsistentHashFactory.
infinispan.client.hotrod.key_size_estimate
This hint allows sizing of byte buffers when serializing and deserializing keys, to minimize array resizing.
The default value for this property is 64.
infinispan.client.hotrod.value_size_estimate
This hint allows sizing of byte buffers when serializing and deserializing values, to minimize array resizing.
The default value for this property is 512.
infinispan.client.hotrod.socket_timeout
This property defines the maximum socket read timeout before giving up waiting for bytes from the server.
The default value for this property is 60000 (equals 60 seconds).
infinispan.client.hotrod.protocol_version
This property defines the protocol version that this client should use. Other valid values include 1.0.
The default value for this property is 1.1.
infinispan.client.hotrod.connect_timeout
This property defines the maximum socket connect timeout before giving up connecting to the server.
The default value for this property is 60000 (equals 60 seconds).