org.apache.hadoop.hbase.replication

Class HBaseReplicationEndpoint

java.lang.Object

org.apache.hbase.thirdparty.com.google.common.util.concurrent.AbstractService

org.apache.hadoop.hbase.replication.BaseReplicationEndpoint

org.apache.hadoop.hbase.replication.HBaseReplicationEndpoint

All Implemented Interfaces:

Abortable, ReplicationEndpoint, ReplicationPeerConfigListener, org.apache.hbase.thirdparty.com.google.common.util.concurrent.Service

Direct Known Subclasses:

HBaseInterClusterReplicationEndpoint

@InterfaceAudience.Private
public abstract class HBaseReplicationEndpoint
extends BaseReplicationEndpoint
implements Abortable

A BaseReplicationEndpoint for replication endpoints whose target cluster is an HBase cluster.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HBaseReplicationEndpoint.PeerRegionServerListener Tracks changes to the list of region servers in a peer's cluster.
static class	HBaseReplicationEndpoint.SinkPeer Wraps a replication region server sink to provide the ability to identify it.

Nested classes/interfaces inherited from interface org.apache.hadoop.hbase.replication.ReplicationEndpoint

ReplicationEndpoint.Context, ReplicationEndpoint.ReplicateContext

Nested classes/interfaces inherited from interface org.apache.hbase.thirdparty.com.google.common.util.concurrent.Service

org.apache.hbase.thirdparty.com.google.common.util.concurrent.Service.Listener, org.apache.hbase.thirdparty.com.google.common.util.concurrent.Service.State

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.hadoop.conf.Configuration	conf
static int	DEFAULT_BAD_SINK_THRESHOLD Default maximum number of times a replication sink can be reported as bad before it will no longer be provided as a sink for replication without the pool of replication sinks being refreshed.
static float	DEFAULT_REPLICATION_SOURCE_RATIO Default ratio of the total number of peer cluster region servers to consider replicating to.

Fields inherited from class org.apache.hadoop.hbase.replication.BaseReplicationEndpoint

ctx, REPLICATION_WALENTRYFILTER_CONFIG_KEY

Constructor Summary

Constructors

Constructor and Description
HBaseReplicationEndpoint()

Method Summary

