ReplicationHandler (Solr 8.9.0 API)

java.lang.Object
- org.apache.solr.handler.RequestHandlerBase
- - org.apache.solr.handler.ReplicationHandler

All Implemented Interfaces:

AutoCloseable, ApiSupport, SolrInfoBean, NestedRequestHandler, SolrMetricProducer, SolrRequestHandler, SolrCoreAware
```
public class ReplicationHandler
extends RequestHandlerBase
implements SolrCoreAware
```
A Handler which provides a REST API for replication and serves replication requests from Followers.

When running on the leader, it provides the following commands
1. Get the current replicable index version (command=indexversion)
2. Get the list of files for a given index version (command=filelist&indexversion=<VERSION>)
3. Get full or a part (chunk) of a given index or a config file (command=filecontent&file=<FILE_NAME>) You can optionally specify an offset and length to get that chunk of the file. You can request a configuration file by using "cf" parameter instead of the "file" parameter.
4. Get status/statistics (command=details)
When running on the follower, it provides the following commands
1. Perform an index fetch now (command=snappull)
2. Get status/statistics (command=details)
3. Abort an index fetch (command=abort)
4. Enable/Disable polling the leader for new versions (command=enablepoll or command=disablepoll)
Since:

solr 1.4

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface ReplicationHandler.PollListener
- Nested classes/interfaces inherited from interface org.apache.solr.core.SolrInfoBean
  SolrInfoBean.Category, SolrInfoBean.Group

Nested Classes
Modifier and Type	Class and Description
`static interface`	`ReplicationHandler.PollListener`

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ALIAS`
`static String`	`CHECKSUM`
`static String`	`CMD_ABORT_FETCH`
`static String`	`CMD_BACKUP`
`static String`	`CMD_DELETE_BACKUP`
`static String`	`CMD_DETAILS`
`static String`	`CMD_DISABLE_POLL`
`static String`	`CMD_DISABLE_REPL`
`static String`	`CMD_ENABLE_POLL`
`static String`	`CMD_ENABLE_REPL`
`static String`	`CMD_FETCH_INDEX`
`static String`	`CMD_GET_FILE`
`static String`	`CMD_GET_FILE_LIST`
`static String`	`CMD_INDEX_VERSION`
`static String`	`CMD_RESTORE`
`static String`	`CMD_RESTORE_STATUS`
`static String`	`CMD_SHOW_COMMITS`
`static String`	`COMMAND`
`static String`	`COMPRESSION`
`static String`	`CONF_CHECKSUM`
`static String`	`CONF_FILE_SHORT`
`static String`	`CONF_FILES`
`static String`	`ERR_STATUS`
`static String`	`EXTERNAL`
`static String`	`FETCH_FROM_LEADER`
`static String`	`FILE`
`static String`	`FILE_STREAM`
`static String`	`GENERATION`
`static String`	`INTERNAL`
`static String`	`INTERVAL_ERR_MSG`
`static String`	`LEADER_URL`
`static String`	`LEGACY_LEADER_URL` Deprecated.
`static String`	`LEGACY_SKIP_COMMIT_ON_LEADER_VERSION_ZERO` Deprecated.
`static String`	`LEN`
`static String`	`MAX_WRITE_PER_SECOND`
`static String`	`MESSAGE`
`static String`	`NEXT_EXECUTION_AT`
`static String`	`NUMBER_BACKUPS_TO_KEEP_INIT_PARAM`
`static String`	`NUMBER_BACKUPS_TO_KEEP_REQUEST_PARAM`
`static String`	`OFFSET`
`static String`	`OK_STATUS`
`static int`	`PACKET_SZ`
`static String`	`PATH`
`static String`	`POLL_INTERVAL`
`static String`	`REPLICATE_AFTER`
`static String`	`RESERVE`
`static String`	`SIZE`
`static String`	`SKIP_COMMIT_ON_LEADER_VERSION_ZERO`
`static String`	`STATUS`
`static String`	`TLOG_FILE`
`static String`	`TLOG_FILES`
`static String`	`WAIT` Boolean param for tests that can be specified when using `CMD_FETCH_INDEX` to force the current request to block until the fetch is complete.

Fields inherited from class org.apache.solr.handler.RequestHandlerBase
appends, defaults, httpCaching, initArgs, invariants, solrMetricsContext

Fields inherited from interface org.apache.solr.request.SolrRequestHandler
TYPE

Constructor Summary

Constructors
Constructor and Description

ReplicationHandler()

Constructors
Constructor and Description
`ReplicationHandler()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`abortFetch()`
`IndexFetcher.IndexFetchResult`	`doFetch(SolrParams solrParams, boolean forceReplication)`
`SolrInfoBean.Category`	`getCategory()` Category of this component
`String`	`getDescription()` Simple one or two line description
`void`	`handleRequestBody(SolrQueryRequest req, SolrQueryResponse rsp)`
`void`	`inform(SolrCore core)`
`void`	`initializeMetrics(SolrMetricsContext parentContext, String scope)` Initialize metrics specific to this producer.
`void`	`setPollListener(ReplicationHandler.PollListener pollListener)`
`void`	`shutdown()`

