Upgrading Kibanaedit

Important

Before upgrading Kibana:

  • Consult the breaking changes docs.
  • Test upgrades in a dev environment before upgrading your production servers.
  • Backup your data using the Elasticsearch snapshots feature. You cannot roll back to an earlier version unless you have a backup of your data.
  • If you are using custom plugins, check that a compatible version is available.

Depending on which version of Kibana you’re upgrading from, the upgrade process to 7.0 will vary.

The recommended path is to upgrade to 6.7 before upgrading to 7.0. This makes it easier to identify the changes you need to make to upgrade and enables you to perform a rolling upgrade with no downtime.

Please see Upgrading the Elastic Stack for a comprehensive overview of the upgrade process.

Upgrading from 5.x or earlieredit

Elasticsearch can read indices created in the previous major version. If you have indices created in 5.x or before, you must reindex or delete them before upgrading to 7.0.0. See Upgrading the Elastic Stack for more information.

Once your reindex is complete, you can follow the Standard upgrade instructions.

Upgrading from 6.xedit

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 (see below).

Note: Saved searches, visualizations, and dashboards created in Kibana 6.x can be generally imported into 7.x.

Upgrading from 6.7edit

6.7 includes an Upgrade Assistant to help you prepare for your upgrade to 7.0. 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 issuesedit

"shard failed" error when viewing Beats dashboards in Kibanaedit

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.