Return-Path: 
 <commits-return-7486-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 69244B85D
	for <apmail-hbase-commits-archive@www.apache.org>;
 Wed, 18 Jan 2012 16:56:03 +0000 (UTC)
Received: (qmail 16583 invoked by uid 500); 18 Jan 2012 16:56:03 -0000
Delivered-To: apmail-hbase-commits-archive@hbase.apache.org
Received: (qmail 16293 invoked by uid 500); 18 Jan 2012 16:56:02 -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 15971 invoked by uid 99); 18 Jan 2012 16:56:02 -0000
Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 18 Jan 2012 16:56:02 +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; Wed, 18 Jan 2012 16:55:59 +0000
Received: from eris.apache.org (localhost [127.0.0.1])
	by eris.apache.org (Postfix) with ESMTP id A85BB2388993
	for <commits@hbase.apache.org>; Wed, 18 Jan 2012 16:55:38 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1232953 - in /hbase/trunk/src/docbkx: book.xml
 troubleshooting.xml
Date: Wed, 18 Jan 2012 16:55:38 -0000
To: commits@hbase.apache.org
From: dmeil@apache.org
X-Mailer: svnmailer-1.0.8-patched
Message-Id: <20120118165538.A85BB2388993@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: dmeil
Date: Wed Jan 18 16:55:38 2012
New Revision: 1232953

URL: http://svn.apache.org/viewvc?rev=1232953&view=rev
Log:
hbase-5227.  [book] book.xml, troubleshooting.xml - added caution about rowlocks.

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

Modified: hbase/trunk/src/docbkx/book.xml
URL: http://svn.apache.org/viewvc/hbase/trunk/src/docbkx/book.xml?rev=1232953&r1=1232952&r2=1232953&view=diff
==============================================================================
--- hbase/trunk/src/docbkx/book.xml (original)
+++ hbase/trunk/src/docbkx/book.xml Wed Jan 18 16:55:38 2012
@@ -1406,6 +1406,15 @@ HTable table2 = new HTable(conf2, "myTab
            <para>Information on non-Java clients and custom protocols is covered in <xref linkend="external_apis" />
            </para>
 		</section>
+	   <section xml:id="client.rowlocks"><title>RowLocks</title>
+           <para><link xlink:href="http://hbase.apache.org/apidocs/org/apache/hadoop/hbase/client/HTable.html#lockRow%28byte[]%29">RowLocks</link> are still
+           in the client API <emphasis>however</emphasis> they are discouraged because if not managed properly these can
+           lock up the RegionServers.
+           </para>
+           <para>There is an oustanding ticket <link xlink:href="https://issues.apache.org/jira/browse/HBASE-2332">HBASE-2332</link> to 
+           remove this feature from the client.
+           </para>
+		</section>
 	</section>
 	
     <section xml:id="client.filter"><title>Client Request Filters</title>

Modified: hbase/trunk/src/docbkx/troubleshooting.xml
URL: http://svn.apache.org/viewvc/hbase/trunk/src/docbkx/troubleshooting.xml?rev=1232953&r1=1232952&r2=1232953&view=diff
==============================================================================
--- hbase/trunk/src/docbkx/troubleshooting.xml (original)
+++ hbase/trunk/src/docbkx/troubleshooting.xml Wed Jan 18 16:55:38 2012
@@ -761,6 +761,9 @@ java.lang.UnsatisfiedLinkError: no gplco
             Adding <code>-XX:+UseMembar</code> to the HBase <varname>HBASE_OPTS</varname> in <filename>conf/hbase-env.sh</filename>
             may fix it.
             </para>
+            <para>Also, are you using <xref linkend="client.rowlocks"/>?  These are discouraged because they can lock up the 
+            RegionServers if not managed properly.
+            </para>
         </section>
         <section xml:id="trouble.rs.runtime.filehandles">
            <title>java.io.IOException...(Too many open files)</title>