Skip to content

Experimental flags in 3.6+ configuration guide are incorrect #1036

@jmhbnz

Description

@jmhbnz

In our 3.7 configuration guide we state the following 10 experimental flags exist:

### Experimental features
```nocode
--experimental-initial-corrupt-check 'false'
Enable to check data corruption before serving any client/peer traffic.
--experimental-corrupt-check-time '0s'
Duration of time between cluster corruption check passes.
--experimental-enable-v2v3 ''
Serve v2 requests through the v3 backend under a given prefix. Deprecated and to be decommissioned in v3.6.
--experimental-enable-lease-checkpoint 'false'
ExperimentalEnableLeaseCheckpoint enables primary lessor to persist lease remainingTTL to prevent indefinite auto-renewal of long lived leases.
--experimental-compaction-batch-limit 1000
ExperimentalCompactionBatchLimit sets the maximum revisions deleted in each compaction batch.
--experimental-peer-skip-client-san-verification 'false'
Skip verification of SAN field in client certificate for peer connections.
--experimental-watch-progress-notify-interval '10m'
Duration of periodical watch progress notification.
--experimental-warning-apply-duration '100ms'
Warning is generated if requests take more than this duration.
--experimental-txn-mode-write-with-shared-buffer 'true'
Enable the write transaction to use a shared buffer in its readonly check operations.
--experimental-bootstrap-defrag-threshold-megabytes
Enable the defrag during etcd server bootstrap on condition that it will free at least the provided threshold of disk space. Needs to be set to non-zero value to take effect.
```

This are incorrect. Some of these flags have been completely removed in v3.7 (i.e. etcd-io/etcd main branch) and some have had the --experimental prefix removed as part of etcd-io/etcd#19141.

By running etcd --help we can validate which flags are present and compare it to the list in the documentation.

We need to review these experimental flags and update https://github.com/etcd-io/website/blob/main/content/en/docs/v3.7/op-guide/configuration.md as appropriate.

There are similar accuracy issues with the v3.6 version of the page.

Metadata

Metadata

Assignees

Labels

bugSomething isn't workinggood first issueGood for newcomershelp wantedExtra attention is needed

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions