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

opensearch-java compatibility is incorrect in OpenSearch 1.3 docs #5532

Closed
channel-dante opened this issue Nov 7, 2023 · 4 comments
Closed
Assignees
Labels
needs-more-info Sev3 Medium priority. Content that's missing, driven by dev, PM or the community.

Comments

@channel-dante
Copy link

channel-dante commented Nov 7, 2023

What's confusing?

According to the opensearch official document(link), the 1.3.x version of opensearch also guides installing the 2.x version of opensearch-java.
image

However, this is different from the version compatibility table discussed here in this repository (link).
image

What do I want to know?

  1. I am using version 1.3.2 of opensearch through AWS. Can I use the 2.x version of opensearch-java? Below is the opensearch information via endpoint.
  2. the latest version of opensearch-java 2.x has all the APIs for the latest versions of OpenSearch 1.x and 2.x ?
  3. If there are no problems with breaking changes (1.3 -> 2.0.0, link) , is it okay to use 2.x?

Since version 1.x is no longer being upgraded from 1.0.0, I would like to use version 2.x if possible.

{
  "name" : ...,
  "cluster_name" : ...,
  "cluster_uuid" : ...,
  "version" : {
    "distribution" : "opensearch",
    "number" : "1.3.2",
    "build_type" : "tar",
    "build_hash" : "unknown",
    "build_date" : "2023-08-..",
    "build_snapshot" : false,
    "lucene_version" : "8.10.1",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "The OpenSearch Project: https://opensearch.org/"
}

@channel-dante channel-dante added bug Technical problem with the doc site or broken link untriaged labels Nov 7, 2023
@dblock
Copy link
Member

dblock commented Nov 7, 2023

The documentation in this repo is correct. I'll move this to the documentation repo to correct 1.3 docs on client compat.

@dblock dblock changed the title Opensearch Version Compatibility opensearch-java compatibility is incorrect in OpenSearch 1.3 docs Nov 7, 2023
@dblock dblock transferred this issue from opensearch-project/opensearch-java Nov 7, 2023
@Naarcha-AWS Naarcha-AWS added 1 - Backlog Issue: The issue is unassigned or assigned but not started Sev3 Medium priority. Content that's missing, driven by dev, PM or the community. and removed bug Technical problem with the doc site or broken link untriaged labels Nov 14, 2023
@Naarcha-AWS Naarcha-AWS added this to the Sprint 11.13.23 milestone Nov 14, 2023
@Naarcha-AWS Naarcha-AWS added the good first issue Good for newcomers label Nov 14, 2023
@hdhalter
Copy link
Contributor

@kolchfa-aws - Is this similar to #2741?

@kolchfa-aws
Copy link
Collaborator

@VachaShah as the expert on the Java client, could you comment on this?

@hdhalter hdhalter added needs-more-info and removed 1 - Backlog Issue: The issue is unassigned or assigned but not started good first issue Good for newcomers labels Nov 28, 2023
@hdhalter
Copy link
Contributor

hdhalter commented May 2, 2024

We have added a note about using the Java client 2.0 with OpenSearch 1.x: https://github.com/opensearch-project/opensearch-java/blob/main/COMPATIBILITY.md#upgrading

@hdhalter hdhalter closed this as completed May 2, 2024
@hdhalter hdhalter removed this from the Weeks 47/48 milestone May 2, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
needs-more-info Sev3 Medium priority. Content that's missing, driven by dev, PM or the community.
Projects
None yet
Development

No branches or pull requests

6 participants