This is an automated email from the ASF dual-hosted git repository.
snemeth pushed a commit to branch branch-3.2
in repository https://gitbox.apache.org/repos/asf/hadoop.git
The following commit(s) were added to refs/heads/branch-3.2 by this push:
new 3951fb6 YARN-10123. Error message around yarn app -stop/start can be
improved. Contributed by Siddharth Ahuja
3951fb6 is described below
commit 3951fb6dea172cf669cf3c5a19ffa7486aeccc6f
Author: Szilard Nemeth <snem...@apache.org>
AuthorDate: Sat May 22 14:35:47 2021 +0200
YARN-10123. Error message around yarn app -stop/start can be improved.
Contributed by Siddharth Ahuja
---
.../apache/hadoop/yarn/client/api/AppAdminClient.java | 4 +++-
.../hadoop-yarn-site/src/site/markdown/YarnCommands.md | 18 +++++++++---------
2 files changed, 12 insertions(+), 10 deletions(-)
diff --git
a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-common/src/main/java/org/apache/hadoop/yarn/client/api/AppAdminClient.java
b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-common/src/main/java/org/apache/hadoop/yarn/client/api/AppAdminClient.java
index b0d737a..a70c5f3 100644
---
a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-common/src/main/java/org/apache/hadoop/yarn/client/api/AppAdminClient.java
+++
b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-common/src/main/java/org/apache/hadoop/yarn/client/api/AppAdminClient.java
@@ -74,7 +74,9 @@ public abstract class AppAdminClient extends CompositeService
{
}
if (!clientClassMap.containsKey(appType)) {
throw new IllegalArgumentException("App admin client class name not " +
- "specified for type " + appType);
+ "specified for type " + appType + ". Please ensure " + appType +
+ " framework has provided a client implementation to handle" +
+ " this functionality.");
}
String clientClassName = clientClassMap.get(appType);
Class<? extends AppAdminClient> clientClass;
diff --git
a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/YarnCommands.md
b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/YarnCommands.md
index 44819d9..3617bb6 100644
---
a/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/YarnCommands.md
+++
b/hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site/src/site/markdown/YarnCommands.md
@@ -51,21 +51,21 @@ Usage: `yarn app [options] `
| -changeQueue \<Queue Name\> | Moves application to a new queue.
ApplicationId can be passed using 'appId' option. 'movetoqueue' command is
deprecated, this new command 'changeQueue' performs same functionality. |
| -component \<Component Name\> \<Count\> | Works with -flex option to change
the number of components/containers running for an application / long-running
service. Supports absolute or relative changes, such as +1, 2, or -3. |
| -components \<Components\> | Works with -upgrade option to trigger the
upgrade of specified components of the application. Multiple components should
be separated by commas. |
-| -decommission \<Application Name\> | Decommissions component instances for
an application / long-running service. Requires -instances option. Supports
-appTypes option to specify which client implementation to use. |
-| -destroy \<Application Name\> | Destroys a saved application specification
and removes all application data permanently. Supports -appTypes option to
specify which client implementation to use. |
-| -enableFastLaunch | Uploads AM dependencies to HDFS to make future launches
faster. Supports -appTypes option to specify which client implementation to
use. |
-| -flex \<Application Name or ID\> | Changes number of running containers for
a component of an application / long-running service. Requires -component
option. If name is provided, appType must be provided unless it is the default
yarn-service. If ID is provided, the appType will be looked up. Supports
-appTypes option to specify which client implementation to use. |
+| -decommission \<Application Name\> | Decommissions component instances for
an application / long-running service. Requires -instances option. Supports
-appTypes option to specify which client implementation to use. Please ensure
the framework corresponding to appType has provided the appropriate client
implementation to handle this specific functionality. |
+| -destroy \<Application Name\> | Destroys a saved application specification
and removes all application data permanently. Supports -appTypes option to
specify which client implementation to use. Please ensure the framework
corresponding to appType has provided the appropriate client implementation to
handle this specific functionality. |
+| -enableFastLaunch | Uploads AM dependencies to HDFS to make future launches
faster. Supports -appTypes option to specify which client implementation to
use. Please ensure the framework corresponding to appType has provided the
appropriate client implementation to handle this specific functionality. |
+| -flex \<Application Name or ID\> | Changes number of running containers for
a component of an application / long-running service. Requires -component
option. If name is provided, appType must be provided unless it is the default
yarn-service. If ID is provided, the appType will be looked up. Supports
-appTypes option to specify which client implementation to use. Please ensure
the framework corresponding to appType has provided the appropriate client
implementation to handle this speci [...]
| -help | Displays help for all commands. |
| -instances \<Component Instances\> | Works with -upgrade option to trigger
the upgrade of specified component instances of the application. Also works
with -decommission option to decommission specified component instances.
Multiple instances should be separated by commas. |
| -kill \<Application ID\> | Kills the application. Set of applications can be
provided separated with space |
-| -launch \<Application Name\> \<File Name\> | Launches application from
specification file (saves specification and starts application). Options
-updateLifetime and -changeQueue can be specified to alter the values provided
in the file. Supports -appTypes option to specify which client implementation
to use. |
+| -launch \<Application Name\> \<File Name\> | Launches application from
specification file (saves specification and starts application). Options
-updateLifetime and -changeQueue can be specified to alter the values provided
in the file. Supports -appTypes option to specify which client implementation
to use. Please ensure the framework corresponding to appType has provided the
appropriate client implementation to handle this specific functionality. |
| -list | List applications. Supports optional use of -appTypes to filter
applications based on application type, -appStates to filter applications based
on application state and -appTags to filter applications based on application
tag. |
| -movetoqueue \<Application ID\> | Moves the application to a different
queue. Deprecated command. Use 'changeQueue' instead. |
| -queue \<Queue Name\> | Works with the movetoqueue command to specify which
queue to move an application to. |
-| -save \<Application Name\> \<File Name\> | Saves specification file for an
application. Options -updateLifetime and -changeQueue can be specified to alter
the values provided in the file. Supports -appTypes option to specify which
client implementation to use. |
-| -start \<Application Name\> | Starts a previously saved application.
Supports -appTypes option to specify which client implementation to use. |
-| -status \<ApplicationId or ApplicationName\> | Prints the status of the
application. If app ID is provided, it prints the generic YARN application
status. If name is provided, it prints the application specific status based on
app's own implementation, and -appTypes option must be specified unless it is
the default `yarn-service` type.|
-| -stop \<Application Name or ID\> | Stops application gracefully (may be
started again later). If name is provided, appType must be provided unless it
is the default yarn-service. If ID is provided, the appType will be looked up.
Supports -appTypes option to specify which client implementation to use. |
+| -save \<Application Name\> \<File Name\> | Saves specification file for an
application. Options -updateLifetime and -changeQueue can be specified to alter
the values provided in the file. Supports -appTypes option to specify which
client implementation to use. Please ensure the framework corresponding to
appType has provided the appropriate client implementation to handle this
specific functionality. |
+| -start \<Application Name\> | Starts a previously saved application.
Supports -appTypes option to specify which client implementation to use. Please
ensure the framework corresponding to appType has provided the appropriate
client implementation to handle this specific functionality. |
+| -status \<ApplicationId or ApplicationName\> | Prints the status of the
application. If app ID is provided, it prints the generic YARN application
status. If name is provided, it prints the application specific status based on
app's own implementation, and -appTypes option must be specified unless it is
the default `yarn-service` type. Please ensure the framework corresponding to
appType has provided the appropriate client implementation to handle this
specific functionality.|
+| -stop \<Application Name or ID\> | Stops application gracefully (may be
started again later). If name is provided, appType must be provided unless it
is the default yarn-service. If ID is provided, the appType will be looked up.
Supports -appTypes option to specify which client implementation to use. Please
ensure the framework corresponding to appType has provided the appropriate
client implementation to handle this specific functionality. |
| -updateLifetime \<Timeout\> | Update timeout of an application from NOW.
ApplicationId can be passed using 'appId' option. Timeout value is in seconds. |
| -updatePriority \<Priority\> | Update priority of an application.
ApplicationId can be passed using 'appId' option. |
---------------------------------------------------------------------
To unsubscribe, e-mail: common-commits-unsubscr...@hadoop.apache.org
For additional commands, e-mail: common-commits-h...@hadoop.apache.org
