HBASE-18849 expand "thirdparty" reference to give examples of setting netty location in common testing modules
Project: http://git-wip-us.apache.org/repos/asf/hbase/repo Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/58f9cd35 Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/58f9cd35 Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/58f9cd35 Branch: refs/heads/HBASE-18467 Commit: 58f9cd3586d0d42d26c82fc9b4a9e0c63e44c6d4 Parents: 29a3ff3 Author: Michael Stack <[email protected]> Authored: Tue Sep 19 16:53:21 2017 -0700 Committer: Michael Stack <[email protected]> Committed: Tue Sep 19 16:54:00 2017 -0700 ---------------------------------------------------------------------- src/main/asciidoc/_chapters/developer.adoc | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hbase/blob/58f9cd35/src/main/asciidoc/_chapters/developer.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/_chapters/developer.adoc b/src/main/asciidoc/_chapters/developer.adoc index 3d010b6..d937d77 100644 --- a/src/main/asciidoc/_chapters/developer.adoc +++ b/src/main/asciidoc/_chapters/developer.adoc @@ -2160,6 +2160,23 @@ this property on platforms that favor the bundled .so. See release notes on HBAS for more. The complaint you see is something like the following: `Cause: java.lang.RuntimeException: Failed construction of Master: class org.apache.hadoop.hbase.master.HMasterorg.apache.hadoop.hbase.shaded.io.netty.channel.epoll.` +If running unit tests and you run into the above message, add the system property +to your surefire configuration by doing like the below: + +[source,xml] +---- + <plugin> + <artifactId>maven-surefire-plugin</artifactId> + <configuration> + <systemPropertyVariables> + <org.apache.hadoop.hbase.shaded.io.netty.packagePrefix>org.apache.hadoop.hbase.shaded.</org.apache.hadoop.hbase.shaded.io.netty.packagePrefix> + </systemPropertyVariables> + </configuration> + </plugin> +---- + +Again the trailing period in the value above is intended. + The `hbase-thirdparty` project has groupid of `org.apache.hbase.thirdparty`. As of this writing, it provides three jars; one for netty with an artifactid of `hbase-thirdparty-netty`, one for protobuf at `hbase-thirdparty-protobuf` and then
