IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Using Kibana in a production environment Standard upgrade »
Elastic Docs ›Kibana Guide [7.0] ›Set Up Kibana

Upgrading Kibana

edit

Upgrading Kibana

edit

Depending on the Kibana version you’re upgrading from, the upgrade process to 7.0.1 varies. The following upgrades are supported:

  • Between minor versions
  • From 5.6 to 6.7
  • From 6.7 to 7.0.1
  • From any version since 7.0.0 to 7.0.1

The following table shows the recommended upgrade paths to 7.0.1.

Upgrade from Recommended upgrade path to 7.0.1

A previous 7.0 version (e.g., 7.0.0)

Upgrade to 7.0.1

6.7

Upgrade to 7.0.1

6.0–6.6
  1. Upgrade to 6.7
  2. Upgrade to 7.0.1

5.6
  1. Upgrade to 6.7
  2. Upgrade to 7.0.1

5.0–5.5
  1. Upgrade to 5.6
  2. Upgrade to 6.7
  3. Upgrade to 7.0.1

The upgrade path from 6.8 to 7.0 is not supported. Instead, perform an upgrade from 6.8 directly to 7.1.

Before you begin

edit

Before you upgrade Kibana:

  • Consult the breaking changes.
  • Before you upgrade production servers, test the upgrades in a dev environment.
  • Backup your data with Elasticsearch snapshots. To roll back to an earlier version, you must have a backup of your data.
  • If you are using custom plugins, check that a compatible version is available.
  • Shut down all Kibana nodes. Running more than one Kibana version against the same Elasticseach index is unsupported. If you upgrade while older Kibana nodes are running, the upgrade can fail.

To identify the changes you need to make to upgrade, and to enable you to perform an Elasticsearch rolling upgrade with no downtime, you must upgrade to 6.7 before you upgrade to 7.0.

For a comprehensive overview of the upgrade process, refer to Upgrading the Elastic Stack.

Upgrading from 5.x or earlier

edit

Elasticsearch can read indices created in the previous major version. Before you upgrade to 7.0.0, you must reindex or delete any indices created in 5.x or earlier. For more information, refer to Upgrading the Elastic Stack.

When your reindex is complete, follow the Standard upgrade instructions.

Upgrading from 6.x

edit

The recommended path is to upgrade to 6.7 before upgrading to 7.0. This makes it easier to identify the required changes, and enables you to use the Upgrade Assistant to prepare for your upgrade to 7.0.

The ability to import Kibana 6.x saved searches, visualizations, and dashboards is supported.

Upgrading from 6.7

edit

To help you prepare for your upgrade to 7.0, 6.7 includes an Upgrade Assistant To access the assistant, go to Management > 7.0 Upgrade Assistant.

After you have addressed any issues that were identified by the Upgrade Assistant, upgrade to 7.0.

Known issues

edit

"shard failed" error when viewing Beats dashboards in Kibana

edit

After upgrading to Elasticsearch 7.0, any indices created by Beats 6.6 or older will not work in Kibana dashboards until the index.query.default_field setting is added to each index. Indices created in Beats 6.7 or later are unaffected. To add the setting to the index, you can use the 7.0 Upgrade Assistant, or add the setting manually.

« Using Kibana in a production environment Standard upgrade »