Skip to content

Incorrect optimistic failure tolerance figures #2914

Description

@nywnywnyw

Product

Vault

Issue type

Other issue

Describe your issue to request changes to the content on developer.hashicorp.com. Be specific and provide as much detail as possible. Include page URLs and screenshots if applicable.

In the documentation for Vault, the "Optimistic failure tolerance" (OFT) figures cited are incorrect.

For example, in a cluster with 3 redundancy zones and 2 nodes in each zone, the quorum size is 2, so the OFT should be 4, instead of 3:
https://developer.hashicorp.com/vault/docs/internals/integrated-storage#redundancy-zones
https://developer.hashicorp.com/vault/docs/enterprise/redundancy-zones#optimistic-failure-tolerance
The statements saying that "The cluster then maintains 3 voting nodes with 2 remaining standbys. The cluster can handle an additional 2 gradual failures before it loses quorum." are thus inaccurate as well. It should have been "an additional 3 gradual failures".

(eg. The correct OFT figure of 4 is cited here on a different page:
https://developer.hashicorp.com/vault/tutorials/raft/raft-redundancy-zones#:~:text=Optimistic%20Failure%20Tolerance%3A%20%20%20%204)

Similar inaccuracies apply to the other figures cited in the table for clusters with 3 redundancy zones and 3 nodes per zone, as well as clusters with 5 redundancy zones and 2 nodes per zone.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    VaultContent update for Vault product docs

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions