Schedule an External Replication Task in order to have a live replica of your data in another database,
in a separate RavenDB cluster.
The replica is up to date at all times, any changes in the database will be reflected in the replica once they occur.
The External Replication task is not creating a backup of your data, see more in Backup -vs- Replication
Note: External Replication can be defined to another database within the same cluster.
That can come into use for example when you want a copy of the data that wouldn't be a client failover target.
If no name is given then RavenDB server will create one for you based on the defined connection string
Task Delay Time (Optional)
If a delay time is set then data will be replicated only after this time period has passed for each data change.
Preferred Node (Optional)
Select a preferred mentor node from the Database Group to be the responsible node for this External Replication Task
If not selected, then the cluster will assign a responsible node (see Members Duties)
Select a connection string from the pre-defined list -or- create a new connection string to be used.
The connection string defines the external database and its server URLs to replicate to.
External Replication - Details in Tasks List View
Tasks List View Details
External Replication Task Details:
Task Status - Active / Not Active / Not on Node / Reconnect
Connection String - The connection string used
Destination Database - The external database to which the data is being replicated
Actual Destination URL - The server URL to which the data is actually being replicated,
the one that is currently used out of the available Topology Discovery URLs
Topology Discovery URLs - List of the available destination Database Group servers URLs
Graph view of the responsible node for the External Replication Task
External Replication - Offline Behaviour
When the source cluster is down (and there is no leader):
Creating a new Ongoing Task is a Cluster-Wide operation,
thus, a new Ongoing External Replication Task cannot be scheduled.
If an External Replication Task was already defined and active when the cluster went down,
then the task will not be active, no replication will take place.
When the node responsible for the external replication task is down
If the responsible node for the External Replication Task is down,
then another node from the Database Group will take ownership of the task so that the external replica is up to date.
When the destination node is down:
The external replication will wait until the destination is reachable again and proceed from where it left off.
If there is a cluster on the other side, and the URL addresses of the destination database group nodes are listed in the connection string,
then when the destination node is down, the replication task will simply start transferring data to one of the other nodes specified.