You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kylin.apache.org by sh...@apache.org on 2018/03/15 08:08:00 UTC

[kylin] branch document updated: update FAQ with password changing

This is an automated email from the ASF dual-hosted git repository.

shaofengshi pushed a commit to branch document
in repository https://gitbox.apache.org/repos/asf/kylin.git


The following commit(s) were added to refs/heads/document by this push:
     new e3fb24d  update FAQ with password changing
e3fb24d is described below

commit e3fb24d00c63e9d545b6914f2d10e695baf3e1fe
Author: shaofengshi <sh...@apache.org>
AuthorDate: Thu Mar 15 16:07:29 2018 +0800

    update FAQ with password changing
---
 website/_docs21/gettingstarted/faq.md    | 34 +++++++++++++++++++++++++++++++
 website/_docs23/gettingstarted/events.md |  2 ++
 website/_docs23/gettingstarted/faq.md    | 35 ++++++++++++++++++++++++++++++++
 website/_docs23/install/kylin_aws_emr.md |  7 ++-----
 website/_docs23/install/kylin_cluster.md |  8 ++++++--
 5 files changed, 79 insertions(+), 7 deletions(-)

diff --git a/website/_docs21/gettingstarted/faq.md b/website/_docs21/gettingstarted/faq.md
index bf75829..fd6f02a 100644
--- a/website/_docs21/gettingstarted/faq.md
+++ b/website/_docs21/gettingstarted/faq.md
@@ -115,5 +115,39 @@ group by a.slr_sgmt
   * User may get this error when first time run hbase client, please check the error trace to see whether there is an error saying couldn't access a folder like "/hadoop/hbase/local/jars"; If that folder doesn't exist, create it.
 
 
