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/index.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, 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).
 
@@ -17,10 +17,11 @@ 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/index.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. 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.
 ::::
 
 
@@ -0,0 +1,39 @@
+---
+navigation_title: "Self-installation APM integration"
+mapped_pages:
+  - https://www.elastic.co/guide/en/observability/current/apm-upgrade-8.0-self-integration.html
+---
+
+
+
+# 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:
+
+* You have a self-installation of the {{stack}}, i.e. you’re not using {{ecloud}}.
+* You have already switched to and are running {{fleet}} and the Elastic APM integration.
+
+
+## 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/index.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.
+
+    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** 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, 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.
@@ -0,0 +1,58 @@
+---
+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 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:
+
+* 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, {{es}}, {{kib}}, and APM Server must be upgraded to version 8.18.
+
+    * 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).
+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**
+
+    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**
+
+    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. 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**
+
+    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. 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? Refer to [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, 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)
@@ -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)
@@ -264,12 +264,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