diff --git a/source/administration/object-management/object-versioning.rst b/source/administration/object-management/object-versioning.rst index c64c996c..a0763c3a 100644 --- a/source/administration/object-management/object-versioning.rst +++ b/source/administration/object-management/object-versioning.rst @@ -132,6 +132,10 @@ following commands: - :mc-cmd:`mc rm --versions --older-than ` - Removes all versions of an object older than the specified calendar date. +.. versionadded:: RELEASE.2024-04-18T19-09-19Z + + MinIO emits a warning if the cumulative size of versions for any single object exceeds 1TiB. + .. _minio-bucket-versioning-id: Version ID Generation diff --git a/source/default-conf.py b/source/default-conf.py index 6fa802f6..bd6350fb 100644 --- a/source/default-conf.py +++ b/source/default-conf.py @@ -61,7 +61,7 @@ 's3-docs' : ('https://docs.aws.amazon.com/AmazonS3/latest/userguide/%s', None), 's3-api' : ('https://docs.aws.amazon.com/AmazonS3/latest/API/%s', None), 'iam-docs' : ('https://docs.aws.amazon.com/IAM/latest/UserGuide/%s', None), - 'minio-release' : ('https://github.com/minio/minio/releases/tag/%s', None), + 'minio-release' : ('https://github.com/minio/minio/releases/tag/%s', '%s'), 'mc-release' : ('https://github.com/minio/mc/releases/tag/%s', None), 'prometheus-docs' : ('https://prometheus.io/docs/%s', None), 'podman-docs' : ('https://docs.podman.io/en/latest/%s', None), diff --git a/source/includes/linux/common-installation.rst b/source/includes/linux/common-installation.rst index 6778d2dc..6d29c8dc 100644 --- a/source/includes/linux/common-installation.rst +++ b/source/includes/linux/common-installation.rst @@ -198,7 +198,7 @@ operating systems using RPM, DEB, or binary: wget https://dl.min.io/server/minio/release/linux-amd64/minio chmod +x minio - sudo mv minio /usr/local/bin/ + sudo mv -f ./minio /usr/local/bin/minio Replace ``/usr/local/bin`` with the location of the existing MinIO binary. Run ``which minio`` to identify the path if not already known. diff --git a/source/includes/linux/steps-upgrade-minio-deployment.rst b/source/includes/linux/steps-upgrade-minio-deployment.rst index 6d284fa8..d8fa02a8 100644 --- a/source/includes/linux/steps-upgrade-minio-deployment.rst +++ b/source/includes/linux/steps-upgrade-minio-deployment.rst @@ -63,17 +63,20 @@ Update ``systemctl``-Managed MinIO Deployments Use these steps to upgrade a MinIO deployment where the MinIO server process is managed by ``systemctl``, such as those created using the MinIO :ref:`DEB/RPM packages `. +This procedure assumes you have the :envvar:`MINIO_CONFIG_ENV_FILE` variable set on all MinIO nodes. + 1. Update the MinIO Binary on Each Node .. include:: /includes/linux/common-installation.rst :start-after: start-upgrade-minio-binary-desc :end-before: end-upgrade-minio-binary-desc + Run ``minio --version`` on each node to validate that you successfully upgraded all binaries to the same version. + Do **not** proceed unless all nodes use the same MinIO binary version. + 2. Restart the Deployment Run the :mc-cmd:`mc admin service restart` command to restart all MinIO server processes in the deployment simultaneously. - - The restart process typically completes within a few seconds and is *non-disruptive* to ongoing operations. .. code-block:: shell :class: copyable @@ -82,6 +85,8 @@ Use these steps to upgrade a MinIO deployment where the MinIO server process is Replace :ref:`alias ` of the MinIO deployment to restart. + S3-compatible SDKs and applications should retry operations automatically, such that the restart process is typically *non-disruptive* to ongoing operations. + 3. Validate the Upgrade Use the :mc:`mc admin info` command to check that all MinIO servers are online, operational, and reflect the installed MinIO version. @@ -150,7 +155,7 @@ The command overwrites the existing ``minio`` binary at that path. wget https://dl.min.io/server/minio/release/linux-amd64/minio chmod +x ./minio - sudo mv -f ./minio /usr/local/bin/ + sudo mv -f ./minio /usr/local/bin/minio Once you have replaced the binary on all MinIO hosts in the deployment, you must restart all nodes simultaneously. diff --git a/source/operations/install-deploy-manage/upgrade-minio-deployment.rst b/source/operations/install-deploy-manage/upgrade-minio-deployment.rst index 7b238f19..3c50e14b 100644 --- a/source/operations/install-deploy-manage/upgrade-minio-deployment.rst +++ b/source/operations/install-deploy-manage/upgrade-minio-deployment.rst @@ -10,6 +10,10 @@ Upgrade a MinIO Deployment :local: :depth: 2 +.. important:: + + For deployments older than :minio-release:`RELEASE.2024-03-30T09-41-56Z` running with :ref:`AD/LDAP ` enabled, you **must** read through the release notes for :minio-release:`RELEASE.2024-04-18T19-09-19Z` before starting this procedure. + You must take the extra steps documented in the linked release as part of the upgrade. .. cond:: linux diff --git a/source/operations/install-deploy-manage/upgrade-minio-tenant.rst b/source/operations/install-deploy-manage/upgrade-minio-tenant.rst index ada06976..c0ecdda8 100644 --- a/source/operations/install-deploy-manage/upgrade-minio-tenant.rst +++ b/source/operations/install-deploy-manage/upgrade-minio-tenant.rst @@ -10,6 +10,11 @@ Upgrade a MinIO Tenant :local: :depth: 1 +.. important:: + + For Tenants using a MinIO Image older than :minio-release:`RELEASE.2024-03-30T09-41-56Z` running with :ref:`AD/LDAP ` enabled, you **must** read through the release notes for :minio-release:`RELEASE.2024-04-18T19-09-19Z` before starting this procedure. + You must take the extra steps documented in the linked release as part of the upgrade procedure. + .. _minio-upgrade-tenant-plugin: Upgrade the Tenant using the MinIO Kubernetes Plugin diff --git a/source/url-excludes.yaml b/source/url-excludes.yaml index a45b377a..e2023ea4 100644 --- a/source/url-excludes.yaml +++ b/source/url-excludes.yaml @@ -9,6 +9,7 @@ excludes: - 'operations/install-deploy-manage/delete-minio-tenant.rst' - 'operations/install-deploy-manage/minio-operator-console.rst' - 'operations/install-deploy-manage/deploy-minio-tenant-helm.rst' +- 'operations/install-deploy-manage/deploy-operator-kustomize.rst' - 'operations/deploy-manage-tenants.rst' - 'developers/sts-for-operator.rst' - 'reference/kubectl-minio-plugin.rst' @@ -43,6 +44,7 @@ excludes: - 'operations/install-deploy-manage/delete-minio-tenant.rst' - 'operations/install-deploy-manage/minio-operator-console.rst' - 'operations/install-deploy-manage/deploy-minio-tenant-helm.rst' +- 'operations/install-deploy-manage/deploy-operator-kustomize.rst' - 'operations/deploy-manage-tenants.rst' - 'reference/kubectl-minio-plugin*' - 'reference/minio-server*' @@ -75,6 +77,7 @@ excludes: - 'operations/install-deploy-manage/delete-minio-tenant.rst' - 'operations/install-deploy-manage/minio-operator-console.rst' - 'operations/install-deploy-manage/deploy-minio-tenant-helm.rst' +- 'operations/install-deploy-manage/deploy-operator-kustomize.rst' - 'operations/deploy-manage-tenants.rst' - 'reference/kubectl-minio-plugin*' - 'reference/minio-server*' @@ -104,6 +107,7 @@ excludes: - 'operations/install-deploy-manage/expand-minio-deployment.rst' - 'operations/deploy-manage-tenants.rst' - 'operations/install-deploy-manage/deploy-minio-tenant-helm.rst' +- 'operations/install-deploy-manage/deploy-operator-kustomize.rst' - 'reference/kubectl-minio-plugin*' - 'reference/minio-server*' - 'reference/minio-mc*'