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

Arpit Agarwal commented on HDFS-9415:
-------------------------------------

Thanks [~xiaobingo]. We should document the format of this setting with 
examples. {{AccessControlList.java}} has a good description that we can reuse.

{code}
   * The String is a a comma separated list of users and groups.
   * The user list comes first and is separated by a space followed 
   * by the group list. For e.g. "user1,user2 group1,group2"
{code}

We can add that both users and groups are optional. So "user1", " group1", "", 
"user1 group1", "user1,user2 group1,group2" are all valid (note the leading 
space in " group1").

Also for {{dfs.permissions.supergroup}}, we should document that it accepts a 
single group name as the value. I have seen some administrators try to 
incorrectly configure this as a comma separated list of groups.

> Document dfs.cluster.administrators and dfs.permissions.superusergroup
> ----------------------------------------------------------------------
>
>                 Key: HDFS-9415
>                 URL: https://issues.apache.org/jira/browse/HDFS-9415
>             Project: Hadoop HDFS
>          Issue Type: Improvement
>          Components: documentation
>            Reporter: Arpit Agarwal
>            Assignee: Xiaobing Zhou
>         Attachments: HDFS-9415.001.patch
>
>
> dfs.cluster.administrators and dfs.permissions.superusergroup documentation 
> is not clear enough.



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

Reply via email to