* Add a note about index migrations to the kibana setup docs * Tewak the migrations asciidocs for clarity * docs: refine saved object migration details Breaking down the migration process into sections helps people find and link to relevant information more easily. The focus is on ongoing maintenance of Kibana, whereas the initial new experience in 6.5.0 is treated as a note of clarification. Error handling should be expanded in the future to include details about specific known error cases.
46 lines
1.9 KiB
Plaintext
46 lines
1.9 KiB
Plaintext
[[upgrade]]
|
|
== Upgrading Kibana
|
|
|
|
[IMPORTANT]
|
|
===========================================
|
|
Before upgrading Kibana:
|
|
|
|
* Consult the <<breaking-changes,breaking changes>> docs.
|
|
* Test upgrades in a dev environment before upgrading your production servers.
|
|
* Backup your data using the Elasticsearch
|
|
{ref}/modules-snapshots.html[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
|
|
will vary. Please consult the following table to determine which process you
|
|
should follow:
|
|
|
|
[cols="1<m,1<m,3",options="header",]
|
|
|=======================================================================
|
|
|Upgrade From |Upgrade To |Supported Upgrade Type
|
|
|3.x |5.x |<<upgrade-new-install,New installation>>
|
|
|4.0 or 4.1 |5.x |<<upgrade-standard-reindex,Standard upgrade & reindex>>
|
|
|4.x >= 4.2 |5.x |<<upgrade-standard,Standard upgrade>>
|
|
|5.0.0 pre GA |5.x |<<upgrade-standard-reindex,Standard upgrade & reindex>>
|
|
|5.x |5.y |<<upgrade-standard,Standard upgrade>> (where `y > x`)
|
|
|5.x |6.x |<<upgrade-standard,Standard upgrade>>
|
|
// & <<migrating-6.0-index,Reindex transformation>>
|
|
|6.x |6.y |<<upgrade-standard,Standard upgrade>> (where `y > x`)
|
|
|6.x |7.x |<<upgrade-standard,Standard upgrade>>
|
|
|=======================================================================
|
|
|
|
NOTE: Saved searches, visualizations, and dashboards created in Kibana 4.x or 5.x
|
|
can be generally imported into 6.x.
|
|
|
|
include::upgrade/upgrade-standard.asciidoc[]
|
|
|
|
include::upgrade/upgrade-standard-reindex.asciidoc[]
|
|
|
|
include::upgrade/upgrade-new-install.asciidoc[]
|
|
|
|
include::upgrade/upgrade-migrations.asciidoc[]
|