Apache
/
hadoop
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

YARN-8938. Updated YARN service upgrade document. 

Contributed by Chandni Singh
This commit is contained in:
Eric Yang 2018-10-24 11:50:09 -04:00
parent 766b78ee07
commit bbc6dcd3d0
1 changed files with 36 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/yarn-service/ServiceUpgrade.md
View File

@ -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 `-autoFinalize` option. With auto-finalization, when all the component-instances of
the service have been upgraded, finalization will be performed automatically by the the service have been upgraded, finalization will be performed automatically by the
service framework.\ 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 ## Upgrade Example
This example shows upgrade of sleeper service. Below is the sleeper service 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 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
```