Manage Elastic Stack Versions

Elastic Cloud Enterprise ships with a number of different versions of the Elastic Stack containing Elasticsearch and Kibana. Periodically, you might need to manage Elastic Stack versions for one of the following reasons:

  • To add new versions of the Elastic Stack as they become available
  • To obtain information about existing Elastic Stack versions
  • To update existing versions of the Elastic Stack
  • To add the Elastic Stack versions that shipped with a version of ECE that you upgraded to

New or updated versions of the Elastic Stack must be prepared to work with Elastic Cloud Enterprise and are provided as packs that you can download.

The following packs containing Elastic Stack versions are available:

Elastic Stack packContains

6.5.3

Elasticsearch and Kibana version 6.5.3

6.5.2

Elasticsearch and Kibana version 6.5.2

6.5.1

Elasticsearch and Kibana version 6.5.1

6.5.0

Elasticsearch and Kibana version 6.5.0

6.4.3

Elasticsearch and Kibana version 6.4.3

6.4.2

Elasticsearch and Kibana version 6.4.2

6.4.1

Elasticsearch and Kibana version 6.4.1

6.4.0

Elasticsearch and Kibana version 6.4.0

6.3.2

Elasticsearch and Kibana version 6.3.2

6.3.1

Elasticsearch and Kibana version 6.3.1

6.3.0

Elasticsearch and Kibana version 6.3.0

6.2.4

Elasticsearch and Kibana version 6.2.4

6.2.3

Elasticsearch and Kibana version 6.2.3

6.2.2

Elasticsearch and Kibana version 6.2.2

6.1.4

Elasticsearch and Kibana version 6.1.4

6.1.3

Elasticsearch and Kibana version 6.1.3

6.0.1

Elasticsearch and Kibana version 6.0.1

6.0.0

Elasticsearch and Kibana version 6.0.0

5.6.14

Elasticsearch and Kibana version 5.6.14

5.6.13

Elasticsearch and Kibana version 5.6.13

5.6.12

Elasticsearch and Kibana version 5.6.12

5.6.11

Elasticsearch and Kibana version 5.6.11

5.6.10

Elasticsearch and Kibana version 5.6.10

5.6.9

Elasticsearch and Kibana version 5.6.9

5.6.8

Elasticsearch and Kibana version 5.6.8

5.6.7

Elasticsearch and Kibana version 5.6.7

5.6.6

Elasticsearch and Kibana version 5.6.6

5.6.5

Elasticsearch and Kibana version 5.6.5

5.6.4

Elasticsearch and Kibana version 5.6.4

5.6.3

Elasticsearch and Kibana version 5.6.3

5.6.2

Elasticsearch and Kibana version 5.6.2

5.6.1

Elasticsearch and Kibana version 5.6.1

5.5.3

Elasticsearch and Kibana version 5.5.3

5.5.2

Elasticsearch and Kibana version 5.5.2

5.5.1

Elasticsearch and Kibana version 5.5.1

5.5.0

Elasticsearch and Kibana version 5.5.0

5.4.3

Elasticsearch and Kibana version 5.4.3

5.4.2

Elasticsearch and Kibana version 5.4.2

5.4.1

Elasticsearch and Kibana version 5.4.1

5.4.0

Elasticsearch and Kibana version 5.4.0

2.4.6

Elasticsearch version 2.4.6 and Kibana version 4.6.5

2.4.5

Elasticsearch version 2.4.5 and Kibana version 4.6.4

Tip

For offline or air-gapped installations, additional steps are required to add Elastic Stack packs, as these packs do not contain any Docker images. After downloading a stack pack, you also need to pull and load the Docker images that match the Elastic Stack version. To learn more about what Docker images you need and about pulling and loading Docker images, see Install ECE (Without Internet Access).

Before you Begin

The examples shown all use HTTPS over port 12443, which requires that you have a TLS certificate configured. Alternatively, you can specify the -k option to turn off certificate verification or use HTTP over port 12400.

Get Elastic Stack Information

You can obtain information about existing Elastic Stack versions that are available in your installation through the Cloud UI or through the command line.

To obtain information about available Elastic Stack versions through the Cloud UI:

  1. Log into the Cloud UI.
  2. From the Platform menu, select Elastic Stack.
  3. Click on the version that you want.

    The available Elastic Stack versions are shown. More detailed information about Docker images, plugins, and related Kibana versions are also available for each Elasticsearch version.

To obtain information about available Elastic Stack versions through the command line:

curl -X GET -u USER:PASSWORD https://COORDINATOR_HOST:12443/api/v1/stack/versions

The admin user

The password for the user

A host that you installed Elastic Cloud Enterprise on that holds the coordinator role, such as a host where you can log into the Cloud UI

For example (output abridged for brevity):

