org.reveno.atp.clustering.api

Interface ClusterConfiguration.MulticastConfiguration

All Known Implementing Classes:

RevenoClusterConfiguration.RevenoMulticastConfiguration

Enclosing interface:

ClusterConfiguration

public static interface ClusterConfiguration.MulticastConfiguration

Method Summary

Modifier and Type	Method and Description
void	host(java.lang.String host) Multicast host.
void	netInterface(java.lang.String netInterface) Network interface to be used by Multicast socket.
void	packetSize(int size) For lowest latency choose a packet size slightly lower than netork MTU.
void	packetsPerSecond(int pps) Limits the amount of packets per seconds that might be sent to multicast socket directly.
void	port(int port) Multicast port.
void	preferBatchingToLatency(boolean batching) Setting that denotes whether to flush every on every Command processed or to buffer it until max packet size is reached.
void	receiveBufferSize(int size) Socket receive buffer size.
void	retransmitPacketsHistory(int packets) The number of packets which will be persistently stored in offheap memory for NAK retransmition purpose.
void	sendBufferSize(int size) Socket send buffer size.
void	sendRetries(int retries) An amount of retries to send in case of PPS limit reached, send buffers full, or initialization is not yet fully happend.
void	spinLoopMicros(int micros) Microseconds during which busy spin loop awaiting new packets will be performed.
void	threadParkMicros(int micros) Microseconds during which LockSupport.parkNanos() will be called in busy spin loop.
void	ttl(int ttl) Milticast transport TTL (Time to live).

Method Detail

host

void host(java.lang.String host)

Multicast host.

Parameters:

host -

port

void port(int port)

Multicast port.

Parameters:

port -

netInterface

void netInterface(java.lang.String netInterface)

Network interface to be used by Multicast socket. Default is lo.

Parameters:

netInterface -

receiveBufferSize

void receiveBufferSize(int size)

Socket receive buffer size. Default is 1MB.

Parameters:

size -

sendBufferSize

void sendBufferSize(int size)

Socket send buffer size. Default is 1MB.

Parameters:

size -

packetsPerSecond

void packetsPerSecond(int pps)

Limits the amount of packets per seconds that might be sent to multicast socket directly. You should configure that according to your network capabilities. Please note, that it is the same as "Commands per second" in Reveno terms only if preferBatchingToLatency(boolean) is set to false. Default value is 3k.

Parameters:

pps -

spinLoopMicros

void spinLoopMicros(int micros)

Microseconds during which busy spin loop awaiting new packets will be performed. 0 - blocking mode. Default value is 0.

Parameters:

micros -

threadParkMicros

void threadParkMicros(int micros)

Microseconds during which LockSupport.parkNanos() will be called in busy spin loop. If spinLoopMicros(int) is set to 0, this setting makes no sense.

Parameters:

micros -

retransmitPacketsHistory

void retransmitPacketsHistory(int packets)

The number of packets which will be persistently stored in offheap memory for NAK retransmition purpose. For example, if pps is 3,000, and packet history is 9,000 then packets for the last 3 seconds might be retransmitted again on request.

Parameters:

packets -

packetSize

void packetSize(int size)

For lowest latency choose a packet size slightly lower than netork MTU. For high throughput choose larger packet sizes (up to 65k). Downside of large packet sizes is, that a packet gap has worse effects (because e.g. 64k need to be retransmitted instead of just 1k). As history and receive buffers reserve N*full packet size number of bytes, large packets also increase required memory to hold buffers. Its good practice to choose multiples of MTU for packet sizes, though its not that significant. Usual values are 1.5k, 3k, 8k, 16k . 64k are also a possible setting (but large buffers). Recommendation is 4k to 8k. For low latency requirements set small mtu sizes on your network adapter and a packet size fitting into a single mtu size. Default is 1k.

Parameters:

size -

preferBatchingToLatency

void preferBatchingToLatency(boolean batching)

Setting that denotes whether to flush every on every Command processed or to buffer it until max packet size is reached. Set false for real low latency and stronger failover guarantees. Default value is true.

Parameters:

batching -

ttl

void ttl(int ttl)

Milticast transport TTL (Time to live). Read more about it here: http://www.tldp.org/HOWTO/Multicast-HOWTO-2.html

Parameters:

ttl -

sendRetries

void sendRetries(int retries)

An amount of retries to send in case of PPS limit reached, send buffers full, or initialization is not yet fully happend. Default value is 15.

Parameters:

retries -