Building Apache Zeppelin

Building Apache Zeppelin

The instructions provided below specify the steps to build Apache Zeppelin version 0.7.3 on Linux on IBM Z for the following distributions:

• RHEL (7.1, 7.2, 7.3, 7.4)
• SLES (12, 12 SP1, 12 SP2, 12 SP3)
• Ubuntu (16.04, 17.10)

General Notes:

• When following the steps below please use a standard permission user unless otherwise specified.
• A directory /<source_root>/ will be referred to in these instructions, this is a temporary writeable directory anywhere you'd like to place it.

Step 1 : Install Dependencies

1.1) Install packages

• RHEL (7.1, 7.2, 7.3, 7.4)

  sudo yum install git tar wget  java-1.8.0-openjdk-headless java-1.8.0-openjdk-devel
  

• SLES 12

  sudo zypper install java-1_7_0-openjdk-devel java-1_7_0-openjdk-headless java-1_7_0-openjdk tar wget git 
  

• SLES (12 SP1, 12 SP2, 12 SP3)

  sudo zypper install git tar wget java-1_8_0-openjdk java-1_8_0-openjdk-devel 
  

• Ubuntu (16.04, 17.10)

  sudo apt-get update
  sudo apt-get install git tar wget maven openjdk-8-jdk-headless openjdk-8-jdk 
  

1.2 ) Download maven binary executable (Only for RHEL/SLES)

cd /<source_root>/ 
wget https://archive.apache.org/dist/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz
tar -zxvf apache-maven-3.3.9-bin.tar.gz
export PATH=/<source_root>/apache-maven-3.3.9/bin:$PATH

1.3) Set environment variable

export MAVEN_OPTS="-Xmx2g -XX:MaxPermSize=1024m"
export JAVA_HOME=/usr/lib64/jvm/java                 # SLES(12, 12 SP1, 12 SP2, 12 SP3)
export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-s390x   # Ubuntu (16.04, 17.10)
export JAVA_HOME=/usr/lib/jvm/java                   # RHEL (7.1, 7.2, 7.3, 7.4)
export PATH=$JAVA_HOME/bin:$PATH

1.4) Install Yarn

• For Ubuntu

  cd /<source_root>/
  wget https://github.com/yarnpkg/yarn/releases/download/v0.24.1/yarn_0.24.1_all.deb
  sudo dpkg -i yarn_0.24.1_all.deb
  

• For RHEL and SLES

  cd /<source_root>/
  wget https://yarnpkg.com/latest.tar.gz
  tar zvxf latest.tar.gz
  export PATH=$PATH:/<source_root>/dist/bin
  

Step 2 : Build and Install Apache Zeppelin

2.1) Download source

git clone https://github.com/apache/zeppelin.git
cd zeppelin/
git checkout v0.7.3

2.2) Edit /<source_root>/zeppelin/zeppelin-web/pom.xml

@@ -44,7 +44,7 @@
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

     <!--plugin versions-->
-    <plugin.frontned.version>1.3</plugin.frontned.version>
+    <plugin.frontned.version>1.5</plugin.frontned.version>
   </properties>

   <build>

2.3) Build Apache Zeppelin

cd <source_root>/zeppelin/
mvn clean package -DskipTests

Step 3 : Testing (Optional)

cd <source_root>/zeppelin/
mvn clean package 

Note:

• Individual test case can be executed by running command mvn clean test in the respective modules

• Test case failures in modules Zengine , Spark , python Interpreter , web Application, server can be ignored as they are seen on x86 system as well

• Test case failures in modules Cassandra passed on increasing server wait time in Achilles source code

Step 4 : Start Apache Zeppelin

cd /<source_root>/zeppelin/
bin/zeppelin-daemon.sh start 

Open http://<ip_address>:8080/#/ in your browser to access Web UI.

References

• https://zeppelin.apache.org/