Type to search.

Upgrade a self-installation of APM Server standalone to 9.0

Stack

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

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 Elastic Stack, i.e. you’re not using Elastic Cloud.
  • You’re running the APM Server binary, i.e. you haven’t switched to the Elastic APM integration.

Prerequisites

  1. Prior to upgrading to version 9.0, Elasticsearch, Kibana, and APM Server must be upgraded to version 8.18.

  2. Review the Elastic APM release notes and Elastic Observability release notes.

  3. Review the Elastic APM breaking changes.

Upgrade steps

  1. Upgrade the Elastic Stack to version 9.0

    The Elastic Stack (Elasticsearch and Kibana) must be upgraded before APM Server. Refer to the Elastic Stack Installation and Upgrade Guide for guidance.

  2. Install the 9.0 APM Server release

    Refer to install to find the command that works with your system.

  3. Review your configuration file

    Some settings have been removed or changed. You might need to update your apm-server.yml configuration file before starting the APM Server. Refer to Installation layout for help in locating this file, and Configure APM Server for a list of all available configuration options.

  4. Start the APM Server

    To start the APM Server, run:

    Shell 
    ./apm-server -e

    Additional details are available in start the APM Server.

  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 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.