Skip to content

Adding documentation for behavior of indices.recovery.max_bytes_per_sec set to 0mb or less#3649

Merged
Naarcha-AWS merged 2 commits intoopensearch-project:mainfrom
AmiStrn:add-documentation-for-max_bytes_per_sec-zero-value
Apr 4, 2023
Merged

Adding documentation for behavior of indices.recovery.max_bytes_per_sec set to 0mb or less#3649
Naarcha-AWS merged 2 commits intoopensearch-project:mainfrom
AmiStrn:add-documentation-for-max_bytes_per_sec-zero-value

Conversation

@AmiStrn
Copy link
Contributor

@AmiStrn AmiStrn commented Apr 1, 2023

After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.

Description

missing documentation for setting indices.recovery.max_bytes_per_sec to 0mb or less.

Issues Resolved

Resolves #3648

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

…and discovering the opposite was happening I see we need the documentation to include this nice extra info.

Resolves opensearch-project#3648

Signed-off-by: AmiStrn <123amitai@gmail.com>
@AmiStrn AmiStrn requested a review from a team as a code owner April 1, 2023 21:47
@AmiStrn
Copy link
Contributor Author

AmiStrn commented Apr 4, 2023

@hdhalter @Naarcha-AWS @dtaivpp who reviews PRs for this repo?

@AmiStrn
Copy link
Contributor Author

AmiStrn commented Apr 4, 2023

@nknize do you think this can be categorized as a bug in the core project?
The behavior was surprising, if you set this param to 0mb per second then the behavior is basically "as many mb as possible per second"...
I opened this so it is at least documented somewhere.

@Naarcha-AWS
Copy link
Contributor

@hdhalter @Naarcha-AWS @dtaivpp who reviews PRs for this repo?

@AmiStrn: That would be anyone on the documentation team listed here. I'm taking a look now.

Copy link
Contributor

@Naarcha-AWS Naarcha-AWS left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Adding additional context based on your issue. Feel free to tweak as needed.

| action.destructive_requires_name | Boolean | When set to `true`, you must specify the index name to delete an index. You cannot delete all indexes or use wildcards. Default is `true`. |
| cluster.indices.close.enable | Boolean | Enables closing of open indexes in OpenSearch. Default is `true`. |
| indices.recovery.max_bytes_per_sec | String | Limits the total inbound and outbound recovery traffic for each node. This applies to peer recoveries and snapshot recoveries. Default is `40mb`. |
| indices.recovery.max_bytes_per_sec | String | Limits the total inbound and outbound recovery traffic for each node. This applies to peer recoveries and snapshot recoveries. Default is `40mb`. Setting to values less than or equal to `0mb` will result in disabling this rate limiting. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| indices.recovery.max_bytes_per_sec | String | Limits the total inbound and outbound recovery traffic for each node. This applies to peer recoveries and snapshot recoveries. Default is `40mb`. Setting to values less than or equal to `0mb` will result in disabling this rate limiting. |
| indices.recovery.max_bytes_per_sec | String | Limits the total inbound and outbound recovery traffic for each node. This applies to peer recoveries and snapshot recoveries. Default is `40mb`. If you set the recovery traffic value to less than or equal to `0mb`, rate limiting will be disabled, which causes recovery data to be transferred at the highest possible rate. |

Copy link
Contributor Author

@AmiStrn AmiStrn Apr 4, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll make a commit via my fork. If i commit from here it will cause dco issues.
Thanks for the input.

@AmiStrn
Copy link
Contributor Author

AmiStrn commented Apr 4, 2023

@hdhalter @Naarcha-AWS @dtaivpp who reviews PRs for this repo?

@AmiStrn: That would be anyone on the documentation team listed here. I'm taking a look now.

Thanks for taking a look @Naarcha-AWS

Signed-off-by: AmiStrn <123amitai@gmail.com>
@AmiStrn AmiStrn requested a review from Naarcha-AWS April 4, 2023 17:58
@Naarcha-AWS Naarcha-AWS added backport 1.3 PR: Backport label for v1.3.x backport 2.5 PR: Backport label for 2.5 backport 2.6 PR: Backport label for 2.6 labels Apr 4, 2023
@carolxob carolxob self-requested a review April 4, 2023 20:10
Copy link
Contributor

@carolxob carolxob left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

