svn commit: r1232953 - in /hbase/trunk/src/docbkx: book.xml troubleshooting.xml

[dm...@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>