diff options
authorJeff Darcy <>2014-04-15 18:06:24 +0000
committerVijay Bellur <>2014-04-16 10:37:34 -0700
commitd6ad57239d396f31ae0cd21e2e8e5db64aae5714 (patch)
parent686ee24a80c6ee7a5135aace8c2536f2afbcf367 (diff)
doc: add documentation for NUFA feature
Change-Id: I00f1c669d4ebc61f09c50f8de4c893907f6d75c2 BUG: 1086745 Signed-off-by: Jeff Darcy <> Reviewed-on: Reviewed-by: Niels de Vos <> Reviewed-by: Vijay Bellur <> Tested-by: Vijay Bellur <>
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/features/ b/doc/features/
new file mode 100644
index 000000000..03b8194b4
--- /dev/null
+++ b/doc/features/
@@ -0,0 +1,20 @@
+# 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
+## 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.