diff --git a/source/administration/bucket-replication.rst b/source/administration/bucket-replication.rst index e24e0b6d..f86ce14a 100644 --- a/source/administration/bucket-replication.rst +++ b/source/administration/bucket-replication.rst @@ -176,45 +176,21 @@ application of object expiration. Replication of Existing Objects ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -MinIO by default does not enable existing object replication. Objects -created before replication was configured *or* while replication is -disabled are not synchronized to the target deployment. -MinIO supports enabling replication of existing objects in a bucket. +MinIO by default replicates existing objects in the source bucket to the configured remote, similar to `AWS: Replicating existing objects between S3 buckets `__ without the overhead of contacting technical support. -Enabling existing object replication marks all objects or object prefixes that -satisfy the replication rules as eligible for synchronization to the source -cluster, *even if* those objects were created prior to configuring or enabling -replication. You can enable existing object replication while configuring -or modifying a replication rule: +MinIO marks all objects or object prefixes that satisfy the replication rules as eligible for synchronization to the remote cluster and bucket. +MinIO only excludes those objects without a version ID, such as those objects written before enabling versioning on the bucket. -- For new replication rules, include ``"existing-objects"`` to the list of - replication features specified to :mc-cmd:`mc replicate add --replicate`. +You can disable existing object replication while configuring or modifying the bucket replication rule. +You must specify *all* desired replication features during creation or modification: -- For existing replication rules, add ``"existing-objects"`` to the list of - existing replication features using - :mc-cmd:`mc replicate update --replicate`. You must specify *all* desired - replication features when editing the replication rule. +- For new replication rules, exclude ``"existing-objects"`` from the list of replication features specified to :mc-cmd:`mc replicate add --replicate`. -Enabling existing object replication does not increase the priority of objects -pending replication. MinIO uses the same core -:ref:`replication scanner and queue system ` for -detecting and synchronizing objects regardless of the enabled replication -feature. The time required to fully synchronize a bucket depends on a number of -factors, including but not limited to the current cluster replication load, -overall cluster load, and the size of the namespace (all objects in the bucket). +- For existing replication rules, remove ``"existing-objects"`` from the list of existing replication features using :mc-cmd:`mc replicate update --replicate`. + The new rule **replaces** the previous rule. -.. include:: /includes/common/scanner.rst - :start-after: start-scanner-speed-config - :end-before: end-scanner-speed-config +Disabling existing object replication does not remove any objects already replicated to the remote bucket. -If versioning was not previously enabled when configuring bucket replication, -existing objects have a ``versionid = null``. These objects do replicate. - -MinIO existing object replication -implements functionality similar to -`AWS: Replicating existing objects between S3 buckets -`__ -without the overhead of contacting technical support. Synchronous vs Asynchronous Replication ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/source/reference/minio-server/settings/kes.rst b/source/reference/minio-server/settings/kes.rst index 82f3403f..79a1cdb7 100644 --- a/source/reference/minio-server/settings/kes.rst +++ b/source/reference/minio-server/settings/kes.rst @@ -10,7 +10,7 @@ Key Encryption Service Settings :local: :depth: 2 -.. |SSE| replace:: :abbr:`SSE (Server-Side Encryption)` +.. |SSE| replace:: :abbr:`SSE (Server-Side Encryption)` The following environment variables control how the MinIO Server interacts with the Key Encryption Service (KES) when managing encryption and keys.