From 7cd71d1db678fe8ab6efc2191310228d9bb27849 Mon Sep 17 00:00:00 2001
From: Misty Stanley-Jones <mstanleyjones@cloudera.com>
Date: Thu, 18 Sep 2014 15:27:05 +1000
Subject: [PATCH] HBASE-11986 Document MOB in Reference Guide

---
 src/main/docbkx/book.xml          | 2 ++
 src/main/docbkx/ops_mgt.xml       | 3 ++-
 src/main/docbkx/schema_design.xml | 9 +++++++++
 3 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/src/main/docbkx/book.xml b/src/main/docbkx/book.xml
index 19dd770157b..78acfeaa23c 100644
--- a/src/main/docbkx/book.xml
+++ b/src/main/docbkx/book.xml
@@ -4658,8 +4658,10 @@ if (result.isStale()) {
 	</section>
 
   </chapter>   <!--  architecture -->
+  
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="hbase_apis.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="external_apis.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="hbase_mob.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="thrift_filter_language.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cp.xml" />
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="performance.xml"/>
diff --git a/src/main/docbkx/ops_mgt.xml b/src/main/docbkx/ops_mgt.xml
index ffcf1ceb8cd..51c432dbf94 100644
--- a/src/main/docbkx/ops_mgt.xml
+++ b/src/main/docbkx/ops_mgt.xml
@@ -2119,7 +2119,8 @@ hbase> restore_snapshot 'myTableSnapshot-122112'
         <para>If you cannot estimate the size of your tables well, when starting off, it's probably
           best to stick to the default region size, perhaps going smaller for hot tables (or
           manually split hot regions to spread the load over the cluster), or go with larger region
-          sizes if your cell sizes tend to be largish (100k and up).</para>
+          sizes if your cell sizes tend to be largish (100k and up). See also the new feature <xref
+            linkend="mob"/>, introduced in HBase 2.0+.</para>
         <para>In HBase 0.98, experimental stripe compactions feature was added that would allow for
           larger regions, especially for log data. See <xref
             linkend="ops.stripe" />.</para>
diff --git a/src/main/docbkx/schema_design.xml b/src/main/docbkx/schema_design.xml
index efbcb556a48..1e86ee71f18 100644
--- a/src/main/docbkx/schema_design.xml
+++ b/src/main/docbkx/schema_design.xml
@@ -464,6 +464,15 @@ public static byte[][] getHexSplits(String startKey, String endKey, int numRegio
         less than the number of row versions. </para>
     </section>
   </section>
+  <section>
+    <title>Cell Size</title>
+    <para>HBase is optimized to handle cell sizes up to 100 KB very well, though it can technically
+      handle cell sizes from 1 kb to 10 MB. Objects between 1 MB and 64 MB are referred to as
+      Medium Objects (MOBs), and support for storing those objects directly in HBase is provided in
+      HBase 2.0+. See <xref linkend="mob"/>.</para>
+    <para>For storing objects larger than 64 MB or larger than 10 MB without MOB support, store the
+      objects directly in HDFS, and store a reference to the file path in HBase.</para>
+  </section>
   <section
     xml:id="supported.datatypes">
     <title> Supported Datatypes </title>