svn commit: r1389527 - in /hbase/trunk/src/docbkx: configuration.xml troubleshooting.xml

[st...@apache.org]

Author: stack
Date: Mon Sep 24 19:36:44 2012
New Revision: 1389527

URL: http://svn.apache.org/viewvc?rev=1389527&view=rev
Log:
Add troubleshooting on hbase dfsclient1 connection to h2, also edit of pseudo-distributed section... needs more work

Modified:
    hbase/trunk/src/docbkx/configuration.xml
    hbase/trunk/src/docbkx/troubleshooting.xml

Modified: hbase/trunk/src/docbkx/configuration.xml
URL: http://svn.apache.org/viewvc/hbase/trunk/src/docbkx/configuration.xml?rev=1389527&r1=1389526&r2=1389527&view=diff
==============================================================================
--- hbase/trunk/src/docbkx/configuration.xml (original)
+++ hbase/trunk/src/docbkx/configuration.xml Mon Sep 24 19:36:44 2012
@@ -417,14 +417,15 @@ to ensure well-formedness of your docume
           HBase. Do not use this configuration for production nor for
           evaluating HBase performance.</para>
 
-	      <para>First, confirm your local HDFS setup.  Below is an example <filename>conf/hdfs-site.xml</filename>.  Note
-	      that the replication is set to 1 because this is a pseudo-distributed setup.  The properties <varname>dfs.name.dir</varname>
-	      and <varname>dfs.data.dir</varname> are being set explicitly, the latter being where HDFS data will exist on your machine.
-   		  </para>
-	      <para>Next, configure HBase for usage.  Below is an example <filename>conf/hbase-site.xml</filename>.  Note
-	      that the <varname>hbase.rootdir</varname> property points to the local HDFS instance.  This is the file into
+	      <para>First, confirm your local HDFS setup.  Below is an example <filename>conf/hdfs-site.xml</filename>.
+	      The properties <varname>dfs.name.dir</varname> and <varname>dfs.data.dir</varname> are being set explicitly,
+              the latter being where HDFS data will exist on your machine.
+   	      </para>
+	      <para>Next, configure HBase for usage.  Below is an example <filename>conf/hbase-site.xml</filename>.
+          This is the file into
           which you add local customizations and overrides for
-          <xref linkend="hbase_default_configurations" /> and <xref linkend="hdfs_client_conf" />
+          <xref linkend="hbase_default_configurations" /> and <xref linkend="hdfs_client_conf" />.
+              Note that the <varname>hbase.rootdir</varname> property points to the local HDFS instance.
    		  </para>
 
           <para>Now skip to <xref linkend="confirm" /> for how to start and verify your
@@ -443,8 +444,7 @@ to ensure well-formedness of your docume
 
           <note>
             <para>Above we bind to <varname>localhost</varname>. This means
-            that a remote client cannot connect. Amend accordingly, if you
-            want to connect from a remote location.</para>
+            that a remote client cannot connect.</para>
           </note>
 
 			
@@ -464,10 +464,6 @@ to ensure well-formedness of your docume
     &lt;name&gt;dfs.data.dir&lt;/name&gt;
     &lt;value&gt;/Users/local/user.name/hdfs-data&lt;/value&gt;
   &lt;/property&gt;
-  &lt;property&gt;
-    &lt;name&gt;dfs.replication&lt;/name&gt;
-    &lt;value&gt;1&lt;/value&gt;
-  &lt;/property&gt;
   ...
 &lt;/configuration&gt;
 </programlisting>
@@ -481,13 +477,13 @@ to ensure well-formedness of your docume
     &lt;value&gt;hdfs://localhost:8020/hbase&lt;/value&gt;
   &lt;/property&gt;
   &lt;property&gt;
-    &lt;name&gt;hbase.zookeeper.quorum&lt;/name&gt;
-    &lt;value&gt;localhost&lt;/value&gt;
-  &lt;/property&gt;
-  &lt;property&gt;
     &lt;name&gt;hbase.cluster.distributed&lt;/name&gt;
     &lt;value&gt;true&lt;/value&gt;
   &lt;/property&gt;
+  &lt;property&gt;
+    &lt;name&gt;hbase.zookeeper.quorum&lt;/name&gt;
+    &lt;value&gt;localhost&lt;/value&gt;
+  &lt;/property&gt;
   ...
 &lt;/configuration&gt;
 </programlisting>

Modified: hbase/trunk/src/docbkx/troubleshooting.xml
URL: http://svn.apache.org/viewvc/hbase/trunk/src/docbkx/troubleshooting.xml?rev=1389527&r1=1389526&r2=1389527&view=diff
==============================================================================
--- hbase/trunk/src/docbkx/troubleshooting.xml (original)
+++ hbase/trunk/src/docbkx/troubleshooting.xml Mon Sep 24 19:36:44 2012
@@ -1059,6 +1059,19 @@ you need to copy under <filename>hbase/l
 in your Hadoop's <filename>lib</filename> directory.  That should fix the above complaint.
 </para>
 </section>
+
+          <section xml:id="trouble.versions.205">
+             <title>...cannot communicate with client version...</title>
+<para>If you see something like the following in your logs
+<computeroutput>...
+2012-09-24 10:20:52,168 FATAL org.apache.hadoop.hbase.master.HMaster: Unhandled exception. Starting shutdown.
+org.apache.hadoop.ipc.RemoteException: Server IPC version 7 cannot communicate with client version 4
+...</computeroutput>
+...are you trying to talk to an Hadoop 2.0.x from an HBase that has an Hadoop 1.0.x client?
+Use the HBase built against Hadoop 2.0 or rebuild your HBase passing the <command>-Dhadoop.profile=2.0</command>
+attribute to Maven (See <xref linkend="maven.build.hadoop" /> for more). 
+</para>
+
 </section>
 
     <section xml:id="trouble.casestudy">