Repository: ambari
Updated Branches:
  refs/heads/branch-2.1 6182ec1c2 -> fee0af148


AMBARI-13621. Improve Ranger configs labels as well as descriptions (Advanced 
Tab)


Project: http://git-wip-us.apache.org/repos/asf/ambari/repo
Commit: http://git-wip-us.apache.org/repos/asf/ambari/commit/fee0af14
Tree: http://git-wip-us.apache.org/repos/asf/ambari/tree/fee0af14
Diff: http://git-wip-us.apache.org/repos/asf/ambari/diff/fee0af14

Branch: refs/heads/branch-2.1
Commit: fee0af1483bf8d637798d027d5eb93d7ffe7656e
Parents: 6182ec1
Author: Gautam Borad <[email protected]>
Authored: Fri Oct 30 11:16:55 2015 +0530
Committer: Gautam Borad <[email protected]>
Committed: Fri Oct 30 12:09:31 2015 +0530

----------------------------------------------------------------------
 .../0.4.0/configuration/admin-properties.xml    | 10 +++----
 .../RANGER/0.4.0/configuration/ranger-env.xml   |  4 +--
 .../RANGER/configuration/ranger-admin-site.xml  |  6 ++--
 .../RANGER/configuration/ranger-env.xml         |  2 +-
 .../RANGER/configuration/ranger-ugsync-site.xml | 30 +++++++++++---------
 5 files changed, 27 insertions(+), 25 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/ambari/blob/fee0af14/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/admin-properties.xml
----------------------------------------------------------------------
diff --git 
a/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/admin-properties.xml
 
b/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/admin-properties.xml
index 0b02eb4..dd9a1b0 100644
--- 
a/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/admin-properties.xml
+++ 
b/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/admin-properties.xml
@@ -72,8 +72,8 @@
   <property>
     <name>db_root_user</name>
     <value>root</value>
-    <display-name>Ranger DB root user</display-name>
-    <description>Database admin user</description>
+    <display-name>Database Admintrator (DBA) username</display-name>
+    <description>Database admin user. This user should have DBA permission to 
create the Ranger Database and Ranger Database User</description>
     <value-attributes>
       <overridable>false</overridable>
     </value-attributes>
@@ -83,8 +83,8 @@
     <name>db_root_password</name>
     <value></value>
     <property-type>PASSWORD</property-type>
-    <display-name>Ranger DB root password</display-name>
-    <description>Database password for the database admin user-id</description>
+    <display-name>Database Admintrator (DBA) password</display-name>
+    <description>Database password for the database admin 
username</description>
     <value-attributes>
       <overridable>false</overridable>
     </value-attributes>
@@ -114,7 +114,7 @@
     <name>db_user</name>
     <value>rangeradmin</value>
     <display-name>Ranger DB username</display-name>
-    <description>Database user-id used for the Ranger schema</description>
+    <description>Database username used for the Ranger schema</description>
     <value-attributes>
       <overridable>false</overridable>
     </value-attributes>

http://git-wip-us.apache.org/repos/asf/ambari/blob/fee0af14/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/ranger-env.xml
----------------------------------------------------------------------
diff --git 
a/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/ranger-env.xml
 
b/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/ranger-env.xml
index 459d5ec..31608a9 100644
--- 
a/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/ranger-env.xml
+++ 
b/ambari-server/src/main/resources/common-services/RANGER/0.4.0/configuration/ranger-env.xml
@@ -24,7 +24,7 @@
     <name>ranger_user</name>
     <value>ranger</value>
     <property-type>USER</property-type>
-    <display-name>Used to create user and assign permission</display-name>
+    <display-name>Ranger User</display-name>
     <description>Ranger username</description>
     <value-attributes>
       <overridable>false</overridable>
@@ -35,7 +35,7 @@
     <name>ranger_group</name>
     <value>ranger</value>
     <property-type>GROUP</property-type>
-    <display-name>Used to create group and assign permission</display-name>
+    <display-name>Ranger Group</display-name>
     <description>Ranger group</description>
     <value-attributes>
       <overridable>false</overridable>

