[
https://issues.apache.org/jira/browse/YARN-7415?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Atul Kulkarni updated YARN-7415:
Priority: Major (was: Minor)
> RM Rest API Submit application documentation not easy to understand
> ---
>
> Key: YARN-7415
> URL: https://issues.apache.org/jira/browse/YARN-7415
> Project: Hadoop YARN
> Issue Type: Bug
> Components: api, docs, documentation
>Affects Versions: 2.7.3
>Reporter: Atul Kulkarni
> Labels: documentation, newbie, rest_api
>
> This specifically pertains to the "Cluster Applications API(Submit
> Application)" documentation
> This line - “Please note that in order to submit an app, you must have an
> authentication filter setup for the HTTP interface. The functionality
> requires that a username is set in the HttpServletRequest. If no filter is
> setup, the response will be an “UNAUTHORIZED” response.” is NOT very helpful
> in conveying to the user what needs to happen on the client side or on the
> REST API side.
> Specifically,
> 1. "Authentication filter setup for the HTTP interface" -
> * Now does this mean that one needs Kerberos enabled on the cluster?
> * If not, what kind of HTTP authentication filter needs to be setup on the
> httpd or on the client side? A few wikipedia or other links to do this would
> go long way in increasing adoption of the RM REST API.
> 2. "The functionality requires that a username is set in the
> HttpServletRequest" -
> * HttpServletRequest is a Java class - does the REST API mandate integrations
> use Java?
> * If not what would be an equivalent of that in normal HTTP REST Parlance?
> This will help people understand what to do when using Python etc.
> I frustrated myself with this documentation over the last few days and very
> many "tutorials" that claim to make it work on production clusters and
> finally reached this conclusion that - if this documentation can be improved,
> it would save everyone a LOT of time and effort.
> I am happy to help fix this - I have no experience contributing to apache
> projects and may make mistakes but I am willing to learn. I would need
> answers to the above questions to be able to do anything with this. I still
> have not figured out how to run the job without hdfs complaining about user
> permissions. Which I am guessing are related.
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
-
To unsubscribe, e-mail: yarn-issues-unsubscr...@hadoop.apache.org
For additional commands, e-mail: yarn-issues-h...@hadoop.apache.org
