Denis Magda created IGNITE-11252:
------------------------------------
Summary: Docs: Index corruption recovery procedure
Key: IGNITE-11252
URL: https://issues.apache.org/jira/browse/IGNITE-11252
Project: Ignite
Issue Type: Task
Components: documentation
Affects Versions: 2.7
Reporter: Denis Magda
Assignee: Prachi Garg
Fix For: 2.8
We need to document a recovery procedure if an index corruption happens. Refer
to this thread for details and examples of the exception dumped to the logs if
the issue occurs:
http://apache-ignite-developers.2346864.n4.nabble.com/Ignite-index-corruption-issue-gt-unrecoverable-cluster-td39869.html
# Recovering from an index corruption
## Applicable if
It is known that an index of a cache is corrupted, but the main data (partition
files and WAL) is fine. Show code snippets of possible examples. Find via the
references shared in the dev list discussion.
## Steps to recover
1. Stop the node
2. Delete index.bin of the affected caches (path is
db/<consistent_id>/cache-<cache_name>/index.bin)
3. Start the node
- Note: At this point the node is active in the cluster but don’t have indexes.
It means that it serves SQL queries but their performance can be low.
Avoid running SQL queries on large tables at this point
4. Wait for message “Finished indexes rebuilding for cache <cache_name>” in the
Ignite log
# Recovering from a persistent storage corruption
## Applicable if
A part of the persistent storage (partition files, checkpoint markers or WAL)
was corrupted
and there is no other way to recover it, but there are healthy copies of all
data on other nodes.
## Steps to recover
1. Stop the node
2. Delete all persistence files of the node (best to clear Ignite working
directory, storage directory, WAL and WAL archive directories)
3. Make sure consistentId is explicitly set in the configuration of the node
- If it isn’t, lookup the generated consistentId using control.sh and set it
explicitly in the config or via IGNITE_CONSISTENT_ID (2.8+ only)
4. Start the node
5. Wait for messages <Finished rebalancing cache> for all caches
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)