diff --git a/docs/management/upgrade-assistant/index.asciidoc b/docs/management/upgrade-assistant/index.asciidoc index dbff211cef372..ccd3f41b9d886 100644 --- a/docs/management/upgrade-assistant/index.asciidoc +++ b/docs/management/upgrade-assistant/index.asciidoc @@ -11,10 +11,13 @@ enables you to see if you are using deprecated features, and guides you through the process of resolving issues. If you have indices that were created prior to 7.0, -you can use the assistant to reindex them so they can be accessed from 8.0. +you can use the assistant to reindex them so they can be accessed from 8.0+. IMPORTANT: To see the most up-to-date deprecation information before -upgrading to 8.0, upgrade to the latest 7.n release. +upgrading to 8.0, upgrade to the latest {prev-major-last} release. + +For more information about upgrading, +refer to {stack-ref}/upgrading-elastic-stack.html[Upgrading to Elastic {version}.] [discrete] === Required permissions diff --git a/docs/redirects.asciidoc b/docs/redirects.asciidoc index 4e0f0d4f99e66..ff6ccbd6fab36 100644 --- a/docs/redirects.asciidoc +++ b/docs/redirects.asciidoc @@ -385,3 +385,13 @@ This content has moved. Refer to <>. == Kibana role management. This content has moved. Refer to <>. + +[role="exclude" logging-configuration-changes] +== Logging configuration changes + +This content has moved. Refer to <>. + +[role="exclude" upgrade-migrations] +== Upgrade migrations + +This content has moved. Refer to <>. diff --git a/docs/setup/upgrade.asciidoc b/docs/setup/upgrade.asciidoc index c828b837d8efd..d8e08b460e5f6 100644 --- a/docs/setup/upgrade.asciidoc +++ b/docs/setup/upgrade.asciidoc @@ -1,114 +1,34 @@ [[upgrade]] == Upgrade {kib} -You can always upgrade to the latest patch release or from one minor version -to another within the same major version series. +To upgrade from 7.16 or earlier to {version}, +**You must first upgrade to {prev-major-last}**. +This enables you to use the Upgrade Assistant to +{stack-ref}/upgrading-elastic-stack.html#prepare-to-upgrade[prepare to upgrade]. +You must resolve all critical issues identified by the Upgrade Assistant +before proceeding with the upgrade. -For major version upgrades: - -. Upgrade to the last minor version released before the new major version. -. Use the Upgrade Assistant to determine what changes you need to make before the major version upgrade. -. When you've addressed all the critical issues, upgrade {es} and then upgrade {kib}. - -IMPORTANT: You can upgrade to pre-release versions of 8.0 for testing, -but upgrading from a pre-release to the final GA version is not supported. -Pre-releases should only be used for testing in a temporary environment. - -[discrete] -[[upgrade-paths]] -=== Recommended upgrade paths to 8.0 - -[cols="<1,3",options="header",] -|==== -|Upgrading from -|Upgrade path - -|7.16 -|Upgrade to 8.0 - -|6.8–7.15 -a| - -. Upgrade to 7.16 -. Upgrade to 8.0 - -|6.0–6.7 -a| - -. Upgrade to 6.8 -. Upgrade to 7.16 -. Upgrade to 8.0 -|==== - -[float] -[[upgrade-before-you-begin]] -=== Before you begin +{kib} does not support rolling upgrades. +You must shut down all {kib} instances, install the new software, and restart {kib}. +Upgrading while older {kib} instances are running can cause data loss or upgrade failures. [WARNING] ==== -{kib} automatically runs upgrade migrations when required. To roll back to an -earlier version in case of an upgrade failure, you **must** have a +{kib} automatically runs <> +when required. +In case of an upgrade failure, you can roll back to an +earlier version of {kib}. To roll back, you **must** have a {ref}/snapshot-restore.html[backup snapshot] that includes the `kibana` feature state. Snapshots include this feature state by default. - -For more information, refer to <>. ==== -Before you upgrade {kib}: +For more information about upgrading, +refer to {stack-ref}/upgrading-elastic-stack.html[Upgrading to Elastic {version}.] -* Consult the <>. -* {ref}/snapshots-take-snapshot.html[Take a snapshot] of your data. To roll back to an earlier version, the snapshot must include the `kibana` feature state. -* Before you upgrade production servers, test the upgrades in a dev environment. -* See <> for common reasons upgrades fail and how to prevent these. -* If you are using custom plugins, check that a compatible version is - available. -* Shut down all {kib} instances. Running more than one {kib} version against - the same Elasticseach index is unsupported. Upgrading while older {kib} - instances are running can cause data loss or upgrade failures. - -NOTE: {kib} logging system may have changed, depending on your target version. For details, see <>. - -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 -*{stack-ref}/upgrading-elastic-stack.html[Upgrading the Elastic Stack]*. - -[float] -[[upgrade-5x-earlier]] -=== Upgrade from 5.x or earlier -{es} 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 -{stack-ref}/upgrading-elastic-stack.html[Upgrading the Elastic Stack]. - -When your reindex is complete, follow the <> -instructions. - -[float] -[[upgrade-6x]] -=== Upgrade from 6.x - -The recommended path is to upgrade to 6.8 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. - -TIP: The ability to import {kib} 6.x saved searches, visualizations, and -dashboards is supported. - -[float] -[[upgrade-67]] -=== Upgrade from 6.8 -To help you prepare for your upgrade to 7.0, 6.8 includes an https://www.elastic.co/guide/en/kibana/6.8/upgrade-assistant.html[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, <>. - - -include::upgrade/upgrade-standard.asciidoc[] +IMPORTANT: You can upgrade to pre-release versions for testing, +but upgrading from a pre-release to the General Available version is not supported. +Pre-releases should only be used for testing in a temporary environment. -include::upgrade/upgrade-migrations.asciidoc[] +include::upgrade/upgrade-migrations.asciidoc[leveloffset=-1] include::upgrade/logging-configuration-changes.asciidoc[] diff --git a/docs/setup/upgrade/logging-configuration-changes.asciidoc b/docs/setup/upgrade/logging-configuration-changes.asciidoc index a7a86fcb45b14..4d5f5f732536e 100644 --- a/docs/setup/upgrade/logging-configuration-changes.asciidoc +++ b/docs/setup/upgrade/logging-configuration-changes.asciidoc @@ -1,4 +1,5 @@ -[[logging-configuration-changes]] +[discrete] +[[logging-config-changes]] === Logging configuration changes WARNING: {kib} 8.0 and later uses a new logging system. Be sure to read the documentation for your version of {kib} before proceeding. diff --git a/docs/setup/upgrade/upgrade-migrations.asciidoc b/docs/setup/upgrade/upgrade-migrations.asciidoc index e9e1b757fd71d..fc921f9118bdf 100644 --- a/docs/setup/upgrade/upgrade-migrations.asciidoc +++ b/docs/setup/upgrade/upgrade-migrations.asciidoc @@ -1,5 +1,6 @@ -[[upgrade-migrations]] -=== Upgrade migrations +[float] +[[saved-object-migrations]] +=== Saved object migrations Every time {kib} is upgraded it will perform an upgrade migration to ensure that all <> are compatible with the new version.