github-mirrors/logstash
1
0
Fork 0
mirror of https://github.com/elastic/logstash.git synced 2025-04-23 22:27:21 -04:00
Code Issues Projects Releases Packages Wiki Activity

Improve breaking PQ change doc for 6.3.0

Browse source 
Once 6.3.0 is the newest release the phrasing should reflect that.

Fixes #9548
This commit is contained in:
Andrew Cholakian 2018-05-09 15:00:59 -05:00
parent 0af9a91e25
commit f49ffad20d
1 changed files with 5 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs/static/breaking-changes.asciidoc vendored
View file

@ -1,15 +1,15 @@
[[breaking-changes]]
== Breaking Changes Across PQ Versions
== Breaking Changes Across PQ Versions Prior to Logstash 6.3.0
We regret to say that due to several serialization issues users will have to take some extra steps when upgrading Logstash instances using persistent queues. While we do strive to maintain backward compatibility within a given major release these bugs have forced us to break that compatibility to ensure correctness of operation. For more technical details on this issue please check our tracking github issue for this matter, https://github.com/elastic/logstash/issues/9494[#9494].
The following applies only to users upgrading from Logstash installations that used the persistent queue prior to 6.3.0.
If you are upgrading Logstash and use the persistent queue, we strongly recommend that you drain or delete the persistent queue before you upgrade.
We regret to say that due to several serialization issues prior to Logstash 6.3.0 users will have to take some extra steps when upgrading Logstash instances using persistent queues. While we do strive to maintain backward compatibility within a given major release these bugs forced us to break that compatibility in version 6.3.0 to ensure correctness of operation. For more technical details on this issue please check our tracking github issue for this matter, https://github.com/elastic/logstash/issues/9494[#9494].
If you are upgrading Logstash from a pre 6.3.0 version and use the persistent queue, we strongly recommend that you drain or delete the persistent queue before you upgrade.
To drain the queue, enable the `queue.drain` setting, and then shutdown Logstash. Wait for it to shutdown completely. This may take a while if you have a large queue backlog.
We are working to resolve issues with data incompatibilities in our 6.3.0 release. These steps won’t be required when you upgrade from a 6.3.0 or greater release to a later 6.x Logstash release.
== Breaking Changes in 6.0.0
This section discusses the changes that you need to be aware of when migrating to Logstash 6.0.0 from the previous major releases.