@Naarcha-AWS Naarcha-AWS merged commit b6763b1 into opensearch-project:main Apr 4, 2023
opensearch-trigger-bot bot pushed a commit that referenced this pull request Apr 4, 2023
…ec set to `0mb` or less (#3649)

* After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.
Resolves #3648

Signed-off-by: AmiStrn <123amitai@gmail.com>

* Modifying the proposal based on maintainers input.

Signed-off-by: AmiStrn <123amitai@gmail.com>

---------

Signed-off-by: AmiStrn <123amitai@gmail.com>
(cherry picked from commit b6763b1)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
opensearch-trigger-bot bot pushed a commit that referenced this pull request Apr 4, 2023
…ec set to `0mb` or less (#3649)

* After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.
Resolves #3648

Signed-off-by: AmiStrn <123amitai@gmail.com>

* Modifying the proposal based on maintainers input.

Signed-off-by: AmiStrn <123amitai@gmail.com>

---------

Signed-off-by: AmiStrn <123amitai@gmail.com>
(cherry picked from commit b6763b1)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
opensearch-trigger-bot bot pushed a commit that referenced this pull request Apr 4, 2023
…ec set to `0mb` or less (#3649)

* After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.
Resolves #3648

Signed-off-by: AmiStrn <123amitai@gmail.com>

* Modifying the proposal based on maintainers input.

Signed-off-by: AmiStrn <123amitai@gmail.com>

---------

Signed-off-by: AmiStrn <123amitai@gmail.com>
(cherry picked from commit b6763b1)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Naarcha-AWS pushed a commit that referenced this pull request Apr 4, 2023
…ec set to `0mb` or less (#3649) (#3670)

* After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.
Resolves #3648



* Modifying the proposal based on maintainers input.



---------


(cherry picked from commit b6763b1)

Signed-off-by: AmiStrn <123amitai@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Naarcha-AWS pushed a commit that referenced this pull request Apr 4, 2023
…ec set to `0mb` or less (#3649) (#3669)

* After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.
Resolves #3648



* Modifying the proposal based on maintainers input.



---------


(cherry picked from commit b6763b1)

Signed-off-by: AmiStrn <123amitai@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Naarcha-AWS pushed a commit that referenced this pull request Apr 6, 2023
…ec set to `0mb` or less (#3649) (#3668)

* After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.
Resolves #3648



* Modifying the proposal based on maintainers input.



---------


(cherry picked from commit b6763b1)

Signed-off-by: AmiStrn <123amitai@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
vagimeli pushed a commit that referenced this pull request Apr 25, 2023
…ec set to `0mb` or less (#3649)

* After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.
Resolves #3648

Signed-off-by: AmiStrn <123amitai@gmail.com>

* Modifying the proposal based on maintainers input.

Signed-off-by: AmiStrn <123amitai@gmail.com>

---------

Signed-off-by: AmiStrn <123amitai@gmail.com>
vagimeli added a commit that referenced this pull request Apr 25, 2023
…es_per_sec set to `0mb` or less (#3649)"

This reverts commit dd4b0e8.
vagimeli pushed a commit that referenced this pull request May 4, 2023
…ec set to `0mb` or less (#3649)

* After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.
Resolves #3648

Signed-off-by: AmiStrn <123amitai@gmail.com>

* Modifying the proposal based on maintainers input.

Signed-off-by: AmiStrn <123amitai@gmail.com>

---------

Signed-off-by: AmiStrn <123amitai@gmail.com>
vagimeli added a commit that referenced this pull request May 4, 2023
…es_per_sec set to `0mb` or less (#3649)"

This reverts commit ed98bdc.
harshavamsi pushed a commit to harshavamsi/documentation-website that referenced this pull request Oct 31, 2023
…ec set to `0mb` or less (opensearch-project#3649)

* After a lovely surprise when trying to limit the recovery completely and discovering the opposite was happening I see we need the documentation to include this nice extra info.
Resolves opensearch-project#3648

Signed-off-by: AmiStrn <123amitai@gmail.com>

* Modifying the proposal based on maintainers input.

Signed-off-by: AmiStrn <123amitai@gmail.com>

---------

Signed-off-by: AmiStrn <123amitai@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport 1.3 PR: Backport label for v1.3.x backport 2.5 PR: Backport label for 2.5 backport 2.6 PR: Backport label for 2.6

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[DOC] missing documentation for setting "indices.recovery.max_bytes_per_sec" to <= 0

3 participants