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/65f83703
Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/65f83703
Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/65f83703
Branch: refs/heads/HDFS-13891
Commit: 65f83703eba768f878db297fa295f9be60f28316
Parents: 9b50ad6
Author: Eric Yang <[email protected]>
Authored: Wed Oct 24 11:50:09 2018 -0400
Committer: Brahma Reddy Battula <[email protected]>
Committed: Tue Oct 30 11:31:17 2018 +0530
----------------------------------------------------------------------
.../markdown/yarn-service/ServiceUpgrade.md | 38 ++++++++++++++++++--
1 file changed, 36 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/hadoop/blob/65f83703/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: [email protected]
For additional commands, e-mail: [email protected]
