Added troubleshooting section on running hbase on other than the hadoop it ships with

git-svn-id: https://svn.apache.org/repos/asf/hbase/trunk@1211758 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Michael Stack 2011-12-08 05:11:36 +00:00
parent 09d0aff149
commit 34df21c7a4
1 changed files with 25 additions and 0 deletions

View File

@ -928,6 +928,31 @@ ERROR org.apache.hadoop.hbase.regionserver.HRegionServer: ZooKeeper session expi
</para>
</section>
</section>
<section xml:id="trouble.versions">
<title>HBase and Hadoop version issues</title>
<section xml:id="trouble.versions.205">
<title><code>NoClassDefFoundError</code> when trying to run 0.90.x on hadoop-0.20.205.x (or hadoop-1.0.x)</title>
<para>HBase 0.90.x does not ship with hadoop-0.20.205.x, etc. To make it run, you need to replace the hadoop
jars that HBase shipped with in its <filename>lib</filename> directory with those of the Hadoop you want to
run HBase on. If even after replacing Hadoop jars you get the below exception:
<computeroutput>
sv4r6s38: Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/configuration/Configuration
sv4r6s38: at org.apache.hadoop.metrics2.lib.DefaultMetricsSystem.&lt;init>(DefaultMetricsSystem.java:37)
sv4r6s38: at org.apache.hadoop.metrics2.lib.DefaultMetricsSystem.&lt;clinit>(DefaultMetricsSystem.java:34)
sv4r6s38: at org.apache.hadoop.security.UgiInstrumentation.create(UgiInstrumentation.java:51)
sv4r6s38: at org.apache.hadoop.security.UserGroupInformation.initialize(UserGroupInformation.java:209)
sv4r6s38: at org.apache.hadoop.security.UserGroupInformation.ensureInitialized(UserGroupInformation.java:177)
sv4r6s38: at org.apache.hadoop.security.UserGroupInformation.isSecurityEnabled(UserGroupInformation.java:229)
sv4r6s38: at org.apache.hadoop.security.KerberosName.&lt;clinit>(KerberosName.java:83)
sv4r6s38: at org.apache.hadoop.security.UserGroupInformation.initialize(UserGroupInformation.java:202)
sv4r6s38: at org.apache.hadoop.security.UserGroupInformation.ensureInitialized(UserGroupInformation.java:177)
</computeroutput>
you need to copy under <filename>hbase/lib</filename>, the <filename>commons-configuration-X.jar</filename> you find
in your Hadoop's <filename>lib</filename> directory. That should fix the above complaint.
</para>
</section>
</section>
</chapter>