From 29eba7ad2ec020e4c978bea16e38c45c24c137c0 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Tue, 25 Mar 2025 13:49:14 -0500 Subject: [PATCH 01/15] update version --- .../upgrade-elastic-cloud-apm-server-standalone-to-8.md | 2 +- .../upgrade-elastic-cloud-with-apm-integration-to-80.md | 3 ++- .../upgrade-self-installation-of-apm-integration-to-8x.md | 6 +++--- ...rade-self-installation-of-apm-server-standalone-to-8x.md | 6 +++--- solutions/observability/apps/upgrade-to-version-8x.md | 4 ++-- solutions/observability/apps/upgrade.md | 2 +- 6 files changed, 12 insertions(+), 11 deletions(-) diff --git a/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-8.md b/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-8.md index 86ada97c31..993af207b8 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-8.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-8.md @@ -17,6 +17,6 @@ This upgrade guide is for the standalone method of running APM Server. Only use Follow these steps to upgrade: 1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). -2. Upgrade {{ecloud}} to 9.0.0-beta1, See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for instructions. +2. Upgrade {{ecloud}} to 9.0, See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for instructions. 3. (Optional) Upgrade to the APM integration. Got time for one more upgrade? See [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). diff --git a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md index c8933b6618..7391fb92bb 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md @@ -17,7 +17,8 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo Follow these steps to upgrade: 1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). -2. Upgrade your {{ecloud}} instance to 9.0.0-beta1. See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for details. The APM integration will automatically be upgraded to version 9.0.0-beta1 as a part of this process. +2. Upgrade your {{ecloud}} instance to 9.0. See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for details. The APM integration will automatically be upgraded to version 9.0 as a part of this process. +3. If 7.x APM indices exist while upgrading to 9.0, follow the instructions in the Upgrade Assistant. ::::{note} {{ece}} users require additional TLS setup. See [Add APM user settings](https://www.elastic.co/guide/en/cloud-enterprise/current/ece-manage-apm-settings.html) for more information. diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md index 526d333e38..4441a471aa 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md @@ -17,17 +17,17 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo ## Prerequisites [_prerequisites_9] -1. Prior to upgrading to version 9.0.0-beta1, {{es}}, and {{kib}} must be upgraded to version 7.17. To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/7.17/upgrading-elastic-stack.html) +1. Prior to upgrading to version 9.0, {{es}}, and {{kib}} must be upgraded to version 7.17. To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/7.17/upgrading-elastic-stack.html) 2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). ## Upgrade steps [_upgrade_steps_2] -1. Upgrade the {{stack}} to version 9.0.0-beta1. +1. Upgrade the {{stack}} to version 9.0. The {{stack}} ({{es}} and {{kib}}) must be upgraded before {{agent}}. See the [{{stack}} Installation and Upgrade Guide](../../../deploy-manage/upgrade/deployment-or-cluster.md) for guidance. -2. Upgrade {{agent}} to version 9.0.0-beta1. As a part of this process, the APM integration will automatically upgrade to version 9.0.0-beta1. +2. Upgrade {{agent}} to version 9.0 As a part of this process, the APM integration will automatically upgrade to version 9.0. 1. In {{fleet}}, select **Agents**. 2. Under **Agents**, click **Upgrade available** to see a list of agents that you can upgrade. diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md index 690980fd76..05c939f5e6 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md @@ -17,7 +17,7 @@ This upgrade guide is for the standalone method of running APM Server. Only use ## Prerequisites [_prerequisites_8] -1. Prior to upgrading to version 9.0.0-beta1, {{es}}, {{kib}}, and APM Server must be upgraded to version 7.17. +1. Prior to upgrading to version 9.0, {{es}}, {{kib}}, and APM Server must be upgraded to version 7.17. * To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/7.17/upgrading-elastic-stack.html) * To upgrade APM Server to version 7.17, see [upgrade to version 7.17](https://www.elastic.co/guide/en/apm/guide/7.17/upgrading-to-717.html). @@ -27,11 +27,11 @@ This upgrade guide is for the standalone method of running APM Server. Only use ## Upgrade steps [_upgrade_steps] -1. **Upgrade the {{stack}} to version 9.0.0-beta1** +1. **Upgrade the {{stack}} to version 9.0** The {{stack}} ({{es}} and {{kib}}) must be upgraded before APM Server. See the [{{stack}} Installation and Upgrade Guide](../../../deploy-manage/upgrade/deployment-or-cluster.md) for guidance. -2. **Install the 9.0.0-beta1 APM Server release** +2. **Install the 9.0 APM Server release** See [install](apm-server-binary.md#apm-installing) to find the command that works with your system. diff --git a/solutions/observability/apps/upgrade-to-version-8x.md b/solutions/observability/apps/upgrade-to-version-8x.md index 4b1bb874c8..122dca7e8e 100644 --- a/solutions/observability/apps/upgrade-to-version-8x.md +++ b/solutions/observability/apps/upgrade-to-version-8x.md @@ -3,9 +3,9 @@ mapped_pages: - https://www.elastic.co/guide/en/observability/current/apm-upgrading-to-8.x.html --- -# Upgrade to version 8.x [apm-upgrading-to-8.x] +# Upgrade to version 9.0 [apm-upgrading-to-9.0] -This guide explains the upgrade process for version 9.0.0-beta1. For a detailed look at what’s new, see: +This guide explains the upgrade process for version 9.0. For a detailed look at what’s new, see: * [Elastic {{observability}} release notes](https://www.elastic.co/guide/en/observability/current/whats-new.html) * [What’s new in {{kib}}](https://www.elastic.co/guide/en/kibana/current/whats-new.html) diff --git a/solutions/observability/apps/upgrade.md b/solutions/observability/apps/upgrade.md index 12d0ecf043..4c2fe41027 100644 --- a/solutions/observability/apps/upgrade.md +++ b/solutions/observability/apps/upgrade.md @@ -9,5 +9,5 @@ This guide gives general recommendations for upgrading Elastic APM. * [{{apm-agent}} compatibility](apm-agent-compatibility.md) * [Breaking Changes](apm-server://release-notes/breaking-changes.md) -* [Upgrade to version 9.0.0-beta1](upgrade-to-version-8x.md) +* [Upgrade to version 9.0](upgrade-to-version-8x.md) * [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md) From 5c384d234b8a6010f19ebc914adf63246d9ff6d8 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Tue, 25 Mar 2025 15:00:14 -0500 Subject: [PATCH 02/15] add reindexing note --- .../upgrade-self-installation-of-apm-integration-to-8x.md | 4 +++- ...grade-self-installation-of-apm-server-standalone-to-8x.md | 5 ++++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md index 4441a471aa..ca7f0e1146 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md @@ -6,7 +6,7 @@ mapped_pages: -# Upgrade a self-installation of the APM integration to 8.x [apm-upgrade-8.0-self-integration] +# Upgrade a self-installation of the APM integration to 9.0 [apm-upgrade-9.0-self-integration] This upgrade guide is for the Elastic APM integration. Only use this guide if both of the following are true: @@ -34,3 +34,5 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo 3. Choose **Upgrade agent** from the **Actions** menu next to the agent you want to upgrade. The **Upgrade agent** option is grayed out when an upgrade is unavailable, or the {{kib}} version is lower than the agent version. For more details, or for bulk upgrade instructions, see [Upgrade {{agent}}](/reference/fleet/upgrade-elastic-agent.md) + +3. When upgrading from 7.x to 9.0 if you reindex 7.x indices, you need to either add [ILM privileges](https://www.elastic.co/guide/en/apm/guide/7.17/privileges-to-setup-beats.html#_set_up_ilm) for `reindexed-v*-apm*` indices or set the indices to `readonly`. \ No newline at end of file diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md index 05c939f5e6..c1223f1db3 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md @@ -25,6 +25,7 @@ This upgrade guide is for the standalone method of running APM Server. Only use 2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). + ## Upgrade steps [_upgrade_steps] 1. **Upgrade the {{stack}} to version 9.0** @@ -49,6 +50,8 @@ This upgrade guide is for the standalone method of running APM Server. Only use Additional details are available in [start the APM Server](apm-server-binary.md#apm-server-starting). -5. **(Optional) Upgrade to the APM integration** +5. When upgrading from 7.x to 9.0 if you reindex 7.x indices, you need to either add [ILM privileges](https://www.elastic.co/guide/en/apm/guide/7.17/privileges-to-setup-beats.html#_set_up_ilm) for `reindexed-v*-apm*` indices or set the indices to `readonly`. + +6. **(Optional) Upgrade to the APM integration** Got time for one more upgrade? See [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). From 6501ed1a6baf33f8a36a5bc48e36de68f6e56f31 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Tue, 25 Mar 2025 17:17:43 -0500 Subject: [PATCH 03/15] remove note --- .../apps/upgrade-elastic-cloud-with-apm-integration-to-80.md | 1 - 1 file changed, 1 deletion(-) diff --git a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md index 7391fb92bb..0dcb8a8115 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md @@ -18,7 +18,6 @@ Follow these steps to upgrade: 1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). 2. Upgrade your {{ecloud}} instance to 9.0. See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for details. The APM integration will automatically be upgraded to version 9.0 as a part of this process. -3. If 7.x APM indices exist while upgrading to 9.0, follow the instructions in the Upgrade Assistant. ::::{note} {{ece}} users require additional TLS setup. See [Add APM user settings](https://www.elastic.co/guide/en/cloud-enterprise/current/ece-manage-apm-settings.html) for more information. From 5c7bf5361f19e22d4feab74d2173174e03fab4f2 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Wed, 26 Mar 2025 14:42:11 -0500 Subject: [PATCH 04/15] update installation guides --- .../upgrade-self-installation-of-apm-integration-to-8x.md | 4 ++-- ...de-self-installation-of-apm-server-standalone-to-8x.md | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md index ca7f0e1146..8522b300c1 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md @@ -17,7 +17,7 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo ## Prerequisites [_prerequisites_9] -1. Prior to upgrading to version 9.0, {{es}}, and {{kib}} must be upgraded to version 7.17. To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/7.17/upgrading-elastic-stack.html) +1. Prior to upgrading to version 9.0, {{es}}, and {{kib}} must be upgraded to version 8.18. To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html) 2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). @@ -35,4 +35,4 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo For more details, or for bulk upgrade instructions, see [Upgrade {{agent}}](/reference/fleet/upgrade-elastic-agent.md) -3. When upgrading from 7.x to 9.0 if you reindex 7.x indices, you need to either add [ILM privileges](https://www.elastic.co/guide/en/apm/guide/7.17/privileges-to-setup-beats.html#_set_up_ilm) for `reindexed-v*-apm*` indices or set the indices to `readonly`. \ No newline at end of file +3. When upgrading from 8.18 to 9.0, if you have 7.x indices, you need to either set the indices to `readonly`, or if reindexing, add [ILM privileges](https://www.elastic.co/guide/en/apm/guide/7.17/privileges-to-setup-beats.html#_set_up_ilm) for `reindexed-v*-apm*` indices. \ No newline at end of file diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md index c1223f1db3..9517ec00c2 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md @@ -17,10 +17,10 @@ This upgrade guide is for the standalone method of running APM Server. Only use ## Prerequisites [_prerequisites_8] -1. Prior to upgrading to version 9.0, {{es}}, {{kib}}, and APM Server must be upgraded to version 7.17. +1. Prior to upgrading to version 9.0, {{es}}, {{kib}}, and APM Server must be upgraded to version 8.18. - * To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/7.17/upgrading-elastic-stack.html) - * To upgrade APM Server to version 7.17, see [upgrade to version 7.17](https://www.elastic.co/guide/en/apm/guide/7.17/upgrading-to-717.html). + * To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html) + * To upgrade APM Server to version 8.18, see [upgrade to version 8.18](https://www.elastic.co/guide/en/observability/8.18/apm-upgrading-to-8.x.html). 2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). @@ -50,7 +50,7 @@ This upgrade guide is for the standalone method of running APM Server. Only use Additional details are available in [start the APM Server](apm-server-binary.md#apm-server-starting). -5. When upgrading from 7.x to 9.0 if you reindex 7.x indices, you need to either add [ILM privileges](https://www.elastic.co/guide/en/apm/guide/7.17/privileges-to-setup-beats.html#_set_up_ilm) for `reindexed-v*-apm*` indices or set the indices to `readonly`. +5. When upgrading from 8.18 to 9.0, if you have 7.x indices, you need to either set the indices to `readonly`, or if reindexing, add [ILM privileges](https://www.elastic.co/guide/en/apm/guide/7.17/privileges-to-setup-beats.html#_set_up_ilm) for `reindexed-v*-apm*` indices. 6. **(Optional) Upgrade to the APM integration** From 63d0cae86229016b32c8b6503aa44175b04d92e3 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Wed, 26 Mar 2025 14:53:29 -0500 Subject: [PATCH 05/15] fix file names --- ...grade-elastic-cloud-apm-server-standalone-to-90.md} | 0 ...pgrade-elastic-cloud-with-apm-integration-to-90.md} | 0 ...rade-self-installation-of-apm-integration-to-90.md} | 0 ...elf-installation-of-apm-server-standalone-to-90.md} | 0 ...grade-to-version-8x.md => upgrade-to-version-90.md} | 8 ++++---- solutions/toc.yml | 10 +++++----- 6 files changed, 9 insertions(+), 9 deletions(-) rename solutions/observability/apps/{upgrade-elastic-cloud-apm-server-standalone-to-8.md => upgrade-elastic-cloud-apm-server-standalone-to-90.md} (100%) rename solutions/observability/apps/{upgrade-elastic-cloud-with-apm-integration-to-80.md => upgrade-elastic-cloud-with-apm-integration-to-90.md} (100%) rename solutions/observability/apps/{upgrade-self-installation-of-apm-integration-to-8x.md => upgrade-self-installation-of-apm-integration-to-90.md} (100%) rename solutions/observability/apps/{upgrade-self-installation-of-apm-server-standalone-to-8x.md => upgrade-self-installation-of-apm-server-standalone-to-90.md} (100%) rename solutions/observability/apps/{upgrade-to-version-8x.md => upgrade-to-version-90.md} (95%) diff --git a/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-8.md b/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md similarity index 100% rename from solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-8.md rename to solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md diff --git a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md similarity index 100% rename from solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md rename to solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md similarity index 100% rename from solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md rename to solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md similarity index 100% rename from solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md rename to solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md diff --git a/solutions/observability/apps/upgrade-to-version-8x.md b/solutions/observability/apps/upgrade-to-version-90.md similarity index 95% rename from solutions/observability/apps/upgrade-to-version-8x.md rename to solutions/observability/apps/upgrade-to-version-90.md index 122dca7e8e..72b1625d52 100644 --- a/solutions/observability/apps/upgrade-to-version-8x.md +++ b/solutions/observability/apps/upgrade-to-version-90.md @@ -30,10 +30,10 @@ Starting in version 7.14, there are two ways to run Elastic APM. Determine which **Self-installation (non-{{ecloud}} users) upgrade guides** -* [Self-installation standalone](upgrade-self-installation-of-apm-server-standalone-to-8x.md) -* [Self-installation APM integration](upgrade-self-installation-of-apm-integration-to-8x.md) +* [Self-installation standalone](upgrade-self-installation-of-apm-server-standalone-to-90.md) +* [Self-installation APM integration](upgrade-self-installation-of-apm-integration-to-90.md) **{{ecloud}} upgrade guides** -* [{{ecloud}} standalone](upgrade-elastic-cloud-apm-server-standalone-to-8.md) -* [{{ecloud}} APM integration](upgrade-elastic-cloud-with-apm-integration-to-80.md) +* [{{ecloud}} standalone](upgrade-elastic-cloud-apm-server-standalone-to-90.md) +* [{{ecloud}} APM integration](upgrade-elastic-cloud-with-apm-integration-to-90.md) diff --git a/solutions/toc.yml b/solutions/toc.yml index 323bc7dcf5..838918d7ba 100644 --- a/solutions/toc.yml +++ b/solutions/toc.yml @@ -261,12 +261,12 @@ toc: - file: observability/apps/upgrade.md children: - file: observability/apps/apm-agent-compatibility.md - - file: observability/apps/upgrade-to-version-8x.md + - file: observability/apps/upgrade-to-version-90.md children: - - file: observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md - - file: observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md - - file: observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-8.md - - file: observability/apps/upgrade-elastic-cloud-with-apm-integration-to-80.md + - file: observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md + - file: observability/apps/upgrade-self-installation-of-apm-integration-to-90.md + - file: observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md + - file: observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md - file: observability/apps/switch-to-elastic-apm-integration.md children: - file: observability/apps/switch-self-installation-to-apm-integration.md From 32daa1695771700963c3643ade9b10d3a3eaeb1e Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Wed, 26 Mar 2025 14:55:27 -0500 Subject: [PATCH 06/15] fix link --- solutions/observability/apps/upgrade.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/apps/upgrade.md b/solutions/observability/apps/upgrade.md index 4c2fe41027..0fb85bd7f0 100644 --- a/solutions/observability/apps/upgrade.md +++ b/solutions/observability/apps/upgrade.md @@ -9,5 +9,5 @@ This guide gives general recommendations for upgrading Elastic APM. * [{{apm-agent}} compatibility](apm-agent-compatibility.md) * [Breaking Changes](apm-server://release-notes/breaking-changes.md) -* [Upgrade to version 9.0](upgrade-to-version-8x.md) +* [Upgrade to version 9.0](upgrade-to-version-90.md) * [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md) From 8035ccfea2d48905174476445c67078476b6f0ea Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Wed, 26 Mar 2025 15:07:16 -0500 Subject: [PATCH 07/15] add note about breaking changes --- .../apps/upgrade-self-installation-of-apm-integration-to-90.md | 1 + .../upgrade-self-installation-of-apm-server-standalone-to-90.md | 1 + 2 files changed, 2 insertions(+) diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md index 8522b300c1..3f8c53afd2 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md @@ -19,6 +19,7 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo 1. Prior to upgrading to version 9.0, {{es}}, and {{kib}} must be upgraded to version 8.18. To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html) 2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). +3. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). ## Upgrade steps [_upgrade_steps_2] diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md index 9517ec00c2..57ad2d51dd 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md @@ -23,6 +23,7 @@ This upgrade guide is for the standalone method of running APM Server. Only use * To upgrade APM Server to version 8.18, see [upgrade to version 8.18](https://www.elastic.co/guide/en/observability/8.18/apm-upgrading-to-8.x.html). 2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). +3. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). From 1a8b1b53590338af27d27c78091f2a8c84c50c93 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Wed, 26 Mar 2025 17:00:34 -0500 Subject: [PATCH 08/15] add breaking changes note to ecloud --- .../upgrade-elastic-cloud-apm-server-standalone-to-90.md | 5 +++-- .../apps/upgrade-elastic-cloud-with-apm-integration-to-90.md | 3 ++- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md b/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md index 993af207b8..b02829eda8 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md @@ -17,6 +17,7 @@ This upgrade guide is for the standalone method of running APM Server. Only use Follow these steps to upgrade: 1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). -2. Upgrade {{ecloud}} to 9.0, See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for instructions. -3. (Optional) Upgrade to the APM integration. Got time for one more upgrade? See [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). +2. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). +3. Upgrade {{ecloud}} to 9.0, See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for instructions. +4. (Optional) Upgrade to the APM integration. Got time for one more upgrade? See [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). diff --git a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md index 0dcb8a8115..e659864eb3 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md @@ -17,7 +17,8 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo Follow these steps to upgrade: 1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). -2. Upgrade your {{ecloud}} instance to 9.0. See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for details. The APM integration will automatically be upgraded to version 9.0 as a part of this process. +2. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). +3. Upgrade your {{ecloud}} instance to 9.0. See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for details. The APM integration will automatically be upgraded to version 9.0 as a part of this process. ::::{note} {{ece}} users require additional TLS setup. See [Add APM user settings](https://www.elastic.co/guide/en/cloud-enterprise/current/ece-manage-apm-settings.html) for more information. From 5c47d04d13dc9c85ea9bd7fee595def85b6c45be Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Thu, 27 Mar 2025 21:32:59 -0500 Subject: [PATCH 09/15] update version --- .../upgrade-self-installation-of-apm-server-standalone-to-90.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md index 57ad2d51dd..a81bf6b363 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md @@ -6,7 +6,7 @@ mapped_pages: -# Upgrade a self-installation of APM Server standalone to 8.x [apm-upgrade-8.0-self-standalone] +# Upgrade a self-installation of APM Server standalone to 9.0 [apm-upgrade-9.0-self-standalone] This upgrade guide is for the standalone method of running APM Server. Only use this guide if both of the following are true: From 451942786fc05d84a821652b66849b524bb8c697 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Mon, 31 Mar 2025 13:38:40 -0500 Subject: [PATCH 10/15] review updates --- .../apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md | 4 ++-- .../apps/upgrade-elastic-cloud-with-apm-integration-to-90.md | 2 +- .../upgrade-self-installation-of-apm-integration-to-90.md | 2 +- solutions/observability/apps/upgrade-to-version-90.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md b/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md index b02829eda8..bd91ed4610 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md @@ -18,6 +18,6 @@ Follow these steps to upgrade: 1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). 2. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). -3. Upgrade {{ecloud}} to 9.0, See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for instructions. -4. (Optional) Upgrade to the APM integration. Got time for one more upgrade? See [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). +3. Upgrade {{ecloud}} to 9.0, refer to [Upgrade your deployment](../../../deploy-manage/upgrade/deployment-or-cluster.md) for instructions. +4. (Optional) Upgrade to the APM integration. Got time for one more upgrade? Refer to [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). diff --git a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md index e659864eb3..e41db438fd 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md @@ -18,7 +18,7 @@ Follow these steps to upgrade: 1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). 2. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). -3. Upgrade your {{ecloud}} instance to 9.0. See [Upgrade versions](../../../deploy-manage/upgrade/deployment-or-cluster.md) for details. The APM integration will automatically be upgraded to version 9.0 as a part of this process. +3. Upgrade your {{ecloud}} instance to 9.0. Refer to [Upgrade your deployment](../../../deploy-manage/upgrade/deployment-or-cluster.md) for details. As a part of this process, the APM integration will automatically upgrade to version 9.0. ::::{note} {{ece}} users require additional TLS setup. See [Add APM user settings](https://www.elastic.co/guide/en/cloud-enterprise/current/ece-manage-apm-settings.html) for more information. diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md index 3f8c53afd2..72758f7cf9 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md @@ -17,7 +17,7 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo ## Prerequisites [_prerequisites_9] -1. Prior to upgrading to version 9.0, {{es}}, and {{kib}} must be upgraded to version 8.18. To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html) +1. Before you upgrade to version 9.0, you must upgrade {{es}} and {{kib}} to the latest patch version of 8.18. For more details, refer to the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html). 2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). 3. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). diff --git a/solutions/observability/apps/upgrade-to-version-90.md b/solutions/observability/apps/upgrade-to-version-90.md index 72b1625d52..97c05e30e9 100644 --- a/solutions/observability/apps/upgrade-to-version-90.md +++ b/solutions/observability/apps/upgrade-to-version-90.md @@ -5,7 +5,7 @@ mapped_pages: # Upgrade to version 9.0 [apm-upgrading-to-9.0] -This guide explains the upgrade process for version 9.0. For a detailed look at what’s new, see: +This guide explains the upgrade process for version 9.0. For a detailed look at what’s new, check out: * [Elastic {{observability}} release notes](https://www.elastic.co/guide/en/observability/current/whats-new.html) * [What’s new in {{kib}}](https://www.elastic.co/guide/en/kibana/current/whats-new.html) From 94e7892c67391556f1b3ad7077b30fd95d62e63d Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Mon, 31 Mar 2025 13:43:42 -0500 Subject: [PATCH 11/15] review changes --- ...de-self-installation-of-apm-server-standalone-to-90.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md index a81bf6b363..c3be781d58 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md @@ -31,15 +31,15 @@ This upgrade guide is for the standalone method of running APM Server. Only use 1. **Upgrade the {{stack}} to version 9.0** - The {{stack}} ({{es}} and {{kib}}) must be upgraded before APM Server. See the [{{stack}} Installation and Upgrade Guide](../../../deploy-manage/upgrade/deployment-or-cluster.md) for guidance. + The {{stack}} ({{es}} and {{kib}}) must be upgraded before APM Server. Refer to the [{{stack}} Installation and Upgrade Guide](../../../deploy-manage/upgrade/deployment-or-cluster.md) for guidance. 2. **Install the 9.0 APM Server release** - See [install](apm-server-binary.md#apm-installing) to find the command that works with your system. + Refer to [install](apm-server-binary.md#apm-installing) to find the command that works with your system. 3. **Review your configuration file** - Some settings have been removed or changed. You may need to update your `apm-server.yml` configuration file prior to starting the APM Server. See [Installation layout](installation-layout.md) for help in locating this file, and [Configure APM Server](configure-apm-server.md) for a list of all available configuration options. + Some settings have been removed or changed. You may need to update your `apm-server.yml` configuration file prior to starting the APM Server. Refer to [Installation layout](installation-layout.md) for help in locating this file, and [Configure APM Server](configure-apm-server.md) for a list of all available configuration options. 4. **Start the APM Server** @@ -55,4 +55,4 @@ This upgrade guide is for the standalone method of running APM Server. Only use 6. **(Optional) Upgrade to the APM integration** - Got time for one more upgrade? See [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). + Got time for one more upgrade? Refer to [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). From 2af3164df2c81907823691010bae41e60a2c55be Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Mon, 31 Mar 2025 13:46:13 -0500 Subject: [PATCH 12/15] review update --- .../upgrade-self-installation-of-apm-server-standalone-to-90.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md index c3be781d58..fa1d1b1dc2 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md @@ -20,7 +20,7 @@ This upgrade guide is for the standalone method of running APM Server. Only use 1. Prior to upgrading to version 9.0, {{es}}, {{kib}}, and APM Server must be upgraded to version 8.18. * To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html) - * To upgrade APM Server to version 8.18, see [upgrade to version 8.18](https://www.elastic.co/guide/en/observability/8.18/apm-upgrading-to-8.x.html). + * To upgrade APM Server to version 8.18, refer to [upgrade to version 8.18](https://www.elastic.co/guide/en/observability/8.18/apm-upgrading-to-8.x.html). 2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). 3. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). From d6fe3a3fbe29127795d9b31ad30a477003fac1f7 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Mon, 31 Mar 2025 14:05:43 -0500 Subject: [PATCH 13/15] delete file --- ...allation-of-apm-server-standalone-to-8x.md | 54 ------------------- 1 file changed, 54 deletions(-) delete mode 100644 solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md deleted file mode 100644 index dae8793d66..0000000000 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-8x.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -navigation_title: "Self-installation standalone" -mapped_pages: - - https://www.elastic.co/guide/en/observability/current/apm-upgrade-8.0-self-standalone.html ---- - - - -# Upgrade a self-installation of APM Server standalone to 8.x [apm-upgrade-8.0-self-standalone] - - -This upgrade guide is for the standalone method of running APM Server. Only use this guide if both of the following are true: - -* You have a self-installation of the {{stack}}, i.e. you’re not using {{ecloud}}. -* You’re running the APM Server binary, i.e. you haven’t switched to the Elastic APM integration. - - -## Prerequisites [_prerequisites_8] - -1. Prior to upgrading to version 9.0.0-beta1, {{es}}, {{kib}}, and APM Server must be upgraded to version 7.17. - - * To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/7.17/upgrading-elastic-stack.html) - * To upgrade APM Server to version 7.17, see [upgrade to version 7.17](https://www.elastic.co/guide/en/apm/guide/7.17/upgrading-to-717.html). - -2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/index.md). - - -## Upgrade steps [_upgrade_steps] - -1. **Upgrade the {{stack}} to version 9.0.0-beta1** - - The {{stack}} ({{es}} and {{kib}}) must be upgraded before APM Server. See the [{{stack}} Installation and Upgrade Guide](../../../deploy-manage/upgrade/deployment-or-cluster.md) for guidance. - -2. **Install the 9.0.0-beta1 APM Server release** - - See [install](apm-server-binary.md#apm-installing) to find the command that works with your system. - -3. **Review your configuration file** - - Some settings have been removed or changed. You may need to update your `apm-server.yml` configuration file prior to starting the APM Server. See [Installation layout](installation-layout.md) for help in locating this file, and [Configure APM Server](configure-apm-server.md) for a list of all available configuration options. - -4. **Start the APM Server** - - To start the APM Server, run: - - ```bash - ./apm-server -e - ``` - - Additional details are available in [start the APM Server](apm-server-binary.md#apm-server-starting). - -5. **(Optional) Upgrade to the APM integration** - - Got time for one more upgrade? See [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). From 8eb2a624514a855f312398c72613e916b83ea31c Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Mon, 31 Mar 2025 14:12:57 -0500 Subject: [PATCH 14/15] fix release notes link --- .../apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md | 2 +- .../apps/upgrade-elastic-cloud-with-apm-integration-to-90.md | 2 +- .../apps/upgrade-self-installation-of-apm-integration-to-90.md | 2 +- .../upgrade-self-installation-of-apm-server-standalone-to-90.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md b/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md index bd91ed4610..f26ced3e9b 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-apm-server-standalone-to-90.md @@ -16,7 +16,7 @@ This upgrade guide is for the standalone method of running APM Server. Only use Follow these steps to upgrade: -1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). +1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/index.md). 2. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). 3. Upgrade {{ecloud}} to 9.0, refer to [Upgrade your deployment](../../../deploy-manage/upgrade/deployment-or-cluster.md) for instructions. 4. (Optional) Upgrade to the APM integration. Got time for one more upgrade? Refer to [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md). diff --git a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md index e41db438fd..65610c25c6 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md @@ -16,7 +16,7 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo Follow these steps to upgrade: -1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). +1. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/index.md). 2. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). 3. Upgrade your {{ecloud}} instance to 9.0. Refer to [Upgrade your deployment](../../../deploy-manage/upgrade/deployment-or-cluster.md) for details. As a part of this process, the APM integration will automatically upgrade to version 9.0. diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md index 72758f7cf9..9ea14b15d1 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md @@ -18,7 +18,7 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo ## Prerequisites [_prerequisites_9] 1. Before you upgrade to version 9.0, you must upgrade {{es}} and {{kib}} to the latest patch version of 8.18. For more details, refer to the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html). -2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). +2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/index.md). 3. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md index fa1d1b1dc2..ca0317ab80 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md @@ -22,7 +22,7 @@ This upgrade guide is for the standalone method of running APM Server. Only use * To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html) * To upgrade APM Server to version 8.18, refer to [upgrade to version 8.18](https://www.elastic.co/guide/en/observability/8.18/apm-upgrading-to-8.x.html). -2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/release-notes.md). +2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/index.md). 3. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md). From fcbe4cd4faeeecfd462504fe3d963ea1adf0d1b6 Mon Sep 17 00:00:00 2001 From: Mike Birnstiehl Date: Mon, 31 Mar 2025 14:37:01 -0500 Subject: [PATCH 15/15] review updates --- .../upgrade-elastic-cloud-with-apm-integration-to-90.md | 2 +- .../upgrade-self-installation-of-apm-integration-to-90.md | 6 +++--- ...rade-self-installation-of-apm-server-standalone-to-90.md | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md index 65610c25c6..6d691df7f9 100644 --- a/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md +++ b/solutions/observability/apps/upgrade-elastic-cloud-with-apm-integration-to-90.md @@ -21,7 +21,7 @@ Follow these steps to upgrade: 3. Upgrade your {{ecloud}} instance to 9.0. Refer to [Upgrade your deployment](../../../deploy-manage/upgrade/deployment-or-cluster.md) for details. As a part of this process, the APM integration will automatically upgrade to version 9.0. ::::{note} -{{ece}} users require additional TLS setup. See [Add APM user settings](https://www.elastic.co/guide/en/cloud-enterprise/current/ece-manage-apm-settings.html) for more information. +{{ece}} users require additional TLS setup. Refer to [Add APM user settings](https://www.elastic.co/guide/en/cloud-enterprise/current/ece-manage-apm-settings.html) for more information. :::: diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md index 9ea14b15d1..27bcf9202d 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md @@ -26,14 +26,14 @@ This upgrade guide is for the Elastic APM integration. Only use this guide if bo 1. Upgrade the {{stack}} to version 9.0. - The {{stack}} ({{es}} and {{kib}}) must be upgraded before {{agent}}. See the [{{stack}} Installation and Upgrade Guide](../../../deploy-manage/upgrade/deployment-or-cluster.md) for guidance. + The {{stack}} ({{es}} and {{kib}}) must be upgraded before {{agent}}. refer to the [{{stack}} Installation and Upgrade Guide](../../../deploy-manage/upgrade/deployment-or-cluster.md) for guidance. 2. Upgrade {{agent}} to version 9.0 As a part of this process, the APM integration will automatically upgrade to version 9.0. 1. In {{fleet}}, select **Agents**. - 2. Under **Agents**, click **Upgrade available** to see a list of agents that you can upgrade. + 2. Under **Agents**, click **Upgrade available** for a list of agents that you can upgrade. 3. Choose **Upgrade agent** from the **Actions** menu next to the agent you want to upgrade. The **Upgrade agent** option is grayed out when an upgrade is unavailable, or the {{kib}} version is lower than the agent version. - For more details, or for bulk upgrade instructions, see [Upgrade {{agent}}](/reference/fleet/upgrade-elastic-agent.md) + For more details, or for bulk upgrade instructions, refer to [Upgrade {{agent}}](/reference/fleet/upgrade-elastic-agent.md) 3. When upgrading from 8.18 to 9.0, if you have 7.x indices, you need to either set the indices to `readonly`, or if reindexing, add [ILM privileges](https://www.elastic.co/guide/en/apm/guide/7.17/privileges-to-setup-beats.html#_set_up_ilm) for `reindexed-v*-apm*` indices. \ No newline at end of file diff --git a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md index ca0317ab80..0d4bdd8484 100644 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md @@ -19,7 +19,7 @@ This upgrade guide is for the standalone method of running APM Server. Only use 1. Prior to upgrading to version 9.0, {{es}}, {{kib}}, and APM Server must be upgraded to version 8.18. - * To upgrade {{es}} and {{kib}}, see the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html) + * To upgrade {{es}} and {{kib}}, refer to the [{{stack}} Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/8.18/upgrading-elastic-stack.html) * To upgrade APM Server to version 8.18, refer to [upgrade to version 8.18](https://www.elastic.co/guide/en/observability/8.18/apm-upgrading-to-8.x.html). 2. Review the [Elastic APM release notes](apm-server://release-notes/index.md) and [Elastic {{observability}} release notes](/release-notes/elastic-observability/index.md).