Manual upgrade procedure for Zeppelin
Basically, newer version of Zeppelin works with previous version notebook directory and configurations.
So, copying notebook
and conf
directory should be enough.
Instructions
- Stop Zeppelin:
bin/zeppelin-daemon.sh stop
- Copy your
notebook
andconf
directory into a backup directory - Download newer version of Zeppelin and Install. See Install Guide.
- Copy backup
notebook
andconf
directory into newer version of Zeppelinnotebook
andconf
directory - Start Zeppelin:
bin/zeppelin-daemon.sh start
Migration Guide
Breaking changes in 0.8.x
From 0.8, Zeppelin has a new type of permission - Runners
As Runners list is empty in note so everybody can view note although Readers list is not empty.
To set all your "writers" to "runners":
1. Copy notebook
and conf
directories to 0.8.0,
2. Move directory docs/assets/themes/zeppelin/note/FixReaders to new notebook
directory,
3. Start the new Zeppelin and run note System/Migrate from 0.7.
Upgrading from Zeppelin 0.7 to 0.8
- From 0.8, we recommend to use
PYSPARK_PYTHON
andPYSPARK_DRIVER_PYTHON
instead ofzeppelin.pyspark.python
aszeppelin.pyspark.python
only effects driver. You can usePYSPARK_PYTHON
andPYSPARK_DRIVER_PYTHON
as using them in spark. - From 0.8, depending on your device, the keyboard shortcut
Ctrl-L
orCommand-L
which goes to the line somewhere user wants is not supported.
Upgrading from Zeppelin 0.6 to 0.7
- From 0.7, we don't use
ZEPPELIN_JAVA_OPTS
as default value ofZEPPELIN_INTP_JAVA_OPTS
and also the same forZEPPELIN_MEM
/ZEPPELIN_INTP_MEM
. If user want to configure the jvm opts of interpreter process, please setZEPPELIN_INTP_JAVA_OPTS
andZEPPELIN_INTP_MEM
explicitly. If you don't setZEPPELIN_INTP_MEM
, Zeppelin will set it to-Xms1024m -Xmx1024m -XX:MaxPermSize=512m
by default. - Mapping from
%jdbc(prefix)
to%prefix
is no longer available. Instead, you can use %[interpreter alias] with multiple interpreter setttings on GUI. - Usage of
ZEPPELIN_PORT
is not supported in ssl mode. Instead useZEPPELIN_SSL_PORT
to configure the ssl port. Value fromZEPPELIN_PORT
is used only whenZEPPELIN_SSL
is set tofalse
. - The support on Spark 1.1.x to 1.3.x is deprecated.
- From 0.7, we uses
pegdown
as themarkdown.parser.type
option for the%md
interpreter. Rendered markdown might be different from what you expected - From 0.7 note.json format has been changed to support multiple outputs in a paragraph. Zeppelin will automatically convert old format to new format. 0.6 or lower version can read new note.json format but output will not be displayed. For the detail, see ZEPPELIN-212 and pull request.
- From 0.7 note storage layer will utilize
GitNotebookRepo
by default instead ofVFSNotebookRepo
storage layer, which is an extension of latter one with versioning capabilities on top of it.