http://git-wip-us.apache.org/repos/asf/ambari/blob/fee0af14/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-admin-site.xml
----------------------------------------------------------------------
diff --git 
a/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-admin-site.xml
 
b/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-admin-site.xml
index 7e7c545..8835503 100644
--- 
a/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-admin-site.xml
+++ 
b/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-admin-site.xml
@@ -92,7 +92,7 @@
   <property>
     <name>ranger.jpa.jdbc.driver</name>
     <value>com.mysql.jdbc.Driver</value>
-    <description>JDBC driver class name</description>
+    <description>JDBC driver class name. Example: For Mysql: 
com.mysql.jdbc.Driver, For Oracle: oracle.jdbc.OracleDriver</description>
     <display-name>Driver class name for a JDBC Ranger database</display-name>
     <value-attributes>
       <overridable>false</overridable>
@@ -109,7 +109,7 @@
     <name>ranger.jpa.jdbc.url</name>
     <value>jdbc:mysql://localhost</value>
     <description>JDBC connect string - auto populated based on other 
values</description>
-    <display-name>JDBC connect string for a Ranger database</display-name>
+    <display-name>JDBC connect string</display-name>
     <value-attributes>
       <overridable>false</overridable>
     </value-attributes>
@@ -275,7 +275,7 @@
 
   <property>
     <name>ranger.ldap.ad.domain</name>
-    <display-name>Domain Name (AD specific)</display-name>
+    <display-name>Domain Name (Only for AD)</display-name>
     <value></value>
     <description>AD domain, only used if Authentication method is 
AD</description>
     <description></description>

http://git-wip-us.apache.org/repos/asf/ambari/blob/fee0af14/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-env.xml
----------------------------------------------------------------------
diff --git 
a/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-env.xml
 
b/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-env.xml
index 2506743..8693c46 100644
--- 
a/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-env.xml
+++ 
b/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-env.xml
@@ -30,7 +30,7 @@
     <name>create_db_dbuser</name>
     <value>true</value>
     <display-name>Setup Database and Databse User</display-name>
-    <description>If set to Yes, Ranger will Setup Database and Databse User. 
This will require to specify Database root user and password</description>
+    <description>If set to Yes, Ambari will create and setup Ranger Database 
and Database User. This will require to specify Database Admin user and 
password</description>
     <value-attributes>
       <type>value-list</type>
       <overridable>false</overridable>

http://git-wip-us.apache.org/repos/asf/ambari/blob/fee0af14/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-ugsync-site.xml
----------------------------------------------------------------------
diff --git 
a/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-ugsync-site.xml
 
b/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-ugsync-site.xml
index 22e53dc..e878d3d 100644
--- 
a/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-ugsync-site.xml
+++ 
b/ambari-server/src/main/resources/stacks/HDP/2.3/services/RANGER/configuration/ranger-ugsync-site.xml
@@ -66,7 +66,7 @@
     <name>ranger.usersync.enabled</name>
     <display-name>Enable User Sync</display-name>
     <value>false</value>
-    <description>Usersync enabled?</description>
+    <description>Should users and groups be synchronized to Ranger Database? 
Required to setup Ranger policies</description>
     <value-attributes>
       <empty-value-valid>true</empty-value-valid>
       <type>value-list</type>
@@ -120,12 +120,14 @@
     <name>ranger.usersync.unix.group.file</name>
     <display-name>Group File</display-name>
     <value>/etc/group</value>
+    <description>Location of the groups file on the linux server</description>
   </property>
 
   <property>
     <name>ranger.usersync.unix.password.file</name>
     <display-name>Password File</display-name>
     <value>/etc/passwd</value>
+    <description>Location of the password file on the linux 
server</description>
   </property>
 
   <property>
@@ -165,28 +167,28 @@
     <name>ranger.usersync.filesource.file</name>
     <display-name>File Name</display-name>
     <value>/tmp/usergroup.txt</value>
