You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
After completing the upgrade, verify that your system is fully operational. Check that data ingestion and search are working as expected, clients and integrations can connect, and {{kib}} is accessible.
2
+
3
+
Confirm that the cluster is healthy and reports the expected version. You can use the following APIs to validate the cluster status after the upgrade:
4
+
5
+
* Check cluster health
6
+
```console
7
+
GET _cluster/health?pretty
8
+
```
9
+
Ensure the status is green, or yellow if that is expected for your configuration (for example, in single-node clusters).
10
+
11
+
* Check nodes and version
12
+
```console
13
+
GET _cat/nodes?v&h=name,node.role,master,ip,version
14
+
```
15
+
Verify that all nodes report the upgraded version in the version column.
Copy file name to clipboardExpand all lines: deploy-manage/upgrade/deployment-or-cluster/upgrade-717.md
+27-34Lines changed: 27 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,6 +23,10 @@ Upgrading from 7.17 to {{version.stack}} requires two major upgrades. Each major
23
23
This completes the upgrade to the latest 9.x release.
24
24
Before running this upgrade, all ingest components and client libraries must be upgraded to 8.19.x.
25
25
26
+
:::{note}
27
+
Upgrading only to version 8.19.x is also a supported path, as it remains a maintained and fully supported release. However, we recommend completing the upgrade to the latest {{version.stack}} version to take advantage of ongoing improvements and new features.
28
+
:::
29
+
26
30
The following sections describe these phases in detail and point to the relevant documentation for each deployment type.
27
31
28
32
Refer to [upgrade paths](/deploy-manage/upgrade.md#upgrade-paths) for more information.
@@ -46,7 +50,7 @@ The [planning phase](/deploy-manage/upgrade/plan-upgrade.md) ensures that the up
46
50
47
51
It involves defining a clear sequence of actions and assessing the impact on [service availability](/deploy-manage/upgrade.md#availability-during-upgrades) and performance during the upgrade.
48
52
49
-
For the 7.17.x → 9.x upgrade path, the main planning outcome is a set of required actions to ensure compatibility across the ecosystem:
53
+
For the 7.17.x → 9.x upgrade path, the main planning outcome is a set of required actions to ensure compatibility across the environment:
50
54
51
55
***Ingest components:**
52
56
@@ -158,6 +162,8 @@ Keep the following considerations in mind when upgrading your deployment or clus
158
162
* If you use [Stack monitoring](/deploy-manage/monitor/stack-monitoring.md) with a dedicated monitoring cluster, upgrade your monitoring cluster first.
159
163
* If you use [remote cluster](/deploy-manage/remote-clusters.md) functionality, upgrade the remote clusters first.
160
164
165
+
Before starting the upgrade, run the same checks and validations you plan to perform afterward, so you have a baseline for comparison. Refer to [](#819-validation) for example checks.
166
+
161
167
To perform the upgrade, follow the instructions below for your specific deployment type:
162
168
163
169
::::{applies-switch}
@@ -186,7 +192,9 @@ During the upgrade process, all components of your deployment are upgraded in th
186
192
- Integrations Server ({{fleet-server}} and APM)
187
193
:::
188
194
195
+
189
196
:::{applies-item} eck:
197
+
In ECK, upgrades are performed declaratively by updating the `spec.version` field in the resource manifest. Once the new version is applied, the operator automatically orchestrates the upgrade, ensuring that each component is upgraded safely and in the correct order.
190
198
191
199
To upgrade your cluster to 8.19, follow the steps in [Upgrade on ECK](/deploy-manage/upgrade/deployment-or-cluster/upgrade-on-eck.md).
192
200
@@ -201,12 +209,10 @@ Make sure to upgrade all components in the specified order.
201
209
202
210
::::
203
211
204
-
### 8.19 upgrade validation
205
-
206
-
After completing the upgrade, verify that your system is fully operational. Check that data ingestion and search are working as expected, clients and integrations can connect, and {{kib}} is accessible.
207
-
208
-
Confirm that the cluster is healthy and reports the expected version.
212
+
### 8.19 upgrade validation [819-validation]
209
213
214
+
:::{include} _snippets/upgrade-validation.md
215
+
:::
210
216
211
217
### Upgrade ingest components to 8.19.x
212
218
@@ -216,6 +222,12 @@ Refer to [Upgrade your ingest components](/deploy-manage/upgrade/ingest-componen
216
222
217
223
After upgrading your ingest components, verify that they’re running correctly and sending data to the cluster before proceeding with the next upgrade.
218
224
225
+
:::{note}
226
+
At this point, you have a fully operational {{stack}} 8.19.x environment. You can choose to remain on this version, as it’s fully maintained and supported.
227
+
228
+
However, we recommend upgrading to {{version.stack}} to benefit from the latest features and performance improvements.
229
+
:::
230
+
219
231
## Upgrade Step 2: 8.19.x → {{version.stack}}
220
232
221
233
This step covers upgrading your deployment from 8.19.x to {{version.stack}}, assuming that all ingest components have been upgraded to 8.19.x, and client libraries are compatible with 9.x.
@@ -351,34 +363,15 @@ Follow the steps in the [upgrade Elastic on-prem](https://www.elastic.co/guide/e
351
363
352
364
### {{version.stack}} upgrade validation
353
365
354
-
(TBD)
366
+
:::{include} _snippets/upgrade-validation.md
367
+
:::
355
368
356
369
### (Optional) Upgrade ingest components to {{version.stack}}
357
370
358
-
(TBD)
359
-
This step is optional, because all ingest components on 8.19.x are compatible with {{stack}} 9.x.
360
-
361
-
Refer to [upgrade your ingest components](/deploy-manage/upgrade/ingest-components.md) for more details.
362
-
363
-
364
-
## Post-Upgrade Wrap-Up
365
-
366
-
(TBD)
367
-
- Confirm cluster stability over an observation period
368
-
- Update operational runbooks and monitoring baselines
369
-
- Validate client library upgrades and integrations
370
-
- Decommission old snapshots if no longer needed
371
-
- Document lessons learned
372
-
373
-
<!--
374
-
(internal list):
375
-
upgrade assistant
376
-
* if you are prompted.... refer to xxx ccr / transforms / old ML indices
377
-
breaking changes
378
-
plugins
379
-
snapshot
380
-
test
381
-
monit first
382
-
remote first
383
-
close ML jobs
384
-
-->
371
+
This step is optional, as all ingest components running on 8.19.x are fully compatible with {{stack}} 9.x. However, upgrading them to {{version.stack}} ensures version alignment across your environment and allows you to take advantage of the latest features, performance improvements, and fixes.
372
+
373
+
Refer to [Upgrade your ingest components](/deploy-manage/upgrade/ingest-components.md) for detailed upgrade instructions.
374
+
375
+
## Next steps
376
+
377
+
You now have a fully upgraded {{stack}} {{version.stack}} environment. To explore new capabilities, see [What’s new in {{version.stack}}](/release-notes/intro/index.md#whats-new-in-the-latest-elastic-release).
0 commit comments