diff --git a/hadoop-yarn-project/CHANGES.txt b/hadoop-yarn-project/CHANGES.txt
index 3923fc270b..1966bd2019 100644
--- a/hadoop-yarn-project/CHANGES.txt
+++ b/hadoop-yarn-project/CHANGES.txt
@@ -120,6 +120,9 @@ Release 2.5.0 - UNRELEASED
YARN-2054. Better defaults for YARN ZK configs for retries and retry-inteval
when HA is enabled. (kasha)
+ YARN-2010. Document yarn.resourcemanager.zk-auth and its scope.
+ (Robert Kanter via kasha)
+
OPTIMIZATIONS
BUG FIXES
diff --git a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-common/src/main/resources/yarn-default.xml b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-common/src/main/resources/yarn-default.xml
index 944677a8c6..c94b782e2d 100644
--- a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-common/src/main/resources/yarn-default.xml
+++ b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-common/src/main/resources/yarn-default.xml
@@ -372,6 +372,18 @@
yarn.resourcemanager.zk-state-store.root-node.acl
+
+
+ Specify the auths to be used for the ACL's specified in both the
+ yarn.resourcemanager.zk-acl and
+ yarn.resourcemanager.zk-state-store.root-node.acl properties. This
+ takes a comma-separated list of authentication mechanisms, each of the
+ form 'scheme:auth' (the same syntax used for the 'addAuth' command in
+ the ZK CLI).
+
+ yarn.resourcemanager.zk-auth
+
+
URI pointing to the location of the FileSystem path where
RM state will be stored. This must be supplied when using