-    <description>/tmp/usergroup.json or /tmp/usergroup.csv or 
/tmp/usergroup.txt</description>
+    <description>Path to the file with the users and groups information. 
Example: /tmp/usergroup.json or /tmp/usergroup.csv or 
/tmp/usergroup.txt</description>
   </property>
 
   <property>
     <name>ranger.usersync.filesource.text.delimiter</name>
-    <display-name>Delimeter</display-name>
+    <display-name>Delimiter</display-name>
     <value>,</value>
     <description>Delimiter used in file, if File based user sync is 
used</description>
   </property>
 
   <property>
     <name>ranger.usersync.ldap.url</name>
-    <display-name>LDAP (AD) URL</display-name>
+    <display-name>LDAP/AD URL</display-name>
     <value></value>
-    <description>LDAP server URL. Example value = 
ldap://localhost:389</description>
+    <description>LDAP server URL. Example: value = ldap://localhost:389 or 
ldaps//localhost:636</description>
   </property>
 
   <property>
     <name>ranger.usersync.ldap.binddn</name>
     <display-name>​Bind User</display-name>
     <value></value>
-    <description>Full distinguished name (DN), including common name (CN), of 
an LDAP user account that has privileges to search for users. Example: 
cn=admin,dc=xasecure,dc=net</description>
+    <description>Full distinguished name (DN), including common name (CN), of 
an LDAP user account that has privileges to search for users. This user is used 
for searching the users. This could be read-only LDAP user. Example: 
cn=admin,dc=example,dc=com</description>
   </property>
 
   <property>
@@ -194,7 +196,7 @@
     <display-name>Bind User Password</display-name>
     <value></value>
     <property-type>PASSWORD</property-type>
-    <description>Password for the account that can search for 
users.</description>
+    <description>Password for the LDAP bind user used for searching 
users.</description>
   </property>
 
   <property>
@@ -244,7 +246,7 @@
     <name>ranger.usersync.ldap.user.objectclass</name>
     <display-name>User Object Class​</display-name>
     <value>person</value>
-    <description>LDAP User Object Class</description>
+    <description>LDAP User Object Class. Example: person or user</description>
   </property>
 
   <property>
@@ -264,7 +266,7 @@
     <name>ranger.usersync.ldap.user.nameattribute</name>
     <display-name>Username Attribute</display-name>
     <value></value>
-    <description>LDAP user name attribute</description>
+    <description>LDAP user name attribute. Example: sAMAccountName in AD, uid 
or cn in OpenLDAP</description>
   </property>
 
   <property>
@@ -280,7 +282,7 @@
     <name>ranger.usersync.ldap.user.groupnameattribute</name>
     <display-name>User Group Name Attribute</display-name>
     <value>memberof, ismemberof</value>
-    <description>LDAP user group name attribute</description>
+    <description>LDAP user group name attribute. Generally it is the same as 
username attribute. Example: sAMAccountName in AD, uid or cn in 
OpenLDAP</description>
   </property>
 
   <property>
@@ -331,7 +333,7 @@
     <name>ranger.usersync.group.usermapsyncenabled</name>
     <value>false</value>
     <display-name>Group User Map Sync</display-name>
-    <description>User map sync enabled?</description>
+    <description>Sync specific groups for users?</description>
     <value-attributes>
       <empty-value-valid>true</empty-value-valid>
       <type>value-list</type>
@@ -376,7 +378,7 @@
     <name>ranger.usersync.group.objectclass</name>
     <display-name>Group Object Class</display-name>
     <value></value>
-    <description></description>
+    <description>LDAP Group object class. Example: group</description>
   </property>
 
   <property>
@@ -393,14 +395,14 @@
     <name>ranger.usersync.group.nameattribute</name>
     <display-name>Group Name Attribute</display-name>
     <value></value>
-    <description>LDAP group name attribute</description>
+    <description>LDAP group name attribute. Example: cn</description>
   </property>
 
   <property>
     <name>ranger.usersync.group.memberattributename</name>
     <display-name>Group Member Attribute</display-name>
     <value></value>
-    <description>LDAP group member attribute name</description>
+    <description>LDAP group member attribute name. Example: 
member</description>
   </property>
 
   <property>

Reply via email to