Methods inherited from class org.apache.solr.handler.RequestHandlerBase
getApis, getInitArgs, getMetricNames, getName, getPluginInfo, getRequestHandler, getSolrMetricsContext, getSolrParamsFromNamedList, getSubHandler, handleRequest, init, setPluginInfo

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.core.SolrInfoBean
getMetricRegistry, getMetricsSnapshot, registerMetricName

Methods inherited from interface org.apache.solr.metrics.SolrMetricProducer
close, getUniqueMetricTag, initializeMetrics

Methods inherited from interface org.apache.solr.api.ApiSupport
registerV1, registerV2

- Field Detail
  - PATH
```
public static final String PATH
```
    See Also:
    
    Constant Field Values
  - LEADER_URL
```
public static final String LEADER_URL
```
    See Also:
    
    Constant Field Values
  - LEGACY_LEADER_URL
```
@Deprecated
public static final String LEGACY_LEADER_URL
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - FETCH_FROM_LEADER
```
public static final String FETCH_FROM_LEADER
```
    See Also:
    
    Constant Field Values
  - SKIP_COMMIT_ON_LEADER_VERSION_ZERO
```
public static final String SKIP_COMMIT_ON_LEADER_VERSION_ZERO
```
    See Also:
    
    Constant Field Values
  - LEGACY_SKIP_COMMIT_ON_LEADER_VERSION_ZERO
```
@Deprecated
public static final String LEGACY_SKIP_COMMIT_ON_LEADER_VERSION_ZERO
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - STATUS
```
public static final String STATUS
```
    See Also:
    
    Constant Field Values
  - MESSAGE
```
public static final String MESSAGE
```
    See Also:
    
    Constant Field Values
  - COMMAND
```
public static final String COMMAND
```
    See Also:
    
    Constant Field Values
  - CMD_DETAILS
```
public static final String CMD_DETAILS
```
    See Also:
    
    Constant Field Values
  - CMD_BACKUP
```
public static final String CMD_BACKUP
```
    See Also:
    
    Constant Field Values
  - CMD_RESTORE
```
public static final String CMD_RESTORE
```
    See Also:
    
    Constant Field Values
  - CMD_RESTORE_STATUS
```
public static final String CMD_RESTORE_STATUS
```
    See Also:
    
    Constant Field Values
  - CMD_FETCH_INDEX
```
public static final String CMD_FETCH_INDEX
```
    See Also:
    
    Constant Field Values
  - CMD_ABORT_FETCH
```
public static final String CMD_ABORT_FETCH
```
    See Also:
    
    Constant Field Values
  - CMD_GET_FILE_LIST
```
public static final String CMD_GET_FILE_LIST
```
    See Also:
    
    Constant Field Values
  - CMD_GET_FILE
```
public static final String CMD_GET_FILE
```
    See Also:
    
    Constant Field Values
  - CMD_DISABLE_POLL
```
public static final String CMD_DISABLE_POLL
```
    See Also:
    
    Constant Field Values
  - CMD_DISABLE_REPL
```
public static final String CMD_DISABLE_REPL
```
    See Also:
    
    Constant Field Values
  - CMD_ENABLE_REPL
```
public static final String CMD_ENABLE_REPL
```
    See Also:
    
    Constant Field Values
  - CMD_ENABLE_POLL
