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 64% 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 index 375989e2da..f26ced3e9b 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-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/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). 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 58% 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 index 99ed669846..6d691df7f9 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-90.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. :::: 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 deleted file mode 100644 index a7b7da5741..0000000000 --- a/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-8x.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -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 8.x [apm-upgrade-8.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. 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) -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_2] - -1. Upgrade the {{stack}} to version 9.0.0-beta1. - - 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. - - 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) 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 new file mode 100644 index 0000000000..27bcf9202d --- /dev/null +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-integration-to-90.md @@ -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. \ 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 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). 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 new file mode 100644 index 0000000000..0d4bdd8484 --- /dev/null +++ b/solutions/observability/apps/upgrade-self-installation-of-apm-server-standalone-to-90.md @@ -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). diff --git a/solutions/observability/apps/upgrade-to-version-8x.md b/solutions/observability/apps/upgrade-to-version-90.md similarity index 88% rename from solutions/observability/apps/upgrade-to-version-8x.md rename to solutions/observability/apps/upgrade-to-version-90.md index 4b1bb874c8..97c05e30e9 100644 --- a/solutions/observability/apps/upgrade-to-version-8x.md +++ b/solutions/observability/apps/upgrade-to-version-90.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) diff --git a/solutions/observability/apps/upgrade.md b/solutions/observability/apps/upgrade.md index 12d0ecf043..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.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) diff --git a/solutions/toc.yml b/solutions/toc.yml index b79058cfac..b313346824 100644 --- a/solutions/toc.yml +++ b/solutions/toc.yml @@ -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