Skip to content

Commit aebca17

Browse files
committed
Add docs
1 parent d547551 commit aebca17

File tree

3 files changed

+60
-3
lines changed

3 files changed

+60
-3
lines changed

docs/_includes/themes/zeppelin/_navigation.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
<li><a href="{{BASE_PATH}}/index.html">What is Apache Zeppelin ?</a></li>
2222
<li role="separator" class="divider"></li>
2323
<li class="title"><span><b>Getting Started</b><span></li>
24-
<li><a href="{{BASE_PATH}}/install/install.html">Quick Start</a></li>
24+
<li><a href="{{BASE_PATH}}/install/install.html">Install</a></li>
2525
<li><a href="{{BASE_PATH}}/install/install.html#zeppelin-configuration">Configuration</a></li>
2626
<li><a href="{{BASE_PATH}}/quickstart/explorezeppelinui.html">Explore Zeppelin UI</a></li>
2727
<li><a href="{{BASE_PATH}}/quickstart/tutorial.html">Tutorial</a></li>

docs/install/install.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,8 @@ Although it can be unstable somehow since it is on development status, you can e
6262
If you want to install Apache Zeppelin with a stable binary package, please visit [Apache Zeppelin download Page](http://zeppelin.apache.org/download.html).
6363
After unpacking, jump to [Starting Apache Zeppelin with Command Line](#starting-apache-zeppelin-with-command-line) section.
6464

65+
If you have downloaded `netinst` binary, [install additional interpreters](http://localhost:4000/install/install.html#install-interpreters) or simply run `./bin/install-interpreter.sh --all` before you jump to [Starting Apache Zeppelin with Command Line](#starting-apache-zeppelin-with-command-line) section.
66+
6567
### Building from Source
6668
If you want to build from the source, the software below needs to be installed on your system.
6769

@@ -389,3 +391,56 @@ You can configure Apache Zeppelin with both **environment variables** in `conf/z
389391
<td>Size in characters of the maximum text message to be received by websocket.</td>
390392
</tr>
391393
</table>
394+
395+
## Install interpreters
396+
397+
You can install additional [interpreters](../manual/interpreters.html) using `bin/install-interpreter.sh` command.
398+
399+
### Community managed interpreters
400+
401+
Informations of community managed interpreters are listed in `conf/interpreter-list` file. `bin/install-interpreter.sh` command will read this file to install interpreters.
402+
403+
##### Install all community managed interpreters
404+
405+
```
406+
./bin/install-interpreter.sh --all
407+
```
408+
409+
##### Install specific interpreters
410+
411+
```
412+
./bin/install-interpreter.sh --name md,shell,jdbc,python
413+
```
414+
415+
You can get full list of community managed interpreters by running
416+
417+
```
418+
./bin/install-interpreter.sh --list
419+
```
420+
421+
Once you have installed interpreter, restart Zeppelin. And then you'll need [create interpreter setting](../manual/interpreters.html#what-is-zeppelin-interpreter) and [binding it with your notebook](../manual/interpreters.html#what-is-zeppelin-interpreter-setting).
422+
423+
424+
### 3rd party interpreters
425+
426+
`./bin/install-interpreter.sh` command can install 3rd party interpreters available in maven repository.
427+
428+
##### Install 3rd party interpreters
429+
430+
```
431+
./bin/install-interpreter.sh --name interpreter1 --repository groupId1:artifact1:version1
432+
```
433+
434+
The command will download maven artifact `groupId1:artifact1:version1` and all of it's transitive dependencies into `interpreter/interpreter1` directory.
435+
436+
Once you have installed interpreters, you'll need to add interpreter class name into `zeppelin.interpreters` property in [configuration](install.html#zeppelin-configuration).
437+
And then restart Zeppelin, [create interpreter setting](../manual/interpreters.html#what-is-zeppelin-interpreter) and [binding it with your notebook](../manual/interpreters.html#what-is-zeppelin-interpreter-setting).
438+
439+
440+
##### Install multiple 3rd party interpreters at once
441+
442+
`--name` and `--repository` argument receives comma separated list
443+
444+
```
445+
./bin/install-interpreter.sh --name interpreter1,interpreter2 --repository groupId1:artifact1:version1,groupId2:artifact2:version2
446+
```

zeppelin-zengine/src/main/java/org/apache/zeppelin/interpreter/InterpreterFactory.java

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -350,15 +350,17 @@ private void loadInterpreterDependencies(InterpreterSetting intSetting)
350350
List<Dependency> deps = intSetting.getDependencies();
351351
if (deps != null) {
352352
for (Dependency d: deps) {
353+
File destDir = new File(conf.getRelativeDir(ConfVars.ZEPPELIN_DEP_LOCALREPO));
354+
353355
if (d.getExclusions() != null) {
354356
depResolver.load(
355357
d.getGroupArtifactVersion(),
356358
d.getExclusions(),
357-
conf.getString(ConfVars.ZEPPELIN_DEP_LOCALREPO) + "/" + intSetting.id());
359+
new File(destDir, intSetting.id()));
358360
} else {
359361
depResolver.load(
360362
d.getGroupArtifactVersion(),
361-
conf.getString(ConfVars.ZEPPELIN_DEP_LOCALREPO) + "/" + intSetting.id());
363+
new File(destDir, intSetting.id()));
362364
}
363365
}
364366
}

0 commit comments

Comments
 (0)