From a27339826c3fb5a1cda26c32fc798fcb9f6d50e3 Mon Sep 17 00:00:00 2001 From: Poorna Krishnamoorthy Date: Thu, 20 May 2021 08:17:14 -0700 Subject: [PATCH] Fix replication README.md docs (#12330) Signed-off-by: Poorna Krishnamoorthy --- docs/bucket/replication/DESIGN.md | 2 +- docs/bucket/replication/README.md | 8 ++++++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/bucket/replication/DESIGN.md b/docs/bucket/replication/DESIGN.md index d85c5ae5a..639f24784 100644 --- a/docs/bucket/replication/DESIGN.md +++ b/docs/bucket/replication/DESIGN.md @@ -16,7 +16,7 @@ If synchronous replication is configured above, replication is attempted right a Any metadata changes on the source object version, such as metadata updates via PutObjectTagging, PutObjectRetention, PutObjectLegalHold and COPY api are replicated in a similar manner to target version, with the `X-Amz-Replication-Status` again cycling through the same states. -The description above details one way replication from source to target w.r.t incoming object uploads and metadata changes to source object version. If active-active replication is configured, any incoming uploads and metadata changes to versions created on the target, will sync back to the source and be marked as `REPLICA` on the source. AWS, as well as MinIO do not by default sync metadata changes on a object version marked `REPLICA` back to source. This requires a setting in the replication configuration called [replica modification sync](https://aws.amazon.com/about-aws/whats-new/2020/12/amazon-s3-replication-adds-support-two-way-replication/) which is not yet available in MinIO. +The description above details one way replication from source to target w.r.t incoming object uploads and metadata changes to source object version. If active-active replication is configured, any incoming uploads and metadata changes to versions created on the target, will sync back to the source and be marked as `REPLICA` on the source. AWS, as well as MinIO do not by default sync metadata changes on a object version marked `REPLICA` back to source. This requires a setting in the replication configuration called [replica modification sync](https://aws.amazon.com/about-aws/whats-new/2020/12/amazon-s3-replication-adds-support-two-way-replication/). For active-active replication, automatic failover occurs on `GET/HEAD` operations if object or object version requested qualifies for replication and is missing on one site, but present on the other. This allows the applications to take full advantage of two-way replication even before the two sites get fully synced. diff --git a/docs/bucket/replication/README.md b/docs/bucket/replication/README.md index a0f47f0c0..8a6563bcb 100644 --- a/docs/bucket/replication/README.md +++ b/docs/bucket/replication/README.md @@ -160,6 +160,14 @@ If bi-directional replication is set up between two clusters, any metadata updat The replication configuration in use on a bucket can be viewed using the `mc replicate export alias/bucket` command. +To disable replica metadata modification syncing, use `mc replicate edit` with the --replicate flag. +``` +$ mc replicate edit alias/bucket --id xyz.id --replicate "delete,delete-marker" +``` +To re-enable replica metadata modification syncing, +``` +$ mc replicate edit alias/bucket --id xyz.id --replicate "delete,delete-marker,replica-metadata-sync" +``` ## MinIO Extension ### Replicating Deletes