Return-Path: 
 <commits-return-10056-apmail-hbase-commits-archive=hbase.apache.org@hbase.apache.org>
X-Original-To: apmail-hbase-commits-archive@www.apache.org
Delivered-To: apmail-hbase-commits-archive@www.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id 3B3199077
	for <apmail-hbase-commits-archive@www.apache.org>;
 Mon, 24 Sep 2012 19:37:30 +0000 (UTC)
Received: (qmail 15174 invoked by uid 500); 24 Sep 2012 19:37:30 -0000
Delivered-To: apmail-hbase-commits-archive@hbase.apache.org
Received: (qmail 15024 invoked by uid 500); 24 Sep 2012 19:37:30 -0000
Mailing-List: contact commits-help@hbase.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@hbase.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@hbase.apache.org>
List-Post: <mailto:commits@hbase.apache.org>
List-Id: <commits.hbase.apache.org>
Reply-To: dev@hbase.apache.org
Delivered-To: mailing list commits@hbase.apache.org
Received: (qmail 15015 invoked by uid 99); 24 Sep 2012 19:37:29 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 24 Sep 2012 19:37:29 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=5.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 24 Sep 2012 19:37:28 +0000
Received: from eris.apache.org (localhost [127.0.0.1])
	by eris.apache.org (Postfix) with ESMTP id 7768F23888FE
	for <commits@hbase.apache.org>; Mon, 24 Sep 2012 19:36:45 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1389527 - in /hbase/trunk/src/docbkx: configuration.xml
 troubleshooting.xml
Date: Mon, 24 Sep 2012 19:36:45 -0000
To: commits@hbase.apache.org
From: stack@apache.org
X-Mailer: svnmailer-1.0.8-patched
Message-Id: <20120924193645.7768F23888FE@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on 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">