summaryrefslogtreecommitdiffstats
path: root/doc/features/nufa.md
diff options
context:
space:
mode:
authorJeff Darcy <jdarcy@redhat.com>2014-04-15 18:06:24 +0000
committerVijay Bellur <vbellur@redhat.com>2014-04-16 06:37:12 -0700
commit1341dd0683aefd96496e44dfb8f15cb612ff7646 (patch)
tree30ff2643f9e9ac65734573f700cb1dbc4f8a4fd5 /doc/features/nufa.md
parent983c05e0da68fe65a9d028df0ec04d2271e9a4d3 (diff)
doc: add documentation for NUFA feature
Change-Id: I00f1c669d4ebc61f09c50f8de4c893907f6d75c2 BUG: 1086745 Signed-off-by: Jeff Darcy <jdarcy@redhat.com> Reviewed-on: http://review.gluster.org/7490 Reviewed-by: Niels de Vos <ndevos@redhat.com> Reviewed-by: Lalatendu Mohanty <lmohanty@redhat.com> Reviewed-by: Humble Devassy Chirammal <humble.devassy@gmail.com> Tested-by: Gluster Build System <jenkins@build.gluster.com>
Diffstat (limited to 'doc/features/nufa.md')
-rw-r--r--doc/features/nufa.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/features/nufa.md b/doc/features/nufa.md
new file mode 100644
index 00000000000..342acafb711
--- /dev/null
+++ b/doc/features/nufa.md
@@ -0,0 +1,19 @@
+# NUFA Translator
+
+The NUFA ("Non Uniform File Access") is a variant of the DHT ("Distributed Hash
+Table") translator, intended for use with workloads that have a high locality
+of reference. Instead of placing new files pseudo-randomly, it places them on
+the same nodes where they are created so that future accesses can be made
+locally. For replicated volumes, this means that one copy will be local and
+others will be remote; the read-replica selection mechanisms will then favor
+the local copy for reads. For non-replicated volumes, the only copy will be
+local.
+
+## Interface
+
+Use of NUFA is controlled by a volume option, as follows.
+
+ gluster volume set myvolume cluster.nufa on
+
+This will cause the NUFA translator to be used wherever the DHT translator
+otherwise would be. The rest is all automatic.