+
+ | Property |
+ Default |
+ Description |
+
+
+ | zeppelin.livy.master |
+ local[*] |
+ Spark master uri. ex) spark://masterhost:7077 |
+
+
+ | zeppelin.livy.url |
+ http://localhost:8998 |
+ URL where livy server is running |
+
+
+ | zeppelin.livy.spark.maxResult |
+ 1000 |
+ Max number of SparkSQL result to display. |
+
+
+
+
+
+## How to use
+Basically, you can use
+
+**spark**
+
+```
+%livy.spark
+sc.version
+```
+
+
+**pyspark**
+
+```
+%livy.pyspark
+print "1"
+```
+
+**sparkR**
+
+```
+%livy.sparkr
+hello <- function( name ) {
+ sprintf( "Hello, %s", name );
+}
+
+hello("livy")
+```
+
+## Impersonation
+When Zeppelin server is running with authentication enabled, then this interpreter utilizes Livy’s user impersonation feature i.e. sends extra parameter for creating and running a session ("proxyUser": "${loggedInUser}"). This is particularly useful when multi users are sharing a Notebook server.
+
+
+### Apply Zeppelin Dynamic Forms
+You can leverage [Zeppelin Dynamic Form]({{BASE_PATH}}/manual/dynamicform.html). You can use both the `text input` and `select form` parameterization features.
+
+```
+%livy.pyspark
+print "${group_by=product_id,product_id|product_name|customer_id|store_id}"
+```
+
+## FAQ
+
+Livy debugging: If you see any of these in error console
+
+> Connect to livyhost:8998 [livyhost/127.0.0.1, livyhost/0:0:0:0:0:0:0:1] failed: Connection refused
+
+Looks like the livy server is not up yet or the config is wrong
+
+> Exception: Session not found, Livy server would have restarted, or lost session.
+
+The session would have timed out, you may need to restart the interpreter.
+
+
+> Blacklisted configuration values in session config: spark.master
+
+edit `conf/spark-blacklist.conf` file in livy server and comment out `#spark.master` line.
diff --git a/livy/pom.xml b/livy/pom.xml
new file mode 100644
index 00000000000..6ad96221a89
--- /dev/null
+++ b/livy/pom.xml
@@ -0,0 +1,170 @@
+
+
+
+