Loading

Upgrade your deployment on Elastic Cloud Enterprise (ECE)

Similar to Elastic Cloud Hosted, a single click in the Elastic Cloud console can upgrade a deployment running on ECE to a newer version, add more processing capacity, change plugins, and enable or disable high availability, all at the same time. During the upgrade process, Elasticsearch, Kibana, and all of your deployment components are upgraded simultaneously.

Once you're prepared to upgrade, do the following:

  1. Ensure your current ECE and Docker or Podman versions are compatible with the Elastic Stack version you're upgrading to. For example, if you're upgrading to 9.0.0, the minimum required version is ECE 3.0. If you don’t have a compatible version installed, upgrade your orchestrator.
  2. Download the most recent stack pack for the version you’re upgrading to, then add the stack pack to your installation using the Cloud UI.
  3. If not configured already, assign a snapshots repository to your deployment to enable snapshots and back up your data. Although this is optional, we recommend this step.

  1. Log in to the Cloud UI.

  2. On the Deployments page, select your deployment.

    Narrow the list by name, ID, or choose from several other filters. To further define the list, use a combination of filters.

  3. In the Deployment version section, click Upgrade.

  4. Select the version you're upgrading to. For example, 9.0.0.

  5. Click Upgrade, then Confirm upgrade. The new configuration takes a few minutes to create.

    Note

    If any incompatibilities are detected when you attempt to upgrade, the UI provides a link to the Upgrade Assistant, which checks for deprecated settings in your cluster and indices and helps you resolve them. If there are any issues that would prevent a successful upgrade, the upgrade is blocked. After resolving the issues, return to the Deployments page and restart the upgrade. Also check the release notes to stay aware of changes and known issues for the version you're upgrading to.

Security realm settings

During the upgrade process, you are prompted to update the security realm settings if your user settings include a xpack.security.authc.realms value.

If the security realms are configured in user_settings, you’ll be prompted to modify the settings:

  1. On the Update security realm settings window, edit the settings.
  2. Click Update settings. If the security realm settings are located in user_settings_override, contact support to help you upgrade.

Once you've successfully upgraded your deployment, upgrade your ingest components, such as Logstash, Elastic Agents, or Beats.