Skip to content

Building HBase

Jump to bottom
linuxonz edited this page Apr 10, 2025 · 42 revisions

Building HBase

The instructions provided below specify the steps to build HBase version 2.6.2 on Linux on IBM Z for following distributions:

  • RHEL (8.8, 8.10, 9.2, 9.4, 9.5)
  • SLES 15 SP6
  • Ubuntu (22.04, 24.04, 24.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 writable directory anywhere you'd like to place it.

1. Download and Install HBase

export SOURCE_ROOT=/<source_root>/

1.1. Install prerequisites

  • RHEL (8.8, 8.10, 9.2, 9.4, 9.5)
sudo yum install -y git wget tar make gcc ant hostname curl
  • SLES 15 SP6
sudo zypper install -y git wget tar make gcc ant gawk gzip hostname curl
  • Ubuntu (22.04, 24.04, 24.10)
sudo apt update
sudo apt-get install -y git wget tar make gcc libjffi-jni hostname curl
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/s390x-linux-gnu/jni/

1.2. Install JDK

  • With Eclipse Adoptium Temurin Runtime (previously known as AdoptOpenJDK hotspot)

    • Download and install Eclipse Adoptium Temurin Runtime (Java 11 or 17) from here.

  • With OpenJDK

    • RHEL (8.8, 8.10, 9.2, 9.4, 9.5)

      • Java 8
      sudo yum install -y java-1.8.0-openjdk-devel
      • Java 11
      sudo yum install -y java-11-openjdk-devel
      • Java 17
      sudo yum install -y java-17-openjdk-devel

    • SLES 15 SP6

      • Java 8
      sudo zypper install -y java-1_8_0-openjdk-devel
      • Java 11
      sudo zypper install -y java-11-openjdk-devel
      • Java 17
      sudo zypper install -y java-17-openjdk-devel

    • Ubuntu (22.04, 24.04, 24.10)

      • Java 8
      sudo apt-get install -y openjdk-8-jdk
      • Java 11
      sudo apt-get install -y openjdk-11-jdk
      • Java 17
      sudo  apt-get -y install openjdk-17-jdk

1.3. Build libjffi (Only on RHEL and SLES)

Note: HBase needs a native library (libjffi-1.2.so: java foreign language interface). Build with java 8!

cd $SOURCE_ROOT
wget https://github.com/jnr/jffi/archive/jffi-1.2.23.tar.gz
tar -xzvf jffi-1.2.23.tar.gz
cd jffi-jffi-1.2.23
ant
export LD_LIBRARY_PATH=${SOURCE_ROOT}/jffi-jffi-1.2.23/build/jni/${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}

1.4. Download the HBase binary

cd $SOURCE_ROOT
wget https://archive.apache.org/dist/hbase/2.6.2/hbase-2.6.2-bin.tar.gz
tar zxf hbase-2.6.2-bin.tar.gz
export PATH=$SOURCE_ROOT/hbase-2.6.2/bin:$PATH

1.5. Set the environment

 export JAVA_HOME=<path to Java installation directory>
 export PATH=$JAVA_HOME/bin:$PATH

2. Verification (optional)

Use the following commands to run HBase server:

cd hbase-2.6.2/bin
start-hbase.sh

The HBase Web UI could be accessed from http://<IP or domain name of the host>:16010 after HBase server is successfully started. Then use the following command to run hbase shell:

hbase shell

The output should contain logs similar to:

Version 2.6.2, r6b3b36b429cf9a9d74110de79eb3b327b29ebf17, Fri Feb 14 14:39:16 UTC 2025

In hbase shell console, type in the following commands:

Version 2.6.2, r6b3b36b429cf9a9d74110de79eb3b327b29ebf17, Fri Feb 14 14:39:16 UTC 2025
Took 0.0035 seconds                                                                                                                                                                           
hbase:001:0> create 'test', 'cf'
Created table test
Took 3.1871 seconds                                                                                                                                                                           
=> Hbase::Table - test
hbase:002:0> list 'test'
TABLE                                                                                                                                                                                         
test                                                                                                                                                                                          
1 row(s)
Took 0.2189 seconds                                                                                                                                                                           
=> ["test"]
hbase:003:0> put 'test', 'row1', 'cf:a', 'value1'
Took 0.4500 seconds                                                                                                                                                                           
hbase:004:0> put 'test', 'row2', 'cf:b', 'value2'
Took 0.0228 seconds                                                                                                                                                                           
hbase:005:0> put 'test', 'row3', 'cf:c', 'value3'
Took 0.0250 seconds                                                                                                                                                                           
hbase:006:0> scan 'test'
ROW                                              COLUMN+CELL                                                                                                                                  
 row1                                            column=cf:a, timestamp=2025-04-08T10:56:58.540, value=value1                                                                                 
 row2                                            column=cf:b, timestamp=2025-04-08T10:57:03.684, value=value2                                                                                 
 row3                                            column=cf:c, timestamp=2025-04-08T10:57:09.491, value=value3                                                                                 
3 row(s)
Took 0.1471 seconds                                                                                                                                                                           
hbase:007:0> get 'test', 'row1'
COLUMN                                           CELL                                                                                                                                         
 cf:a                                            timestamp=2025-04-08T10:56:58.540, value=value1                                                                                              
1 row(s)
Took 0.1627 seconds                                                                                                                                                                           
hbase:008:0> exit

If your session looks similar to the above, congrats, your standalone HBase server is operational!

Use the following commands to stop HBase server:

stop-hbase.sh

References:

The information provided in this article is accurate at the time of writing, but on-going development in the open-source projects involved may make the information incorrect or obsolete. Please open issue or contact us on IBM Z Community if you have any questions or feedback.

Clone this wiki locally