org.apache.solr.update

Class PeerSync

java.lang.Object

org.apache.solr.update.PeerSync

All Implemented Interfaces:

SolrMetricProducer

public class PeerSync
extends Object
implements SolrMetricProducer

This class is useful for performing peer to peer synchronization of recently indexed update commands during recovery process.

WARNING: This API is experimental and might change in incompatible ways in the next release.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PeerSync.PeerSyncResult

Field Summary

Fields

Modifier and Type	Field and Description
static Comparator<Long>	absComparator
static String	METRIC_SCOPE

Constructor Summary

Constructors

Constructor and Description
PeerSync(SolrCore core, List<String> replicas, int nUpdates)
PeerSync(SolrCore core, List<String> replicas, int nUpdates, boolean cantReachIsSuccess, boolean getNoVersionsIsSuccess)
PeerSync(SolrCore core, List<String> replicas, int nUpdates, boolean cantReachIsSuccess, boolean getNoVersionsIsSuccess, boolean onlyIfActive, boolean doFingerprint)

Method Summary

Modifier and Type	Method and Description
void	initializeMetrics(SolrMetricManager manager, String registry, String tag, String scope) Initializes metrics specific to this producer.
long	percentile(List<Long> arr, float frac)
void	setStartingVersions(List<Long> startingVersions) optional list of updates we had before possibly receiving new updates
PeerSync.PeerSyncResult	sync() Returns true if peer sync was successful, meaning that this core may be considered to have the latest updates.
static void	sync(SolrCore core, List<String> replicas, int nUpdates) Requests and applies recent updates from peers

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.solr.metrics.SolrMetricProducer

initializeMetrics

Field Detail

absComparator

public static Comparator<Long> absComparator

METRIC_SCOPE

public static final String METRIC_SCOPE

See Also:

Constant Field Values

Constructor Detail

PeerSync

public PeerSync(SolrCore core,
                List<String> replicas,
                int nUpdates)

PeerSync

public PeerSync(SolrCore core,
                List<String> replicas,
                int nUpdates,
                boolean cantReachIsSuccess,
                boolean getNoVersionsIsSuccess)

PeerSync

public PeerSync(SolrCore core,
                List<String> replicas,
                int nUpdates,
                boolean cantReachIsSuccess,
                boolean getNoVersionsIsSuccess,
                boolean onlyIfActive,
                boolean doFingerprint)

Method Detail

initializeMetrics

public void initializeMetrics(SolrMetricManager manager,
                              String registry,
                              String tag,
                              String scope)

Description copied from interface: SolrMetricProducer

Initializes metrics specific to this producer.

Note: for back-compatibility this method by default calls SolrMetricProducer.initializeMetrics(SolrMetricManager, String, String).

Specified by:

initializeMetrics in interface SolrMetricProducer

Parameters:

manager - an instance of SolrMetricManager

registry - registry name where metrics are registered

tag - symbolic tag that represents a group of related instances that have the same life-cycle. Parent component can use the tag when calling SolrMetricManager.unregisterGauges(String, String) to unregister metrics created by this instance of the producer.

scope - scope of the metrics (eg. handler name) to separate metrics of instances of the same component executing in different contexts

setStartingVersions

public void setStartingVersions(List<Long> startingVersions)

optional list of updates we had before possibly receiving new updates

percentile

public long percentile(List<Long> arr,
                       float frac)

sync

public PeerSync.PeerSyncResult sync()

Returns true if peer sync was successful, meaning that this core may be considered to have the latest updates. It does not mean that the remote replica is in sync with us.

sync

public static void sync(SolrCore core,
                        List<String> replicas,
                        int nUpdates)

Requests and applies recent updates from peers