From d83b216a825fd3c42b8519ec6afe64913af7ace3 Mon Sep 17 00:00:00 2001 From: Daryl White <53910321+djwfyi@users.noreply.github.com> Date: Wed, 5 Oct 2022 12:57:46 -0500 Subject: [PATCH] Adds information or requeueing healing processes (#598) Closes #529 Release RELEASE.2022-08-11T04-37-28Z optimized when site healing requeues. Updated bucket replication and site replication docs to reflect this change. --- source/administration/bucket-replication.rst | 8 ++++++-- source/glossary.rst | 4 ++++ .../install-deploy-manage/multi-site-replication.rst | 4 ++++ source/reference/minio-mc/mc-pipe.rst | 2 +- source/reference/minio-mc/mc-support-top-api.rst | 4 ++-- source/reference/minio-mc/mc-support-top-disk.rst | 4 ++-- source/reference/minio-mc/mc-support-top-locks.rst | 2 +- source/reference/minio-mc/mc-undo.rst | 2 +- 8 files changed, 21 insertions(+), 9 deletions(-) diff --git a/source/administration/bucket-replication.rst b/source/administration/bucket-replication.rst index fb431307..b7f5db1a 100644 --- a/source/administration/bucket-replication.rst +++ b/source/administration/bucket-replication.rst @@ -24,7 +24,7 @@ and destination buckets. remote replication target. Client-side Bucket Replication - Use The command process to synchronize objects between buckets + Use the command process to synchronize objects between buckets within the same S3-compatible cluster *or* between two independent S3-compatible clusters. Client-side replication using :mc:`mc mirror` supports MinIO-to-S3 and similar replication configurations. @@ -75,7 +75,6 @@ replication while adding the following MinIO-only features: buckets. - Multi-Site replication of objects between three or more MinIO deployments - (New in :minio-release:`RELEASE.2021-09-23T04-46-24Z`). .. _minio-replication-behavior-resync: @@ -272,6 +271,11 @@ workers operating on that queue. MinIO continuously works to replicate and remove objects from the queue while scanning for new unreplicated objects to add to the queue. +.. versionchanged:: RELEASE.2022-08-11T04-37-28Z + + Failed or pending replications requeue automatically when performing a list or any ``GET`` or ``HEAD`` API method. + For example, using :mc:`mc stat`, :mc:`mc cat`, or :mc-cmd:`mc ls` after a remote location comes back online requeues replication. + MinIO sets the ``X-Amz-Replication-Status`` metadata field according to the replication state of the object: diff --git a/source/glossary.rst b/source/glossary.rst index a43afaf4..d9e4e42d 100644 --- a/source/glossary.rst +++ b/source/glossary.rst @@ -18,6 +18,10 @@ Glossary See also: :term:`active-active`. + alias + A locally defined reference to a MinIO Deployment used in most command line interface operations. + See :mc-cmd:`mc alias set`. + audit logs Granular descriptions of each operation on a MinIO deployment. :ref:`Audit logs ` support security standards and regulations which require detailed tracking of operations. diff --git a/source/operations/install-deploy-manage/multi-site-replication.rst b/source/operations/install-deploy-manage/multi-site-replication.rst index 51f35069..02e7ef30 100644 --- a/source/operations/install-deploy-manage/multi-site-replication.rst +++ b/source/operations/install-deploy-manage/multi-site-replication.rst @@ -78,6 +78,10 @@ Site Healing Any MinIO deployment in the site replication configuration can resynchronize damaged :ref:`replica-eligible data ` from the peer with the most updated ("latest") version of that data. +.. versionchanged:: RELEASE.2022-08-11T04-37-28Z + + Failed or pending replications requeue automatically when performing any ``GET`` or ``HEAD`` API method. + For example, using :mc:`mc stat`, :mc:`mc cat`, or :mc:`mc ls` commands after a site comes back online prompts healing to requeue. Prerequisites ------------- diff --git a/source/reference/minio-mc/mc-pipe.rst b/source/reference/minio-mc/mc-pipe.rst index 96981150..f086c4e7 100644 --- a/source/reference/minio-mc/mc-pipe.rst +++ b/source/reference/minio-mc/mc-pipe.rst @@ -55,7 +55,7 @@ Parameters .. mc-cmd:: TARGET :required: - The full path to the :ref:`alias ` or prefix where the command should run. + The full path to the :ref:`alias ` or prefix where the command should run. .. mc-cmd:: --attr :optional: diff --git a/source/reference/minio-mc/mc-support-top-api.rst b/source/reference/minio-mc/mc-support-top-api.rst index 8b65e6e6..b5555c6a 100644 --- a/source/reference/minio-mc/mc-support-top-api.rst +++ b/source/reference/minio-mc/mc-support-top-api.rst @@ -23,7 +23,7 @@ The :mc:`mc support top api` command summarizes the real-time API events on a Mi .. tab-item:: EXAMPLE - The following command udisplays the current in-progress S3 API calls on the :term:`alias` ``myminio``. + The following command displays the current in-progress S3 API calls on the :term:`alias` ``myminio``. .. code-block:: shell :class: copyable @@ -55,7 +55,7 @@ Parameters :required: The full path to the alias, prefix, or object where the command should run. - The path must include at least an :ref:`ALIAS `. + The path must include at least an :ref:`ALIAS `. .. mc-cmd:: --name :optional: diff --git a/source/reference/minio-mc/mc-support-top-disk.rst b/source/reference/minio-mc/mc-support-top-disk.rst index c6074abb..31919513 100644 --- a/source/reference/minio-mc/mc-support-top-disk.rst +++ b/source/reference/minio-mc/mc-support-top-disk.rst @@ -23,7 +23,7 @@ The :mc:`mc support top disk` command displays current disk statistics. .. tab-item:: EXAMPLE - The following command udisplays the current in-progress S3 API calls on the :term:`alias` ``myminio``. + The following command displays the current in-progress S3 API calls on the :term:`alias` ``myminio``. .. code-block:: shell :class: copyable @@ -51,7 +51,7 @@ Parameters .. mc-cmd:: TARGET :required: - The full path to the :ref:`alias ` or :term:`prefix` where the command should run. + The full path to the :ref:`alias ` or :term:`prefix` where the command should run. .. mc-cmd:: --count, -c :optional: diff --git a/source/reference/minio-mc/mc-support-top-locks.rst b/source/reference/minio-mc/mc-support-top-locks.rst index 063f9b48..d1723c35 100644 --- a/source/reference/minio-mc/mc-support-top-locks.rst +++ b/source/reference/minio-mc/mc-support-top-locks.rst @@ -51,7 +51,7 @@ Parameters .. mc-cmd:: TARGET :required: - The full path to the :ref:`alias ` or prefix where the command should run. + The full path to the :ref:`alias ` or prefix where the command should run. .. mc-cmd:: --stale :optional: diff --git a/source/reference/minio-mc/mc-undo.rst b/source/reference/minio-mc/mc-undo.rst index 8bc4b579..98f291bd 100644 --- a/source/reference/minio-mc/mc-undo.rst +++ b/source/reference/minio-mc/mc-undo.rst @@ -57,7 +57,7 @@ Parameters :required: The full path to the object or prefix where the command should run. - The path must include the :ref:`ALIAS `, bucket, and prefix or object name. + The path must include the :ref:`ALIAS `, bucket, and prefix or object name. .. mc-cmd:: --last :optional: