Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Change remote store documentation to reflect all the config options #1245

Merged
merged 3 commits into from
Sep 20, 2022

Conversation

sachinpkale
Copy link
Member

Signed-off-by: Sachin Kale [email protected]

Description

  • In 2.3.0 release of OpenSearch, remote store is experimental feature and can be enabled by using 1 of the 3 options:
    • By updating jvm.options file
    • By using OPENSEARCH_JAVA_OPTS environment variable
    • By changing run.gradle
  • In the current documentation for remote store, only first 2 options are mentioned and run.gradle option is documented as a pre-requisite.
  • Please refer Segment Replication configuration doc for these changes

Issues Resolved

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

@sachinpkale sachinpkale requested a review from a team as a code owner September 16, 2022 06:29
Copy link
Collaborator

@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.

Thanks @sachinpkale! Just a few suggestions and we'll get this merged in.

@@ -12,30 +12,18 @@ Remote-backed storage is an experimental feature. Therefore, we do not recommend
Remote-backed storage offers OpenSearch users a new way to protect against data loss by automatically creating backups of all index transactions and sending them to remote storage. In order to expose this feature, segment replication must also be enabled. See [Segment replication]({{site.url}}{{site.baseurl}}/opensearch/segment-replication/) for additional information.


## Enable the feature
## Enabling the feature flag
Copy link
Collaborator

Choose a reason for hiding this comment

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

Let's switch to "Enable the feature flag".


### Option 1: Modify jvm.options
1. Option 1: Modify jvm.options
Copy link
Collaborator

Choose a reason for hiding this comment

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

Let's keep these as H3 headers, just for consistency with the gradle option.

Copy link
Member Author

Choose a reason for hiding this comment

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

These come under H3 header: Enable on a node using a tarball install so changed it to H4 header. Let me know if that is fine.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Works for me.

@@ -50,7 +38,7 @@ Run OpenSearch
./bin/opensearch
```

### Option 2: Enable from an environment variable
1. Option 2: Enable from an environment variable
Copy link
Collaborator

Choose a reason for hiding this comment

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

Same here, let's keep as an h3 heading.

@@ -67,6 +55,32 @@ export OPENSEARCH_JAVA_OPTS="-Dopensearch.experimental.feature.replication_type.
./bin/opensearch
```

### For developers using Gradle, enable feature flag by updating run.gradle
Copy link
Collaborator

Choose a reason for hiding this comment

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

Let's rename this header to "Enable for OpenSearch development".

}
```

### Enable with Docker containers
Copy link
Collaborator

Choose a reason for hiding this comment

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

Let's put this above the gradle section with the other two JVM options.

Sachin Kale added 2 commits September 19, 2022 10:32
Signed-off-by: Sachin Kale <[email protected]>
Signed-off-by: Sachin Kale <[email protected]>
@sachinpkale
Copy link
Member Author

Thanks @sachinpkale! Just a few suggestions and we'll get this merged in.

Thanks @Naarcha-AWS for the review. I have addressed your comments. Please take a look again.

@Naarcha-AWS Naarcha-AWS added the backport 2.3 PR: Backport label for 2.3 label Sep 20, 2022
@Naarcha-AWS Naarcha-AWS merged commit 57417bb into opensearch-project:main Sep 20, 2022
opensearch-trigger-bot bot pushed a commit that referenced this pull request Sep 20, 2022
…1245)

* Change remote store documentation to reflect all the config options

Signed-off-by: Sachin Kale <[email protected]>

* Address review comments

Signed-off-by: Sachin Kale <[email protected]>

* Address review comments

Signed-off-by: Sachin Kale <[email protected]>

Signed-off-by: Sachin Kale <[email protected]>
Co-authored-by: Sachin Kale <[email protected]>
(cherry picked from commit 57417bb)
Naarcha-AWS pushed a commit that referenced this pull request Sep 20, 2022
…1245) (#1274)

* Change remote store documentation to reflect all the config options

Signed-off-by: Sachin Kale <[email protected]>

* Address review comments

Signed-off-by: Sachin Kale <[email protected]>

* Address review comments

Signed-off-by: Sachin Kale <[email protected]>

Signed-off-by: Sachin Kale <[email protected]>
Co-authored-by: Sachin Kale <[email protected]>
(cherry picked from commit 57417bb)

Co-authored-by: Sachin Kale <[email protected]>
macohen pushed a commit to macohen/documentation-website that referenced this pull request Sep 21, 2022
…pensearch-project#1245)

* Change remote store documentation to reflect all the config options

Signed-off-by: Sachin Kale <[email protected]>

* Address review comments

Signed-off-by: Sachin Kale <[email protected]>

* Address review comments

Signed-off-by: Sachin Kale <[email protected]>

Signed-off-by: Sachin Kale <[email protected]>
Co-authored-by: Sachin Kale <[email protected]>
Signed-off-by: Mark Cohen <[email protected]>
Naarcha-AWS pushed a commit that referenced this pull request Oct 6, 2022
…1245)

* Change remote store documentation to reflect all the config options

Signed-off-by: Sachin Kale <[email protected]>

* Address review comments

Signed-off-by: Sachin Kale <[email protected]>

* Address review comments

Signed-off-by: Sachin Kale <[email protected]>

Signed-off-by: Sachin Kale <[email protected]>
Co-authored-by: Sachin Kale <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport 2.3 PR: Backport label for 2.3
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants