Elasticsearch

TuxCare's Endless Lifecycle Support (ELS) for Elasticsearch provides security patches and selected bug fixes that are integral to the stable operation of applications running on the Elasticsearch Java client libraries.

Supported Versions

  • Elasticsearch 7.16.3, 7.17.15
  • Elasticsearch Java Client 7.17.15, 8.7.1, 8.13.4

Other versions upon request.

Installation

Prerequisites

  • Maven or Gradle build tool installed
  • Nexus repository access credentials (username and password) — contact [email protected]
  • To browse available artifacts, visit TuxCare Nexus and click Sign in in the top right corner. You may need to refresh the page after logging in.
  1. Configure credentials

    For Maven, you may choose any valid <id> value instead of tuxcare-registry, but use the same value in both settings.xml and pom.xml.

    <?xml version="1.0" encoding="UTF-8"?>
    <settings xmlns="http://maven.apache.org/SETTINGS/1.1.0">
      <servers>
        <server>
          <id>tuxcare-registry</id>
          <username>USERNAME</username>
          <password>PASSWORD</password>
        </server>
      </servers>
    </settings>

    Replace USERNAME and PASSWORD with your TuxCare credentials (see Prerequisites above).

  2. Add the TuxCare repository

    Add the TuxCare Elasticsearch repository and plugins to your build configuration.

    <repositories>
      <repository>
        <id>tuxcare-registry</id>
        <url>https://nexus.repo.tuxcare.com/repository/els_java/</url>
      </repository>
    </repositories>
    • To fully switch from the official Elasticsearch repository, replace it with the TuxCare repository.
    • To keep both, add TuxCare after the official one.

    Example Maven and Gradle projects are available on GitHub. Before running the examples, set the required environment variables.

  3. Update dependencies

    Replace Elasticsearch dependencies with TuxCare-maintained versions. You can find artifact versions on Nexus — sign in with your TuxCare credentials.

    <dependencies>
        <dependency>
            <groupId>org.elasticsearch.client</groupId>
            <artifactId>elasticsearch-rest-high-level-client</artifactId>
            <version>7.16.3-tuxcare.1</version>
        </dependency>
    </dependencies>

    For the Elasticsearch Java Client, use the co.elastic.clients:elasticsearch-java artifact:

    <dependencies>
        <dependency>
            <groupId>co.elastic.clients</groupId>
            <artifactId>elasticsearch-java</artifactId>
            <version>8.13.4-tuxcare.1</version>
        </dependency>
    </dependencies>
  4. Verify and build

    Verify the setup:

    mvn dependency:tree -Dverbose

    Build the project:

    mvn clean install

    The build tool identifies and resolves dependencies from the TuxCare ELS for Elasticsearch repository.

What's Next?