Multi-Datacenter Replication Reference: Per Bucket
To enable or disable replication per bucket, you can use the repl
bucket property.
Some changes have occurred between 1.1 and 1.2.
These repl
values are available in Riak Enterprise version 1.1 and
above:
true
— Enable replication (realtime + fullsync)false
— Disable replication (realtime + fullsync)
These option values are only available in Riak Enterprise version 1.2 and above:
realtime
— Replication only occurs in realtime for this bucketfullsync
— Replication only occurs during a fullsync operationboth
— Replication occurs in realtime and during fullsync
Example of Disabling
curl -v -XPUT http://127.0.0.1:8098/buckets/my_bucket \
-H "Content-Type: application/json" \
-d '{"props":{"repl":false}}'
Example of Enabling
curl -v -XPUT http://127.0.0.1:8098/buckets/my_bucket \
-H "Content-Type: application/json" \
-d '{"props":{"repl":true}}'
How Bucket Properties Work in Riak Enterprise
When using Multi-Datacenter Replication, each bucket’s write properties are derived from the bucket’s properties in the destination cluster. If the bucket doesn’t exist, the default properties of the destination cluster are used.
It’s important to note that this goes for properties such as backend
.
If the bucket doesn’t exist in the destination cluster, Riak will create
it with the default backend and not with the backend used in the
source cluster.