com.sleepycat.je.rep.impl.node

Class FeederManager

java.lang.Object

com.sleepycat.je.rep.impl.node.FeederManager

public final class FeederManager
extends Object

FeedManager is responsible for the creation and management of the Feeders used to respond to connections initiated by a Replica. runfeeders() is the central loop that listens for replica connections and manages the lifecycle of individual Feeders. It's re-entered each time the node becomes a Master and is exited when its status changes. There is a single instance of FeederManager that is created for a replication node. There are many instances of Feeders per FeederManager. Each Feeder instance represents an instance of a connection between the node serving as the feeder and the replica. Note that the FeederManager and the Replica currently reuse the Replication node's thread of control. When we implement r2r we will need to revisit the thread management to provide for concurrent operation of the FeederManger and the Replica.

Field Summary

Fields

Modifier and Type	Field and Description
static String	FEEDER_SERVICE
long	pollTimeoutMs

Method Summary

Modifier and Type	Method and Description
int	activeAckArbiterCount()
int	activeAckReplicaCount()
Set<String>	activeAckReplicas(boolean includeArbiters) Returns the set of active replicas and arbiters, that are currently active with this feeder and are supplying acknowledgments.
int	activeReplicaCount() The numbers of Replicas currently "active" with this feeder.
Set<String>	activeReplicas() Returns the set of Replicas that are currently active with this feeder.
Map<String,Feeder>	activeReplicasMap()
String	dumpState(boolean acksOnly)
Feeder	getArbiterFeeder()
Feeder	getFeeder(String nodeName) Returns the Feeder associated with the node, if such a feeder is currently active.
StatGroup	getFeederManagerStats(StatsConfig config) Returns the statistics associated with the FeederManager.
int	getNumCurrentAckFeeders(VLSN commitVLSN) Returns a count of the number of feeders whose replicas are counted in durability decisions and have acknowledged txn-end VLSNs >= the commitVLSN argument.
StatGroup	getProtocolStats(StatsConfig config)
int	getTestDelayMs()
Feeder	putFeeder(String nodeName, Feeder feeder)
void	resetStats()
static void	setDelayCBVLSNUpdateHook(TestHook<NameIdPair> hook) Set a test hook, parameterized by feeder's Name/ID pair, that delays CBVLSN updates if it throws an IllegalStateException.
void	setTestDelayMs(int testDelayMs)
void	shutdownFeeder(RepNodeImpl node) Shuts down a specific feeder.
void	updateDTVLSN(long heartbeatVLSN) Update the Master's DTVLSN if we can conclude based upon the state of the replicas that the DTVLSN needs to be advanced.

Methods inherited from class java.lang.Object

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

Field Detail

pollTimeoutMs

public final long pollTimeoutMs

FEEDER_SERVICE

public static final String FEEDER_SERVICE

See Also:

Constant Field Values

Method Detail

getFeederManagerStats

public StatGroup getFeederManagerStats(StatsConfig config)

Returns the statistics associated with the FeederManager.

Returns:

the statistics

getProtocolStats

public StatGroup getProtocolStats(StatsConfig config)

resetStats

public void resetStats()

getTestDelayMs

public int getTestDelayMs()

setTestDelayMs

public void setTestDelayMs(int testDelayMs)

getFeeder

public Feeder getFeeder(String nodeName)

Returns the Feeder associated with the node, if such a feeder is currently active.

getArbiterFeeder

public Feeder getArbiterFeeder()

putFeeder

public Feeder putFeeder(String nodeName,
                        Feeder feeder)

activeReplicaCount

public int activeReplicaCount()

The numbers of Replicas currently "active" with this feeder. Active currently means they are connected. It does not make any guarantees about where they are in the replication stream. They may, for example, be too far behind to participate in timely acks.

Returns:

the active replica count

activeAckReplicaCount

public int activeAckReplicaCount()

activeAckArbiterCount

public int activeAckArbiterCount()

activeReplicas

public Set<String> activeReplicas()

Returns the set of Replicas that are currently active with this feeder. A replica is active if it has completed the handshake sequence.

Returns:

the set of replica node names

activeAckReplicas

public Set<String> activeAckReplicas(boolean includeArbiters)

Returns the set of active replicas and arbiters, that are currently active with this feeder and are supplying acknowledgments. A replica is active if it has completed the handshake sequence. An Arbiter is only returned if it's in active arbitration.

Parameters:

includeArbiters - include active arbiters in the list of returned node names if true; exclude arbiters otherwise.

Returns:

the set of replica and if includeArbiters active arbiter node names

activeReplicasMap

public Map<String,Feeder> activeReplicasMap()

shutdownFeeder

public void shutdownFeeder(RepNodeImpl node)

Shuts down a specific feeder. It's typically done in response to the removal of a member from the group.

dumpState

public String dumpState(boolean acksOnly)

getNumCurrentAckFeeders

public int getNumCurrentAckFeeders(VLSN commitVLSN)

Returns a count of the number of feeders whose replicas are counted in durability decisions and have acknowledged txn-end VLSNs >= the commitVLSN argument.

Parameters:

commitVLSN - the commitVLSN being checked

updateDTVLSN

public void updateDTVLSN(long heartbeatVLSN)

Update the Master's DTVLSN if we can conclude based upon the state of the replicas that the DTVLSN needs to be advanced. This method is invoked when a replica heartbeat reports a more recent txn VLSN. This (sometimes) redundant form of DTVLS update is useful in circumstances when the value could not be maintained via the usual ack response processing: 1) The application is using no ack transactions explicitly. 2) There were ack transaction timeouts due to network problems and the acks were never received or were received after the timeout had expired.

setDelayCBVLSNUpdateHook

public static void setDelayCBVLSNUpdateHook(TestHook<NameIdPair> hook)

Set a test hook, parameterized by feeder's Name/ID pair, that delays CBVLSN updates if it throws an IllegalStateException.