Skip to content

Commit 821f1b0

Browse files
authored
HBASE-29100 Document Hadoop-less assembly (#6675)
Signed-off-by: Duo Zhang <[email protected]>
1 parent 035be4d commit 821f1b0

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

src/main/asciidoc/_chapters/configuration.adoc

+22
Original file line numberDiff line numberDiff line change
@@ -453,6 +453,7 @@ expressly advises downstream users to avoid running on top of this release. For
453453
the link:https://s.apache.org/hadoop-3.1.0-announcement[release announcement for Hadoop 3.1.0].
454454
====
455455

456+
[[note_replace_hadoop]]
456457
.Replace the Hadoop Bundled With HBase!
457458
[NOTE]
458459
====
@@ -707,6 +708,27 @@ An example of such an HDFS client configuration is `dfs.replication`.
707708
If for example, you want to run with a replication factor of 5, HBase will create files with the
708709
default of 3 unless you do the above to make the configuration available to HBase.
709710

711+
[[byo-hadoop-assembly]]
712+
=== Choosing between the Classic Package and the BYO Hadoop Package
713+
714+
Starting with HBase 3.0, HBase includes two binary packages. The classic package
715+
includes both the HBase and Hadoop components, while the Hadoop-less "Bring Your Own Hadoop"
716+
package omits the Hadoop components, and uses the files from an existing Hadoop installation.
717+
The classic binary package filename is named `hbase-<version>-bin.tar.gz` i.e.
718+
_hbase-3.0.0-bin.tar.gz_ , while the Hadoop-less package is
719+
`hbase-byo-hadoop-<version>-bin.tar.gz` i.e. _hbase-byo-hadoop-3.0.0-bin.tar.gz_.
720+
721+
If the cluster nodes already have Hadoop installed, you can use the Hadoop-less package.
722+
In this case you need to make sure that the `HADOOP_HOME` environment variable is set and
723+
points to the Hadoop installation.
724+
The easiest way to ensure this is to set it in _hbase-env.sh_. You still need to make sure that
725+
the Hadoop configuration files are present on the HBase classpath, as described above.
726+
727+
.Advantages of the BYO Hadoop package
728+
* There is no need to replace the Hadoop libraries, as noted <<note_replace_hadoop,above>>.
729+
* It is easier to upgrade Hadoop and HBase independently (as long as compatible versions are used).
730+
* Both the package and installed size are about 100 MB smaller.
731+
710732
[[confirm]]
711733
== Running and Confirming Your Installation
712734

0 commit comments

Comments
 (0)