influxdata / influxdata/docs-v2

Document the --recover-deferred-snapshots option

Open
#7,738 0 comments 0 reactions 0 assignees View on GitHub
product:v3-monolith
Dominant language
JavaScript
Stars
82
Forks
326
Avg merge
1d 1h
Merged PRs (30d)
82

Description

## Problem

`--recover-deferred-snapshots` isn't documented anywhere in docs-v2.

The v3.11.3 release notes and the Enterprise storage engine configuration
reference both refer to it, because the new
`--recover-deferred-snapshots-in-flight-limit` option only has meaning in
relation to it. A reader who follows either reference finds no definition of
the option that does the recovering.

## What's missing

The "Deferred snapshot recovery" section in
`content/influxdb3/enterprise/reference/storage-engine-config-options.md`
(under Compactor) documents the in-flight limit but not its parent option.
It needs a table row for `--recover-deferred-snapshots` covering:

- What the option does: returns deferred snapshots to compaction.
- Its default. Presumably disabled, but this needs engineering confirmation
rather than an inference from the option name.
- Its type: whether it's a boolean flag or takes a value.
- Its environment variable, if it differs from the name-derived
`INFLUXDB3_RECOVER_DEFERRED_SNAPSHOTS`.
- Whether it's safe to leave on permanently, or is meant to be set, run, and
removed.

## Context

Added in the v3.11.3 release notes work. See influxdb_pro#5502 for the
in-flight limit option that prompted this.

## Done when

`--recover-deferred-snapshots` appears in the Enterprise storage engine
configuration reference with a confirmed default and behavior, and the
"Deferred snapshot recovery" section reads correctly without depending on
outside knowledge of the option.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start in content/influxdb3/enterprise/reference/storage-engine-config-options.md, in the Compactor section's "Deferred snapshot recovery" table. Compare the v3.11.3 release notes and related references, then obtain engineering confirmation for the option's default, type, environment variable, and intended usage. Done when the table documents --recover-deferred-snapshots and the section is self-contained.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.