Modifier and Type	Method and Description
void	abort(String why, Throwable e)
protected void	chooseSinks()
protected AsyncClusterConnection	createConnection(org.apache.hadoop.conf.Configuration conf)
protected void	disconnect()
protected void	doStart()
protected void	doStop()
protected List<ServerName>	fetchSlavesAddresses() Get the list of all the region servers from the specified peer
protected int	getNumSinks()
UUID	getPeerUUID() Returns a UUID of the provided peer id.
protected HBaseReplicationEndpoint.SinkPeer	getReplicationSink() Get a randomly-chosen replication sink to replicate to.
void	init(ReplicationEndpoint.Context context) Initialize the replication endpoint with the given context.
boolean	isAborted()
protected void	reportBadSink(HBaseReplicationEndpoint.SinkPeer sinkPeer) Report a SinkPeer as being bad (i.e.
protected void	reportSinkSuccess(HBaseReplicationEndpoint.SinkPeer sinkPeer) Report that a SinkPeer successfully replicated a chunk of data.
void	start() Initiates service startup and returns immediately.
void	stop() If the service is starting or running, this initiates service shutdown and returns immediately.

Methods inherited from class org.apache.hadoop.hbase.replication.BaseReplicationEndpoint

canReplicateToSameCluster, getNamespaceTableCfWALEntryFilter, getScopeWALEntryFilter, getWALEntryfilter, isStarting, peerConfigUpdated

Methods inherited from class org.apache.hbase.thirdparty.com.google.common.util.concurrent.AbstractService

addListener, awaitRunning, awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, awaitTerminated, doCancelStart, failureCause, isRunning, notifyFailed, notifyStarted, notifyStopped, startAsync, state, stopAsync, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.hadoop.hbase.Abortable

abort

Methods inherited from interface org.apache.hadoop.hbase.replication.ReplicationEndpoint

awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, failureCause, isRunning, replicate

Field Detail

conf

protected org.apache.hadoop.conf.Configuration conf

DEFAULT_BAD_SINK_THRESHOLD

public static final int DEFAULT_BAD_SINK_THRESHOLD

Default maximum number of times a replication sink can be reported as bad before it will no longer be provided as a sink for replication without the pool of replication sinks being refreshed.

See Also:

Constant Field Values

DEFAULT_REPLICATION_SOURCE_RATIO

public static final float DEFAULT_REPLICATION_SOURCE_RATIO

Default ratio of the total number of peer cluster region servers to consider replicating to.

See Also:

Constant Field Values

Constructor Detail

HBaseReplicationEndpoint

public HBaseReplicationEndpoint()

Method Detail

createConnection

protected AsyncClusterConnection createConnection(org.apache.hadoop.conf.Configuration conf)
                                           throws IOException

Throws:

IOException

init

public void init(ReplicationEndpoint.Context context)
          throws IOException

Description copied from interface: ReplicationEndpoint

Initialize the replication endpoint with the given context.

Specified by:

init in interface ReplicationEndpoint

Overrides:

init in class BaseReplicationEndpoint

Parameters:

context - replication context

Throws:

IOException - error occur when initialize the endpoint.

disconnect

protected void disconnect()

start

public void start()

Description copied from interface: ReplicationEndpoint

Initiates service startup and returns immediately. A stopped service may not be restarted. Equivalent of startAsync call in Guava Service.

Specified by:

start in interface ReplicationEndpoint

stop

public void stop()

Description copied from interface: ReplicationEndpoint

If the service is starting or running, this initiates service shutdown and returns immediately. If the service has already been stopped, this method returns immediately without taking action. Equivalent of stopAsync call in Guava Service.

Specified by:

stop in interface ReplicationEndpoint

doStart

protected void doStart()

Specified by:

doStart in class org.apache.hbase.thirdparty.com.google.common.util.concurrent.AbstractService

doStop

protected void doStop()

Specified by:

doStop in class org.apache.hbase.thirdparty.com.google.common.util.concurrent.AbstractService

getPeerUUID

public UUID getPeerUUID()

Description copied from interface: ReplicationEndpoint

Returns a UUID of the provided peer id. Every HBase cluster instance has a persisted associated UUID. If the replication is not performed to an actual HBase cluster (but some other system), the UUID returned has to uniquely identify the connected target system.

Specified by:

getPeerUUID in interface ReplicationEndpoint

Returns:

a UUID or null if the peer cluster does not exist or is not connected.

abort

public void abort(String why,
                  Throwable e)

Specified by:

abort in interface Abortable

isAborted

public boolean isAborted()

Specified by:

isAborted in interface Abortable

fetchSlavesAddresses

protected List<ServerName> fetchSlavesAddresses()

Get the list of all the region servers from the specified peer

Returns:

list of region server addresses or an empty list if the slave is unavailable

chooseSinks

protected void chooseSinks()

getNumSinks

protected int getNumSinks()

getReplicationSink

protected HBaseReplicationEndpoint.SinkPeer getReplicationSink()
                                                        throws IOException

Get a randomly-chosen replication sink to replicate to.

Returns:

a replication sink to replicate to

Throws:

IOException

reportBadSink

protected void reportBadSink(HBaseReplicationEndpoint.SinkPeer sinkPeer)

Report a SinkPeer as being bad (i.e. an attempt to replicate to it failed). If a single SinkPeer is reported as bad more than replication.bad.sink.threshold times, it will be removed from the pool of potential replication targets.

Parameters:

sinkPeer - The SinkPeer that had a failed replication attempt on it

reportSinkSuccess

protected void reportSinkSuccess(HBaseReplicationEndpoint.SinkPeer sinkPeer)

Report that a SinkPeer successfully replicated a chunk of data. n * The SinkPeer that had a failed replication attempt on it