elastic · mdbirnstiehl · Apr 2, 2025 · Mar 25, 2025 · Mar 25, 2025 · Mar 25, 2025
@@ -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.0-beta1, 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).
 
@@ -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. 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.

@@ -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:
@@ -17,20 +17,23 @@ 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 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]
 
-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.
     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 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.
@@ -17,21 +17,23 @@ 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 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).
+3. Review the [Elastic APM breaking changes](apm-server://release-notes/breaking-changes.md).
+
 
 
 ## 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.
 
@@ -49,6 +51,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 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**
 
     Got time for one more upgrade? See [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.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)
@@ -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)
@@ -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-90.md)
 * [Switch to the Elastic APM integration](switch-to-elastic-apm-integration.md)
@@ -262,12 +262,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