Skip to content

Commit 5f08804

Browse files
committed
suggestions implemented
1 parent 3554a3a commit 5f08804

File tree

2 files changed

+42
-34
lines changed

2 files changed

+42
-34
lines changed
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
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.

deploy-manage/upgrade/deployment-or-cluster/upgrade-717.md

Lines changed: 27 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,10 @@ Upgrading from 7.17 to {{version.stack}} requires two major upgrades. Each major
2323
This completes the upgrade to the latest 9.x release.
2424
Before running this upgrade, all ingest components and client libraries must be upgraded to 8.19.x.
2525

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+
2630
The following sections describe these phases in detail and point to the relevant documentation for each deployment type.
2731

2832
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
4650

4751
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.
4852

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:
5054

5155
* **Ingest components:**
5256

@@ -158,6 +162,8 @@ Keep the following considerations in mind when upgrading your deployment or clus
158162
* If you use [Stack monitoring](/deploy-manage/monitor/stack-monitoring.md) with a dedicated monitoring cluster, upgrade your monitoring cluster first.
159163
* If you use [remote cluster](/deploy-manage/remote-clusters.md) functionality, upgrade the remote clusters first.
160164

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+
161167
To perform the upgrade, follow the instructions below for your specific deployment type:
162168

163169
::::{applies-switch}
@@ -186,7 +192,9 @@ During the upgrade process, all components of your deployment are upgraded in th
186192
- Integrations Server ({{fleet-server}} and APM)
187193
:::
188194

195+
189196
:::{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.
190198

191199
To upgrade your cluster to 8.19, follow the steps in [Upgrade on ECK](/deploy-manage/upgrade/deployment-or-cluster/upgrade-on-eck.md).
192200

@@ -201,12 +209,10 @@ Make sure to upgrade all components in the specified order.
201209

202210
::::
203211

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]
209213

214+
:::{include} _snippets/upgrade-validation.md
215+
:::
210216

211217
### Upgrade ingest components to 8.19.x
212218

@@ -216,6 +222,12 @@ Refer to [Upgrade your ingest components](/deploy-manage/upgrade/ingest-componen
216222

217223
After upgrading your ingest components, verify that they’re running correctly and sending data to the cluster before proceeding with the next upgrade.
218224

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+
219231
## Upgrade Step 2: 8.19.x → {{version.stack}}
220232

221233
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
351363

352364
### {{version.stack}} upgrade validation
353365

354-
(TBD)
366+
:::{include} _snippets/upgrade-validation.md
367+
:::
355368

356369
### (Optional) Upgrade ingest components to {{version.stack}}
357370

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

Comments
 (0)