[
https://issues.apache.org/jira/browse/IGNITE-29018?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18108399#comment-18108399
]
Ignite TC Bot commented on IGNITE-29018:
----------------------------------------
I broadened this documentation follow-up to cover the cache dump reader
utility/API as one coherent topic rather than only the IGNITE-27716 log wording.
Draft PR: https://github.com/apache/ignite/pull/13521
The patch adds a dedicated Cache Dump Reader tools page and documents cache
dump creation entry point, DumpReader/DumpConsumer lifecycle, reader options,
snapshotTransferRate, and the partition log fields.
> [doc] Document cache dump reader utility and API
> ------------------------------------------------
>
> Key: IGNITE-29018
> URL: https://issues.apache.org/jira/browse/IGNITE-29018
> Project: Ignite
> Issue Type: Task
> Components: documentation
> Reporter: Ignite TC Bot
> Priority: Major
> Labels: ignite-2
> Time Spent: 10m
> Remaining Estimate: 0h
>
> Document the Apache Ignite 2 cache dump reader utility/API as one coherent
> user-facing topic.
> This follow-up intentionally covers more than the original IGNITE-27716 log
> wording. The current public docs did not have a dedicated cache dump reader
> page, so a narrow paragraph in the snapshots restore section would be
> misleading.
> Source scope:
> * IGNITE-19950 - cache dumps
> * IGNITE-20472 - API to consume cache dumps
> * IGNITE-20601 - custom dump location handling
> * IGNITE-20614 - snapshotTransferRate used for dump creation rate limiting
> * IGNITE-20708 - cache group filter for DumpReader
> * IGNITE-20722 - skipCopies for DumpReader
> * IGNITE-22020 - keepRaw parameter for DumpReaderConfiguration
> * IGNITE-25554 - cache names filter for DumpReader
> * IGNITE-26729 - non-volatile data structures in cache dump
> * IGNITE-27716 - cache group/cache name in DumpReader partition logs
> * IGNITE-27842 - DumpReader consumer/API no longer marked experimental
> User-facing documentation should explain:
> * how to create a cache dump through IgniteSnapshot.createDump(...);
> * how to read a dump with DumpReader, DumpReaderConfiguration, DumpConsumer,
> and DumpEntry;
> * the consumer lifecycle and the fact that onPartition(...) can be called
> concurrently;
> * reader options: threadCount, timeout, failFast, keepBinary, keepRaw,
> groupNames, cacheNames, skipCopies, and encryptionSpi;
> * that snapshotTransferRate also limits cache dump creation disk write rate;
> * how to interpret DumpReader partition log messages, including the grp field.
> Draft PR: https://github.com/apache/ignite/pull/13521
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
