|
1 | 1 | # Upgrade
|
2 | 2 |
|
3 |
| -% What needs to be done: Write from scratch |
| 3 | +⚠️ **This page is a work in progress.** ⚠️ |
4 | 4 |
|
5 |
| -% GitHub issue: https://github.com/elastic/docs-projects/issues/355 |
| 5 | +Upgrading to the latest version provides you access to Elastic latest features, enhancements, performance improvements, and bug fixes, many of which enable you to save your organization money, respond faster to potential threats, and improve the tools you use to investigate and analyze your data. As new versions are released, older versions reach their end of life at a regular cadence, so it’s important to ensure that your deployment is fully maintained and supported. For more information, refer to Elastic’s [Product End of Life Dates](https://www.elastic.co/support/eol). |
| 6 | + |
| 7 | +:::{note} |
| 8 | +Upgrading from a release candidate build, such as 9.0.0-rc1 or 9.0.0-rc2, is not supported. Pre-releases should only be used for testing in a temporary environment. |
| 9 | +::: |
| 10 | + |
| 11 | +## Plan your upgrade [plan-upgrade] |
| 12 | + |
| 13 | +There are a number of things you need to plan for before performing the actual upgrade, so create a test plan. Consider the following recommendations: |
| 14 | + |
| 15 | +* Plan for an appropriate amount of time to complete the upgrade. Depending on your configuration and the size of your cluster, the process can take up to a few weeks or more to complete. |
| 16 | +* Consider opening a [support case](https://support.elastic.co/) with Elastic to alert our Elastic Support team of your system change. If you need additional assistance, [Elastic Consulting Services](https://www.elastic.co/consulting) provides the technical expertise and step-by-step approach for upgrading your Elastic deployment. |
| 17 | +* Schedule a system maintenance window within your organization. |
| 18 | + |
| 19 | +**Check system requirements** |
| 20 | + |
| 21 | +Ensure the version you’re upgrading to for {{es}}, {{kib}}, and any ingest components supports your current operating system. Refer to the [Product and Operating System support matrix](https://www.elastic.co/support/matrix#matrix_os). |
| 22 | + |
| 23 | +**OpenJDK compatibility and FIPS compliance** |
| 24 | + |
| 25 | +By default, {{es}} is built using Java and includes a bundled version of [OpenJDK](https://openjdk.java.net/) within each distribution. While we strongly recommend using the bundled Java Virtual Machine (JVM) in all installations of {{es}}, if you choose to use your own JVM, ensure it’s compatible by reviewing the [Product and JVM support matrix](https://www.elastic.co/support/matrix#matrix_jvm). {{es}} 9.0 requires Java 21 and supports Java 24. |
| 26 | + |
| 27 | +If you’re running {{es}} in FIPS 140-2 mode, {{es}} 9.0 has been tested with [Bouncy Castle's](https://www.bouncycastle.org/java.html) FIPS implementation and is the recommended Java security provider when running {{es}}. |
| 28 | + |
| 29 | +**Conduct a component inventory** |
| 30 | + |
| 31 | +It is very important to map all the components that are being used on the {{stack}}. When you upgrade your deployment, you also may need to upgrade all the other components. You should record if each component is used, and if it is, also record the current version. While not comprehensive, here’s a list of components you should check: |
| 32 | + |
| 33 | +* {{es}} |
| 34 | +* {{es}} Hadoop |
| 35 | +* {{es}} plugins |
| 36 | +* {{es}} clients |
| 37 | +* {{kib}} |
| 38 | +* {{ls}} |
| 39 | +* {{ls}} plugins |
| 40 | +* {{beats}} |
| 41 | +* {{beats}} modules |
| 42 | +* {{apm-agent}} |
| 43 | +* APM server |
| 44 | +* {{agent}} |
| 45 | +* {{fleet}} |
| 46 | +* Security |
| 47 | +* Browsers |
| 48 | +* External services (Kafka, etc.) |
| 49 | + |
| 50 | +:::{tip} |
| 51 | +When you do your inventory, you can [enable audit logging](/deploy-manage/monitor/logging-configuration/enabling-audit-logs.md) to evaluate resources accessing your deployment. |
| 52 | +::: |
| 53 | + |
| 54 | +**Test your development environment** |
| 55 | + |
| 56 | +We highly recommend testing and upgrading in your development environment before your production environment. Therefore, it is crucial to ensure that both your development and production environments have the same settings. Consider checking the following components beforehand: |
| 57 | + |
| 58 | +* Enrichment information |
| 59 | +* Plugins |
| 60 | +* Mapping |
| 61 | +* Index lifecycle management (ILM) |
| 62 | +* Snapshot lifecycle management (SLM) |
| 63 | +* Index templates |
| 64 | +* {{ml-cap}} jobs |
| 65 | +* Inbound sample data |
| 66 | +* Live data |
| 67 | +* Performance |
| 68 | +* Outbound integrations |
| 69 | +* Dashboards |
| 70 | +* Alerts |
| 71 | +* Authentication |
| 72 | + |
| 73 | +## Choose your upgrade path [choose-upgrade-path] |
| 74 | + |
| 75 | +The procedures you follow to upgrade depend on your infrastructure and deployment method. You’ve installed Elastic components using either Elastic-managed infrastructure or self-managed infrastructure. |
| 76 | + |
| 77 | +### Elastic-managed infrastructure |
| 78 | + |
| 79 | +Elastic-managed infrastructure includes {{ecloud}} – the umbrella term for {{ech}} (ECH) and {{serverless-full}}. {{serverless-full}} (“Serverless”) is a fully managed cloud offering with three products: {{es-serverless}}, {{obs-serverless}}, and {{sec-serverless}}. All serverless products are built on top of the Search AI Lake. Customers on serverless receive the latest features automatically when updates are published and do not need to choose an upgrade path. |
| 80 | + |
| 81 | +{{ech}} is Elastic’s cloud offering for managing {{stack}} deployments, built on top of {{es}}. A single click in the {{ecloud}} console can upgrade a deployment to a newer version. |
| 82 | + |
| 83 | +### Self-managed infrastructure |
| 84 | + |
| 85 | +Self-managed infrastructure – either on-prem or on public cloud, includes: |
| 86 | +* {{stack}} |
| 87 | +* {{ece}} (ECE) |
| 88 | +* {{eck}} (ECK) |
| 89 | + |
| 90 | +For ECE and ECK, you must ensure the operator is running a compatible version with the {{stack}} version you’re upgrading to. If not, you need to upgrade that before you can upgrade your cluster. |
| 91 | + |
| 92 | +If you’re running the {{stack}} on your own self-managed infrastructure, you must upgrade each component individually. |
| 93 | + |
| 94 | +% Refer to the diagram below for a visualization of the different deployment methods. |
6 | 95 |
|
7 |
| -% Scope notes: Can have version-specific child pages Connection between upgrading your orchestrator and your cluster |
8 | 96 |
|
9 |
| -⚠️ **This page is a work in progress.** ⚠️ |
|
0 commit comments