Skip to content

Commit fa2c6fd

Browse files
authored
[Upgrade 9.0] Minor fixes (#1141)
Contributes to [elastic/docs-projects#247](elastic/docs-projects#247) and [elastic/docs-projects#270](elastic/docs-projects#270) by incorporating some minor updates.
1 parent f85608c commit fa2c6fd

File tree

4 files changed

+14
-15
lines changed

4 files changed

+14
-15
lines changed

deploy-manage/upgrade/deployment-or-cluster/upgrade-on-ece.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Once you're [prepared to upgrade](/deploy-manage/upgrade/prepare-to-upgrade.md),
1414

1515
% Note: Add a link once confirmed where prepare to upgrade will reside in TOC.
1616

17-
1. Ensure your current ECE and Docker or Podman versions are [compatible](https://www.elastic.co/support/matrix/#elastic-cloud-enterprise) with the {{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](/deploy-manage/upgrade/orchestrator/upgrade-cloud-enterprise.md).
17+
1. Ensure your current ECE and Docker or Podman versions are [compatible](https://www.elastic.co/support/matrix/#elastic-cloud-enterprise) with the {{stack}} version you're upgrading to. For example, if you're upgrading to 9.0.0, the minimum required version is ECE 4.0. If you don’t have a compatible version installed, [upgrade your orchestrator](/deploy-manage/upgrade/orchestrator/upgrade-cloud-enterprise.md).
1818
2. Download the most recent [stack pack](/deploy-manage/deploy/cloud-enterprise/manage-elastic-stack-versions.md#ece_most_recent_elastic_stack_packs) for the version you’re upgrading to, then [add the stack pack](/deploy-manage/deploy/cloud-enterprise/manage-elastic-stack-versions.md#ece-manage-elastic-stack-add) to your installation using the Cloud UI.
1919
3. If not configured already, [assign a snapshots repository](/deploy-manage/tools/snapshot-and-restore/cloud-enterprise.md) to your deployment to enable snapshots and back up your data. Although this is optional, we recommend this step.
2020

deploy-manage/upgrade/orchestrator.md

+1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
navigation_title: "Upgrade your ECE or ECK orchestrator"
23
applies_to:
34
deployment:
45
ece:

deploy-manage/upgrade/plan-upgrade.md

+4-6
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Plan your upgrade
22

3-
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:
3+
There are several things you need to plan for before performing the actual upgrade, so create a test plan. Consider the following recommendations:
44

55
* 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.
66
* 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.
@@ -18,7 +18,7 @@ If you’re running {{es}} in FIPS 140-2 mode, we recommend using [Bouncy Castl
1818

1919
## Conduct a component inventory
2020

21-
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 whether 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:
21+
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 whether any users use each component, and if so, also record the current version. While not comprehensive, here’s a list of components you should check:
2222

2323
* {{es}}
2424
* {{es}} Hadoop
@@ -77,8 +77,6 @@ Self-managed infrastructure – either on-prem or on public cloud, includes:
7777
* {{ece}} (ECE)
7878
* {{eck}} (ECK)
7979

80-
For ECE and ECK, ensure the operator is running a version compatible with the {{stack}} version you’re upgrading to. If not, you need to upgrade that before you can upgrade your cluster.
80+
For ECE and ECK, ensure the operator is running a version compatible with the {{stack}} version you’re upgrading to. If not, you need to upgrade that before [upgrading your cluster](/deploy-manage/upgrade/deployment-or-cluster.md).
8181

82-
If you’re running the {{stack}} on your own self-managed infrastructure, you must upgrade each component individually.
83-
84-
% Refer to the diagram below for a visualization of the different deployment methods.
82+
If you’re running the {{stack}} on your own self-managed infrastructure, you must [upgrade each component individually](/deploy-manage/upgrade/deployment-or-cluster/self-managed.md).

deploy-manage/upgrade/prepare-to-upgrade.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,11 @@ Upgrading from a release candidate build, such as 9.0.0-rc1, is unsupported. Use
1919

2020
To upgrade from 8.17.0 or earlier to 9.0.0, you must first upgrade to the latest 8.18 patch release. This allows you to use the [Upgrade Assistant](prepare-to-upgrade/upgrade-assistant.md) to identify and resolve issues, reindex indices created before 8.0.0, and perform a rolling upgrade. Upgrading to the latest 8.18 patch release is required even if you choose a full {{es}} cluster restart. If you're using 7.x and earlier, you may need to complete multiple upgrades or perform a full-cluster restart to reach the latest 8.18 patch release before upgrading to 9.0.0.
2121

22-
Alternatively, you can create a 9.0 deployment and reindex from remote. For more information, refer to [Reindex to upgrade](#reindex-to-upgrade).
22+
Alternatively, you can create a 9.0.0 deployment and reindex from remote. For more information, refer to [Reindex to upgrade](#reindex-to-upgrade).
2323

2424
:::{note}
25-
For flexible upgrade scheduling, 8.18.0 {{beats}} and {{ls}} are compatible with 9.0.0 {{es}}.
26-
By default, 8.x {{es}} clients are compatible with 9.0.0 and use [REST API compatibility](elasticsearch://reference/elasticsearch/rest-apis/compatibility.md) to maintain compatibility with the 9.0.0 {{es}} server.
25+
For flexible upgrade scheduling, 8.18.0 {{beats}} and {{ls}} are compatible with 9.x {{es}}.
26+
By default, 8.x {{es}} clients are compatible with 9.x and use [REST API compatibility](elasticsearch://reference/elasticsearch/rest-apis/compatibility.md) to maintain compatibility with the 9.x {{es}} server.
2727
:::
2828

2929
Review the following best practices to upgrade your deployments.
@@ -42,14 +42,14 @@ Review the following best practices to upgrade your deployments.
4242

4343
To successfully upgrade, resolve all critical issues. If you make additional changes, create a snapshot to back up your data.
4444

45-
1. To identify if your applications use unsupported features or behave differently in 9.0.0, review the deprecation logs in the Upgrade Assistant.
45+
1. To identify if your applications use unsupported features or behave differently in 9.x, review the deprecation logs in the Upgrade Assistant.
4646

4747
4. Major version upgrades can include breaking changes that require additional steps to ensure your applications function as expected. Review the [breaking changes](../../release-notes/index.md) for each product you use to learn more about potential impacts on your application. Ensure you test with the new version before upgrading existing deployments.
4848

4949
1. Make the recommended changes to ensure your clients continue operating as expected after the upgrade.
5050

5151
:::{note}
52-
As a temporary solution, use the 8.x syntax to submit requests to 9.0.0 with REST API compatibility mode. While this allows you to submit requests using the old syntax, it doesn’t guarantee the same behavior. REST API compatibility should serve as a bridge during the upgrade, not a long-term solution. For more details on how to effectively use REST API compatibility during an upgrade, refer to [REST API compatibility](elasticsearch://reference/elasticsearch/rest-apis/compatibility.md).
52+
As a temporary solution, use the 8.x syntax to submit requests to 9.x with REST API compatibility mode. While this allows you to submit requests using the old syntax, it doesn’t guarantee the same behavior. REST API compatibility should serve as a bridge during the upgrade, not a long-term solution. For more details on how to effectively use REST API compatibility during an upgrade, refer to [REST API compatibility](elasticsearch://reference/elasticsearch/rest-apis/compatibility.md).
5353
:::
5454

5555
1. If you use {{es}} plugins, ensure each plugin is compatible with the {{es}} version you're upgrading.
@@ -82,7 +82,7 @@ Review the following best practices to upgrade your deployments.
8282
1. If you use a separate [monitoring cluster](/deploy-manage/monitor/stack-monitoring/elasticsearch-monitoring-self-managed.md), upgrade the monitoring cluster before the production cluster. The monitoring cluster and the clusters being monitored should be running the same version of the {{stack}}. Monitoring clusters cannot monitor production clusters running newer versions of the {{stack}}. If necessary, the monitoring cluster can monitor production clusters running the latest release of the previous major version.
8383

8484
:::{note}
85-
If you use {{ccs}}, 9.0.0 and later can search only remote clusters running the previous minor version, the same version, or a newer minor version in the same major version. For more information, refer to [{{ccs-cap}}](../../solutions/search/cross-cluster-search.md).
85+
If you use {{ccs}}, versions 9.0.0 and later can search only remote clusters running the previous minor version, the same version, or a newer minor version in the same major version. For more information, refer to [{{ccs-cap}}](../../solutions/search/cross-cluster-search.md).
8686

8787
If you use {{ccr}}, a cluster that contains follower indices must run the same or newer (compatible) version as the remote cluster. For more information and to view the version compatibility matrix, refer to [{{ccr-cap}}](/deploy-manage/tools/cross-cluster-replication.md). To view your remote clusters in {{kib}}, go to **Stack Management > Remote Clusters**.
8888

@@ -91,9 +91,9 @@ Review the following best practices to upgrade your deployments.
9191

9292
1. To reduce overhead on the cluster during the upgrade, close {{ml}} jobs. Although {{ml}} jobs can run during a rolling upgrade, doing so increases the cluster workload.
9393

94-
1. If you have `.ml-anomalies-*`anomaly detection result indices created in {{es}} 7.x, reindex them, mark them as read-only, or delete them before you upgrade to 9.0.0. For more information, refer to [Migrate anomaly detection results](#anomaly-migration).
94+
1. If you have `.ml-anomalies-*`anomaly detection result indices created in {{es}} 7.x, reindex them, mark them as read-only, or delete them before you upgrade to 9.x. For more information, refer to [Migrate anomaly detection results](#anomaly-migration).
9595

96-
1. If you have transform destination indices created in {{es}} 7.x, reset, reindex, or delete them before you upgrade to 9.0.0. For more information, refer to [Migrate transform destination indices](#transform-migration).
96+
1. If you have transform destination indices created in {{es}} 7.x, reset, reindex, or delete them before you upgrade to 9.x. For more information, refer to [Migrate transform destination indices](#transform-migration).
9797

9898

9999
## Reindex to upgrade [reindex-to-upgrade]

0 commit comments

Comments
 (0)