```
public static final String CMD_ENABLE_POLL
```
    See Also:
    
    Constant Field Values
  - CMD_INDEX_VERSION
```
public static final String CMD_INDEX_VERSION
```
    See Also:
    
    Constant Field Values
  - CMD_SHOW_COMMITS
```
public static final String CMD_SHOW_COMMITS
```
    See Also:
    
    Constant Field Values
  - CMD_DELETE_BACKUP
```
public static final String CMD_DELETE_BACKUP
```
    See Also:
    
    Constant Field Values
  - GENERATION
```
public static final String GENERATION
```
    See Also:
    
    Constant Field Values
  - OFFSET
```
public static final String OFFSET
```
    See Also:
    
    Constant Field Values
  - LEN
```
public static final String LEN
```
    See Also:
    
    Constant Field Values
  - FILE
```
public static final String FILE
```
    See Also:
    
    Constant Field Values
  - SIZE
```
public static final String SIZE
```
    See Also:
    
    Constant Field Values
  - MAX_WRITE_PER_SECOND
```
public static final String MAX_WRITE_PER_SECOND
```
    See Also:
    
    Constant Field Values
  - CONF_FILE_SHORT
```
public static final String CONF_FILE_SHORT
```
    See Also:
    
    Constant Field Values
  - TLOG_FILE
```
public static final String TLOG_FILE
```
    See Also:
    
    Constant Field Values
  - CHECKSUM
```
public static final String CHECKSUM
```
    See Also:
    
    Constant Field Values
  - ALIAS
```
public static final String ALIAS
```
    See Also:
    
    Constant Field Values
  - CONF_CHECKSUM
```
public static final String CONF_CHECKSUM
```
    See Also:
    
    Constant Field Values
  - CONF_FILES
```
public static final String CONF_FILES
```
    See Also:
    
    Constant Field Values
  - TLOG_FILES
```
public static final String TLOG_FILES
```
    See Also:
    
    Constant Field Values
  - REPLICATE_AFTER
```
public static final String REPLICATE_AFTER
```
    See Also:
    
    Constant Field Values
  - FILE_STREAM
```
public static final String FILE_STREAM
```
    See Also:
    
    Constant Field Values
  - POLL_INTERVAL
```
public static final String POLL_INTERVAL
```
    See Also:
    
    Constant Field Values
  - INTERVAL_ERR_MSG
```
public static final String INTERVAL_ERR_MSG
```
    See Also:
    
    Constant Field Values
  - PACKET_SZ
```
public static final int PACKET_SZ
```
    See Also:
    
    Constant Field Values
  - RESERVE
```
public static final String RESERVE
```
    See Also:
    
    Constant Field Values
  - COMPRESSION
```
public static final String COMPRESSION
```
    See Also:
    
    Constant Field Values
  - EXTERNAL
```
public static final String EXTERNAL
```
    See Also:
    
    Constant Field Values
  - INTERNAL
```
public static final String INTERNAL
```
    See Also:
    
    Constant Field Values
  - ERR_STATUS
```
public static final String ERR_STATUS
```
    See Also:
    
    Constant Field Values
  - OK_STATUS
```
public static final String OK_STATUS
```
    See Also:
    
    Constant Field Values
  - NEXT_EXECUTION_AT
```
public static final String NEXT_EXECUTION_AT
```
    See Also:
    
    Constant Field Values
  - NUMBER_BACKUPS_TO_KEEP_REQUEST_PARAM
```
public static final String NUMBER_BACKUPS_TO_KEEP_REQUEST_PARAM
```
    See Also:
    
    Constant Field Values
  - NUMBER_BACKUPS_TO_KEEP_INIT_PARAM
```
public static final String NUMBER_BACKUPS_TO_KEEP_INIT_PARAM
```
    See Also:
    
    Constant Field Values
  - WAIT
```
public static final String WAIT
```
    Boolean param for tests that can be specified when using CMD_FETCH_INDEX to force the current request to block until the fetch is complete. NOTE: This param is not advised for non-test code, since the the duration of the fetch for non-trivial indexes will likeley cause the request to time out.
    
    See Also:
    
    Constant Field Values
    
    NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.
- Constructor Detail
  - ReplicationHandler
