From 64e93189f194729b098ce83f6c8f077d2b8d35ab Mon Sep 17 00:00:00 2001
From: Karthik Kambatla <kasha@apache.org>
Date: Mon, 24 Mar 2014 23:27:12 +0000
Subject: [PATCH] HADOOP-10423. Clarify compatibility policy document for
 combination of new client and old server. (Chris Nauroth via kasha)

git-svn-id: https://svn.apache.org/repos/asf/hadoop/common/branches/branch-2@1581117 13f79535-47bb-0310-9956-ffa450edef68
---
 hadoop-common-project/hadoop-common/CHANGES.txt          | 3 +++
 .../hadoop-common/src/site/apt/Compatibility.apt.vm      | 9 +++++++++
 2 files changed, 12 insertions(+)

diff --git a/hadoop-common-project/hadoop-common/CHANGES.txt b/hadoop-common-project/hadoop-common/CHANGES.txt
index e310faa93d4..b9adb41bdcb 100644
--- a/hadoop-common-project/hadoop-common/CHANGES.txt
+++ b/hadoop-common-project/hadoop-common/CHANGES.txt
@@ -80,6 +80,9 @@ Release 2.4.0 - UNRELEASED
     HADOOP-10015. UserGroupInformation prints out excessive warnings.
     (Nicolas Liochon via szetszwo)
 
+    HADOOP-10423. Clarify compatibility policy document for combination of 
+    new client and old server. (Chris Nauroth via kasha)
+
   OPTIMIZATIONS
 
   BUG FIXES
diff --git a/hadoop-common-project/hadoop-common/src/site/apt/Compatibility.apt.vm b/hadoop-common-project/hadoop-common/src/site/apt/Compatibility.apt.vm
index e3c4a4daf1c..ecf6e75f3bc 100644
--- a/hadoop-common-project/hadoop-common/src/site/apt/Compatibility.apt.vm
+++ b/hadoop-common-project/hadoop-common/src/site/apt/Compatibility.apt.vm
@@ -124,6 +124,15 @@ hand-in-hand to address this.
     (cluster) to a later version (or vice versa).  For example, a
     Hadoop 2.1.0 client talking to a Hadoop 2.3.0 cluster.
 
+    * Client-Server compatibility is also required to allow users to upgrade the
+    client before upgrading the server (cluster).  For example, a Hadoop 2.4.0
+    client talking to a Hadoop 2.3.0 cluster.  This allows deployment of
+    client-side bug fixes ahead of full cluster upgrades.  Note that new cluster
+    features invoked by new client APIs or shell commands will not be usable.
+    YARN applications that attempt to use new APIs (including new fields in data
+    structures) that have not yet deployed to the cluster can expect link
+    exceptions.
+
     * Client-Server compatibility is also required to allow upgrading
     individual components without upgrading others. For example,
     upgrade HDFS from version 2.1.0 to 2.2.0 without upgrading MapReduce.