+#### 14. How to update the default password for 'ADMIN'?
+  * By default, Kylin uses a simple, configuration based user registry; The default administrator 'ADMIN' with password 'KYLIN' is hard-coded in `kylinSecurity.xml`. To modify the password, you need firstly get the new password's encrypted value (with BCrypt), and then set it in `kylinSecurity.xml`. Here is a sample with password 'ABCDE'
+  
+{% highlight Groff markup %}
+
+cd $KYLIN_HOME/tomcat/webapps/kylin/WEB-INF/lib
+
+java -classpath kylin-server-base-2.2.0.jar:spring-beans-4.3.10.RELEASE.jar:spring-core-4.3.10.RELEASE.jar:spring-security-core-4.2.3.RELEASE.jar:commons-codec-1.7.jar:commons-logging-1.1.3.jar org.apache.kylin.rest.security.PasswordPlaceholderConfigurer BCrypt ABCDE
+
+BCrypt encrypted password is:
+$2a$10$A7.J.GIEOQknHmJhEeXUdOnj2wrdG4jhopBgqShTgDkJDMoKxYHVu
+
+{% endhighlight %}
+
+Then you can set it into `kylinSecurity.xml'
+
+{% highlight Groff markup %}
+
+vi ./tomcat/webapps/kylin/WEB-INF/classes/kylinSecurity.xml
+
+{% endhighlight %}
+
+Replace the origin encrypted password with the new one: 
+{% highlight Groff markup %}
+
+        <bean class="org.springframework.security.core.userdetails.User" id="adminUser">
+            <constructor-arg value="ADMIN"/>
+            <constructor-arg
+                    value="$2a$10$A7.J.GIEOQknHmJhEeXUdOnj2wrdG4jhopBgqShTgDkJDMoKxYHVu"/>
+            <constructor-arg ref="adminAuthorities"/>
+        </bean>
+        
+{% endhighlight %}
 
+Restart Kylin to take effective. If you have multiple Kylin server as a cluster, do the same on each instance. 
 
diff --git a/website/_docs23/gettingstarted/events.md b/website/_docs23/gettingstarted/events.md
index 35d02fb..22f474e 100644
--- a/website/_docs23/gettingstarted/events.md
+++ b/website/_docs23/gettingstarted/events.md
@@ -20,5 +20,7 @@ __Conferences__
 
 __Meetup__
 
+
+* [Apache Kylin & Alluxio Meetup @Shanghai](http://huiyi.csdn.net/activity/product/goods_list?project_id=3746), in Shanghai, China, 1:00PM - 17:30PM, Sunday, 2018-1-21
 * [Apache Kylin Meetup @Bay Area](http://www.meetup.com/Cloud-at-ebayinc/events/218914395/), in San Jose, US, 6:00PM - 7:30PM, Thursday, 2014-12-04
 
diff --git a/website/_docs23/gettingstarted/faq.md b/website/_docs23/gettingstarted/faq.md
index c9a8998..a5a68ad 100644
--- a/website/_docs23/gettingstarted/faq.md
+++ b/website/_docs23/gettingstarted/faq.md
@@ -105,3 +105,38 @@ group by a.slr_sgmt
   * Please check the [post in mailing list](http://apache-kylin.74782.x6.nabble.com/JDBC-query-result-Date-column-get-wrong-value-td5370.html)
 
 
+#### 12. How to update the default password for 'ADMIN'?
+  * By default, Kylin uses a simple, configuration based user registry; The default administrator 'ADMIN' with password 'KYLIN' is hard-coded in `kylinSecurity.xml`. To modify the password, you need firstly get the new password's encrypted value (with BCrypt), and then set it in `kylinSecurity.xml`. Here is a sample with password 'ABCDE'
+  
+{% highlight Groff markup %}
+
+cd $KYLIN_HOME/tomcat/webapps/kylin/WEB-INF/lib
+
+java -classpath kylin-server-base-2.3.0.jar:spring-beans-4.3.10.RELEASE.jar:spring-core-4.3.10.RELEASE.jar:spring-security-core-4.2.3.RELEASE.jar:commons-codec-1.7.jar:commons-logging-1.1.3.jar org.apache.kylin.rest.security.PasswordPlaceholderConfigurer BCrypt ABCDE
+
+BCrypt encrypted password is:
+$2a$10$A7.J.GIEOQknHmJhEeXUdOnj2wrdG4jhopBgqShTgDkJDMoKxYHVu
+
+{% endhighlight %}
+
+Then you can set it into `kylinSecurity.xml'
+
+{% highlight Groff markup %}
+
+vi ./tomcat/webapps/kylin/WEB-INF/classes/kylinSecurity.xml
+
+{% endhighlight %}
+
+Replace the origin encrypted password with the new one: 
+{% highlight Groff markup %}
+
+        <bean class="org.springframework.security.core.userdetails.User" id="adminUser">
+            <constructor-arg value="ADMIN"/>
+            <constructor-arg
+                    value="$2a$10$A7.J.GIEOQknHmJhEeXUdOnj2wrdG4jhopBgqShTgDkJDMoKxYHVu"/>
+            <constructor-arg ref="adminAuthorities"/>
+        </bean>
+        
+{% endhighlight %}
+
+Restart Kylin to take effective. If you have multiple Kylin server as a cluster, do the same on each instance. 
\ No newline at end of file
diff --git a/website/_docs23/install/kylin_aws_emr.md b/website/_docs23/install/kylin_aws_emr.md
index d949ae5..a31347d 100644
--- a/website/_docs23/install/kylin_aws_emr.md
+++ b/website/_docs23/install/kylin_aws_emr.md
@@ -9,7 +9,7 @@ Many users run Hadoop on public Cloud like AWS today. Apache Kylin, compiled wit
 
 ### Recommended Version
 * AWS EMR 5.7 (for EMR 5.8 and above, please check [KYLIN-3129](https://issues.apache.org/jira/browse/KYLIN-3129))
-* Apache Kylin v2.2.0 for HBase 1.x
+* Apache Kylin v2.2.0 or above for HBase 1.x
 
 ### Start EMR cluster
 
@@ -161,7 +161,4 @@ To restart a cluster with the same HBase data, specify the same Amazon S3 locati
 ## Deploy Kylin in a dedicated EC2 
 
 Running Kylin in a dedicated client node (not master, core or task) is recommended. You can start a separate EC2 instance within the same VPC and subnet as your EMR, copy the Hadoop clients from master node to it, and then install Kylin in it. This can improve the stability of services in master node as well as Kylin itself. 
-	
-## Known issues on EMR
-* [KYLIN-3028](https://issues.apache.org/jira/browse/KYLIN-3028)
-* [KYLIN-3032](https://issues.apache.org/jira/browse/KYLIN-3032)
+	
\ No newline at end of file
diff --git a/website/_docs23/install/kylin_cluster.md b/website/_docs23/install/kylin_cluster.md
index 8ea381d..509c22a 100644
--- a/website/_docs23/install/kylin_cluster.md
+++ b/website/_docs23/install/kylin_cluster.md
@@ -21,8 +21,12 @@ A typical scenario is depicted in the following chart:
 If you are running Kylin in a cluster where you have multiple Kylin REST server instances, please make sure you have the following property correctly configured in ${KYLIN_HOME}/conf/kylin.properties for EVERY server instance.
 
 1. kylin.rest.servers 
-	List of web servers in use, this enables one web server instance to sync up with other servers. For example: kylin.rest.servers=sandbox1:7070,sandbox2:7070
-  
+	List of web servers in use, this enables one web server instance to sync up with other servers. For example: 
+
+```
+	kylin.rest.servers=host1:7070,host2:7070
+```
+
 2. kylin.server.mode
 	Make sure there is only one instance whose "kylin.server.mode" is set to "all"(or "job"), others should be "query"
 	

-- 
To stop receiving notification emails like this one, please contact
shaofengshi@apache.org.