[2/2] incubator-kudu git commit: Update upgrade instructions for 0.7.0

[jd...@apache.org]

Update upgrade instructions for 0.7.0

This patch also changes the way we track upgrade instructions. From now
on we'll only give the instructions from going to the previous latest
to the newest. This makes sense since we don't test upgrading from
other versions, nor do we want to.

Change-Id: I8be0ef7ca5f32f1f91504866dfe34a6be0550705
Reviewed-on: http://gerrit.cloudera.org:8080/2353
Reviewed-by: Misty Stanley-Jones <mi...@apache.org>
Tested-by: Kudu Jenkins
Reviewed-by: Todd Lipcon <to...@apache.org>


Project: http://git-wip-us.apache.org/repos/asf/incubator-kudu/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-kudu/commit/8eec83f9
Tree: http://git-wip-us.apache.org/repos/asf/incubator-kudu/tree/8eec83f9
Diff: http://git-wip-us.apache.org/repos/asf/incubator-kudu/diff/8eec83f9

Branch: refs/heads/master
Commit: 8eec83f9579e80afa8e8b2c6293433ce68e77d39
Parents: b250bc0
Author: Jean-Daniel Cryans <jd...@apache.org>
Authored: Mon Feb 29 11:01:37 2016 -0800
Committer: Jean-Daniel Cryans <jd...@gerrit.cloudera.org>
Committed: Wed Mar 2 00:30:57 2016 +0000

----------------------------------------------------------------------
 docs/installation.adoc  | 26 ++++++++++++++------------
 docs/release_notes.adoc |  4 ++--
 2 files changed, 16 insertions(+), 14 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-kudu/blob/8eec83f9/docs/installation.adoc
----------------------------------------------------------------------
diff --git a/docs/installation.adoc b/docs/installation.adoc
index 0772574..cdc9746 100644
--- a/docs/installation.adoc
+++ b/docs/installation.adoc
@@ -621,37 +621,39 @@ in `java/kudu-client/target/apidocs/index.html`.
 // end::view_api[]
 
 [[upgrade]]
-== Upgrade from 0.5.0 to 0.6.0
+== Upgrade from 0.6.0 to 0.7.0
 
-Before upgrading, see <<client_compatibility_0.6.0>> and <<api_compatibility_0.6.0>>.
-To upgrade from Kudu 0.5.0 to 0.6.0, perform the following high-level steps, which
-are detailed in <<upgrade_procedure_0.6.0>>:
+Before upgrading, see <<client_compatibility>> and <<api_compatibility>>.
+To upgrade from Kudu 0.6.0 to 0.7.0, perform the following high-level steps, which
+are detailed in <<upgrade_procedure>>:
 
 . Shut down all Kudu services.
-. Install the new Kudu packages or parcels, or install Kudu 0.6.0 from source.
+. Install the new Kudu packages or parcels, or install Kudu 0.7.0 from source.
 . Restart all Kudu services.
 
 It is technically possible to upgrade Kudu using rolling restarts, but it has not
 been tested and is not recommended.
 
-[[client_compatibility_0.6.0]]
+NOTE: For the duration of the Kudu Beta, upgrade instructions are only given for going
+from the previous latest version to the newest.
+
+[[client_compatibility]]
 === Client compatibility
 
-Kudu 0.6.0 maintains wire compatibility with Kudu 0.5.0. This means that a Kudu 0.6.0
-client can communicate with a Kudu 0.5.0 cluster, and vice versa. For that reason,
+Kudu 0.7.0 maintains wire compatibility with previous versions. This means that a Kudu 0.7.0
+client can communicate with a Kudu 0.6.0 cluster, and vice versa. For that reason,
 you do not need to upgrade client JARs at the same time the cluster is upgraded.
 
 The same wire compatibility guarantees apply to the Impala_Kudu fork that was released
 with Kudu 0.5.0.
 
-[[api_compatibility_0.6.0]]
+[[api_compatibility]]
 
 === API Compatibility
 
-The Kudu 0.6.0 client API is not compatible with the Kudu 0.5.0 client API. See the
-link:release_notes.html#0.6.0[Kudu 0.6.0 release notes] for details.
+The Kudu 0.7.0 client API is compatible with Kudu 0.6.0.
 
-[[upgrade_procedure_0.6.0]]
+[[upgrade_procedure]]
 === Upgrade procedure
 
 . Stop the Kudu master and tablet server services:

http://git-wip-us.apache.org/repos/asf/incubator-kudu/blob/8eec83f9/docs/release_notes.adoc
----------------------------------------------------------------------
diff --git a/docs/release_notes.adoc b/docs/release_notes.adoc
index 2e3f7ae..463989e 100644
--- a/docs/release_notes.adoc
+++ b/docs/release_notes.adoc
@@ -64,6 +64,8 @@ See also +++<a href="https://issues.cloudera.org/issues/?jql=project%20%3D%20Kud
 for Kudu 0.7.0</a>+++ and +++<a href="https://github.com/apache/incubator-kudu/compare/branch-0.6.0...branch-0.7.0">Git
 changes between 0.6.0 and 0.7.0</a>+++.
 
+The upgrade instructions can be found at link:installation.html#upgrade[Upgrade from 0.6.0 to 0.7.0].
+
 [[rn_0.7.0_incompatible_changes]]
 ==== Incompatible changes
 
@@ -163,8 +165,6 @@ consistent with the C++ client.
 . OSX is now supported for single-host development. Please consult its specific installation
 instructions in link:installation.html#osx_from_source[OS X].
 
-The upgrade instructions are situated at link:installation.html#upgrade[Upgrade from 0.5.0 to 0.6.0].
-
 ==== Limitations
 
 See also <<beta_limitations>>. Where applicable, this list adds to or overrides that