[ 
https://issues.apache.org/jira/browse/HADOOP-10922?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14118994#comment-14118994
 ] 

Larry McCay commented on HADOOP-10922:
--------------------------------------

Thank you for the detailed review.
I also anticipated moving a good bit of this to the design doc but it seemed 
some of the background was needed here in order to understand the provider.path 
config.

All of your points are clear and reasonable and I will make the changes. I need 
to figure out how to do the monospaced thing in apt. :)

b. What does "comma separated list of url syntax" mean? Should this say 
"comma-separated list of URIs"?
Is only the first provider consulted? That's what the example's descriptive 
text seems to indicate.

The comma-separated list determines the providers that are returned by the 
getProviders call. Once you get a list of providers consulting the is up to the 
consumer of the API. The Configuration.getPassword method actually consults 
them all until it finds the alias in a provider and returns that one.

Hope that makes sense and I will try and convey that in the documentation and 
clarify the example description so that when using the CLI you really should 
indicate specifically which provider you want with the -provider option and 
only provide one. For background info, the CLI implementation will affect the 
first non-transient provider in the path that it encounters. Transient 
providers are providers like UserProvider since they are not long term storage 
for passwords but are instead available for job access and cleaned up when 
done. That is definitely description for the design document.

> User documentation for CredentialShell
> --------------------------------------
>
>                 Key: HADOOP-10922
>                 URL: https://issues.apache.org/jira/browse/HADOOP-10922
>             Project: Hadoop Common
>          Issue Type: Improvement
>    Affects Versions: 2.6.0
>            Reporter: Andrew Wang
>            Assignee: Larry McCay
>         Attachments: HADOOP-10922-1.patch
>
>
> The CredentialShell needs end user documentation for the website.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to