You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-commits@hadoop.apache.org by ey...@apache.org on 2018/10/24 15:52:12 UTC

hadoop git commit: YARN-8938. Updated YARN service upgrade document. Contributed by Chandni Singh

Repository: hadoop
Updated Branches:
  refs/heads/trunk 766b78ee0 -> bbc6dcd3d


YARN-8938.  Updated YARN service upgrade document.
            Contributed by Chandni Singh


Project: http://git-wip-us.apache.org/repos/asf/hadoop/repo
Commit: http://git-wip-us.apache.org/repos/asf/hadoop/commit/bbc6dcd3
Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/bbc6dcd3
Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/bbc6dcd3

Branch: refs/heads/trunk
Commit: bbc6dcd3d0976932a49d8650804fb0a4018b3a02
Parents: 766b78e
Author: Eric Yang <ey...@apache.org>
Authored: Wed Oct 24 11:50:09 2018 -0400
Committer: Eric Yang <ey...@apache.org>
Committed: Wed Oct 24 11:51:44 2018 -0400

----------------------------------------------------------------------
 .../markdown/yarn-service/ServiceUpgrade.md     | 38 ++++++++++++++++++--
 1 file changed, 36 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/hadoop/blob/bbc6dcd3/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/yarn-service/ServiceUpgrade.md
----------------------------------------------------------------------
diff --git a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/yarn-service/ServiceUpgrade.md b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/yarn-service/ServiceUpgrade.md
index 839be22..559d9cd 100644
--- a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/yarn-service/ServiceUpgrade.md
+++ b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/yarn-service/ServiceUpgrade.md
@@ -47,8 +47,21 @@ A service can be auto-finalized when the upgrade is initialized with
 `-autoFinalize` option. With auto-finalization, when all the component-instances of
 the service have been upgraded, finalization will be performed automatically by the
 service framework.\
-\
-**NOTE**: Cancel of upgrade is not implemented yet.
+
+Hadoop 3.2.0 onwards canceling upgrade and express upgrade is also supported.
+
+1. Cancel upgrade.\
+Before the upgrade of the service is finalized, the user has an option to cancel
+the upgrade. This step resolves the dependencies between the components and then
+sequentially rolls back each component which was upgraded.
+
+2. Express upgrade.\
+This is a one-step process to upgrade all the components of the service. It involves
+providing the service spec of the newer version of the service. The service master
+then performs the following steps automatically:\
+a. Discovers all the components that require an upgrade.\
+b. Resolve dependencies between these components.\
+c. Triggers upgrade of the components sequentially.
 
 ## Upgrade Example
 This example shows upgrade of sleeper service. Below is the sleeper service
@@ -195,3 +208,24 @@ e.g. The command below finalizes the upgrade of `my-sleeper`:
 ```
 yarn app -upgrade my-sleeper -finalize
 ```
+
+### Cancel Upgrade
+User can cancel an upgrade before it is finalized using the below command:
+```
+yarn app -upgrade ${service_name} -cancel
+```
+e.g. Before the upgrade is finalized, the command below cancels the upgrade of
+`my-sleeper`:
+```
+yarn app -upgrade my-sleeper -cancel
+```
+
+### Express Upgrade
+User can upgrade a service in one using the below command:
+```
+yarn app -upgrade ${service_name} -express ${path_to_new_service_def_file}
+```
+e.g. The command below express upgrades `my-sleeper`:
+```
+yarn app -upgrade my-sleeper -express sleeper_v101.json
+```
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: common-commits-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-commits-help@hadoop.apache.org