diff --git a/src/main/docbkx/book.xml b/src/main/docbkx/book.xml
index 3a4ff604b7b..be0a65b6044 100644
--- a/src/main/docbkx/book.xml
+++ b/src/main/docbkx/book.xml
@@ -2139,12 +2139,14 @@ rs.close();
General Cache Configurations
- Apart from the cache implementaiton itself, you can set some general
- configuration options to control how the cache performs.
- See .
- After setting any of these options, restart or rolling restart your cluster for the
- configuration to take effect. Check logs for errors or unexpected behavior.
+ Apart from the cache implementaiton itself, you can set some general configuration
+ options to control how the cache performs. See . After setting any of these options, restart or rolling restart your cluster for the
+ configuration to take effect. Check logs for errors or unexpected behavior.
+ See also , which discusses a new option
+ introduced in HBASE-9857.
+
+ Prefetch Option for Blockcache
+ HBASE-9857
+ adds a new option to prefetch HFile contents when opening the blockcache, if a columnfamily
+ or regionserver property is set. This option is available for HBase 0.98.3 and later. The
+ purpose is to warm the blockcache as rapidly as possible after the cache is opened, using
+ in-memory table data, and not counting the prefetching as cache misses. This is great for
+ fast reads, but is not a good idea if the data to be preloaded will not fit into the
+ blockcache. It is useful for tuning the IO impact of prefetching versus the time before all
+ data blocks are in cache.
+ To enable prefetching on a given column family, you can use HBase Shell or use the
+ API.
+
+ Enable Prefetch Using HBase Shell
+ hbase> create 'MyTable', { NAME => 'myCF', PREFETCH_BLOCKS_ON_OPEN => 'true' }
+
+
+ Enable Prefetch Using the API
+
+// ...
+HTableDescriptor tableDesc = new HTableDescriptor("myTable");
+HColumnDescriptor cfDesc = new HColumnDescriptor("myCF");
+cfDesc.setPrefetchBlocksOnOpen(true);
+tableDesc.addFamily(cfDesc);
+// ...
+
+
+ See the API documentation for CacheConfig.
+ <varname>hbase.regionserver.global.memstore.size</varname>See .