From d6ad57239d396f31ae0cd21e2e8e5db64aae5714 Mon Sep 17 00:00:00 2001 From: Jeff Darcy Date: Tue, 15 Apr 2014 18:06:24 +0000 Subject: doc: add documentation for NUFA feature Change-Id: I00f1c669d4ebc61f09c50f8de4c893907f6d75c2 BUG: 1086745 Signed-off-by: Jeff Darcy Reviewed-on: http://review.gluster.org/7489 Reviewed-by: Niels de Vos Reviewed-by: Vijay Bellur Tested-by: Vijay Bellur --- doc/features/nufa.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 doc/features/nufa.md diff --git a/doc/features/nufa.md b/doc/features/nufa.md new file mode 100644 index 000000000..03b8194b4 --- /dev/null +++ b/doc/features/nufa.md @@ -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 +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. + -- cgit