diff --git a/bin/hbase b/bin/hbase
index 4489a3f33919..f1ffb11f3d1d 100755
--- a/bin/hbase
+++ b/bin/hbase
@@ -729,6 +729,13 @@ elif [ "$COMMAND" = "hbtop" ] ; then
HBASE_OPTS="${HBASE_OPTS} ${HBASE_HBTOP_OPTS}"
else
CLASS=$COMMAND
+if [[ "$CLASS" =~ .*IntegrationTest.* ]] ; then
+ for f in ${HBASE_HOME}/lib/test/*.jar; do
+ if [ -f "${f}" ]; then
+ CLASSPATH="${CLASSPATH}:${f}"
+ fi
+ done
+ fi
fi
# Add lib/jdk11 jars to the classpath
diff --git a/hbase-assembly/pom.xml b/hbase-assembly/pom.xml
index b94699e6a5a7..796f443e9b3d 100644
--- a/hbase-assembly/pom.xml
+++ b/hbase-assembly/pom.xml
@@ -388,7 +388,18 @@
org.apache.hbase
hbase-rsgroup
-
+
+ junit
+ junit
+
+
+ org.mockito
+ mockito-core
+
+
+ compile
+
+
diff --git a/hbase-assembly/src/main/assembly/client.xml b/hbase-assembly/src/main/assembly/client.xml
index 2a8e669ae492..54ed2e96fdd8 100644
--- a/hbase-assembly/src/main/assembly/client.xml
+++ b/hbase-assembly/src/main/assembly/client.xml
@@ -52,6 +52,7 @@
com.sun.jersey:*
com.sun.jersey.contribs:*
jline:jline
+ junit:junit
com.github.stephenc.findbugs:findbugs-annotations
commons-logging:commons-logging
org.apache.hbase:hbase-shaded-client
@@ -63,6 +64,8 @@
org.slf4j:*
org.apache.logging.log4j:*
io.opentelemetry.javaagent:*
+ org.hamcrest:hamcrest-core
+ org.mockito:mockito-core
@@ -157,6 +160,15 @@
io.opentelemetry.javaagent:*
+
+
+ lib/test
+
+ junit:junit
+ org.hamcrest:hamcrest-core
+ org.mockito:mockito-core
+
+
diff --git a/hbase-assembly/src/main/assembly/hadoop-three-compat.xml b/hbase-assembly/src/main/assembly/hadoop-three-compat.xml
index a1bbcb8ab865..61a2dfae8bb6 100644
--- a/hbase-assembly/src/main/assembly/hadoop-three-compat.xml
+++ b/hbase-assembly/src/main/assembly/hadoop-three-compat.xml
@@ -110,6 +110,9 @@
org.slf4j:*
org.apache.logging.log4j:*
io.opentelemetry.javaagent:*
+ junit:junit
+ org.hamcrest:hamcrest-core
+ org.mockito:mockito-core
@@ -258,6 +261,16 @@
io.opentelemetry.javaagent:*
+
+
+
+ lib/test
+
+ junit:junit
+ org.hamcrest:hamcrest-core
+ org.mockito:mockito-core
+
+
diff --git a/src/main/asciidoc/_chapters/developer.adoc b/src/main/asciidoc/_chapters/developer.adoc
index b3e2ffea1443..6eacead1cfd9 100644
--- a/src/main/asciidoc/_chapters/developer.adoc
+++ b/src/main/asciidoc/_chapters/developer.adoc
@@ -1677,7 +1677,7 @@ They are generally long-lasting, sizeable (the test can be asked to 1M rows or 1
Integration tests are what you would run when you need to more elaborate proofing of a release candidate beyond what unit tests can do.
They are not generally run on the Apache Continuous Integration build server, however, some sites opt to run integration tests as a part of their continuous testing on an actual cluster.
-Integration tests currently live under the _src/test_ directory in the hbase-it submodule and will match the regex: _**/IntegrationTest*.java_.
+Integration tests currently live under the _src/test_ directory in the hbase-it submodule and will match the regex: _*IntegrationTest*.java_.
All integration tests are also annotated with `@Category(IntegrationTests.class)`.
Integration tests can be run in two modes: using a mini cluster, or against an actual distributed cluster.
@@ -1794,6 +1794,17 @@ Currently tarball deployments, deployments which uses _hbase-daemons.sh_, and li
_/etc/init.d/_ scripts are not supported for now, but it can be easily added.
For other deployment options, a ClusterManager can be implemented and plugged in.
+Some integration tests define a _main_ method as entry point, and can be run on its' own, rather than using the test driver. For example, the _itbll_ test can be run as follows:
+
+----
+bin/hbase org.apache.hadoop.hbase.test.IntegrationTestBigLinkedList loop 2 1 100000 /temp 1 1000 50 1 0
+----
+
+NOTE: The _hbase_ script assumes all integration tests with exposed _main_ methods to be run
+against a distributed cluster will follow the *IntegrationTest* regex naming pattern
+mentioned above, in order to proper set test dependencies into the classpath.
+
+
[[maven.build.commands.integration.tests.destructive]]
==== Destructive integration / system tests (ChaosMonkey)