Command Line Upgrade
Also available as:
loading table of contents...

Configuring and Upgrading Apache Zeppelin


The su commands in this section use zeppelin to represent the Zeppelin Service user. If you are using another name for your Apache Zeppelin Service user, you need to substitute your Zeppelin Service user name for zeppelin in each of the su commands

For HDP 2.6.0, use the Zeppelin version shipped with HDP 2.6.0.

If you have a previous version of Zeppelin, use the following steps to upgrade Zeppelin:

  1. Stop the Zeppelin server:

    su - zeppelin -c “/usr/hdp/current/zeppelin-server/bin/ stop”
  2. Migrate configurations from the old Zeppelin configuration directory, /etc/zeppelin/<old version> to /etc/zeppelin/conf. Update any references to the old version of hdp in the configuration files.

  3. Migrate existing notebooks to the new version. Copy the notebook directory recursively from the Zeppelin notebook folder for the previous HDP version, to the Zeppelin notebook folder in the new HDP version:

    cp -R /usr/hdp/ /usr/hdp/

  4. (Optional, for clusters using Active Directory authentication) The Active Directory class name changed in HDP 2.6.

    In /usr/hdp/current/zeppelin-server/conf/shiro.ini, change org.apache.zeppelin.server.ActiveDirectoryGroupRealm to org.apache.zeppelin.realm.ActiveDirectoryGroupRealm.

  5. Start the Zeppelin server:

    su - zeppelin -c “/usr/hdp/current/zeppelin-server/bin/ start”
  6. Validate the Zeppelin installation in one of the following ways:

    • Use the following command:

      su - zeppelin -c “/usr/hdp/current/zeppelin-server/bin/ status”
    • Check the status by opening the Zeppelin host in a web browser, with the port number that you configured for it in, for example, http://zeppelin.local:9995.