HBASE-10398 HBase book updates for Replication after HBASE-10322. (Misty)

src/main/docbkx/book.xml

@@ -4390,6 +4390,11 @@ This option should not normally be used, and it is not in <code>-fixAll</code>.
   <appendix xml:id="compression">
 
     <title >Compression In HBase<indexterm><primary>Compression</primary></indexterm></title>
+    <note>
+      <para>Codecs mentioned in this section are for encoding and decoding data blocks. For
+        information about replication codecs, see <xref
+          linkend="cluster.replication.preserving.tags" />.</para>
+    </note>
     <para>There are a bunch of compression options in HBase.  Some codecs come with java --
         e.g. gzip -- and so require no additional installations. Others require native
         libraries.  The native libraries may be available in your hadoop as is the case

src/main/docbkx/ops_mgt.xml

@@ -1109,6 +1109,16 @@ false
     <title>Cluster Replication</title>
     <para>See <link
         xlink:href="http://hbase.apache.org/replication.html">Cluster Replication</link>. </para>
+    <note xml:id="cluster.replication.preserving.tags">
+      <title>Preserving Tags During Replication</title>
+      <para>By default, the codec used for replication between clusters strips tags, such as
+        cell-level ACLs, from cells. To prevent the tags from being stripped, you can use a
+        different codec which does not strip them. Configure
+          <code>hbase.replication.rpc.codec</code> to use
+          <literal>org.apache.hadoop.hbase.codec.KeyValueCodecWithTags</literal>, on both the source
+        and sink RegionServers involved in the replication. This option was introduced in <link
+          xlink:href="https://issues.apache.org/jira/browse/HBASE-10322">HBASE-10322</link>.</para>
+    </note>
   </section>
   <section
     xml:id="ops.backup">

src/main/docbkx/security.xml

@@ -1582,6 +1582,11 @@ user_permission <table>
           <code>org.apache.hadoop.hbase.security.visibility.DefaultScanLabelGenerator</code>. One
         can configure a set of ScanLabelGenerators to be used by the system. For this, a comma
         separated set of implementation class names to be configured. </para>
+      <note>
+        <title>Visibility Labels and Replication</title>
+        <para>By default, visibility labels are lost on replication. To change this behavior, see
+          <xref linkend="cluster.replication.preserving.tags" />.</para>
+      </note>
     </section>
   </section>