@@ -117,4 +117,9 @@ Kyuubi's internal is very simple to understand, which is shown as the picture be
-[Home Page](https://yaooqinn.github.io/kyuubi/)
\ No newline at end of file
+## Additional Documentations
+
+[Building Kyuubi](https://yaooqinn.github.io/kyuubi/docs/building.html)
+[Configuration Guide](https://yaooqinn.github.io/kyuubi/docs/configurations.html)
+[Authentication/Security Guide](https://yaooqinn.github.io/kyuubi/docs/authentication.html)
+[Home Page](https://yaooqinn.github.io/kyuubi/)
diff --git a/docs/authentication.md b/docs/authentication.md
index 981eee894..305bdcf86 100644
--- a/docs/authentication.md
+++ b/docs/authentication.md
@@ -1,4 +1,4 @@
-# Authentication/Security Guide
+# Kyuubi Authentication/Security Guide
Kyuubi supports Anonymous (no authentication) with and without SASL, Kerberos (GSSAPI), pass through LDAP between the Thrift client and itself.
## Configuration
@@ -46,4 +46,9 @@ $KYUUBI_HOME/bin/start-kyuubi.sh --conf spark.kyuubi.authentication=KERBEROS
$SPARK_HOME/bin/beeline -u "jdbc:hive2://${replace with spark.kyuubi.frontend.bind.host}:10000/;principal=${replace with spark.yarn.principal};hive.server2.proxy.user=yaooqinn"
```
-[Home Page](https://yaooqinn.github.io/kyuubi/)
\ No newline at end of file
+## Additional Documentations
+
+[Building Kyuubi](https://yaooqinn.github.io/kyuubi/docs/building.html)
+[Configuration Guide](https://yaooqinn.github.io/kyuubi/docs/configurations.html)
+[Kyuubi Architecture](https://yaooqinn.github.io/kyuubi/docs/architecture.html)
+[Home Page](https://yaooqinn.github.io/kyuubi/)
diff --git a/docs/building.md b/docs/building.md
index 9275d65c2..e52de98ea 100644
--- a/docs/building.md
+++ b/docs/building.md
@@ -37,4 +37,9 @@ With Maven, you can use the -DwildcardSuites flag to run individual Scala tests:
For more information about the ScalaTest Maven Plugin, refer to the [ScalaTest documentation](http://www.scalatest.org/user_guide/using_the_scalatest_maven_plugin).
-[Home Page](https://yaooqinn.github.io/kyuubi/)
\ No newline at end of file
+## Additional Documentations
+
+[Configuration Guide](https://yaooqinn.github.io/kyuubi/docs/configurations.html)
+[Authentication/Security Guide](https://yaooqinn.github.io/kyuubi/docs/authentication.html)
+[Kyuubi Architecture](https://yaooqinn.github.io/kyuubi/docs/architecture.html)
+[Home Page](https://yaooqinn.github.io/kyuubi/)
diff --git a/docs/configurations.md b/docs/configurations.md
index 3fecdb94a..19b768445 100644
--- a/docs/configurations.md
+++ b/docs/configurations.md
@@ -1,4 +1,4 @@
-# Configuration Guide
+# Kyuubi Configuration Guide
Kyuubi provides several kinds of properties to configure the system:
@@ -97,14 +97,23 @@ spark.kyuubi.operation.incremental.collect|false|Whether to use incremental resu
---
## Spark Configurations
+All properties of Spark can be set as servel level ones. Some of them only work for Kyuubi server itself and become unchangable, such as `spark.driver.memory` specifying the heap memory of server. Session level Spark properties take Server lever ones as default values and can be changed with session connection strings. And obviously, all sql properties of Spark can be set via `set` statement at runtime, such as `set spark.sql.autoBroadcastJoinThreshold=-1`
-Spark properties become session level options, which are used to generate a SparkContext instances and passed to Kyuubi Server by JDBC/ODBC connection strings. Setting them in `$SPARK_HOME/conf/spark-defaults.conf` supplies with default values for each session.
+#### Session Level
+Spark properties which becomes session level options, which are used to generate a `SparkContext` instances and passed to Kyuubi Server by JDBC/ODBC connection strings. Setting them in `$SPARK_HOME/conf/spark-defaults.conf` supplies with default values for each session.
+#### Server Level
Name|Default|Description
---|---|---
spark.driver.memory| 1g | Amount of memory to use for the Kyuubi Server instance. Set this through the --driver-memory command line option or in your default properties file.
spark.driver.extraJavaOptions| (none) | A string of extra JVM options to pass to the Kyuubi Server instance. For instance, GC settings or other logging. Set this through the --driver-java-options command line option or in your default properties file.
+Spark use netty as RPC between driver and executor, Kyuubi Server may need much bigger directory memory size.
+
+```properties
+spark.driver.extraJavaOptions -XX:PermSize=1024m -XX:MaxPermSize=1024m -XX:MaxDirectMemorySize=4096m
+```
+
Spark properties for [Driver](http://spark.apache.org/docs/latest/configuration.html#runtime-environment) like those above controls Kyuubi Server's own behaviors, while other properies could be set in JDBC/ODBC connection strings.
Please refer to the [Configuration Guide](http://spark.apache.org/docs/latest/configuration.html) in the online documentation for an overview on how to configure Spark.
@@ -117,4 +126,9 @@ These configurations are used for SparkSessin to talk to Hive MetaStore Server c
## Hadoop Configurations
Please refer to the [Apache Hadoop](http://hadoop.apache.org)'s online documentation for an overview on how to configure Hadoop.
-[Home Page](https://yaooqinn.github.io/kyuubi/)
\ No newline at end of file
+## Additional Documentations
+
+[Building Kyuubi](https://yaooqinn.github.io/kyuubi/docs/building.html)
+[Authentication/Security Guide](https://yaooqinn.github.io/kyuubi/docs/authentication.html)
+[Kyuubi Architecture](https://yaooqinn.github.io/kyuubi/docs/architecture.html)
+[Home Page](https://yaooqinn.github.io/kyuubi/)
diff --git a/patches/0001-support-multi-sc-for-diff-users-towards-spark-2.1-and-lower.patch b/patches/0001-support-multi-sc-for-diff-users-towards-spark-2.1-and-lower.patch
deleted file mode 100644
index 0f1838a70..000000000
--- a/patches/0001-support-multi-sc-for-diff-users-towards-spark-2.1-and-lower.patch
+++ /dev/null
@@ -1,60 +0,0 @@
-From b7ae7c5a7ef64d8209bc3ce4f8303d41470f8bc6 Mon Sep 17 00:00:00 2001
-From: Kent Yao