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:

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.

Most recent Elastic Stack packsedit

The following are the most recently released Elastic Stack packs for version 8.x, 7.x, and 6.x, respectively:

All available Elastic Stack packsedit

Following is the full list of available packs containing Elastic Stack versions. Note that Enterprise Search was introduced with ECE 2.6.0 and requires that version or higher.

Before you beginedit

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, as shown in our examples, or use HTTP over port 12400.

Get Elastic Stack informationedit

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:

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

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 packsedit

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:

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

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

Update Elastic Stack packsedit

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:

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