curl -X GET -u admin:4Z52y8Gq7PrxMDy47ipJPSh4ozBMynOGa9HWxcy2D3j https://10.56.12.153:12443/api/v1/stack/versions
{
  "stacks": [
    {
      "version": "2.4.5",
      "template": {
        "template_version": "",
        "hashes": []
      },
      "elasticsearch": {
        "docker_image": "docker.elastic.co/cloud-enterprise/elasticsearch:2.4.5-0",
        "plugins": [
          "graph",
          "analysis-icu",
          "analysis-kuromoji",
          "analysis-smartcn",
          "analysis-stempel",
          "analysis-phonetic",
          "watcher",
          "mapper-attachments",
          "delete-by-query"
        ],
        "default_plugins": [
          "found-elasticsearch",
          "cloud-aws",
          "found-license-plugin",
          "shield",
          "marvel-agent"
        ...
        ]
      }
    },
    {
      "version": "5.2.2",
      "template": {
        "template_version": "",
        "hashes": []
      },
      "elasticsearch": {
        "docker_image": "docker.elastic.co/cloud-enterprise/elasticsearch:5.2.2-0",
        "plugins": [
          "analysis-icu",
          "analysis-kuromoji",
          "analysis-smartcn",
          "analysis-stempel",
          "analysis-phonetic",
          "mapper-attachments",
          "ingest-attachment",
          "ingest-geoip",
          "ingest-user-agent"
        ],
        "default_plugins": [
          "repository-s3",
          "found-elasticsearch",
          "x-pack"
        ...
        ]
      }
    }
  ]
}

You can also query for a specific version with a URI such as https://COORDINATOR_HOST:12443/api/v1/stack/versions/5.3.2, for example.

Add Elastic Stack Packs

You can add new Elastic Stack packs to your installation through the Cloud UI, through the Elastic Cloud Enterprise installation script, or through the RESTful API.

To add a new Elastic Stack pack from the Cloud UI:

  1. Download the Elastic Stack version that you want.
  2. Log into the Cloud UI.
  3. From the Platform menu, select Elastic Stack.
  4. Click Upload Elastic Stack pack.
  5. Select a .zip file that contains an Elastic Stack pack and upload it.

    After the stack pack has been uploaded successfully, the new version appears in the list of Elastic Stack versions and can be used when you create or change a deployment.

To add a new Elastic Stack pack through the Elastic Cloud Enterprise installation script from the command line:

  1. Log into a host running Elastic Cloud Enterprise.
  2. Add the Elastic Stack pack with the add-stack-version action:

    ./elastic-cloud-enterprise.sh add-stack-version --version X.Y.Z --user USER --pass PASSWORD

    A supported Elastic Stack version, such as 5.4.0

    The admin user

    The password for the user

    For example:

    bash elastic-cloud-enterprise.sh add-stack-version --version 5.4.0 --user admin --pass pGX5DwKzVAAIeCIpTwwAkCuJDu0ASdFP33UmYpfogfF

To add a new Elastic Stack pack through the RESTful API from the command line:

  1. Download the pack on an internet-connected host from Elastic and make it available locally.
  2. Add the Elastic Stack pack with the following API call:

    curl -X POST -u USER:PASSWORD https://COORDINATOR_HOST:12443/api/v1/stack/versions \
    -H 'content-type: application/zip' \
    --data-binary "@PATH/STACK_PACK_FILE"

    The admin user

    The password for the user

    A host that you installed Elastic Cloud Enterprise on that holds the coordinator role, such as a host where you can log into the Cloud UI

    The local path and the new Elastic Stack pack .zip file

    For example:

    curl -X POST -u admin:pGX5DwKzVAAIeCIpTwwAkCuJDu0ASdFP33UmYpfogfF https://10.56.12.153:12443/api/v1/stack/versions \
    -H 'content-type: application/zip' \
    --data-binary "@/Users/iuriitceretian/Documents/stacks/5.4.0.zip"

Update Elastic Stack Packs

Updating an Elastic Stack pack might become necessary if an Elastic Stack version has been updated with security fixes, for example. You can update an existing Elastic Stack version through the Cloud UI or through the command line.

Updated versions of Elasticsearch and Kibana are used when you create new Elasticsearch clusters, but they are not automatically applied to already running clusters. To update existing Elasticsearch clusters and Kibana after an updated Elastic Stack pack has been added, you need to change the deployment configuration.

To update Elastic Stack packs through the Cloud UI:

  1. Download the Elastic Stack version that you want.
  2. Log into the Cloud UI.
  3. From the Platform menu, select Elastic Stack.
  4. Delete the old pack you want to replace.
  5. Click Upload Elastic Stack pack.
  6. Select a ZIP file that contains an Elastic Stack pack and upload it.

    After the stack pack has been uploaded successfully, the updated Elastic Stack version replaces the existing one.

To update Elastic Stack packs through the RESTful API from the command line:

  1. Download an updated pack on an internet-connected host from Elastic and make it available locally.
  2. Update the Elastic Stack pack with the following API call:

    curl -X PUT -u USER:PASSWORD https://COORDINATOR_HOST:12443/api/v1/stack/versions \
    -H 'content-type: application/zip' \
    --data-binary "@PATH/STACK_PACK_FILE"

    The admin user

    The password for the user

    A host that you installed Elastic Cloud Enterprise on that holds the coordinator role, such as a host where you can log into the Cloud UI

    The local path and the updated Elastic Stack pack .zip file

    For example:

    curl -X PUT -u admin:pGX5DwKzVAAIeCIpTwAAkCuJDu0ASdFP33UmYpfogfF https://10.58.12.153:12443/api/v1/stack/versions \
    -H 'content-type: application/octet-stream' \
    --data-binary "@/Users/johnsmith/Documents/stacks/6.4.0.zip"