From 8af96ff9baec9e8860a80e005630f18c1a97c13b Mon Sep 17 00:00:00 2001 From: Misty Stanley-Jones Date: Mon, 10 Aug 2015 09:20:08 +1000 Subject: [PATCH] HBASE-13446 Add docs warning about missing data for downstream on versions prior to HBASE-13262 --- src/main/asciidoc/_chapters/troubleshooting.adoc | 8 ++++++++ src/main/asciidoc/_chapters/upgrading.adoc | 8 ++++++++ 2 files changed, 16 insertions(+) diff --git a/src/main/asciidoc/_chapters/troubleshooting.adoc b/src/main/asciidoc/_chapters/troubleshooting.adoc index 1776c9e..a2c9247 100644 --- a/src/main/asciidoc/_chapters/troubleshooting.adoc +++ b/src/main/asciidoc/_chapters/troubleshooting.adoc @@ -559,6 +559,14 @@ You can also tail all the logs at the same time, edit files, etc. For more information on the HBase client, see <>. +=== Missed Scan Results Due To Mismatch Of `hbase.client.scanner.max.result.size` Between Client and Server +If either the client or server version is lower than 0.98.11/1.0.0 and the server +has a smaller value for `hbase.client.scanner.max.result.size` than the client, scan +requests that reach the server's `hbase.client.scanner.max.result.size` are likely +to miss data. In particular, 0.98.11 defaults `hbase.client.scanner.max.result.size` +to 2 MB but other versions default to larger values. For this reason, be very careful +using 0.98.11 servers with any other client version. + [[trouble.client.scantimeout]] === ScannerTimeoutException or UnknownScannerException diff --git a/src/main/asciidoc/_chapters/upgrading.adoc b/src/main/asciidoc/_chapters/upgrading.adoc index 6b63833..9742654 100644 --- a/src/main/asciidoc/_chapters/upgrading.adoc +++ b/src/main/asciidoc/_chapters/upgrading.adoc @@ -204,6 +204,14 @@ See the release notes on the issue link:https://issues.apache.org/jira/browse/HB .Distributed Log Replay <> is off by default in HBase 1.0.0. Enabling it can make a big difference improving HBase MTTR. Enable this feature if you are doing a clean stop/start when you are upgrading. You cannot rolling upgrade to this feature (caveat if you are running on a version of HBase in excess of HBase 0.98.4 -- see link:https://issues.apache.org/jira/browse/HBASE-12577[HBASE-12577 Disable distributed log replay by default] for more). +.Mismatch Of `hbase.client.scanner.max.result.size` Between Client and Server +If either the client or server version is lower than 0.98.11/1.0.0 and the server +has a smaller value for `hbase.client.scanner.max.result.size` than the client, scan +requests that reach the server's `hbase.client.scanner.max.result.size` are likely +to miss data. In particular, 0.98.11 defaults `hbase.client.scanner.max.result.size` +to 2 MB but other versions default to larger values. For this reason, be very careful +using 0.98.11 servers with any other client version. + [[upgrade1.0.rolling.upgrade]] ==== Rolling upgrade from 0.98.x to HBase 1.0.0 .From 0.96.x to 1.0.0 -- 2.3.2 (Apple Git-55)