mirror of
https://github.com/elastic/logstash.git
synced 2025-04-23 22:27:21 -04:00
Update upgrade guide docs to refer to 6.0
Also include reference to the removal of mapping types Fixes #8532
This commit is contained in:
parent
ba42c3d601
commit
81df5ff9f6
1 changed files with 14 additions and 17 deletions
31
docs/static/upgrading.asciidoc
vendored
31
docs/static/upgrading.asciidoc
vendored
|
@ -17,7 +17,7 @@ See the following topics for information about upgrading Logstash:
|
|||
* <<upgrading-using-package-managers>>
|
||||
* <<upgrading-using-direct-download>>
|
||||
* <<upgrading-logstash-pqs>>
|
||||
* <<upgrading-logstash-5.0>>
|
||||
* <<upgrading-logstash-6.0>>
|
||||
|
||||
[[upgrading-using-package-managers]]
|
||||
=== Upgrading Using Package Managers
|
||||
|
@ -58,8 +58,8 @@ Keep in mind that only one Logstash instance can write to `path.queue`. You
|
|||
cannot have the original instance and the new instance writing to the queue at
|
||||
the same time.
|
||||
|
||||
[[upgrading-logstash-5.0]]
|
||||
=== Upgrading Logstash to 5.0
|
||||
[[upgrading-logstash-6.0]]
|
||||
=== Upgrading Logstash to 6.0
|
||||
|
||||
Before upgrading Logstash, remember to read the <<breaking-changes,breaking changes>>.
|
||||
|
||||
|
@ -70,26 +70,23 @@ If you are installing Logstash with other components in the Elastic Stack, also
|
|||
|
||||
Fresh installations can and should start with the same version across the Elastic Stack.
|
||||
|
||||
Elasticsearch 5.0 does not require Logstash 5.0. An Elasticsearch 5.0 cluster will happily receive data from a
|
||||
Logstash 2.x instance via the default HTTP communication layer. This provides some flexibility to decide when to upgrade
|
||||
Elasticsearch 6.0 does not require Logstash 6.0. An Elasticsearch 6.0 cluster will happily receive data from a
|
||||
Logstash 5.x instance via the default HTTP communication layer. This provides some flexibility to decide when to upgrade
|
||||
Logstash relative to an Elasticsearch upgrade. It may or may not be convenient for you to upgrade them together, and it
|
||||
is
|
||||
not required to be done at the same time as long as Elasticsearch is upgraded first.
|
||||
is not required to be done at the same time as long as Elasticsearch is upgraded first.
|
||||
|
||||
You should upgrade in a timely manner to get the performance improvements that come with Logstash 5.0, but do so in
|
||||
You should upgrade in a timely manner to get the performance improvements that come with Logstash 6.0, but do so in
|
||||
the way that makes the most sense for your environment.
|
||||
|
||||
==== When Not to Upgrade
|
||||
|
||||
If any Logstash plugin that you require is not compatible with Logstash 5.0, then you should wait until it is ready
|
||||
If any Logstash plugin that you require is not compatible with Logstash 6.0, then you should wait until it is ready
|
||||
before upgrading.
|
||||
|
||||
Although we make great efforts to ensure compatibility, Logstash 5.0 is not completely backwards compatible. As noted
|
||||
in the Elastic Stack upgrade guide, Logstash 5.0 should not be upgraded before Elasticsearch 5.0. This is both
|
||||
practical and because some Logstash 5.0 plugins may attempt to use features of Elasticsearch 5.0 that did not exist
|
||||
in earlier versions. For example, if you attempt to send the 5.x template to a cluster before Elasticsearch 5.0, then it
|
||||
will not be able to use it and all indexing will fail likely fail. If you use your own, custom template with Logstash,
|
||||
then this issue can be ignored.
|
||||
Although we make great efforts to ensure compatibility, Logstash 6.0 is not completely backwards compatible. As noted
|
||||
in the Elastic Stack upgrade guide, Logstash 6.0 should not be upgraded before Elasticsearch 6.0. This is both
|
||||
practical and because some Logstash 6.0 plugins may attempt to use features of Elasticsearch 6.0 that did not exist
|
||||
in earlier versions.
|
||||
|
||||
Note the Elasticsearch Output Index Template change in the <<breaking-changes>> documentation for further insight into
|
||||
this change and how it impacts operations.
|
||||
Note that multiple doctypes are no longer supported in Elasticsearch 6.0. Please refer to
|
||||
{ref}/removal-of-types.html[Removal of mapping types] and {ref}/breaking-changes.html[Breaking changes] for more information.
|
Loading…
Add table
Add a link
Reference in a new issue