Repository: kudu Updated Branches: refs/heads/master 131c5d7af -> cf1b1f42c
docs: update docs for CFile checksum handling Notes that the behavior when encountering a CFile checksum has changed in 1.8.0. I've kept around the manual steps, since they are still valuable. Change-Id: I11ecfe2739122f80894c5bbba13de853d962754a Reviewed-on: http://gerrit.cloudera.org:8080/11581 Reviewed-by: Grant Henke <[email protected]> Tested-by: Grant Henke <[email protected]> Tested-by: Kudu Jenkins Project: http://git-wip-us.apache.org/repos/asf/kudu/repo Commit: http://git-wip-us.apache.org/repos/asf/kudu/commit/75472c82 Tree: http://git-wip-us.apache.org/repos/asf/kudu/tree/75472c82 Diff: http://git-wip-us.apache.org/repos/asf/kudu/diff/75472c82 Branch: refs/heads/master Commit: 75472c82b1c0a2a2a91472e405b3ee4639e26575 Parents: 131c5d7 Author: Andrew Wong <[email protected]> Authored: Thu Oct 4 12:52:47 2018 -0700 Committer: Andrew Wong <[email protected]> Committed: Thu Oct 4 20:44:48 2018 +0000 ---------------------------------------------------------------------- docs/troubleshooting.adoc | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/kudu/blob/75472c82/docs/troubleshooting.adoc ---------------------------------------------------------------------- diff --git a/docs/troubleshooting.adoc b/docs/troubleshooting.adoc index 0f37913..1bebe07 100644 --- a/docs/troubleshooting.adoc +++ b/docs/troubleshooting.adoc @@ -703,11 +703,10 @@ hold no data. They must not be deleted. [[cfile_corruption]] === Corruption: checksum error on CFile block -If the data on disk becomes corrupt, users will encounter warnings containing -"Corruption: checksum error on CFile block" in the tablet server logs and -client side errors when trying to scan tablets with corrupt CFile blocks. -Until link:https://issues.apache.org/jira/browse/KUDU-2469[KUDU-2469] is -completed, fixing this corruption is a manual process. +In versions prior to Kudu 1.8.0, if the data on disk becomes corrupt, users +will encounter warnings containing "Corruption: checksum error on CFile block" +in the tablet server logs and client side errors when trying to scan tablets +with corrupt CFile blocks. Fixing this corruption is a manual process. To fix the issue, users can first identify all the affected tablets by running a checksum scan on the affected tables or tablets using the @@ -739,3 +738,6 @@ with an empty one using the ---- sudo -u kudu kudu tablet unsafe_replace_tablet <master_addresses> <tablet_id> ---- + +From versions 1.8.0 onwards, Kudu will mark the affected replicas as failed, +leading to their automatic re-replication elsewhere.
