Browse Source

[DOCS] Add tip for upgrade assistant (#55027)

Our upgrade docs don't mention the upgrade assistant, which can be
helpful when migrating across major versions. The docs also don't
mention deprecation logs, which can highlight other functionality that
may change.

This adds a related tip admonition to the upgrade docs.
James Rodewig 5 years ago
parent
commit
776ffc9fcc
1 changed files with 11 additions and 0 deletions
  1. 11 0
      docs/reference/upgrade.asciidoc

+ 11 - 0
docs/reference/upgrade.asciidoc

@@ -14,6 +14,17 @@ ifeval::[ "{version}" != "{minor-version}.0" ]
 * From any version since {minor-version}.0 to {version}
 endif::[]
 
+[TIP]
+====
+For rolling upgrades between major versions (e.g., 5.6 to 6.8), we recommend
+using the {kibana-ref}/upgrade-assistant.html[Kibana Upgrade Assistant].
+
+The upgrade assistant identifies deprecated settings in your cluster and guides
+you through the process of resolving issues, including reindexing.
+
+We also recommend checking your <<deprecation-logging,deprecation logs>> for any
+other functionality that may have changed.
+====
 
 The following table shows the recommended upgrade paths to {version}.