Appendix B. Hotrod.Properties

B.1. Hotrod.Properties

The following is a list of parameters that may be used to configure the behavior of a RemoteCacheManager. These elements are placed into the hotrod-client.properties file which is read when starting the application.

Table B.1. Hotrod-Client Configuration Properties

NameDescription

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. Defaults to 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. Defaults to 127.0.0.1:11222.

infinispan.client.hotrod.force_return_values

Whether or not to implicitly force return values for all calls. Defaults to false.

infinispan.client.hotrod.tcp_no_delay

Affects TCP NODELAY on the TCP stack. Defaults to true.

infinispan.client.hotrod.tcp_keep_alive

Affects TCP KEEPALIVE on the TCP stack. Defaults to false.

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. Defaults to true.

infinispan.client.hotrod.transport_factory

Controls which tansport to use. Currently only the TcpTransport is supported. Defaults to org.infinispan.client.hotrod.impl.transport.tcp.TcpTransportFactory.

infinispan.client.hotrod.marshaller

Allows you to specify a custom org.infinispan.marshall.Marshaller implementation to serialize and deserialize user objects. For portable serialization payloads, you should configure the marshaller to be org.infinispan.client.hotrod.marshall.ProtoStreamMarshaller. Defaults to org.infinispan.marshall.jboss.GenericJBossMarshaller.

infinispan.client.hotrod.async_executor_factory

Allows you to specify a custom asynchronous executor for async calls. Defaults to 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. Defaults to 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. Defaults to 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 HotRod server version used. By default it uses the hash function specified by the server in the responses as indicated in org.infinispan.client.hotrod.impl.consistenthash.ConsistentHashFactory.

infinispan.client.hotrod.key_size_estimate

This hint allows sizing of byte buffers when serializing and deserializing keys, to minimize array resizing. Defaults to 64.

infinispan.client.hotrod.value_size_estimate

This hint allows sizing of byte buffers when serializing and deserializing values, to minimize array resizing. Defaults to 512.

infinispan.client.hotrod.socket_timeout

This property defines the maximum socket read timeout before giving up waiting for bytes from the server. Defaults to 60000 (60 seconds).

infinispan.client.hotrod.protocol_version

This property defines the protocol version that this client should use. Defaults to 2.0.

infinispan.client.hotrod.connect_timeout

This property defines the maximum socket connect timeout before giving up connecting to the server. Defaults to 60000 (60 seconds).

infinispan.client.hotrod.max_retries

This property defines the maximum number of retries in case of a recoverable error. A valid value should be greater or equals to 0 (zero). Zero mean no retry. Defaults to 10.

infinispan.client.hotrod.use_ssl

This property defines if SSL is enabled. Defaults to false.

infinispan.client.hotrod.key_store_file_name

Specifies the filename of a keystore to use to create the SSLContext. A key_store_password must also be defined.

infinispan.client.hotrod.key_store_password

Specifies the password needed to open the keystore. A key_store_file_name must also be defined.

infinispan.client.hotrod.trust_store_file_name

Specifies the filename of a truststore to use to create the SSLContext. A trust_store_password must also be defined.

infinispan.client.hotrod.trust_store_password

Specified the password needed to open the truststore. A trust_store_file_name must also be defined.