From dae02ea70d41cd602c4e48357b85715de96045c2 Mon Sep 17 00:00:00 2001 From: ravindk89 Date: Tue, 10 Aug 2021 14:16:16 -0400 Subject: [PATCH] Include NFS consistency warning on standalone pages --- .../installation/deploy-minio-standalone.rst | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/source/installation/deploy-minio-standalone.rst b/source/installation/deploy-minio-standalone.rst index fa9ac2ac..a23e42b0 100644 --- a/source/installation/deploy-minio-standalone.rst +++ b/source/installation/deploy-minio-standalone.rst @@ -28,6 +28,18 @@ The following procedure deploys MinIO in :guilabel:`Standalone Mode` consisting of a single MinIO server and a single drive or storage volume. Standalone deployments are best suited for evaluation and initial development environments. +.. admonition:: Network File System Volumes Break Consistency Guarantees + :class: note + + MinIO's strict **read-after-write** and **list-after-write** consistency + model requires local disk filesystems (``xfs``, ``ext4``, etc.). + + MinIO cannot provide consistency guarantees if the underlying storage + volumes are NFS or a similar network-attached storage volume. + + For deployments that *require* using network-attached storage, use + NFSv4 for best results. + 1) Download and Run MinIO Server ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -208,6 +220,18 @@ The procedure uses `Podman `__ for running the MinIO container in rootfull mode. Configuring for rootless mode is out of scope for this procedure. +.. admonition:: Network File System Volumes Break Consistency Guarantees + :class: note + + MinIO's strict **read-after-write** and **list-after-write** consistency + model requires local disk filesystems (``xfs``, ``ext4``, etc.). + + MinIO cannot provide consistency guarantees if the underlying storage + volumes are NFS or a similar network-attached storage volume. + + For deployments that *require* using network-attached storage, use + NFSv4 for best results. + 1) Create a Configuration File to store Environment Variables ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~