```
public ReplicationHandler()
```
- Method Detail
  - setPollListener
```
public void setPollListener(ReplicationHandler.PollListener pollListener)
```
  - handleRequestBody
```
public void handleRequestBody(SolrQueryRequest req,
                              SolrQueryResponse rsp)
                       throws Exception
```
    Specified by:
    
    handleRequestBody in class RequestHandlerBase
    
    Throws:
    
    Exception
  - abortFetch
```
public boolean abortFetch()
```
  - doFetch
```
public IndexFetcher.IndexFetchResult doFetch(SolrParams solrParams,
                                             boolean forceReplication)
```
  - getCategory
```
public SolrInfoBean.Category getCategory()
```
    Description copied from interface: SolrInfoBean
    
    Category of this component
    
    Specified by:
    
    getCategory in interface SolrInfoBean
    
    Overrides:
    
    getCategory in class RequestHandlerBase
  - getDescription
```
public String getDescription()
```
    Description copied from interface: SolrInfoBean
    
    Simple one or two line description
    
    Specified by:
    
    getDescription in interface SolrInfoBean
    
    Specified by:
    
    getDescription in class RequestHandlerBase
  - initializeMetrics
```
public void initializeMetrics(SolrMetricsContext parentContext,
                              String scope)
```
    Description copied from interface: SolrMetricProducer
    
    Initialize metrics specific to this producer.
    
    Specified by:
    
    initializeMetrics in interface SolrMetricProducer
    
    Overrides:
    
    initializeMetrics in class RequestHandlerBase
    
    Parameters:
    
    parentContext - parent metrics context. If this component has the same life-cycle as the parent it can simply use the parent context, otherwise it should obtain a child context using SolrMetricsContext.getChildContext(Object) passing this as the child.
    
    scope - component scope
  - inform
```
public void inform(SolrCore core)
```
    Specified by:
    
    inform in interface SolrCoreAware
  - shutdown
```
public void shutdown()
```

Class ReplicationHandler

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.solr.core.SolrInfoBean

Field Summary

Fields inherited from class org.apache.solr.handler.RequestHandlerBase

Fields inherited from interface org.apache.solr.request.SolrRequestHandler

Constructor Summary

Method Summary

Methods inherited from class org.apache.solr.handler.RequestHandlerBase

Methods inherited from class java.lang.Object

Methods inherited from interface org.apache.solr.core.SolrInfoBean

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

Methods inherited from interface org.apache.solr.api.ApiSupport

Field Detail

PATH

LEADER_URL

LEGACY_LEADER_URL

FETCH_FROM_LEADER

SKIP_COMMIT_ON_LEADER_VERSION_ZERO

LEGACY_SKIP_COMMIT_ON_LEADER_VERSION_ZERO

STATUS

MESSAGE

COMMAND

CMD_DETAILS

CMD_BACKUP

CMD_RESTORE

CMD_RESTORE_STATUS

CMD_FETCH_INDEX

CMD_ABORT_FETCH

CMD_GET_FILE_LIST

CMD_GET_FILE

CMD_DISABLE_POLL

CMD_DISABLE_REPL

CMD_ENABLE_REPL

CMD_ENABLE_POLL

CMD_INDEX_VERSION

CMD_SHOW_COMMITS

CMD_DELETE_BACKUP

GENERATION

OFFSET

LEN

FILE

SIZE

MAX_WRITE_PER_SECOND

CONF_FILE_SHORT

TLOG_FILE

CHECKSUM

ALIAS

CONF_CHECKSUM

CONF_FILES

TLOG_FILES

REPLICATE_AFTER

FILE_STREAM

POLL_INTERVAL

INTERVAL_ERR_MSG

PACKET_SZ

RESERVE

COMPRESSION

EXTERNAL

INTERNAL

ERR_STATUS

OK_STATUS

NEXT_EXECUTION_AT

NUMBER_BACKUPS_TO_KEEP_REQUEST_PARAM

NUMBER_BACKUPS_TO_KEEP_INIT_PARAM

WAIT

Constructor Detail

ReplicationHandler

Method Detail

setPollListener

handleRequestBody

abortFetch

doFetch

getCategory

getDescription

initializeMetrics

inform

shutdown