New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
« Upgrade on Elastic Cloud Hosted Upgrade on Elastic Cloud on Kubernetes (ECK) »
Elastic Docs ›Elastic Installation and Upgrade Guide [9.0] ›Upgrade to Elastic 9.0.0-beta1 ›Upgrade your deployment or cluster

Upgrade on Elastic Cloud Enterprise (ECE)

edit

Upgrade on Elastic Cloud Enterprise (ECE)

edit

Similar to Elastic Cloud Hosted, a single click in the Elastic Cloud console can upgrade a deployment running on ECE to a newer version. 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 versions are compatible with 9.0.0-beta1 (the minimum required version for 9.x 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 via the Cloud UI.
  3. Back up your data to a snapshot. First, configure a snapshot repository to enable snapshots.

Perform the upgrade

edit
  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.

To upgrade a deployment:

  1. In the Deployment version section, click Upgrade.
  2. Select version 9.0.0-beta1.

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

    If any incompatibilities are detected when you attempt to upgrade to 9.0.0-beta1, the UI provides a link to the Upgrade Assistant, which checks for deprecated settings in your cluster and indices and helps you resolve them. After resolving the issues, return to the deployments page and restart the upgrade.

    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.

After you’re done upgrading, upgrade your ingest components in the following order:

  1. Logstash: upgrade instructions
  2. Beats: upgrade instructions
  3. Elastic Agent: upgrade instructions
  4. APM agents: upgrade instructions
« Upgrade on Elastic Cloud Hosted Upgrade on Elastic Cloud on Kubernetes (ECK) »

On this page

Was this helpful?
Feedback