org.reveno.atp.clustering.core

Class RevenoClusterConfiguration.RevenoMulticastConfiguration

java.lang.Object

org.reveno.atp.clustering.core.RevenoClusterConfiguration.RevenoMulticastConfiguration

All Implemented Interfaces:

ClusterConfiguration.MulticastConfiguration

Enclosing class:

RevenoClusterConfiguration

public static class RevenoClusterConfiguration.RevenoMulticastConfiguration
extends java.lang.Object
implements ClusterConfiguration.MulticastConfiguration

Constructor Summary

Constructors

Constructor and Description
RevenoMulticastConfiguration()

Method Summary

Modifier and Type	Method and Description
int	datagramSize()
java.lang.String	host()
void	host(java.lang.String host) Multicast host.
java.lang.String	netInterface()
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.
int	packetsPerSecond()
void	packetsPerSecond(int pps) Limits the amount of packets per seconds that might be sent to multicast socket directly.
int	port()
void	port(int port) Multicast port.
boolean	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.
int	receiveBufferSize()
void	receiveBufferSize(int size) Socket receive buffer size.
int	retransmitPacketsHistory()
void	retransmitPacketsHistory(int packets) The number of packets which will be persistently stored in offheap memory for NAK retransmition purpose.
int	sendBufferSize()
void	sendBufferSize(int size) Socket send buffer size.
int	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.
int	spinLoopMicros()
void	spinLoopMicros(int micros) Microseconds during which busy spin loop awaiting new packets will be performed.
int	threadParkMicros()
void	threadParkMicros(int micros) Microseconds during which LockSupport.parkNanos() will be called in busy spin loop.
int	ttl()
void	ttl(int ttl) Milticast transport TTL (Time to live).

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RevenoMulticastConfiguration

public RevenoMulticastConfiguration()

Method Detail

host

public void host(java.lang.String host)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

Multicast host.

Specified by:

host in interface ClusterConfiguration.MulticastConfiguration

host

public java.lang.String host()

port

public void port(int port)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

Multicast port.

Specified by:

port in interface ClusterConfiguration.MulticastConfiguration

port

public int port()

netInterface

public void netInterface(java.lang.String netInterface)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

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

Specified by:

netInterface in interface ClusterConfiguration.MulticastConfiguration

netInterface

public java.lang.String netInterface()

receiveBufferSize

public void receiveBufferSize(int size)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

Socket receive buffer size. Default is 1MB.

Specified by:

receiveBufferSize in interface ClusterConfiguration.MulticastConfiguration

receiveBufferSize

public int receiveBufferSize()

sendBufferSize

public void sendBufferSize(int size)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

Socket send buffer size. Default is 1MB.

Specified by:

sendBufferSize in interface ClusterConfiguration.MulticastConfiguration

sendBufferSize

public int sendBufferSize()

packetsPerSecond

public void packetsPerSecond(int pps)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

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 ClusterConfiguration.MulticastConfiguration.preferBatchingToLatency(boolean) is set to false. Default value is 3k.

Specified by:

packetsPerSecond in interface ClusterConfiguration.MulticastConfiguration

packetsPerSecond

public int packetsPerSecond()

spinLoopMicros

public void spinLoopMicros(int micros)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

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

Specified by:

spinLoopMicros in interface ClusterConfiguration.MulticastConfiguration

spinLoopMicros

public int spinLoopMicros()

threadParkMicros

public void threadParkMicros(int micros)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

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

Specified by:

threadParkMicros in interface ClusterConfiguration.MulticastConfiguration

threadParkMicros

public int threadParkMicros()

retransmitPacketsHistory

public void retransmitPacketsHistory(int packets)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

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.

Specified by:

retransmitPacketsHistory in interface ClusterConfiguration.MulticastConfiguration

retransmitPacketsHistory

public int retransmitPacketsHistory()

packetSize

public void packetSize(int size)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

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.

Specified by:

packetSize in interface ClusterConfiguration.MulticastConfiguration

datagramSize

public int datagramSize()

preferBatchingToLatency

public void preferBatchingToLatency(boolean batching)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

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.

Specified by:

preferBatchingToLatency in interface ClusterConfiguration.MulticastConfiguration

preferBatchingToLatency

public boolean preferBatchingToLatency()

ttl

public void ttl(int ttl)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

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

Specified by:

ttl in interface ClusterConfiguration.MulticastConfiguration

ttl

public int ttl()

sendRetries

public void sendRetries(int retries)

Description copied from interface: ClusterConfiguration.MulticastConfiguration

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.

Specified by:

sendRetries in interface ClusterConfiguration.MulticastConfiguration

sendRetries

public int sendRetries()