YARN-11632. [Doc] Add allow-partial-result description to Yarn Federation documentation. (#6340) Contributed by Shilun Fan.

Reviewed-by: Inigo Goiri <inigoiri@apache.org>
Signed-off-by: Shilun Fan <slfan1989@apache.org>
This commit is contained in:
slfan1989 2024-01-03 07:17:37 +08:00 committed by GitHub
parent 0b43026cab
commit 556fbcf025
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -606,6 +606,18 @@ We allow the Router to initiate a separate thread for periodically monitoring th
**Note** We don't need to configure the subCluster deregister checking threads for all Routers; using 1-2 Routers for checking is sufficient. **Note** We don't need to configure the subCluster deregister checking threads for all Routers; using 1-2 Routers for checking is sufficient.
#### How to configure allow partial result
The Router is used to connect multiple YARN SubClusters and plays a role in merging the returned results from multiple subClusters for certain interfaces. However, if a subcluster undergoes RM upgrade or encounters RM failure, calling that particular RM will not return the correct results.
To address this issue, the Router provides configuration that allows returning partial results. When we configure the relevant parameters, the Router will skip the failed subClusters and only return results from the other subClusters.
This ensures that we can obtain at least some correct results.
| Property | Example | Description |
|:------------------------------------------------------|:--------|:----------------------------------------------|
| `yarn.router.interceptor.allow-partial-result.enable` | `false` | Whether to support returning partial results. |
**Note** It is important to note that even if we configure the parameters, if all sub-clusters return failures, the Router will still throw an exception. This is because there are no available results to return, making it impossible to provide a valid response.
#### How to use Router Command Line #### How to use Router Command Line
##### Cmd1: deregisterSubCluster ##### Cmd1: deregisterSubCluster