[DOCS] Added link to upgrade guide and bumped the upgrade topic up to the top level (#27621)

* [DOCS] Added link to the upgrade guide & tweaked the intro.

* [DOCS] Bumped upgrade topic up to the top level of the TOC
This commit is contained in:
debadair 2017-12-05 10:58:52 -08:00 committed by GitHub
parent 8bcf5393f2
commit 25ec068aef
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
11 changed files with 23 additions and 13 deletions

View File

@ -2,3 +2,5 @@
include::getting-started.asciidoc[] include::getting-started.asciidoc[]
include::setup.asciidoc[] include::setup.asciidoc[]
include::upgrade.asciidoc[]

View File

@ -50,6 +50,4 @@ include::setup/sysconfig.asciidoc[]
include::setup/bootstrap-checks.asciidoc[] include::setup/bootstrap-checks.asciidoc[]
include::setup/upgrade.asciidoc[]
include::setup/stopping.asciidoc[] include::setup/stopping.asciidoc[]

View File

@ -1,5 +1,19 @@
[[setup-upgrade]] [[setup-upgrade]]
== Upgrading Elasticsearch = Upgrade Elasticsearch
[partintro]
--
Elasticsearch can usually be upgraded using a <<rolling-upgrades,Rolling upgrade>>
process so upgrading does not interrupt service. However, you might
need to <<reindex-upgrade,Reindex to upgrade>> indices created in older versions.
Upgrades across major versions prior to 6.0 require a <<restart-upgrade,Full cluster restart>>.
When upgrading to a new version of Elasticsearch, you need to upgrade each
of the products in your Elastic Stack. The steps you need to take to upgrade
differ depending on which products you are using. Want a list that's tailored
to your stack? Try out our {upgrade_guide}[Interactive Upgrade Guide]. For
more information about upgrading your stack, see {stack-ref}[Upgrading the
Elastic Stack].
[IMPORTANT] [IMPORTANT]
=========================================== ===========================================
@ -17,10 +31,6 @@ your data.
=========================================== ===========================================
Elasticsearch can usually be upgraded using a <<rolling-upgrades,Rolling upgrade>>
process so upgrading does not interrupt service. However, you might
need to <<reindex-upgrade,Reindex to upgrade>> indices created in older versions.
Upgrades across major versions prior to 6.0 require a <<restart-upgrade,Full cluster restart>>.
The following table shows when you can perform a rolling upgrade, when you The following table shows when you can perform a rolling upgrade, when you
need to reindex or delete old indices, and when a full cluster restart is need to reindex or delete old indices, and when a full cluster restart is
@ -56,7 +66,7 @@ For information about how to upgrade old indices, see <<reindex-upgrade,
Reindex to upgrade>>. Reindex to upgrade>>.
=============================================== ===============================================
--
include::upgrade/rolling_upgrade.asciidoc[] include::upgrade/rolling_upgrade.asciidoc[]

View File

@ -1,5 +1,5 @@
[[restart-upgrade]] [[restart-upgrade]]
=== Full cluster restart upgrade == Full cluster restart upgrade
A full cluster restart upgrade requires that you shut all nodes in the cluster A full cluster restart upgrade requires that you shut all nodes in the cluster
down, upgrade them, and restart the cluster. A full cluster restart was required down, upgrade them, and restart the cluster. A full cluster restart was required

View File

@ -1,5 +1,5 @@
[[reindex-upgrade]] [[reindex-upgrade]]
=== Reindex before upgrading == Reindex before upgrading
Elasticsearch can read indices created in the *previous major version*. Elasticsearch can read indices created in the *previous major version*.
Older indices must be reindexed or deleted. Elasticsearch 6.x Older indices must be reindexed or deleted. Elasticsearch 6.x
@ -56,7 +56,7 @@ been deleted.
[[reindex-upgrade-inplace]] [[reindex-upgrade-inplace]]
==== Reindex in place === Reindex in place
To manually reindex your old indices with the <<docs-reindex,`reindex` API>>: To manually reindex your old indices with the <<docs-reindex,`reindex` API>>:
@ -88,7 +88,7 @@ regular part of your Elastic Stack. For more information, see
******************************************* *******************************************
[[reindex-upgrade-remote]] [[reindex-upgrade-remote]]
==== Reindex from a remote cluster === Reindex from a remote cluster
You can use <<reindex-from-remote,reindex from remote>> to migrate indices from You can use <<reindex-from-remote,reindex from remote>> to migrate indices from
your old cluster to a new 6.x cluster. This enables you move to 6.x from a your old cluster to a new 6.x cluster. This enables you move to 6.x from a

View File

@ -1,5 +1,5 @@
[[rolling-upgrades]] [[rolling-upgrades]]
=== Rolling upgrades == Rolling upgrades
A rolling upgrade allows an Elasticsearch cluster to be upgraded one node at A rolling upgrade allows an Elasticsearch cluster to be upgraded one node at
a time so upgrading does not interrupt service. Running multiple versions of a time so upgrading does not interrupt service. Running multiple versions of