This is an automated email from the ASF dual-hosted git repository.
snemeth pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/hadoop.git
The following commit(s) were added to refs/heads/trunk by this push:
new ebf6b14 YARN-10123. Error message around yarn app -stop/start can be
improved. Contributed by Siddharth Ahuja
ebf6b14 is described below
commit ebf6b14c6794acd89d947c7b1ddb4d8d707b6f45
Author: Szilard Nemeth <snem...@apache.org>
AuthorDate: Fri Apr 23 22:48:33 2021 +0200
YARN-10123. Error message around yarn app -stop/start can be improved.
Contributed by Siddharth Ahuja
This is required to highlight that an implementation at framework level is
needed for the stop/start functionality to work.
---
.../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 2fd59a8..b9f7248 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 3082ff8..123ff6b 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
